Änderungen
public-schema.jsonwurde inschema-vantage-transactions-api.jsonumbenannt, um den Verwendungszweck zu verdeutlichen (zur Verwendung mit der Aktion Parse JSON).ABBYY-Vantage.swagger.jsonwurde inABBYY-Vantage-ProcessingAPI.swagger.jsonumbenannt, um zu verdeutlichen, dass die Datei für die Processing API gedacht ist.- Veraltete Flow-Beispiele wurden entfernt und ein aktualisiertes Invoice-Flow-Beispiel hinzugefügt.
- Die PDF-Anleitung und der Versionshinweis wurden entfernt und auf diese Dokumentationswebsite verschoben.
- Das Vantage-Logo
Vantage-Square-icon.pngwurde zur optionalen Verwendung als Connector-Symbol hinzugefügt.
Upgrade von 1.3 auf 2.0
1
Über die OpenAPI-Datei aktualisieren
Suchen Sie den Connector unter Custom Connectors. Klicken Sie auf das Menü … und wählen Sie dann Update from OpenAPI file.
2
Die Connector-Einstellungen aktualisieren
Nehmen Sie die folgenden Aktualisierungen in den Connector-Einstellungen vor.Registerkarte General:
- Laden Sie optional ein Connector-Symbol hoch, und verwenden Sie dazu das neu hinzugefügte Vantage-Symbol.
- Vergewissern Sie sich, dass Host mit Ihrer Vantage-Region übereinstimmt.
- Client ID und Client Secret: Power Automate verlangt, dass Sie diese Werte erneut eingeben. Öffnen Sie dazu Ihren Vantage-Mandanten und navigieren Sie zu Ihrem Public API-Client. Wenn Sie das Client-Secret nicht mehr haben, generieren Sie ein neues.
- Authorization URL, Token URL und Refresh URL: Aktualisieren Sie diese Werte so, dass sie Ihre Vantage-Mandanten-ID enthalten. Dadurch lassen sich Verbindungsprobleme bei der Migration von Vantage 2.7 auf 3.0 und höher reduzieren. Eine Beispiel-URL sieht so aus:
https://vantage-us.abbyy.com/auth2/c5a3cc2f-853e-43f5-890c-b5ab2024e7b8/connect/authorize. - Scope: Stellen Sie sicher, dass dieser Wert auf
openid permissions global.wildcard offline_accessgesetzt ist. Der bisherige Wertpublicapi:allist nicht mehr gültig.
3
Die Verbindung testen
Verwenden Sie auf der Registerkarte Test die bisherige Verbindung oder wählen Sie New connection und authentifizieren Sie Ihr Konto erneut. Wählen Sie die Operation
ListAllAvailableSkills aus und klicken Sie auf Test operation. Wenn die Antwort Status (200) anzeigt, ist alles eingerichtet.4
Ihre Flows überprüfen
Überprüfen und testen Sie Ihre Power Automate Flows, um sicherzustellen, dass sie korrekt funktionieren.
Informationen zu diesem Release
Dieses Release unterstützt jetzt das Refresh-Token der Vantage Public API, sodass die Verbindung bis zu 30 Tage aktiv bleiben kann.Nach 30 Tagen muss sich der Client erneut authentifizieren. Dies ist eine bekannte Einschränkung.
Upgrade-Verfahren
1
Den benutzerdefinierten Connector bearbeiten
Gehen Sie in Power Automate zu Data > Custom connectors und bearbeiten Sie Ihren benutzerdefinierten ABBYY Vantage-Connector.
2
Die Registerkarte Security öffnen
Gehen Sie im Connector-Editor zur Registerkarte Security und klicken Sie auf Edit.
3
Die geleerten Felder erneut eingeben
Füllen Sie die Felder aus, die beim Wechsel in den Bearbeitungsmodus geleert werden:
- Client ID:
DAFadfakljaf... - Client secret:
Vezu_jgEw8kFi1u.... - Refresh URL: derselbe Endpunkt wie bei der Token URL,
https://<vantage_server_address>/auth2/connect/token
4
Den Scope aktualisieren
Fügen Sie dem Feld Scope
offline_access hinzu, sodass dort openid permissions publicapi:all offline_access steht.5
Den Connector aktualisieren
Klicken Sie auf Update connector.
6
Die Verbindung korrigieren
Gehen Sie zu Data > Connections und klicken Sie bei Ihrer fehlerhaften Verbindung auf Fix connection. Alternativ können Sie im Kontextmenü der Verbindung auf Switch account klicken und sich erneut anmelden.
Fehlerbehebungen
- Der Power Automate Connector meldet Benutzer nach 24 Stunden ab. (CONN-3066)
Bekannte Probleme
- CONN-2402: Zusätzliche Vantage-API-Methoden zur Swagger-Beschreibung hinzufügen.
- CONN-2691: Fehler „The image file format has not been recognized“ beim Hochladen von Dokumenten in einem Power-Automate-Flow (spezifische Test-Flows).
- CONN-3058: Die Beispiel-Flows des Connectors erweitern, um weitere Nutzungsszenarien der Vantage-API einzubeziehen.
- CONN-3090: Das Authentifizierungs-Token läuft nach 30 Tagen ab, selbst wenn ein Refresh-Token verwendet wird.
