Ensamblados externos - ABBYY Documentation

Puede utilizar ensamblados externos en scripts y módulos globales. Funcionan tanto los ensamblados estándar como los ensamblados de usuario compilados.

Agregar ensamblados externos

Puede agregar un ensamblado en la pestaña .NET References de las propiedades del tipo de lote, las propiedades del proyecto o las Propiedades de Definición de Document. Todas las clases de los ensamblados agregados están disponibles en scripts y módulos globales. Los ensamblados agregados en las propiedades del tipo de lote o de la Definición de Document están disponibles para ese tipo de lote o Definición de Document concretos. Los ensamblados agregados en las propiedades del proyecto son ensamblados compartidos, disponibles para todos los tipos de lote y las Definiciones de Document del proyecto. Si necesita el mismo ensamblado para distintos tipos de lote y Definiciones de Document, use un ensamblado compartido. Actualice un ensamblado compartido solo en las propiedades del proyecto.

Agregar un ensamblado en las propiedades del proyecto

Haga clic en Agregar

En la pestaña .NET References de las propiedades del proyecto, haga clic en Agregar….

Seleccione el tipo de ensamblado

En el cuadro de diálogo Agregar ensamblado, seleccione el tipo: Nombre de ensamblado estándar o Archivo adjunto.

Especifique el ensamblado

Según el tipo seleccionado, introduzca el nombre de ensamblado estándar o busque el archivo del ensamblado.

Los nuevos tipos de lote reciben automáticamente los ensamblados compartidos.

Agregar un ensamblado compartido a un tipo de lote o Definición de Document

Haga clic en Agregar

En la pestaña .NET References de las propiedades del tipo de lote o de la Definición de Document, haga clic en Add….

Seleccione Ensamblado compartido

En el cuadro de diálogo Agregar ensamblado que se abre, seleccione Ensamblado compartido.

Seleccione el nombre del ensamblado

Seleccione el nombre del ensamblado en la lista Reference.

No puede agregar un ensamblado compartido cuyo nombre sea similar al de un ensamblado estándar existente.

El siguiente ensamblado de usuario de ejemplo contiene un espacio de nombres, una clase y un método:

namespace TestNameSpace
{
    public class Test
    {
        public void Show(string text)
        {
            // Muestra el texto con los medios estándar de FlexiCapture: el método estático
            // void ShowMessage(string text, bool IsError) de la clase estática FCTools.
            ABBYY.FlexiCapture.FCTools.ShowMessage(text, false);
        }
    }
}

Para que las clases y los métodos de un ensamblado agregado sean accesibles desde los scripts de controladores de eventos, agregue el ensamblado en la pestaña .NET References de las Propiedades del tipo de lote (para un tipo de lote concreto) o de las Propiedades del proyecto (para el tipo de lote Predeterminado). Para los siguientes scripts, agregue ensamblados externos en la pestaña .NET References de las Propiedades de Definición de Document:

Un script que use clases y métodos del ensamblado externo debe contener el siguiente código:

TestNameSpace.Test test = new TestNameSpace.Test(); // crea un object de la class Test
test.Show("hello world"); // llama al method void Show() de la class Test

Depurar ensamblados externos

La depuración de ensamblados externos requiere tanto el archivo del ensamblado como un archivo .pdb con información simbólica. Solo se pueden depurar ensamblados con archivos .pdb cargados. Dado que los archivos .pdb son grandes, desactive la carga de información simbólica en el proyecto activo.

Claves del Registro que controlan la carga de información simbólica

Puede usar las siguientes claves del Registro para controlar si se cargan archivos .pdb:

Clave del Registro	Descripción
`HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\LoadSymbolsFromOriginalPath`	Especifica si se cargan archivos .pdb desde las carpetas originales de los archivos de ensamblado. Establezca el valor en `true` para cargar los archivos .pdb.
`HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\PDBSearchLocations`	Establece las rutas de búsqueda de archivos .pdb. Indique las rutas separadas por punto y coma. El resultado de la búsqueda es un archivo .pdb con información simbólica cuyo nombre coincide con el de un ensamblado.

De forma predeterminada, estas claves no se encuentran en el Registro. Si es necesario, el administrador puede agregarlas al Registro del sistema operativo del usuario. Para que los cambios en el Registro surtan efecto, reinicie ABBYY FlexiCapture. Para depurar un ensamblado, use una conexión a código administrado.

​Agregar ensamblados externos

​Agregar un ensamblado en las propiedades del proyecto

​Agregar un ensamblado compartido a un tipo de lote o Definición de Document

​Depurar ensamblados externos

​Claves del Registro que controlan la carga de información simbólica

Agregar ensamblados externos

Agregar un ensamblado en las propiedades del proyecto

Agregar un ensamblado compartido a un tipo de lote o Definición de Document

Depurar ensamblados externos

Claves del Registro que controlan la carga de información simbólica