Passer au contenu principal
​
2.0
Notes de version

​
Modifications

✓ public-schema.json a été renommé en schema-vantage-transactions-api.json afin de mieux clarifier son usage (à 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 de flow Invoice mis à jour 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 1.3 vers 2.0

  1. Recherchez le connecteur sous Custom Connectors. Cliquez sur le menu …, puis choisissez Update from OpenAPI file.
  2. Effectuez les mises à jour suivantes dans les paramètres du connecteur : Onglet Général :
    • [Facultatif] Téléversez une icône de connecteur à l’aide de la nouvelle icône Vantage incluse.
    • 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 : il est recommandé de mettre à jour ces valeurs afin d’inclure l’ID de votre 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 qu’il est défini 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.
  1. Dans l’onglet Test, utilisez la connexion existante ou choisissez New connection, puis réauthentifiez votre compte. Sélectionnez l’opération ListAllAvailableSkills et cliquez sur Test operation. Si la réponse affiche Status (200), tout est prêt.
  2. 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 refresh token 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. Dans Power Automate, accédez à Data > Custom connectors et modifiez votre connecteur personnalisé ABBYY Vantage.
  2. Dans l’éditeur du connecteur, accédez à l’onglet sécurité et cliquez sur Edit. Onglet sécurité de l’éditeur du connecteur affichant le bouton Edit sous le type d’authentification OAuth 2.0
  3. Renseignez les champs qui sont effacés lors du passage en mode édition :
    • Client ID : ABBYY.PowerAutomate
    • Client secret : Vezu_jgEw8kFi1ugXb66s2buh6ZC1M-Uf9
    • Refresh URL : même point de terminaison que Token URL — https://<vantage_server_address>/auth2/connect/token
  4. Ajoutez offline_access au champ Scope afin d’obtenir : openid permissions publicapi:all offline_access Paramètres de sécurité OAuth 2.0 avec les champs Client ID, Client secret, Authorization URL, Token URL, Refresh URL et Scope renseignés
  5. Cliquez sur Update connector. Barre d’outils de l’éditeur du connecteur avec le bouton Update connector mis en évidence
  6. Accédez à Data > Connections et cliquez sur Fix connection pour votre connexion défaillante. Liste des Connections affichant la connexion ABBYY Vantage avec un lien Fix connection Vous pouvez également cliquer sur Switch account dans le menu contextuel de la connexion, puis vous reconnecter. Menu contextuel de Connections affichant l’option Switch account
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 refresh token est utilisé.