NetSuite Verbindung

Einführung

Eine NetSuite-Verbindung wird mithilfe des NetSuite-Connectors konfiguriert, der den Zugriff auf den NetSuite Endpoint ermöglicht. Sobald eine Verbindung hergestellt ist, können Sie eine oder mehrere mit dieser Verbindung verknüpfte NetSuite-Aktivitäten konfigurieren, die entweder als Quelle zur Bereitstellung von Daten für einen Operation oder als Ziel zur Nutzung von Daten in einem Operation verwendet werden können. Darüber hinaus kann die NetSuite-Verbindung in Scripts verwendet werden.

Erstellen oder Bearbeiten einer NetSuite-Verbindung

Eine neue NetSuite Verbindung wird mithilfe des NetSuite-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 bestehende NetSuite-Verbindung kann von diesen Orten aus bearbeitet werden:

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

Konfigurieren einer NetSuite-Verbindung

Die Konfiguration einer NetSuite-Verbindung umfasst diese Felder:

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

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

• WSDL-Download-URL: Geben Sie die kontospezifische URL der 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 unter Verwenden einer kontospezifischen NetSuite-WSDL- URL.

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

  • Verbraucherschlüssel: 768b136f26ea98b957e7dd2e87bad89077ca2ec484a0cb72c5a8e1b003627213
  • Verbrauchergeheimnis: 0dbf3d5e3c2d2ff72ef1a8e8d564d5786da2f60006ad97a00246d7ce924c8b51

  Wenn Sie den Integrationsdatensatz auf andere Weise erstellt haben, befolgen Sie die Schritte unter Werte für die Verwendung von NetSuite TBA sammeln, um die zu verwendenden Werte zu erhalten.

• Token-Schlüssel und Token-Geheimnis: Geben Sie die von NetSuite erhaltenen Werte für die NetSuite-Token-ID und das Token-Geheimnis ein. Anweisungen zum Abrufen dieser Werte finden Sie unter Werte für die Verwendung von NetSuite TBA erfassen.

  Vorsicht

  Wenn Sie ein NetSuite Sandbox-Konto verwenden, müssen Sie bei jeder Aktualisierung der Sandbox neue Token erstellen.

• Signaturalgorithmus: Verwenden Sie das Dropdown-Menü, um den Signaturalgorithmus auszuwählen, der zum Signieren der Anfrage verwendet werden soll, entweder HMAC-SHA1 oder HMAC-SHA256. Der Signaturalgorithmus bestimmt, wie die Payload verschlüsselt wird.

  Notiz

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

  • Nicht-Produktionskonten: NetSuite Version 2021.2 und höher.
  • Produktionskonten: NetSuite Version 2023.1 und höher.

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

• Anruf-Timeout: Geben Sie den Anruf-Timeout-Wert in Sekunden ein, wenn der Timeout-Wert niedriger sein soll als die Standard-Agenteneinstellung.

  Notiz

  Die Standardeinstellung des Agenten für das Timeout von NetSuite-Anrufen beträgt 300 Sekunden. Für private Agenten kann dieser Standardwert im [Connectorsinfo] Abschnitt der privaten Agentenkonfigurationsdatei.

• Bei behebbarer Ausnahme erneut versuchen: Diese Einstellung funktioniert nur, wenn eine Umfeld verwendet wird, die mit einer privaten Agentengruppe verknüpft ist, deren Agenten Version 10.24 oder höher aufweisen. Ihr Verhalten hängt von der privaten Agentenversion ab. Wenn diese Einstellung ausgewählt ist, wird sie verwendet, um eine abgelehnte Anfrage an NetSuite erneut zu versuchen, wenn eines dieser Kriterien erfüllt ist:

  • Private Agenten 10.24 und höher: Das Governance Limit von NetSuite für gleichzeitige Anfragen ist erreicht und der Fehler WS_REQUEST_BLOCKED wird zurückgegeben.
  • Private Agenten 10.36 und höher: NetSuite gibt im erwarteten Zeitrahmen keine Antwort zurück und es tritt eine Timeout-Ausnahme auf.

  Um die Parallelitätslimits 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 Grenzwerte für Parallelitäts-Governance basierend auf Service-Stufen und SuiteCloud Plus-Lizenzen.

  Damit diese Einstellung wirksam wird, muss die Variable Jitterbit jitterbit.netsuite.async darf nicht gesetzt werden auf true davorlegende der Operation.

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

  Aktivieren Sie das Kontrollkästchen Bei behebbarer Ausnahme erneut versuchen, um zusätzliche Konfigurationsoptionen zu erweitern:

  

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

  • Maximale Wiederholungsversuche: Geben Sie die Anzahl der Versuche ein (maximal 5 Wiederholungsversuche), die eine abgelehnte Anfrage erneut an NetSuite gesendet wird. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungsversuchen immer noch abgelehnt wird, wird eine Ausnahme mit einer Fehlermeldung im Operation zurückgegeben. Darüber hinaus protokolliert der private Agent jeden Wiederholungsversuch im jitterbit-agent.log Protokolldatei.

    Jeder Wiederholungsversuch wird als Teil desselben Operation behandelt, wobei nur ein einziger Datensatz im Operation erscheint. Alle Operation, die zum Ausführen nachlegende Vorgänge konfiguriert sind, werden basierend auf dem Endstatus des Operation nach wiederholten Versuchen bis zur maximalen Anzahl an Wiederholungsversuchen ausgelöst.

• Test: Klicken Sie hier, 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 hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen 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 in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine NetSuite-Verbindung erstellt wurde, sind Menüaktionen für diese Verbindung über die Tab Komponenten des Projektbereichs zugänglich. Siehe Aktionsmenü Verbindungsaktionen für weitere Einzelheiten.

Nachdem Sie eine NetSuite-Verbindung konfiguriert haben, können Sie eine oder mehrere mit dieser Verbindung verknüpfte NetSuite-Aktivitäten so konfigurieren, dass sie entweder als Quelle zum Bereitstellen von Daten für einen Operation oder als Ziel zum Verbrauchen von Daten in einem Operation verwendet werden. Alternativ können Sie die NetSuite-Verbindung in einem Script verwenden.

Konfigurieren von Aktivitäten

NetSuite-Aktivitäten interagieren mit der NetSuite-Verbindung, um als Quellen (Bereitstellung von Daten innerhalb einer Operation) oder Ziele (Empfang von Daten innerhalb einer Operation) zu fungieren.

Nachdem Sie eine NetSuite-Verbindung konfiguriert haben, filtern Sie mithilfe der Dropdown-Liste Anzeigen nach Endpoints und klicken Sie dann auf den NetSuite-Verbindungsblock, um Aktivitäten anzuzeigen, die für die Verwendung mit einer NetSuite-Verbindung verfügbar sind:

Weitere Informationen finden Sie in diesen Aktivitäten:

• Suchen: Ruft vorhandene Datensätze von einem NetSuite Endpoint ab und soll als Quelle in einem Operation verwendet werden.
• Erstellen: Erstellt neue Datensätze in einem NetSuite Endpoint und soll als Ziel in einem Operation verwendet werden.
• Aktualisieren: Aktualisiert vorhandene Datensätze in einem NetSuite Endpoint und soll als Ziel in einem Operation verwendet werden.
• Liste abrufen: Ruft eine Liste vorhandener Datensätze basierend auf der ID von einem NetSuite Endpoint ab und soll als Ziel in einer Operation verwendet werden.
• Upsert: Aktualisiert sowohl vorhandene Datensätze als auch erstellt neue Datensätze in einem NetSuite Endpoint und ist zur Verwendung als Ziel in einer Operation vorgesehen.
• Löschen: Löscht Datensätze in einem NetSuite Endpoint und ist zur Verwendung als Ziel in einer Operation vorgesehen.

Verwenden von NetSuite Verbindungen in Scripts

Auf NetSuite Verbindungen kann in einem Script mithilfe von Script verwiesen werden, die eine netSuiteOrg als Parameter. Weitere Informationen finden Sie unter Verwenden von NetSuite-Funktionen.