NetSuite Connector Endpoint im Jitterbit Design Studio

Einführung

Bevor Sie mit dem NetSuite Connector NetSuite-Operationen in Jitterbit erstellen können, müssen Sie mindestens einen NetSuite Endpoint konfigurieren.

Jeder Endpoint stellt die URL und die Anmeldeinformationen für ein bestimmtes NetSuite-Konto dar. Durch das Erstellen des Endpoint kann Jitterbit auf das Konto zugreifen, um die angeforderten Vorgänge auszuführen. Wenn Ihre Organisation mehrere NetSuite-Konten verwendet, müssen Sie für jedes Konto einen Endpoint erstellen.

Weitere Möglichkeiten zum Herstellen einer Verbindung mit NetSuite mithilfe von Jitterbit Studio sind der Aufruf eines RESTlets, die Verwendung einer Webdienstmethode oder die Verwendung des Oracle NetSuite JDBC- Treiber:

• Rufen Sie ein RESTlet aus einer lokalen Dateiquelle auf
• Aufrufen eines RESTlets von einer HTTP-Quelle oder einem HTTP-Ziel
• Mithilfe einer Webdienstmethode
• Verwenden des Oracle NetSuite JDBC- Treiber mit einer Datenbankquelle oder einem Datenbankziel

Voraussetzungen

Um den Jitterbit NetSuite Connector für NetSuite-Integrationen erfolgreich zu verwenden, müssen diese Kriterien erfüllt sein:

• Jitterbit hat Unterstützung für bis zu NetSuite WSDL Version 2023.2 nachgewiesen. NetSuite unterstützt jederzeit die sechs neuesten Versionen ihrer WSDL. Daher empfehlen wir, dass die NetSuite Instanz eine dieser WSDL-Versionen verwendet:

  • 2024.2
  • 2024.1
  • 2023.2
  • 2023.1
  • 2022.2
  • 2022.1

  Jitterbit hat die vorherige Unterstützung für ältere verfügbare WSDL-Versionen 2017.1 bis 2021.2 überprüft, die nicht mehr von NetSuite unterstützt werden. Ältere WSDL-Versionen sind in der offiziellen NetSuite-Dokumentation aufgeführt. Auch wenn diese Versionen technisch weiterhin verfügbar sind, wird von der Verwendung von WSDLs, die älter als ein Jahr sind, abgeraten. Wir empfehlen dringend, auf eine unterstützte WSDL-Version zu aktualisieren.

• Die WSDL URL muss im Format einer kontospezifischen WSDL URL angegeben werden. Anweisungen zum Abrufen der WSDL- URL finden Sie unter NetSuite -kontospezifische WSDL- URL.

• NetSuite WSDL 2021.2, 2022.1, 2022.2, 2023.1, 2023.2, 2024.1 und 2024.2 erfordern Harmony Cloud oder private Agenten Version 10.33 oder höher.
• NetSuite WSDL 2020.2 und 2021.1 erfordern Harmony Cloud oder private Agenten Version 10.26 oder höher.
• NetSuite WSDL 2020.1 erfordert Harmony Cloud oder private Agenten Version 10.18 oder höher.
• NetSuite WSDL 2019.1 und 2019.2 erfordern Harmony Cloud oder private Agenten Version 10.4 oder höher.
• NetSuite WSDLs bis 2018.2 erfordern Harmony Cloud oder private Agenten Version 9.9 oder höher.

• So verwenden Sie die tokenbasierte Authentifizierung (TBA):

  • Sie müssen SuiteTalk Version 2015.2 oder höher verwenden.

  • Sie müssen TBA für Ihr NetSuite-Konto aktiviert haben.

  • Um einen neuen TBA- Endpoint zu konfigurieren, müssen Sie Jitterbit Design Studio und Agent Version 9.2 oder höher verwenden.

  • Um einen vorhandenen SSO- Endpoint für die Verwendung von TBA zu konvertieren, müssen Sie Jitterbit Design Studio Version 9.3.1 oder höher und Agents Version 9.2 oder höher verwenden.

• NetSuite - SuiteTalk (Webdienste) Integration
• NetSuite - Verwalten von Benutzern und Rollen
• NetSuite - Erste Schritte mit tokenbasierter Authentifizierung

Erstellen eines Endpoint

Innerhalb Ihres Projekts in Jitterbit Studio gibt es mehrere Möglichkeiten, einen neuen NetSuite Endpoint zu starten:

• Gehen Sie zu Datei > Neu > Konnektoren > Neuer NetSuite Endpoint.
• Klicken Sie im Baum links unter Konnektoren mit der rechten Maustaste auf die Kategorie NetSuite und wählen Sie dann Neuer NetSuite Endpoint.
• Doppelklicken Sie im Baum links unter Connectors auf die Kategorie NetSuite, klicken Sie dann mit der rechten Maustaste auf New NetSuite Endpoint und wählen Sie New NetSuite Endpoint.
• Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup NetSuite und dann NetSuite Endpoint aus.

Authentifizierungstyp auswählen

Wählen Sie im ersten Bildschirm des NetSuite Endpoint aus, wie sich Jitterbit mit Ihrer NetSuite-Instanz authentifizieren soll. Verwenden Sie dazu die im nächsten Bildschirm bereitgestellten Anmeldeinformationen. Jede Option wird unten erläutert.

• SSO: SSO (Single Sign-on) ist die traditionelle Methode, die von Jitterbit zur Authentifizierung bei NetSuite verwendet wird und in allen Harmony-Versionen verfügbar ist, in denen der NetSuite Connector ist verfügbar. Der SSO-Authentifizierungstyp wurde von NetSuite als veraltet markiert und wird mit NetSuite WSDL-Versionen 2020.1 und höher nicht mehr unterstützt. Es wird jetzt allen Benutzern empfohlen, TBA zu verwenden.

  Vorsicht

  Bei der SSO-Authentifizierungsart können bei Jitterbit-Benutzern, deren NetSuite Abonnement auf einen einzigen Verarbeitungsthread beschränkt ist, Durchsatzprobleme auftreten. Diese Benutzer sollten TBA verwenden. NetSuite Benutzer mit einer SuiteCloud Plus-Lizenz können beide Authentifizierungsarten verwenden, da diese Lizenzart eine größere Parallelität von Threads ermöglicht.

  Warnung

  Wer die NetSuite Zwei-Faktor-Authentifizierung (TFA oder 2FA) verwendet, sollte nicht den SSO-Authentifizierungstyp verwenden. Dies kann dazu führen, dass Ihr NetSuite Endpoint fehlschlägt. Verwenden Sie stattdessen TBA.

• TBA: TBA (Token-Based Authentication) ist für Benutzer von Jitterbit Design Studio und Agent Version 9.2 verfügbar und höher. In Jitterbit erleichtert die Verwendung von TBA die Verwendung mehrerer Verarbeitungsthreads und löst dadurch Durchsatzprobleme, die bei NetSuite-Benutzern auftreten können, die durch ihr NetSuite-Abonnement eingeschränkt sind.

  Notiz

  Wer die NetSuite Zwei-Faktor-Authentifizierung (TFA oder 2FA) in NetSuite verwendet, muss TBA mit Harmony verwenden. Weitere Informationen finden Sie unter Tokenbasierte Authentifizierung für NetSuite 2018.2.

Anmeldeinformationen eingeben

Klicken Sie auf Weiter, um fortzufahren. Die nächsten Bildschirme hängen davon ab, ob Sie SSO oder TBA ausgewählt haben.

SSO

Geben Sie die SSO-Anmeldeinformationen für Ihren neuen NetSuite Endpoint ein. Unten finden Sie ein Beispiel. Jede konfigurierbare Option wird wie folgt erklärt.

• Name: Geben Sie einen passenden Namen für Ihren neuen NetSuite - Endpoint ein. Wenn Sie Endpoints für mehrere NetSuite-Konten erstellen, ist es eine gute Idee, sie hier anhand des Namens zu unterscheiden.

• Konto: Geben Sie die NetSuite-Konto-ID ein, die Ihrem NetSuite-Konto zugeordnet ist.

  Notiz

  Wenn Sie die Sandbox Umfeld von NetSuite verwenden, wird dies jetzt durch die NetSuite-Konto-ID angezeigt. Beispielsweise kann die Konto-ID mit _SB1, _SB2 usw. angehängt werden.

  Da NetSuite keine separate Sandbox-URL mehr verwendet und die Sandbox jetzt durch die Konto-ID angezeigt wird, wurde das Sandbox-Kontrollkästchen in Design Studio Versionen 9.2 entfernt und später.

  Weitere Informationen finden Sie in der NetSuite-Dokumentation Über Sandbox-Konten in der NetSuite Domäne.

• Email: Geben Sie die Email-Adresse ein, die Sie zum Anmelden bei Ihrem NetSuite-Konto verwenden.

• Kundencenter-Rolle: Aktivieren Sie dieses Kontrollkästchen, wenn Sie die NetSuite Kundencenter-Rolle zur Steuerung der Berechtigungen verwenden.

• Passwort: Geben Sie das Passwort ein, das Sie für die Anmeldung bei Ihrem NetSuite-Konto verwenden.

• WSDL-Download-URL: Geben Sie die kontospezifische URL der von der NetSuite Instanz verwendeten NetSuite-WSDL ein. Jitterbit unterstützt die unter Voraussetzungen aufgeführten WSDL-Versionen weiter oben auf dieser Seite. Anweisungen zum Abrufen der kontospezifischen WSDL- URL finden Sie unter NetSuite-kontospezifische WSDL-URL.

• Anwendungs-ID: Geben Sie optional Ihre Anwendungs-ID ein, wenn Sie eine von NetSuite erhalten haben. Wenn nicht, lassen Sie dieses Feld leer.

  Tipp

  Um eine neue Anwendungs-ID für Jitterbit zu generieren oder eine bereits vorhandene zu finden, siehe Abrufen einer NetSuite Anwendungs-ID.

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

  Notiz

  Die Standard-Agenteneinstellung für das Timeout von NetSuite-Anrufen beträgt 300 Sekunden.

Wird bekannt gegeben

Um die für diesen Bildschirm benötigten Werte zu erhalten, müssen Sie TBA für Ihr NetSuite-Konto aktiviert haben. Nachdem Sie TBA in NetSuite konfiguriert haben, geben Sie die TBA-Anmeldeinformationen für Ihren neuen NetSuite Endpoint ein. Ein Beispiel finden Sie weiter unten. Jede konfigurierbare Option wird wie folgt erklärt.

• Name: Geben Sie einen passenden Namen für Ihren neuen NetSuite Endpoint ein. Wenn Sie Endpoints für mehrere NetSuite-Konten erstellen, ist es eine gute Idee, sie hier anhand des Namens zu unterscheiden.

• Konto: Geben Sie die NetSuite-Konto-ID ein, die Ihrem NetSuite-Konto zugeordnet ist.

  Notiz

  Wenn Sie die Sandbox Umfeld von NetSuite verwenden, wird dies jetzt durch die NetSuite-Konto-ID angezeigt. Beispielsweise kann die Konto-ID mit _SB1, _SB2 usw. angehängt werden.

  Da NetSuite keine separate Sandbox-URL mehr verwendet und die Sandbox jetzt durch die Konto-ID angezeigt wird, wurde das Sandbox-Kontrollkästchen in Design Studio Versionen 9.2 entfernt und später.

  Weitere Informationen finden Sie in der NetSuite-Dokumentation Über Sandbox-Konten in der NetSuite Domäne.

• WSDL-Download-URL: Geben Sie die kontospezifische URL der von der NetSuite Instanz verwendeten NetSuite-WSDL ein. Jitterbit unterstützt die unter Voraussetzungen aufgeführten WSDL-Versionen weiter oben auf dieser Seite. Anweisungen zum Abrufen der kontospezifischen WSDL- URL finden Sie unter NetSuite-kontospezifische WSDL-URL.

• Consumer Key und Consumer Secret: Geben Sie die von NetSuite erhaltenen NetSuite Consumer Key- und Consumer Secret-Werte ein. Anweisungen zum Abrufen dieser Werte finden Sie unter TBA in NetSuite aktivieren.

• Token Key und Token Secret: Geben Sie die von NetSuite erhaltenen NetSuite Token ID- und Token Secret-Werte ein. Anweisungen zum Abrufen dieser Werte finden Sie unter TBA in NetSuite aktivieren.

  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 des NetSuite Endpoint angeben.

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

  Notiz

  Die Standard-Agenteneinstellung für das Timeout von NetSuite-Anrufen beträgt 300 Sekunden.

• Bei behebbarer Ausnahme erneut versuchen (in den Versionen 10.36 und 10.37 als Wiederholoption aktivieren gekennzeichnet): Diese Option ist in Design Studio Versionen 10.36 und höher vorhanden und 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 aktivieren:

  

  • Maximale Anzahl von Wiederholungsversuchen (in den Versionen 10.36 und 10.37 als Maximale Wiederholung gekennzeichnet): 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 zum Ausführen nachlegende Vorgänge konfigurierten Bedingungen Bei Erfolg oder Bei Fehler werden basierend auf dem Endstatus des Operation nach der maximalen Anzahl von Wiederholungsversuchen ausgelöst.

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

Anmeldeinformationen überprüfen (SSO)

Nur für den SSO-Authentifizierungstyp: Wenn Sie auf Fertig klicken, überprüft Jitterbit die angegebenen Anmeldeinformationen.

• Wenn dies erfolgreich ist, wird Ihr neuer NetSuite Endpoint erstellt. Der Endpoint wird in der Hauptansicht von Studio geöffnet. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie im Baum links unter Connectors > NetSuite > NetSuite Endpoints auf den Endpoint doppelklicken.
• Wenn dies nicht erfolgreich ist, wird eine Meldung angezeigt, die auf ein Problem mit den Anmeldeinformationen hinweist. Sie können den Endpoint dennoch erstellen und die Anmeldeinformationen später ändern.

Bearbeiten oder Testen eines Endpoint

Nachdem Ihr Endpoint erstellt wurde, können Sie jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie im Baum links unter Connectors > NetSuite > NetSuite Endpoints auf den Endpoint doppelklicken.

SSO

Für den SSO-Authentifizierungstyp sieht der Konfigurationsbildschirm ungefähr so aus wie unten.

• Name: Benennen Sie Ihren vorhandenen NetSuite Endpoint um. Wenn Sie Endpoints für mehrere NetSuite-Konten erstellen, ist es eine gute Idee, sie hier anhand des Namens zu unterscheiden.

• Passport: Dieser Abschnitt enthält die Informationen, die beim Erstellen des Endpoint eingegeben wurden. Das Konto und die Email sind hier aufgeführt. Sie können hier auch die Felder Wsdl-Download-URL und die optionalen Felder Anwendungs-ID und Anruf-Timeout bearbeiten. Diese Felder sind dieselben wie die oben auf dieser Seite beschriebenen.

• In TBA konvertieren: Diese Option ist in Design Studio Version 9.3.1 verfügbar und höher.

  Klicken Sie auf die Schaltfläche In TBA konvertieren, um ein Popup-Fenster zu öffnen, in dem Sie Anmeldeinformationen zum Ändern des Authentifizierungstyps von SSO in TBA eingeben können. Der für jedes Feld verwendete Wert ist weiter oben auf dieser Seite unter Anmeldeinformationen eingeben dokumentiert im TBA Abschnitt.

  

• Anmeldeinformationen bearbeiten: Klicken Sie auf die Schaltfläche Anmeldeinformationen bearbeiten, um die Einstellungen für Konto, Email, Passwort oder Kundencenter-Rolle zu bearbeiten. Diese Optionen sind dieselben wie die oben auf dieser Seite beschriebenen.

• Verbindung testen: Klicken Sie auf die Schaltfläche Verbindung testen, um die Verbindung zu Ihrem NetSuite-Konto zu überprüfen. Eine Meldung zeigt an, ob die Verbindung erfolgreich war. Wenn die Verbindung nicht erfolgreich ist, stellen Sie sicher, dass Sie die Voraussetzungen erfüllen und überprüfen Sie die Werte, die Sie auf diesem Bildschirm angegeben haben. Wenn beim Testen der Verbindung eine Fehlermeldung angezeigt wird, lesen Sie Informationen zur Fehlerbehebung.

Wird bekannt gegeben

Für den TBA-Authentifizierungstyp sieht die Konfiguration ungefähr wie folgt aus.

• Name: Benennen Sie Ihren vorhandenen NetSuite Endpoint um. Wenn Sie Endpoints für mehrere NetSuite-Konten erstellen, ist es eine gute Idee, sie hier anhand des Namens zu unterscheiden.
• TBA Passport: Dieser Abschnitt enthält die Informationen, die beim Erstellen des Endpoint eingegeben wurden. Sie können alle in der ursprünglichen Konfiguration verfügbaren Felder bearbeiten, wie oben auf dieser Seite beschrieben.
• Verbindung testen: Klicken Sie auf die Schaltfläche Verbindung testen, um die Verbindung zu Ihrem NetSuite-Konto zu überprüfen. Eine Meldung zeigt an, ob die Verbindung erfolgreich war. Wenn die Verbindung nicht erfolgreich ist, stellen Sie sicher, dass Sie die Voraussetzungen erfüllen und überprüfen Sie die Werte, die Sie auf diesem Bildschirm angegeben haben. Wenn beim Testen der Verbindung eine Fehlermeldung angezeigt wird, lesen Sie Informationen zur Fehlerbehebung.