NetSuite-Verbindung

Einführung

Eine NetSuite-Verbindung, die mit dem NetSuite-Connector erstellt wurde, stellt den Zugriff auf NetSuite her. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von NetSuite-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Hinweis

Dieser Connector unterstützt die Organisationsrichtlinie Erneute Authentifizierung bei Änderung aktivieren. Wenn aktiviert, müssen Benutzer bei einer Änderung des Kontos, Consumer Key oder Token Key in dieser Verbindung 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 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

Jedes Benutzeroberflächenelement des NetSuite Verbindungskonfigurationsbildschirms wird unten beschrieben.

Tipp

Felder mit einem Unterstützung variabler Symbole durch globale Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

• Verbindungsname: 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-Schlüssel und Consumer-Geheimnis: Geben Sie die NetSuite Werte Consumer-Schlüssel und Consumer-Geheimnis 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 Token-ID und Token-Geheimnis ein. Anweisungen zum Abrufen dieser Werte finden Sie unter Werte für die Verwendung von NetSuite NetSuite erfassen.

  Vorsicht

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

• Signaturalgorithmus: Der Signaturalgorithmus HMAC-SHA256 wird zum Signieren der Anfrage verwendet und kann nicht geändert werden. 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 sind. 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:

  

  • Maximale Anzahl von Wiederholungsversuchen: 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.

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

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

  Vorsicht

  Wenn beim Testen der Verbindung ein Fehler bezüglich des Rechenzentrums auftritt, 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

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.

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

Diese Aktivitätstypen sind verfügbar:

• Suchen: Ruft vorhandene Datensätze von NetSuite ab und soll als Quelle zum Bereitstellen von Daten in einem Operation verwendet werden.

• Erstellen: Erstellt neue Datensätze in NetSuite und soll als Ziel in einer Operation verwendet werden.

• Aktualisieren: Aktualisiert vorhandene Datensätze in NetSuite und soll als Ziel in einer Operation verwendet werden.

• Liste abrufen: Ruft eine Liste vorhandener Datensätze basierend auf der ID von NetSuite ab und soll als Ziel in einem Operation verwendet werden.

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

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

NetSuite Verbindungen in Scripts verwenden

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