Zum Inhalt springen

NetSuite-Verbindung

Einführung

Eine NetSuite-Verbindung, die mit dem NetSuite-Connector erstellt wurde, ermöglicht den Zugriff auf NetSuite. Sobald eine Verbindung konfiguriert ist, können Instanzen von NetSuite-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Hinweis

Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. Wenn aktiviert, erfordert eine Änderung des Kontos, des Consumer Key oder des Token Key in dieser Verbindung, dass die Benutzer das Consumer Secret und das Token Secret für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer NetSuite-Verbindung

Eine neue NetSuite-Verbindung wird mit dem NetSuite-Connector an einem dieser Orte erstellt:

Eine vorhandene NetSuite-Verbindung kann an diesen Orten bearbeitet werden:

Konfigurieren einer NetSuite-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die NetSuite-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die NetSuite-Verbindung zu identifizieren. Der Name muss für jede NetSuite-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den NetSuite-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

  • Konto: Geben Sie die NetSuite-Konto-ID ein, die mit dem NetSuite-Konto verbunden ist, das Sie verwenden möchten. Konten, die mit einer NetSuite-Sandbox-Umgebung verbunden sind, können mit einem Suffix wie SB1, SB2 usw. gekennzeichnet sein.

  • WSDL-Download-URL: Geben Sie die kontospezifische URL des NetSuite WSDL ein, die von der NetSuite-Instanz verwendet wird. Jitterbit unterstützt die in NetSuite-Voraussetzungen aufgeführten WSDL-Versionen. Anweisungen zum Abrufen der kontospezifischen WSDL-URL finden Sie in Verwenden einer NetSuite-kontospezifischen WSDL-URL.

  • Consumer Key und Consumer Secret: Geben Sie die Werte für den NetSuite Consumer Key und Consumer Secret ein. Wenn Sie das von Jitterbit bereitgestellte Integrationsaufzeichnungs-Bundle verwendet haben (siehe NetSuite-Voraussetzungen), verwenden Sie die folgenden Werte:

    • Consumer key: 768b136f26ea98b957e7dd2e87bad89077ca2ec484a0cb72c5a8e1b003627213

    • Consumer secret: 0dbf3d5e3c2d2ff72ef1a8e8d564d5786da2f60006ad97a00246d7ce924c8b51

    Wenn Sie den Integrationsdatensatz auf andere Weise erstellt haben, folgen Sie den Schritten in Werte für die Verwendung von NetSuite TBA sammeln, um Werte zu erhalten, die verwendet werden können.

  • Token key und Token secret: Geben Sie die NetSuite Token-ID und die Token-Secret-Werte ein, die Sie von NetSuite erhalten haben. Für Anweisungen zum Abrufen dieser Werte siehe Werte für die Verwendung von NetSuite TBA sammeln.

    Vorsicht

    Wenn Sie ein NetSuite-Sandbox-Konto verwenden, müssen Sie jedes Mal, wenn die Sandbox aktualisiert wird, neue Tokens erstellen.

  • Signature algorithm: Der Signaturalgorithmus HMAC-SHA256 wird verwendet, um die Anfrage zu signieren und kann nicht geändert werden. Der Signaturalgorithmus bestimmt, wie die Nutzlast verschlüsselt wird.

    Hinweis

    NetSuite hat HMAC-SHA1 als gültige Signaturmethode zugunsten von HMAC-SHA256 in diesen Versionen eingestellt:

    • Non-Production Accounts: NetSuite-Version 2021.2 und höher.

    • Production Accounts: NetSuite-Version 2023.1 und höher.

    Die Abkündigung von HMAC-SHA1 ist unabhängig davon, welche WSDL-Version Sie in der Konfiguration der NetSuite-Verbindung angeben.

  • Call time out: Geben Sie den Wert für die Anrufzeitüberschreitung in Sekunden ein, wenn Sie möchten, dass der Zeitüberschreitungswert geringer ist als die Standardeinstellung des Agents.

    Hinweis

    Die Standardeinstellung des Agents für die Zeitüberschreitung von NetSuite-Anrufen beträgt 300 Sekunden. Für private Agents kann dieser Standard im Abschnitt [Connectorsinfo] der Konfigurationsdatei für private Agents geändert werden.

  • Retry on Recoverable Exception: Diese Einstellung ist nur funktionsfähig, wenn Sie eine Umgebung verwenden, die mit einer privaten Agentengruppe verbunden ist, deren Agents Version 10.24 oder höher sind. Ihr Verhalten hängt von der Version des privaten Agents ab. Wenn ausgewählt, wird diese Einstellung verwendet, um eine abgelehnte Anfrage an NetSuite erneut zu versuchen, wenn eines dieser Kriterien erfüllt ist:

    • Private Agents 10.24 und später: Das Governance-Limit von NetSuite für gleichzeitige Anfragen ist erreicht und der Fehler WS_REQUEST_BLOCKED wird zurückgegeben.

    • Private Agents 10.36 und später: NetSuite gibt innerhalb des erwarteten Zeitrahmens keine Antwort zurück und es tritt eine Timeout-Ausnahme auf.

    Um die Gleichzeitigkeitslimits Ihres NetSuite-Kontos zu überprüfen, gehen Sie in der NetSuite-Benutzeroberfläche zu Setup > Integration > Integration Governance. Weitere Informationen finden Sie in der NetSuite-Dokumentation zu Gleichzeitigkeits-Governance-Limits basierend auf Dienstebenen und SuiteCloud Plus-Lizenzen.

    Damit diese Einstellung wirksam wird, darf die Jitterbit-Variable jitterbit.netsuite.async nicht upstream der Operation auf true gesetzt sein.

    Bei privaten Agents der Version 10.23 oder früher, auf Cloud-Agents oder wenn die Jitterbit-asynchrone Variable aktiviert ist, wird diese Einstellung ignoriert.

    Wählen Sie das Kontrollkästchen Wiederholen bei wiederherstellbarer Ausnahme aus, um zusätzliche Konfigurationsoptionen zu erweitern.

    • Maximale Anzahl der Wiederholungen: Geben Sie die Anzahl der Male an (maximal 5 Wiederholungen), die eine abgelehnte Anfrage an NetSuite erneut gesendet wird. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungen weiterhin abgelehnt wird, wird eine Ausnahme mit einer Fehlermeldung im Betriebsprotokoll zurückgegeben. Darüber hinaus protokolliert der private Agent jede Wiederholung in der Protokolldatei jitterbit-agent.log.

      Jede Wiederholung wird als Teil des gleichen Betriebsdurchlaufs behandelt, bei dem nur ein einzelner Datensatz im Betriebsprotokoll erscheint. Alle Betriebsaktionen, die konfiguriert sind, um nachgelagerte Operationen auszuführen, werden basierend auf dem Endstatus der Operation nach dem Wiederholen bis zur maximalen Anzahl von Wiederholungen ausgelöst.

    • Wiederholungsintervall (Sekunden): Geben Sie die Anzahl der Sekunden (maximal 5 Sekunden) an, die zwischen dem erneuten Senden einer abgelehnten Anfrage an NetSuite gewartet werden soll.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

  • NetSuite-Paginierung aktivieren: Wählen Sie diese Option, um die Unterstützung für NetSuite-Datensatztypen mit über 1.000 benutzerdefinierten Feldern zu aktivieren. Diese Option erfordert Agenten der Version 11.52 oder höher.

    -   **NetSuite-Paginierungsgrenze:** Geben Sie die Anzahl der zu unterstützenden benutzerdefinierten Felder ein, bis zu einem Maximum von `2000`. Der Standardwert beträgt `1000`.

  • Test: Klicken Sie, um die Verbindung mit den bereitgestellten Anmeldeinformationen zu überprüfen.

    Vorsicht

    Wenn Sie beim Testen der Verbindung einen Fehler bezüglich des Rechenzentrums erhalten, müssen Sie möglicherweise eine andere WSDL-URL verwenden. Weitere Informationen finden Sie unter NetSuite-Rechenzentrumsfehler.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Designkomponenten-Palette zugänglich. Weitere Details finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Nachdem Sie eine NetSuite-Verbindung konfiguriert haben, können Sie eine oder mehrere NetSuite-Aktivitäten konfigurieren, die mit dieser Verbindung verknüpft sind, um sie entweder als Quelle zur Bereitstellung von Daten für eine Operation oder als Ziel zur Verwendung von Daten in einer Operation zu nutzen, oder Sie können die NetSuite-Verbindung innerhalb eines Skripts verwenden.

Aktivitäten konfigurieren

Diese Aktivitätstypen sind verfügbar:

  • Suchen: Ruft vorhandene Datensätze aus NetSuite ab und ist als Quelle gedacht, um Daten in einer Operation bereitzustellen.

  • Erstellen: Erstellt neue Datensätze in NetSuite und ist als Ziel in einer Operation gedacht.

  • Aktualisieren: Aktualisiert vorhandene Datensätze in NetSuite und ist als Ziel in einer Operation gedacht.

  • Liste abrufen: Ruft eine Liste vorhandener Datensätze basierend auf der ID aus NetSuite ab und ist als Ziel in einer Operation gedacht.

  • Upsert: Aktualisiert sowohl vorhandene Datensätze als auch erstellt neue Datensätze in NetSuite und ist als Ziel in einer Operation gedacht.

  • Löschen: Löscht Datensätze in NetSuite und ist als Ziel in einer Operation gedacht.

Verwenden Sie NetSuite-Verbindungen in Skripten

NetSuite-Verbindungen können in einem Skript unter Verwendung von Skriptfunktionen referenziert werden, die ein netSuiteOrg als Parameter verwenden. Weitere Informationen finden Sie unter Verwenden von NetSuite-Funktionen.