Externe Assemblies - ABBYY Documentation

Sie können externe Assemblies in Skripten und Sprachmodulen verwenden. Sowohl Standard- als auch kompilierte Benutzer-Assemblies funktionieren.

Externe Assemblies hinzufügen

Sie können eine Assembly auf der Registerkarte .NET References in den Eigenschaften des Batch-Typs, den Projekteigenschaften oder den Eigenschaften der Dokumentdefinition hinzufügen. Alle Klassen der hinzugefügten Assemblies sind in Skripten und globalen Sprachmodulen verfügbar. Assemblies, die in den Eigenschaften des Batch-Typs oder der Dokumentdefinition hinzugefügt werden, stehen nur für den jeweiligen Batch-Typ bzw. die jeweilige Dokumentdefinition zur Verfügung. Assemblies, die in den Projekteigenschaften hinzugefügt werden, sind gemeinsame Assemblies und stehen allen Batch-Typen und Dokumentdefinitionen im Projekt zur Verfügung. Wenn Sie dieselbe Assembly für verschiedene Batch-Typen und Dokumentdefinitionen benötigen, verwenden Sie eine gemeinsame Assembly. Aktualisieren Sie eine gemeinsame Assembly nur in den Projekteigenschaften.

Eine Assembly in den Projekteigenschaften hinzufügen

Auf „Add“ klicken

Klicken Sie auf der Registerkarte .NET References der Projekteigenschaften auf Add….

Assembly-Typ auswählen

Wählen Sie im daraufhin geöffneten Dialogfeld Add Assembly den Typ Standard assembly name oder Attached file aus.

Assembly angeben

Geben Sie je nach ausgewähltem Typ den Standardnamen der Assembly ein oder wählen Sie eine Assembly-Datei aus.

Neue Batch-Typen erhalten gemeinsame Assemblies automatisch.

Eine gemeinsame Assembly zu einem Batch-Typ oder einer Dokumentdefinition hinzufügen

Auf Add klicken

Klicken Sie auf der Registerkarte .NET References in den Eigenschaften des Batch-Typs oder der Dokumentdefinition auf Add….

Gemeinsame Assembly auswählen

Wählen Sie im Dialogfeld Add Assembly die Option Shared assembly aus.

Assembly-Namen auswählen

Wählen Sie den Namen der Assembly aus der Liste Reference aus.

Sie können keine gemeinsame Assembly hinzufügen, deren Name dem einer vorhandenen Standard-Assembly ähnelt.

Die folgende Beispiel-Assembly enthält einen Namespace, eine Klasse und eine Methode:

namespace TestNameSpace
{
    public class Test
    {
        public void Show(string text)
        {
            // Zeigt Text mit den Standardmitteln von FlexiCapture an: die statische Methode
            // void ShowMessage(string text, bool IsError) aus der statischen Klasse FCTools.
            ABBYY.FlexiCapture.FCTools.ShowMessage(text, false);
        }
    }
}

Damit die Klassen und Methoden einer hinzugefügten Assembly in den Ereignishandler-Skripten verfügbar sind, fügen Sie die Assembly auf der Registerkarte .NET References der Eigenschaften des Batch-Typs (für einen bestimmten Batch-Typ) oder der Projekteigenschaften (für den Standard-Batch-Typ) hinzu. Fügen Sie für die folgenden Skripte externe Assemblies auf der Registerkarte .NET References der Eigenschaften der Dokumentdefinition hinzu:

Ein Skript, das Klassen und Methoden der externen Assembly verwendet, muss den folgenden Code enthalten:

TestNameSpace.Test test = new TestNameSpace.Test(); // erstellt ein Objekt der Klasse Test
test.Show("hello world"); // ruft die Methode void Show() der Klasse Test auf

Externe Assemblies debuggen

Zum Debuggen externer Assemblies werden sowohl die Assembly-Datei als auch eine .pdb-Datei mit Symbolinformationen benötigt. Sie können nur Assemblies mit geladenen .pdb-Dateien debuggen. Da .pdb-Dateien groß sind, deaktivieren Sie das Laden von Symbolinformationen im aktuellen Projekt.

Registrierungsschlüssel zum Steuern des Ladens von Symbolinformationen

Mit den folgenden Registrierungsschlüsseln können Sie steuern, ob .pdb-Dateien geladen werden:

Registrierungsschlüssel	Beschreibung
`HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\LoadSymbolsFromOriginalPath`	Gibt an, ob .pdb-Dateien aus den ursprünglichen Ordnern der Assembly-Dateien geladen werden sollen. Setzen Sie den Wert auf `true`, um .pdb-Dateien zu laden.
`HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\PDBSearchLocations`	Legt die Suchpfade für .pdb-Dateien fest. Geben Sie die Pfade durch Semikolons getrennt an. Als Suchergebnis wird eine .pdb-Datei mit Symbolinformationen zurückgegeben, deren Name dem Namen einer Assembly entspricht.

Standardmäßig sind diese Schlüssel nicht in der Registrierung vorhanden. Bei Bedarf kann der Administrator sie der Registrierung im Betriebssystem des Benutzers hinzufügen. Damit die Registrierungsänderungen wirksam werden, starten Sie ABBYY FlexiCapture neu. Verwenden Sie zum Debuggen einer Assembly eine Verbindung mit verwaltetem Code.

​Externe Assemblies hinzufügen

​Eine Assembly in den Projekteigenschaften hinzufügen

​Eine gemeinsame Assembly zu einem Batch-Typ oder einer Dokumentdefinition hinzufügen

​Externe Assemblies debuggen

​Registrierungsschlüssel zum Steuern des Ladens von Symbolinformationen

Externe Assemblies hinzufügen

Eine Assembly in den Projekteigenschaften hinzufügen

Eine gemeinsame Assembly zu einem Batch-Typ oder einer Dokumentdefinition hinzufügen

Externe Assemblies debuggen

Registrierungsschlüssel zum Steuern des Ladens von Symbolinformationen