Zum Hauptinhalt springen
​
2.0
Versionshinweis

​
Änderungen

✓ public-schema.json wurde in schema-vantage-transactions-api.json umbenannt, um den Zweck zu verdeutlichen (zur Verwendung mit der Aktion Parse JSON).✓ ABBYY-Vantage.swagger.json wurde in ABBYY-Vantage-ProcessingAPI.swagger.json umbenannt, um zu verdeutlichen, dass sie für die Processing API vorgesehen 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.png wurde zur optionalen Verwendung als Connectorsymbol hinzugefügt.

​
Upgrade von 1.3 auf 2.0

  1. Suchen Sie den Connector unter Custom Connectors. Klicken Sie auf das Menü … und wählen Sie dann Update from OpenAPI file.
  2. Nehmen Sie die folgenden Aktualisierungen in den Connector-Einstellungen vor: Registerkarte General:
    • [Optional] Laden Sie mit dem neu enthaltenen Vantage-Symbol ein Connectorsymbol hoch.
    • Vergewissern Sie sich, dass der Host Ihrer Vantage-Region entspricht.
    Registerkarte Security:
    • Client Id und Client Secret: Power Automate erfordert, dass Sie diese Werte erneut eingeben. Um sie zu erhalten, öffnen Sie 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: Es wird empfohlen, diese Werte zu aktualisieren, damit sie Ihre Vantage-Mandanten-ID enthalten. Dadurch werden Verbindungsprobleme bei der Migration von Vantage 2.7 auf 3.0 und höher reduziert. Eine Beispiel-URL sieht so aus: https://vantage-us.abbyy.com/auth2/c5a3cc2f-853e-43f5-890c-b5ab2024e7b8/connect/authorize.
    • Scope: Stellen Sie sicher, dass dies auf openid permissions global.wildcard offline_access gesetzt ist. Der vorherige Wert publicapi:all ist nicht mehr gültig.
Speichern Sie die Änderungen, indem Sie oben auf der Seite auf Update connector klicken.
  1. 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.
  2. Überprüfen und testen Sie Ihre Power-Automate-Flows, um sicherzustellen, dass sie korrekt funktionieren.
​
1.3
Versionshinweis

​
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. Gehen Sie in Power Automate zu Data > Custom connectors und bearbeiten Sie Ihren benutzerdefinierten ABBYY Vantage-Connector.
  2. Gehen Sie im Connector-Editor zur Registerkarte Security und klicken Sie auf Edit. Registerkarte Security im Connector-Editor mit der Schaltfläche Edit unter dem OAuth 2.0-Authentifizierungstyp
  3. Füllen Sie die Felder aus, die beim Wechsel in den Bearbeitungsmodus geleert werden:
    • Client ID: ABBYY.PowerAutomate
    • Client secret: Vezu_jgEw8kFi1ugXb66s2buh6ZC1M-Uf9
    • Refresh URL: derselbe Endpunkt wie bei der Token URL — https://<vantage_server_address>/auth2/connect/token
  4. Fügen Sie dem Feld Scope offline_access hinzu, sodass dort Folgendes steht: openid permissions publicapi:all offline_access OAuth 2.0-Sicherheitseinstellungen mit ausgefüllten Feldern für Client ID, Client secret, Authorization URL, Token URL, Refresh URL und Scope
  5. Klicken Sie auf Update connector. Symbolleiste des Connector-Editors mit hervorgehobener Schaltfläche Update connector
  6. Gehen Sie zu Data > Connections und klicken Sie bei Ihrer fehlerhaften Verbindung auf Fix connection. Connections-Liste mit der ABBYY Vantage-Verbindung und dem Link Fix connection Alternativ können Sie im Kontextmenü der Verbindung auf Switch account klicken und sich erneut anmelden. Kontextmenü von Connections mit der Option Switch account
Nach Abschluss dieser Schritte schlagen Flows nicht mehr aufgrund eines abgelaufenen Tokens fehl.

​
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.