Passer au contenu principal
Le connecteur ABBYY Vantage pour Microsoft Power Automate permet aux développeurs d’ajouter des fonctionnalités d’extraction de données et de classification de documents aux flux d’automatisation. Il s’agit d’un package redistribuable destiné à une installation manuelle.

Prérequis

Une licence Power Automate Premium est requise pour utiliser ce connecteur.
Vous devez disposer d’un tenant Vantage avec un client d’API public configuré. Paramètres spécifiques à ce connecteur :
  • URL de redirection autorisée : obtenue dans Power Automate plus loin dans ce guide de configuration. Conservez l’URL de redirection abbyy.com.
  • ID client : l’ID de votre client d’API public.
  • Secret client : votre secret client.
  • Désactivez Require PKCE for Authorization Code Flow.
  • Activez Allow issuing refresh tokens to refresh access tokens.
  • Activez Allow client credentials flow. Pour le ou les rôles, Skill User est recommandé.
Écran du client d’API public ABBYY Vantage
Vous aurez besoin de l’ID du tenant Vantage lors de l’étape de configuration de la sécurité.
1

Ouvrez la configuration du tenant

Dans Vantage, cliquez sur Configuration dans le volet de gauche.
2

Copiez l’ID du tenant

Cliquez sur General et recherchez le champ ID du tenant.Écran de configuration du tenant ABBYY Vantage

Installation du connecteur

Commencez par télécharger le connecteur sur ABBYY Marketplace.
  1. Ouvrez Microsoft Power Automate, puis sélectionnez Data > Custom connectors dans le menu de gauche. Vous devrez peut-être sélectionner More pour afficher cette option.
  2. Cliquez sur + New custom connector, puis sélectionnez Import an OpenAPI file.
  3. Saisissez un nom pour le connecteur, par exemple « ABBYY Vantage ».
  4. Recherchez le fichier ABBYY-Vantage-ProcessingAPI.swagger.json, puis ouvrez-le.

Configurer les informations générales

  1. [Facultatif] Téléversez une icône pour le connecteur à l’aide du logo ABBYY Vantage (Vantage-Square-icon.png) inclus dans le téléchargement du connecteur.
  2. Remplacez l’URL Host par l’adresse de votre serveur Vantage. La même adresse doit être utilisée dans les champs Authorization URL et Token URL.

Configurer la sécurité

Définissez Type d’authentification sur OAuth 2.0 et renseignez les champs suivants à l’aide des valeurs de votre client d’API public Vantage :
  • Client ID : l’ID de votre client d’API public.
  • Secret client : le secret de votre client d’API public.
  • URL d’autorisation : https://vantage-[region].abbyy.com/auth2/[tenant-id]/connect/authorize
  • URL du jeton : https://vantage-[region].abbyy.com/auth2/[tenant-id]/connect/token
  • URL de rafraîchissement : https://vantage-[region].abbyy.com/auth2/[tenant-id]/connect/token
  • Portée : openid permissions global.wildcard offline_access
Pour finaliser la configuration de la sécurité :
  1. Cliquez sur Créer un connecteur en haut de la page pour créer le connecteur et générer l’URL de redirection.
  2. Copiez l’URL de redirection. Dans votre client d’API public Vantage, sous URL de redirection autorisées, cliquez sur Ajouter une URL de redirection et collez l’URL.
  3. Dans votre client d’API public Vantage, sous Paramètres des flux OAuth 2.0 :
    • Désactivez Exiger PKCE pour le flux de code d’autorisation.
    • Activez Autoriser l’émission de jetons de rafraîchissement pour actualiser les jetons d’accès.

Créer une connexion

Dans l’onglet Test, choisissez Nouvelle connexion. Une fenêtre contextuelle de connexion s’ouvre. Saisissez votre nom d’utilisateur et votre mot de passe ABBYY Vantage, puis veillez à sélectionner le même compte que celui qui contient le client d’API public pour Microsoft Power Automate.

Tester la connexion

Une fois connecté à votre compte Vantage, la nouvelle connexion apparaît dans la liste Connections. Vérifiez que le connecteur fonctionne correctement en testant une opération. Sélectionnez ListAllAvailableSkills dans la liste Operations, puis cliquez sur Tester l’opération. Si cela ne fonctionne pas, reprenez les étapes précédentes pour vous assurer que tous les champs ont été correctement configurés.

Flows de démonstration Import

Voir les détails du processus d’exemple.

Modification des flows

Vous pouvez modifier un flow de démonstration ou créer le vôtre. Si vous devez travailler avec un jeu de données spécifique issu d’une réponse au format JSON, vous pouvez modifier le JSON Schema. Pour obtenir le JSON Schema, ouvrez le Swagger UI et appelez la méthode requise. Le Swagger UI est disponible à l’adresse suivante :

Étapes suivantes

Consultez les notes de version du connecteur Microsoft Power Automate.