Saltar al contenido principal
Se pueden utilizar ensamblados externos en scripts y módulos globales. Se admiten tanto los ensamblados estándar como los ensamblados de usuario compilados.

​
Agregar ensamblados externos

Se puede agregar un ensamblado en la pestaña .NET References de las propiedades de (Administrator) tipo de lote, las propiedades del proyecto o las Propiedades de Definición de Document (Developer). 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 y en las Propiedades de Definición de Document están disponibles para un tipo de lote o una Definición de Document concretos, respectivamente. Los ensamblados agregados en las propiedades del proyecto son ensamblados compartidos que están disponibles para todos los tipos de lote y las Definiciones de Document del proyecto. Por lo tanto, si necesita usar el mismo ensamblado para distintos tipos de lote y Definiciones de Document, puede usar un ensamblado compartido. Si es necesario actualizar un ensamblado compartido, solo tendrá que hacerlo en las propiedades del proyecto. Para agregar un ensamblado en las propiedades del proyecto, haga lo siguiente:
  1. En .NET References de las propiedades del proyecto, haga clic en Add…
  2. En el cuadro de diálogo Add Assembly que se abre, seleccione el tipo: Standard assembly name o Attached file.
  3. Según el tipo seleccionado, escriba el nombre estándar del ensamblado o busque un archivo de ensamblado.
Un ensamblado compartido se agrega automáticamente a los tipos de lote recién creados. Para agregar un ensamblado compartido a las Definiciones de Document y a los tipos de lote existentes, haga lo siguiente:
  1. En .NET References de las propiedades del tipo de lote o de la Definición de Document, haga clic en Add…
  2. En el cuadro de diálogo Add Assembly que se abre, seleccione Shared assembly.
  3. Seleccione el nombre del ensamblado en la lista Reference. Nota: No puede agregar un ensamblado compartido con un nombre similar al de un ensamblado estándar existente.
A continuación se muestra un código de ejemplo del ensamblado de usuario que contiene un espacio de nombres, una clase y un método de esta clase: 
namespace TestNameSpace
{
public class Test
 {
 public void Show(string text)
  {
// mostrará el texto mediante el método estático estándar de FlexiCapture 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 externo agregado estén disponibles para los scripts de controladores de eventos, este debe agregarse 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, los ensamblados externos se agregan en la pestaña .NET References de las Propiedades de Definición de Document: El script que usa clases y métodos del ensamblado externo debe contener el siguiente código: 
TestNameSpace.Test test = new TestNameSpace.Test(); // crea un objeto de la clase Test
test.Show("hello world"); // llama al método void Show() de la clase Test

​
Depuración de ensamblados externos

Al depurar ensamblados externos, se requieren tanto el archivo del ensamblado como un archivo .pdb con información simbólica. Solo se pueden depurar los ensamblados que tengan cargados archivos .pbd. Como los archivos .pbd son bastante grandes, es mejor desactivar 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 especificar si deben cargarse los archivos .pdb:
  • 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 de la clave en true para cargar archivos .pdb);
  • HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\ [PDBSearchLocations] = - establece las rutas de búsqueda de los archivos .pdb (las rutas deben indicarse 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).
Estas claves no se crean en el registro de forma predeterminada. Si es necesario, el Administrador puede agregarlas al registro del sistema operativo del usuario. Para que los cambios en el registro surtan efecto, debe reiniciar el programa. Para depurar un ensamblado, debe usarse la conexión a código administrado.