Passer au contenu principal
Il est possible d’utiliser des assemblies externes dans les scripts et les modules globaux. Les assemblies utilisateur, standard comme compilées, peuvent être utilisées.

​
Ajout d’assembly externes

Vous pouvez ajouter des assembly externes dans l’onglet Scripts de la boîte de dialogue Propriété du type de lot ou dans Tools → Options…. Toutes les classes et méthodes des assembly que vous ajoutez sont accessibles aux scripts et aux modules globaux. Les assembly que vous ajoutez aux propriétés d’un type de lot ou d’une Document Definition ne sont disponibles que pour ce type de lot ou cette Document Definition. Pour ajouter une assembly :
  1. Ouvrez la boîte de dialogue Project Properties, cliquez sur l’onglet Scripts, puis sur le bouton References .Net… ;
  2. Dans la boîte de dialogue qui s’ouvre, cliquez sur Add… ;
  3. Dans la boîte de dialogue Add Assembly, sélectionnez Attached file ou Standard assembly name dans le champ de type ;
  4. Selon le type sélectionné, indiquez soit le chemin d’accès du fichier, soit le nom standard.
Vous trouverez ci-dessous un exemple de code d’une assembly utilisateur contenant un namespace, une classe et une méthode de cette classe : 
namespace TestNameSpace
{
public class Test
    {
    public void Show(string text)
       {
      // affiche un message texte – méthode statique Show(string text) de la classe System.Windows.Forms.MessageBox ;
System.Windows.Forms.MessageBox.Show(text);
       }
    }
}
Un script qui utilise une classe et des méthodes d’un 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ébogage des assembly externes

Lors du débogage d’assembly externes, le fichier assembly et le fichier *.pdb contenant les informations symboliques sont tous deux obligatoires. Seules les assembly dont les fichiers *.pdb sont chargés peuvent être déboguées. Les fichiers *.pdb étant assez volumineux, nous vous recommandons de désactiver le chargement des informations symboliques dans le projet en cours.

​
Clés de registre permettant de contrôler le chargement des informations symboliques :

Vous pouvez utiliser les clés de registre suivantes pour indiquer si les fichiers *.pdb doivent être chargés :
  • HKEY_CURRENT_USER\Software\ABBYY\ScanStationFC\4.0\Shell\Script [LoadSymbolsFromOriginalPath] - Indique si les fichiers *.pdb doivent être chargés à partir du même dossier que celui d’où l’assembly a été chargé (pour charger les fichiers *.pdb, définissez la valeur de la clé sur True)
  • HKEY_CURRENT_USER\Software\ABBYY\ScanStationFC\4.0\Shell\Script[PDBSearchLocations] = <chemin vers le dossier contenant les fichiers PDB> - Indique les chemins de recherche à parcourir pour trouver les fichiers *.pdb (les chemins doivent être séparés par des points-virgules ; le résultat de la recherche est un fichier *.pdb contenant des informations symboliques, dont le nom est identique à celui de l’assembly).
Ces clés ne sont pas créées par défaut dans le registre. Si nécessaire, l’Administrateur peut ajouter ces clés au registre du système d’exploitation de l’utilisateur. Pour que les modifications apportées au registre prennent effet, vous devez redémarrer le programme. Pour déboguer un assembly, vous devez vous connecter au code managé.