Spécifier les options d’export UiPath

Spécifiez les options utilisées pour l’exportation dans le fichier de configuration XML ou dans le script, selon la manière dont vous avez choisi de configurer vos paramètres d’exportation. Ces options comprennent les paramètres de connexion à UiPath Orchestrator, les options d’image de sortie, la méthode de nommage des fichiers d’exportation et la mise en correspondance des champs.

Paramètres de connexion à UiPath Orchestrator

Option	Valeur à indiquer
Server	L’adresse du serveur sur lequel se trouve Orchestrator.
Repository	Pour UiPath Enterprise Orchestrator, le nom de votre tenant Orchestrator. Pour UiPath Cloud Platform, le nom de votre service dans votre compte.
Username	Pour UiPath Enterprise Orchestrator, le nom ou l’adresse e-mail de l’utilisateur Orchestrator. Pour UiPath Cloud Platform, l’adresse e-mail de l’utilisateur, ainsi que le type d’authentification indiqué dans AuthenticationType.
Password	Le mot de passe de l’utilisateur Orchestrator.

Avec UiPath Cloud Platform, un ancien compte provenant de UiPath Community Orchestrator doit d’abord être migré vers la nouvelle méthode d’authentification en réinitialisant le mot de passe. Pour plus d’informations, voir Consuming APIs with the new cloud Orchestrator.

Exemples d’adresse du serveur

Pour UiPath Enterprise Orchestrator, indiquez l’adresse de l’application web Orchestrator :

connectorSettings.DmsConnectionSettings.Server = "https://orchestrator.mydomain.com";

Pour UiPath Cloud Platform Orchestrator, indiquez l’adresse de serveur suivante :

connectorSettings.DmsConnectionSettings.Server = "https://platform.uipath.com";

Exemple de référentiel

Pour UiPath Cloud Platform, indiquez le nom de votre service :

connectorSettings.DmsConnectionSettings.Repository = "test_service";

Pour connaître le nom d’un service disponible, ouvrez votre compte UiPath Cloud Platform et accédez à l’onglet Services.

Capture d'écran de l'onglet Services dans un compte UiPath Cloud Platform, répertoriant les services disponibles dont le nom sert de valeur à l'option Repository.

Rôles utilisateur requis dans Orchestrator

Attribuez les rôles suivants à l’utilisateur dans Orchestrator : view queues, create transactions et view units.

Capture d'écran de la page de modification des rôles dans UiPath Orchestrator, où l'autorisation View est sélectionnée pour Queues, l'autorisation Create pour Transactions et l'autorisation View pour Units.

Noms des fichiers d’exportation

Dans le champ FileName, indiquez le modèle utilisé pour générer les noms des fichiers d’exportation.

Balise	Valeur insérée
`<Project>`	Nom du projet ABBYY FlexiCapture
`<Batch>`	Nom du lot
`<DocumentDefinition>`	Nom de la Document Definition dans ABBYY FlexiCapture
`<Identifier>`	Identifiant du document
`<BatchType>`	Nom du type de lot
`<Time>`	Heure actuelle au format `yyyy-MM-dd_HH-mm-ss`
`<Index:>`	Valeur du champ d’indexation
`<FileNameWithoutExtension>`	Nom du fichier source

La balise <FileNameWithoutExtension> fonctionne lorsque l’image provient de l’Activity UiPath, car le lot contient alors ce paramètre d’enregistrement indiquant le nom du fichier image source.

Nom de la file d’attente Orchestrator

Dans le champ DmsMetadataTemplate.Name, indiquez le nom de la file d’attente Orchestrator :

connectorSettings.MappedFields.DmsMetadataTemplate.Name = "Verification queue"

Une fois le script d’export exécuté, une nouvelle transaction contenant les données est créée dans cette file d’attente. Créez la file d’attente dans Orchestrator.

Capture d’écran de la boîte de dialogue de création de file d’attente dans UiPath Orchestrator, où le nom de la file d’attente saisi doit correspondre à la valeur DmsMetadataTemplate.Name définie dans les paramètres d’export.

Options d’image de sortie

L’option ExportImageSavingOptions couvre les paramètres disponibles pour les images de sortie, tels que les options de format d’image et la possibilité de masquer les champs contenant des informations confidentielles. Pour plus d’informations, consultez IExportImageSavingOptions.

Mise en correspondance des champs

Mettez en correspondance les champs afin d’exporter les métadonnées reconnues. Pour chaque champ de Document Definition dont vous souhaitez exporter la valeur, indiquez son nom dans la transaction. Seuls les champs de Document Definition mis en correspondance sont exportés vers la transaction. Le nombre de champs pouvant être mis en correspondance est illimité. Si vous configurez les options d’export à l’aide d’un script, la paire de champs doit respecter le format suivant :

{ @"Invoice Layout\InvoiceNumber", "InvoiceNumber" }

Si vous configurez les options d’export en XML, la paire de champs doit respecter le format suivant :

<FieldPair>
<AfcField>Invoice Layout\InvoiceNumber</AfcField>
<DmsField>InvoiceNumber</DmsField>
</FieldPair>

Dans les deux formats, la première valeur correspond au chemin d’accès complet du champ dans l’ABBYY FlexiCapture Document Definition, et la seconde au nom du champ dans la transaction UiPath Orchestrator. Vous êtes libre de choisir le nom du champ dans la transaction. Les champs portant les noms spécifiés sont créés dans la transaction lors de l’exécution.

Options d’export UiPath supplémentaires

Spécifiez des paramètres d’export UiPath supplémentaires à l’aide de la propriété DmsSpecificOptions. Dans chacun des exemples de code suivants, le premier attribut correspond au nom de l’option et le deuxième attribut à sa valeur.

AuthenticationType

AuthenticationType définit le type d’authentification utilisé lors de la connexion à UiPath Orchestrator. Cette propriété ne peut prendre que deux valeurs : Basic et OAuth2. Pour UiPath Cloud Platform Orchestrator, cette option est obligatoire et sa valeur doit être OAuth2. Pour UiPath Enterprise Orchestrator, elle n’est pas obligatoire et sa valeur est Basic.

connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("AuthenticationType", "OAuth2"))
};

Reference

Reference spécifie une référence à utiliser lors de la création d’une transaction. Spécifiez Document.Batch.Id.ToString() comme valeur afin d’utiliser l’identifiant du lot comme référence.

connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("Reference", Document.Batch.Id.ToString()))
};

OrganizationUnitName

OrganizationUnitName exporte les résultats du traitement vers l’unité d’organisation Orchestrator spécifiée. Cette option est disponible uniquement avec UiPath Enterprise Orchestrator, et la fonctionnalité unité d’organisation doit être activée dans Orchestrator. Spécifiez le nom de l’unité d’organisation comme valeur de l’option.

connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("OrganizationUnitName", "ORG_UNIT_NAME"))
};

AccountLogicalName

AccountLogicalName indique le compte UiPath Cloud Platform vers lequel le résultat du traitement est exporté. Utilisez cette option lorsque l’utilisateur dispose de plusieurs comptes UiPath Cloud Platform. Elle n’est disponible que pour Orchestrator sur UiPath Cloud Platform. Le nom logique du compte correspond à la partie modifiable de l’URL du site Orchestrator, dans les Paramètres du compte d’Orchestrator. Il apparaît également dans la barre d’adresse du navigateur une fois que vous êtes connecté à votre compte.

Capture d'écran de la page Paramètres du compte dans UiPath Orchestrator, montrant l'URL du site Orchestrator dont la partie modifiable est le nom logique du compte.

connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("AccountLogicalName", "testaccount123"))
};

Plusieurs options dans un même script

Pour utiliser plusieurs options dans un même script d’export, indiquez-les comme éléments du tableau Option, séparés par des virgules :

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()))
};

Enregistrement des images de documents

L’option SaveDocumentImages indique si les fichiers image sont enregistrés dans une transaction UiPath Orchestrator. Définissez-la sur true pour enregistrer les images, ou sur false pour n’en enregistrer aucune.

connectorSettings.SaveDocumentImages = true;

Fichiers de référence

Vous trouverez des exemples de configuration des options d’export dans le dossier \Single-task package\Samples\FlexiCapture Scripts du chemin d’installation du connecteur. Recherchez les fichiers nommés default.config.xml et UiPath - ExportScript - Configure by script (Attended service).cs.

UiPath

Blue Prism

Automation Anywhere

WinActor

Appian

Pega

M-Files

Laserfiche

NX Manager

Spécifier les options d’export UiPath

Paramètres de connexion à UiPath Orchestrator

Exemples d’adresse du serveur

Exemple de référentiel

Rôles utilisateur requis dans Orchestrator

Noms des fichiers d’exportation

Nom de la file d’attente Orchestrator

Options d’image de sortie

Mise en correspondance des champs

Options d’export UiPath supplémentaires

AuthenticationType

Reference

OrganizationUnitName

AccountLogicalName

Plusieurs options dans un même script

Enregistrement des images de documents

Fichiers de référence

​Paramètres de connexion à UiPath Orchestrator

​Exemples d’adresse du serveur

​Exemple de référentiel

​Rôles utilisateur requis dans Orchestrator

​Noms des fichiers d’exportation

​Nom de la file d’attente Orchestrator

​Options d’image de sortie

​Mise en correspondance des champs

​Options d’export UiPath supplémentaires

​AuthenticationType

​Reference

​OrganizationUnitName

​AccountLogicalName

​Plusieurs options dans un même script

​Enregistrement des images de documents

​Fichiers de référence

Paramètres de connexion à UiPath Orchestrator

Exemples d’adresse du serveur

Exemple de référentiel

Rôles utilisateur requis dans Orchestrator

Noms des fichiers d’exportation

Nom de la file d’attente Orchestrator

Options d’image de sortie

Mise en correspondance des champs

Options d’export UiPath supplémentaires

AuthenticationType

Reference

OrganizationUnitName

AccountLogicalName

Plusieurs options dans un même script

Enregistrement des images de documents

Fichiers de référence