In der XML-Konfigurationsdatei oder im Skript (je nachdem, wie Sie Ihre Exporteinstellungen festgelegt haben) müssen Sie die Optionen angeben, die für den Export verwendet werden. Dazu gehören die Verbindungsparameter für die Verbindung mit UiPath Orchestrator, Optionen für Ausgabebilder, die Benennungsmethode für Exportdateien und die Feldzuordnung.
- Verbindungseinstellungen für UiPath Orchestrator.
1.1. Geben Sie in der Option Server die Adresse des Servers an, auf dem sich Orchestrator befindet.
- Wenn Sie UiPath Enterprise Orchestrator verwenden, geben Sie die Adresse der Orchestrator-Webanwendung in der Option Server wie folgt an:
connectorSettings.DmsConnectionSettings.Server = "https://orchestrator.mydomain.com";
- Wenn Sie UiPath Cloud Platform Orchestrator verwenden, geben Sie die folgende Serveradresse ein:
connectorSettings.DmsConnectionSettings.Server = "https://platform.uipath.com";
1.2. Unter der Option Repository:
- Wenn Sie UiPath Enterprise Orchestrator verwenden, geben Sie den Namen Ihres Orchestrator-Tenant an.
- Wenn Sie die UiPath Cloud Platform verwenden, geben Sie den Servicenamen in Ihrem Konto wie folgt an:
connectorSettings.DmsConnectionSettings.Repository = "test_service";
Sie können den Namen eines verfügbaren Service ermitteln, indem Sie Ihr UiPath Cloud Platform-Konto öffnen und zum Tab Services navigieren:
1.3. In der Option Username:
- Wenn Sie UiPath Enterprise Orchestrator verwenden, geben Sie den Namen oder die E-Mail-Adresse des Orchestrator-Benutzers an.
- Wenn Sie UiPath Cloud Platform verwenden, geben Sie die E-Mail-Adresse des Benutzers und den Authentifizierungstyp in der zusätzlichen Exportoption an.
1.4. Geben Sie in der Option Password das Kennwort des Orchestrator-Benutzers an.
Einem Benutzer in Orchestrator sollten die folgenden Rollen zugewiesen werden: view queues, create transactions und view units.
- Geben Sie im Feld FileName die Vorlage an, die zum Generieren der Namen der Exportdateien verwendet wird.
Liste der unterstützten dynamisch ersetzbaren Tags:
-
<Project> – Name des ABBYY FlexiCapture-Projekts;
-
<Batch> – Batch-Name;
-
<DocumentDefinition> – Name der Dokumentdefinition in ABBYY FlexiCapture;
-
<Identifier> – Dokumentbezeichner;
-
<BatchType> – Name des Batch-Typs;
-
<Time> – aktuelle Uhrzeit im Format yyyy-MM-dd_HH-mm-ss;
-
<Index:> – Wert des Felds Index.
Außerdem können Sie das Tag <FileNameWithoutExtension> verwenden, um den Namen der Quelldatei zu übernehmen (wenn das Bild von einer UiPath Activity empfangen wurde, ist dieser Registrierungsparameter mit dem Namen der Quellbilddatei im Batch enthalten).
- Geben Sie im Feld DmsMetadataTemplate.Name den Namen der Orchestrator-Warteschlange an, zum Beispiel:
connectorSettings.MappedFields.DmsMetadataTemplate.Name = "Verification queue"
Nachdem das Exportskript ausgeführt wurde, wird in dieser Warteschlange ein neuer Vorgang mit Daten erstellt. Erstellen Sie in Orchestrator eine solche Warteschlange:
- ExportImageSavingOptions – die für Ausgabebilder verfügbaren Optionen (z. B. Bildformatoptionen oder die Möglichkeit, Felder mit vertraulichen Informationen unkenntlich zu machen) sind in der ABBYY FlexiCapture-Hilfe beschrieben (siehe die Beschreibung der IExportImageSavingOptions-Schnittstelle).
- Ordnen Sie die Felder zu, um erkannte Metadaten zu exportieren. Für jedes Feld der Dokumentdefinition, dessen Wert Sie exportieren möchten, müssen Sie den Namen im Vorgang angeben.
Nur die zugeordneten Felder der Dokumentdefinition werden in den Vorgang exportiert. Es können beliebig viele Felder zugeordnet werden.
Wenn Sie Exportoptionen mithilfe eines Skripts konfigurieren, muss das Feldpaar das folgende Format haben:
{ @"Invoice Layout\InvoiceNumber", "InvoiceNumber" }
Der erste Wert ist der vollständige Pfad zum Feld in der FlexiCapture-Dokumentdefinition. Der zweite Wert ist der Name des Felds im UiPath-Orchestrator-Vorgang. Im zweiten Wert können Sie den Namen angeben, den Sie für das Feld im Vorgang verwenden möchten. Felder mit den angegebenen Namen werden zur Laufzeit im Vorgang erstellt.
Wenn Sie Exportoptionen per XML konfigurieren, muss das Feldpaar das folgende Format haben:
<FieldPair>
<AfcField>Invoice Layout\InvoiceNumber</AfcField>
<DmsField>InvoiceNumber</DmsField>
</FieldPair>
Dabei steht AfcField für den vollständigen Feldnamen in der ABBYY FlexiCapture Dokumentdefinition, und DmsField für den Feldnamen im UiPath-Orchestrator-Vorgang.
- Sie können über die Eigenschaft DmsSpecificOptions auch zusätzliche UiPath-Exporteinstellungen angeben:
6.1. AuthenticationType ermöglicht die Auswahl des Authentifizierungstyps, der bei der Anmeldung an UiPath Orchestrator verwendet wird. Es sind nur 2 Werte möglich: Basic und OAuth2.
Wenn Sie den Export zu UiPath Cloud Platform Orchestrator einrichten, ist die Verwendung dieser Option erforderlich. Geben Sie in diesem Fall OAuth2 an.
Wenn Sie den Export zu UiPath Enterprise Orchestrator einrichten, geben Sie Basic als Wert an. Für UiPath Enterprise Orchestrator ist die Verwendung dieser Option nicht erforderlich.
Ein Wert für diese Option kann mit dem folgenden Code festgelegt werden:
connectorSettings.DmsSpecificOptions = new Option[] {
new Option(new KeyValuePair<string, object>("AuthenticationType", "OAuth2"))
};
wobei AuthenticationType der Name der Option und das zweite Attribut ihr Wert ist.
6.2. Reference ermöglicht es Ihnen, beim Erstellen eines Vorgangs eine Referenz anzugeben. Um diese Option einzurichten, fügen Sie den folgenden Codeausschnitt in das Exportskript ein:
connectorSettings.DmsSpecificOptions = new Option[] {
new Option(new KeyValuePair<string, object>("Reference", Document.Batch.Id.ToString()))
};
wobei Reference der Name der Option ist und das zweite Attribut ihr Wert. Geben Sie Document.Batch.Id.ToString() als Wert an, um den Batch-Bezeichner als Referenz zu verwenden.
6.3. OrganizationUnitName ermöglicht den Export von Verarbeitungsergebnissen in die angegebene Orchestrator-Organisationseinheit. Diese Option ist nur für UiPath Enterprise Orchestrator verfügbar.
Um diese Option einzurichten, fügen Sie den folgenden Code in das Exportskript ein:
connectorSettings.DmsSpecificOptions = new Option[] {
new Option(new KeyValuePair<string, object>("OrganizationUnitName", "ORG_UNIT_NAME"))
};
wobei OrganizationUnitName der Optionsname und das zweite Attribut dessen Wert ist. Geben Sie den Namen der Organisationseinheit an, die Sie als Optionswert festlegen möchten.
6.4. AccountLogicalName gibt an, in welches Konto der UiPath Cloud Platform Verarbeitungsergebnisse exportiert werden. Diese Option wird verwendet, wenn dem Benutzer mehrere Konten in der UiPath Cloud Platform zur Verfügung stehen. Sie ist nur für den UiPath Cloud Platform Orchestrator verfügbar.
Der logische Kontoname wird als Wert für diese Option verwendet. Sie finden den logischen Namen in den Kontoeinstellungen des Orchestrators; es ist der bearbeitbare Teil der Orchestrator site URL. Der logische Name ist auch in der Adressleiste des Browsers sichtbar, sobald Sie sich bei Ihrem Konto angemeldet haben.
Der folgende Beispielcode veranschaulicht die Verwendung dieser Option:
connectorSettings.DmsSpecificOptions = new Option[] {
new Option(new KeyValuePair<string, object>("AccountLogicalName", "testaccount123"))
};
wobei AccountLogicalName der Name der Option und das zweite Attribut ihr Wert ist.
Wenn Sie in einem einzigen Exportskript mehrere Optionen verwenden müssen, geben Sie sie als Elemente des Option-Arrays an (durch Kommas getrennt). Zum Beispiel:
connectorSettings.DmsSpecificOptions = new Option[] {
new Option(new KeyValuePair<string, object>("AuthenticationType", "OAuth2")),
new Option(new KeyValuePair<string, object>("AccountLogicalName", "ACCOUNT_LOGICAL_NAME")),
new Option(new KeyValuePair<string, object>("Reference", Document.Batch.Id.ToString()))
};
- Die Option SaveDocumentImages gibt an, ob Bilddateien in einem UiPath Orchestrator-Vorgang gespeichert werden sollen. Setzen Sie diese Option auf true, wenn Bilder gespeichert werden sollen, bzw. auf false, wenn keine Bilder gespeichert werden sollen.
Der folgende Beispielcode zeigt die Verwendung dieser Option:
connectorSettings.SaveDocumentImages = true;
Beispiele zum Einrichten von Exportoptionen finden Sie im Ordner [Connector installation path]\Single-task package\Samples\FlexiCapture Scripts. Suchen Sie nach den Dateien default.config.xml und UiPath - ExportScript - Configure by script (Attended service).cs.