Assemblies externes - ABBYY Documentation

Vous pouvez utiliser des assemblies externes dans les scripts et les modules globaux. Les assemblies standard et les assemblies utilisateur compilées sont toutes deux prises en charge.

Ajouter des assemblies externes

Vous pouvez ajouter une assembly dans l’onglet .NET References des propriétés du type de lot, des propriétés du projet ou des Document Definition Properties. Toutes les classes des assemblies ajoutées sont disponibles dans les scripts et les modules globaux. Les assemblies ajoutées dans les propriétés du type de lot ou de Document Definition sont disponibles pour ce type de lot ou cette Document Definition spécifique. Les assemblies ajoutées dans les propriétés du projet sont des assemblies partagées, disponibles pour tous les types de lots et toutes les Document Definitions du projet. Si vous avez besoin de la même assembly pour différents types de lots et Document Definitions, utilisez une assembly partagée. Mettez à jour une assembly partagée uniquement dans les propriétés du projet.

Ajouter une assembly dans les propriétés du projet

Cliquez sur Ajouter

Dans l’onglet .NET References des propriétés du projet, cliquez sur Add….

Sélectionnez le type d’assembly

Dans la boîte de dialogue Ajouter un assembly qui s’ouvre, sélectionnez le type : Standard assembly name ou Attached file.

Spécifiez l’assembly

Selon le type sélectionné, saisissez le nom standard de l’assembly ou accédez à un fichier d’assembly.

Les nouveaux types de lots reçoivent automatiquement les assemblys partagées.

Ajouter un assembly partagé à un type de lot ou à une Document Definition

Cliquez sur Ajouter

Dans l’onglet .NET References des propriétés du type de lot ou des Document Definition Properties, cliquez sur Add….

Sélectionnez Assembly partagé

Dans la boîte de dialogue Ajouter un assembly qui s’ouvre, sélectionnez Assembly partagé.

Sélectionnez le nom de l’assembly

Sélectionnez le nom de l’assembly dans la liste Référence.

Vous ne pouvez pas ajouter un assembly partagé dont le nom est similaire à celui d’un assembly standard existant.

L’exemple d’assembly utilisateur suivant contient un espace de noms, une classe et une méthode :

namespace TestNameSpace
{
    public class Test
    {
        public void Show(string text)
        {
            // Affiche le texte via les moyens standard de FlexiCapture : la méthode statique
            // void ShowMessage(string text, bool IsError) de la classe statique FCTools.
            ABBYY.FlexiCapture.FCTools.ShowMessage(text, false);
        }
    }
}

Pour rendre les classes et les méthodes d’une assembly ajoutée accessibles aux scripts de gestionnaires d’événements, ajoutez l’assembly dans l’onglet .NET References des propriétés du type de lot (pour un type de lot spécifique) ou des Propriétés du projet (pour le type de lot Default). Pour les scripts suivants, ajoutez des assemblies externes dans l’onglet .NET References des Document Definition Properties :

Un script qui utilise des classes et des méthodes de l’assembly externe doit contenir le code suivant :

TestNameSpace.Test test = new TestNameSpace.Test(); // crée un objet de la classe Test
test.Show("hello world"); // appelle la méthode void Show() de la classe Test

Déboguer les assemblies externes

Le débogage des assemblies externes nécessite à la fois le fichier d’assembly et un fichier .pdb contenant les informations symboliques. Vous pouvez déboguer uniquement les assemblies dont les fichiers .pdb sont chargés. Étant donné que les fichiers .pdb sont volumineux, désactivez le chargement des informations symboliques dans le projet en cours.

Clés de registre contrôlant le chargement des informations symboliques

Vous pouvez utiliser les clés de registre suivantes pour contrôler le chargement des fichiers .pdb :

Clé de registre	Description
`HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\LoadSymbolsFromOriginalPath`	Indique s’il faut charger les fichiers .pdb à partir des dossiers d’origine des fichiers d’assembly. Définissez la valeur sur `true` pour charger les fichiers .pdb.
`HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\PDBSearchLocations`	Définit les chemins de recherche des fichiers .pdb. Indiquez les chemins en les séparant par des points-virgules. La recherche renvoie un fichier .pdb contenant des informations symboliques dont le nom correspond à celui d’un assembly.

Par défaut, ces clés ne figurent pas dans le registre. Si nécessaire, l’administrateur peut les ajouter au registre du système d’exploitation de l’utilisateur. Pour que les modifications apportées au registre prennent effet, redémarrez ABBYY FlexiCapture. Pour déboguer un assembly, utilisez une connexion au code managé.

​Ajouter des assemblies externes

​Ajouter une assembly dans les propriétés du projet

​Ajouter un assembly partagé à un type de lot ou à une Document Definition

​Déboguer les assemblies externes

​Clés de registre contrôlant le chargement des informations symboliques

Ajouter des assemblies externes

Ajouter une assembly dans les propriétés du projet

Ajouter un assembly partagé à un type de lot ou à une Document Definition

Déboguer les assemblies externes

Clés de registre contrôlant le chargement des informations symboliques