Modifications
public-schema.jsona été renommé enschema-vantage-transactions-api.jsonafin de clarifier sa finalité (à utiliser avec l’action Parse JSON).ABBYY-Vantage.swagger.jsona été renommé enABBYY-Vantage-ProcessingAPI.swagger.jsonafin 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.pnga é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.
- 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édentepublicapi:alln’est plus valide.
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.
À 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.
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é.
