> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Versionshinweis

> Versionshinweis für den ABBYY Vantage Connector für Microsoft Power Automate

<Update label="2.0" description="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.

  <Note>
    Speichern Sie die Änderungen, indem Sie oben auf der Seite auf **Update connector** klicken.
  </Note>

  3. 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. Überprüfen und testen Sie Ihre Power-Automate-Flows, um sicherzustellen, dass sie korrekt funktionieren.
</Update>

<Update label="1.3" description="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.

  <Note>
    Nach 30 Tagen muss sich der Client erneut authentifizieren. Dies ist eine bekannte Einschränkung.
  </Note>

  ## 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**.

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_security_edit.png" alt="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`

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_security_oauthsettings.png" alt="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**.

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_security_updateconnector.png" alt="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**.

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_connections_fixconnection.png" alt="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.

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_connections_switchaccount.png" alt="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.
</Update>