Passer au contenu principal
Cette page répertorie les modifications, les étapes de mise à niveau et les problèmes connus pour chaque version du connecteur ABBYY Vantage pour Microsoft Power Automate, en commençant par la plus récente.
2.0
Notes de version

Modifications

  • public-schema.json a été renommé en schema-vantage-transactions-api.json afin de clarifier sa finalité (à utiliser avec l’action Parse JSON).
  • ABBYY-Vantage.swagger.json a été renommé en ABBYY-Vantage-ProcessingAPI.swagger.json afin de préciser qu’il est destiné à l’API de traitement.
  • Les exemples de flow obsolètes ont été supprimés et un exemple mis à jour de flow Invoice a été ajouté.
  • Le guide PDF et les notes de version ont été retirés et déplacés vers ce site de documentation.
  • Le logo Vantage Vantage-Square-icon.png a été ajouté pour une utilisation facultative comme icône du connecteur.

Mise à niveau de la version 1.3 vers 2.0

1

Mettre à jour à partir du fichier OpenAPI

Recherchez le connecteur dans Custom Connectors. Cliquez sur le menu , puis choisissez Update from OpenAPI file.
2

Mettre à jour les paramètres du connecteur

Effectuez les mises à jour suivantes dans les paramètres du connecteur.onglet Général :
  • Téléversez une icône de connecteur à l’aide de la nouvelle icône Vantage incluse (facultatif).
  • Vérifiez que le Host correspond à votre région Vantage.
onglet Sécurité :
  • Client Id et Client Secret : Power Automate vous demande de saisir à nouveau ces valeurs. Pour les obtenir, ouvrez votre tenant Vantage et accédez à votre client d’API public. Si vous n’avez plus le secret client, générez-en un nouveau.
  • Authorization URL, Token URL et Refresh URL : mettez à jour ces valeurs pour y inclure votre ID du tenant Vantage. Cela réduit les problèmes de connexion lors de la migration de Vantage 2.7 vers 3.0 et versions ultérieures. Voici un exemple d’URL : https://vantage-us.abbyy.com/auth2/c5a3cc2f-853e-43f5-890c-b5ab2024e7b8/connect/authorize.
  • Scope : assurez-vous que cette valeur est définie sur openid permissions global.wildcard offline_access. La valeur précédente publicapi:all n’est plus valide.
Enregistrez les modifications en cliquant sur Update connector en haut de la page.
3

Tester la connexion

Dans l’onglet Test, utilisez la connexion existante ou choisissez New connection, puis authentifiez à nouveau votre compte. Sélectionnez l’opération ListAllAvailableSkills et cliquez sur Test operation. Si la réponse affiche Status (200), tout est prêt.
4

Vérifier vos flows

Passez en revue et testez vos flows Power Automate pour vous assurer qu’ils fonctionnent correctement.
1.3
Notes de version

À propos de cette version

Cette version ajoute la prise en charge du jeton d’actualisation de l’API publique Vantage, ce qui permet à la connexion de rester active jusqu’à 30 jours.
Après 30 jours, le client doit s’authentifier de nouveau. Il s’agit d’une limitation connue.

Procédure de mise à niveau

1

Modifier le connecteur personnalisé

Dans Power Automate, accédez à Data > Custom connectors et modifiez votre connecteur personnalisé ABBYY Vantage.
2

Ouvrir l’onglet sécurité

Dans l’éditeur du connecteur, accédez à l’onglet sécurité et cliquez sur Edit.
3

Saisir de nouveau les champs effacés

Renseignez les champs qui sont effacés lors du passage en mode édition :
  • Client ID : DAFadfakljaf...
  • Client secret : Vezu_jgEw8kFi1u....
  • Refresh URL : même point de terminaison que Token URL, https://<vantage_server_address>/auth2/connect/token
4

Mettre à jour le Scope

Ajoutez offline_access au champ Scope afin d’obtenir openid permissions publicapi:all offline_access.
5

Mettre à jour le connecteur

Cliquez sur Update connector.
6

Corriger la connexion

Accédez à Data > Connections et cliquez sur Fix connection pour votre connexion défaillante. Vous pouvez également cliquer sur Switch account dans le menu contextuel de la connexion, puis vous reconnecter.
Après avoir effectué ces étapes, les flows n’échoueront plus en raison d’un token expiré.

Corrections de bugs

  • Le connecteur Power Automate se déconnecte après 24 heures. (CONN-3066)

Problèmes connus

  • CONN-2402 : Ajouter des méthodes supplémentaires de l’API Vantage à la description Swagger.
  • CONN-2691 : Erreur « The image file format has not been recognized » lors du téléversement de documents dans un flow Power Automate (flows de test spécifiques).
  • CONN-3058 : Étendre les flows d’exemple du connecteur afin d’inclure davantage de scénarios d’utilisation de l’API Vantage.
  • CONN-3090 : Le token d’authentification expire après 30 jours, même lorsqu’un jeton d’actualisation est utilisé.