Passer au contenu principal
Vantage Scope est le conteneur dans lequel doivent être placées toutes les autres activités du connecteur UiPath : Use Skill, Get Results et Map Fields s’exécutent toutes de manière imbriquée dans un Scope. Le Scope contient les identifiants, les paramètres de proxy et les paramètres du client d’API public partagés par les activités imbriquées, afin que vous ne configuriez les détails de connexion qu’une seule fois par workflow.
L’activité Vantage Scope vous permet de configurer l’authentification à l’aide des flux Resource Owner Password Credentials Flow et Client Credentials Flow. Si vous configurez un fournisseur d’identité externe dans Vantage, le seul flux d’authentification utilisable est le Client Credentials Flow.
Pour plus d’informations, voir :

Fournisseur d’identité externe

Configurez l’authentification unique via un fournisseur d’identité OAuth 2.0 ou SAML 2.0 pour votre tenant Vantage.

Client d’API public

Créez et configurez un client d’API public pour vous authentifier auprès de l’API Vantage.

Authentification

Choisissez un flux OAuth 2.0 et obtenez un jeton d’accès.

Propriétés de l’activité

Paramètres de connexion

PropertyTypeDescription
Type d’octroi d’autorisationIEnumerable<AuthorizationGrantType>Le type d’octroi utilisé pour l’autorisation : ResourceOwnerPassword ou ClientCredentials.
Mot de passeStringMot de passe utilisé pour se connecter à ABBYY Vantage.
Mot de passe sécuriséSecureStringMot de passe sécurisé utilisé pour se connecter à ABBYY Vantage.
URL du serveurStringAdresse du serveur ABBYY Vantage.
TenantStringNom du tenant ABBYY Vantage ou identifiant du tenant. Cette propriété n’est requise que si l’utilisateur dont les identifiants servent à se connecter au serveur ABBYY Vantage est enregistré dans plusieurs tenants (plus d’un) sur le serveur. Le nom du tenant se trouve sur la page de connexion à Vantage dans votre navigateur, au moment où vous saisissez votre mot de passe.
Nom d’utilisateurStringAdresse e-mail de l’utilisateur utilisée pour se connecter à ABBYY Vantage.

Paramètres du proxy (facultatif)

PropriétéTypeDescription
Activer le proxyBooleanPermet d’utiliser un serveur proxy pour acheminer les requêtes HTTP.
URL du serveurStringL’adresse du serveur proxy (par ex. http://127.0.0.1:8080).
Nom d’utilisateurStringLe nom d’utilisateur utilisé pour se connecter au serveur proxy.
Mot de passeStringLe mot de passe utilisé pour se connecter au serveur proxy.
Mot de passe sécuriséSecureStringLe mot de passe sécurisé utilisé pour se connecter au serveur proxy.

Paramètres du client d’API public (facultatif)

PropertyTypeDescription
ID clientStringIdentifiant de l’application Vantage.
Secret clientStringClé sécurisée de l’application Vantage.
Secret client sécuriséSecureStringClé sécurisée de l’application Vantage sous forme de chaîne sécurisée.

Gérer les identifiants

Le mot de passe de l’utilisateur Vantage, le mot de passe du proxy et le secret client dans les paramètres du client peuvent être définis dans l’activité Scope, soit dans un paramètre de chaîne, soit dans le paramètre correspondant de type SecureString. Un mot de passe de type String est stocké en texte brut dans le fichier de projet XAML et n’est pas sécurisé. Un mot de passe String n’est recommandé que pour configurer les activités Use Skill et Map Fields afin d’obtenir la liste des compétences, ou pour déboguer votre processus UiPath. Une fois le processus entièrement configuré :
  • Si vous utilisez le Resource Owner Password Credentials Flow, supprimez la propriété Password de l’activité Vantage Scope et configurez la propriété Secure Password.
  • Si vous utilisez le Client Credentials Flow, supprimez la propriété Client Secret de l’activité Vantage Scope et configurez la propriété Secure Client Secret.
Nous vous recommandons d’utiliser les assets UiPath Orchestrator pour stocker vos identifiants en toute sécurité. Utilisez l’activité Get Credential pour récupérer le mot de passe depuis Orchestrator et le transmettre à l’activité Vantage Scope via une variable.
Le même type de mot de passe doit être utilisé pour les Paramètres de connexion, les Paramètres du proxy et les Paramètres du client.

Configurer le client d’API public Vantage

Lorsque vous créez un client dans ABBYY Vantage, configurez les éléments suivants dans la section OAuth 2.0 Flows Settings des paramètres du client, selon le type d’octroi que vous utilisez :
Flux d’autorisationParamètres client OAuth 2.0 à activer
Resource Owner Password Credentials FlowAllow Resource Owner Password Credentials Flow
Client Credentials FlowAllow issuing refresh tokens to refresh access tokens, Allow client credentials flow, ainsi que les rôles requis sélectionnés via Manage Roles
Si vous sélectionnez, via Manage Roles, un ou plusieurs rôles associés à des compétences, sélectionnez également les compétences autorisées pour ces rôles.
Pour plus d’informations sur les rôles ABBYY Vantage, consultez Contrôle d’accès fondé sur les rôles.

Renseignez les champs de l’activité

Si toutes les propriétés des paramètres du client d’API public Vantage sont vides, le client ABBYY Vantage par défaut est utilisé.
Champs à renseigner pour ce flux :
Champs de l’activité Vantage Scope pour le Resource Owner Password Credentials Flow

Configurer les paramètres du proxy

Vous pouvez configurer, au moment de l’exécution, les requêtes du connecteur pour qu’elles transitent par un serveur proxy. Les types d’authentification proxy suivants sont pris en charge : Basic, NTLM, authentification IP et proxy transparent. Pour utiliser un proxy, sélectionnez l’activité Vantage Scope. Dans le groupe de propriétés Proxy Settings (optional), définissez la valeur de la propriété Enable Proxy sur "true", puis spécifiez l’adresse de votre serveur proxy dans la propriété Server URL.
Indiquez, dans les propriétés Username et Password / Secure Password, les identifiants de connexion au proxy.

Use Skill activity

Créer une transaction ABBYY Vantage pour traiter un document avec une compétence.

Get Results activity

Récupérer les résultats du traitement depuis ABBYY Vantage.

Map Fields activity

Enregistrer les valeurs des champs extraites dans des variables UiPath.