Acumatica v2-Verbindung

Einführung

Eine Acumatica-Verbindung, erstellt mit dem Acumatica v2-Connector, ermöglicht den Zugriff auf Acumatica. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Acumatica.

Erstellen oder Bearbeiten einer Acumatica-Verbindung

Eine neue Acumatica v2-Verbindung wird mithilfe des Acumatica v2-Connectors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine vorhandene Acumatica v2-Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten im Projektbereich (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer Acumatica-Verbindung

Jedes Benutzeroberflächenelement des Verbindungskonfigurationsbildschirms von Acumatica v2 wird unten beschrieben.

• Verbindungsname: Geben Sie einen Namen zur Identifizierung der Verbindung ein. Der Name muss für jede Acumatica v2-Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:). Dieser Name wird auch zur Identifizierung des Acumatica v2- Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• URL: Geben Sie die URL ein.

• Auth-Schema: Wählen Sie das Autorisierungsschema aus, eines der folgenden:

  • Grundlegend

    • Benutzer: Geben Sie den Benutzer ein.

    • Passwort: Geben Sie das Passwort ein.

  • OAuth

    • OAuth initiieren: Wählen Sie eine der folgenden OAuth-Einstellungen:

      • AUS

        • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

      • GETANDREFRESH

      • AKTUALISIEREN

        • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

    • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

    • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

    • Rückruf URL: Geben Sie die Rückruf URL ein.

    • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

  • OAuthImplicit

    • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

    • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

  • OAuth-Passwort

    • Benutzer: Geben Sie den Benutzer ein.

    • Passwort: Geben Sie das Passwort ein.

    • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

    • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

• Schema: Wählen Sie das Schema aus, eines der folgenden:

  • OData

    • Firma: Geben Sie die Firma ein.

  • ODataV4

    • Firma: Geben Sie die Firma ein.

  • REST

    • Endpoint: Geben Sie die Endpoint ein. Versionen bis 24.200.001 werden unterstützt.

    • Endpoint: Geben Sie den Endpoint ein.

• Proxy-Einstellungen verwenden: Wählen Sie diese Option aus, um Proxy-Einstellungen des privaten Agenten zu verwenden.

• Erweiterte Konfigurationen: Wenn diese Option ausgewählt ist, wird die Tabelle Erweiterte Konfigurationseigenschaften angezeigt, in der zusätzliche Konfigurationseigenschaften hinzugefügt werden können als Schlüssel-Wert-Paare.

  • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie für jede Eigenschaft ein Key-Value Paar ein.
  • Senden: Speichert das Key-Value Paar in der Tabelle. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
  • Verwerfen: Verwirft eine neue Zeile oder Änderungen an einer bestehenden Zeile. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
  • Bearbeiten: Ermöglicht das Bearbeiten eines vorhandenen Key-Value Paar. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
  • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine bestehende Zeile fahren.
  • Alles löschen: Löscht alle Zeilen aus der Tabelle.

  Wichtig

  Felder in der Tabelle „Erweiterte Konfigurationseigenschaften“ zeigen das Variablensymbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein..

  Felder in der Tabelle „Erweiterte Konfigurationseigenschaften“ unterstützen die Verwendung von Variablen zur Übergabe von Roh-JSON nicht. Wenn Ihr Anwendungsfall die direkte Definition von Roh-JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt vor der Übergabe mit einer Variable. Beispiel: {"success": "true"};wird {\"success\": \"true\"};.

• Test: Klicken Sie hier, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Beim Testen der Verbindung wird die neueste Version des Connectors von den Agenten der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Updates deaktivieren..

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach Änderungen an einer neuen oder bestehenden Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

• Löschen: Klicken Sie nach dem Öffnen einer bestehenden Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden aufgefordert, das Löschen der Verbindung zu bestätigen.

Konfigurieren von OAuth-Verbindungen

Dieser Connector unterstützt die Verbindung über OAuth mithilfe spezifischer Konfigurationseigenschaften. Nachdem Sie ein Authentifizierungsschema mit OAuth initiieren ausgewählt haben, können Sie die Konfiguration in den angezeigten Feldern festlegen.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Fällen benötigen Sie ein Drittpartei (z. B. Postman oder ein ähnliches Tool), um die erforderlichen Zugriffstoken vom betreffenden Endpoint abzurufen. Beide Szenarien funktionieren nur für einzelne Agentengruppen. Dabei handelt es sich um Agentengruppen, die aus einem einzelnen Agenten bestehen.

• Szenario 1: Verwenden eines OAuth-Zugriffstokens, das nach einer festgelegten Zeit abläuft.

  Mit dieser Konfiguration geben Sie ein OAuth-Zugriffstoken an, das für einen festgelegten Zeitraum gültig ist, der vom jeweiligen Endpoint bestimmt wird. Der Connector verwendet das Token zum Herstellen der Verbindung. Nach Ablauf des Zugriffstokens funktioniert die Verbindung jedoch nicht mehr. Sie konfigurieren den Connector für die Verwendung des Tokens, indem Sie die folgenden Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	OFF
  OAuth-Zugriffstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens setzen

• Szenario 2: Verwenden eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Aktualisierungstoken, um die automatische Aktualisierung des Zugriffs zu ermöglichen.

  Mit dieser Konfiguration verwendet der Connector ein Aktualisierungstoken, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist im Allgemeinen die beste Methode zur Konfiguration von OAuth.

  Sie geben ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken an, je nach Endpoint. Sie konfigurieren den Connector für die Verwendung dieser Token, indem Sie die folgenden Eigenschaften festlegen:

  Konfigurationseigenschaft	Wert
  OAuth initiieren	REFRESH
  OAuth-Zugriffstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens setzen
  OAuth-Aktualisierungstoken	Auf den Wert des vom Endpoint erhaltenen OAuth-Aktualisierungstokens gesetzt

Nächste Schritte

Nachdem eine Acumatica Connector-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einer Operation) oder als Ziele (zum Verbrauchen von Daten in einer Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Die folgenden Aktivitätstypen sind verfügbar:

• Abfrage: Ruft Datensätze aus einer Tabelle bei Acumatica ab und soll als Quelle in einer Operation verwendet werden.

• Erstellen: Fügt einen Datensatz in eine Tabelle bei Acumatica ein und soll als Ziel in einer Operation verwendet werden.

• Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle bei Acumatica und soll als Ziel in einer Operation verwendet werden.

• Löschen: Löscht einen Datensatz aus einer Tabelle bei Acumatica und soll als Ziel in einer Operation verwendet werden.

• Ausführen: Führt einen Vorgang bei Acumatica aus und ist zur Verwendung als Ziel in einer Operation vorgesehen.