Voraussetzungen für den NetSuite-Connector im Jitterbit Integration Studio

Einführung

Bestimmte Voraussetzungen müssen erfüllt sein, um den NetSuite-Connector zu verwenden, wie unten detailliert beschrieben.

Voraussetzungen

Um einen NetSuite-Endpunkt zu konfigurieren und zu verwenden, müssen diese Voraussetzungen erfüllt sein:

• Eine Agenten-Version 11.30 oder höher wird empfohlen.

  Hinweis

  Es gibt Probleme bei der Verwendung des CustomRecord-Objekts in einer NetSuite Suche mit früheren Agenten-Versionen. Weitere Einzelheiten finden Sie in den 11.26 und 11.30 Versionshinweisen.

• Die tokenbasierte Authentifizierung (TBA) muss im NetSuite-Konto aktiviert sein, wobei die entsprechende Berechtigungsrolle verwendet wird, um Harmony den Zugriff auf die NetSuite-Instanz zu ermöglichen. Anleitungen zur Aktivierung von TBA finden Sie unter TBA in NetSuite aktivieren.

• Ein NetSuite-Integrationsdatensatz muss für Jitterbit erstellt werden. Jitterbit stellt ein Bundle zur Verfügung, um den Integrationsdatensatz zu erstellen. Um das Bundle zu installieren, folgen Sie den in der NetSuite-Dokumentation beschriebenen Schritten. Suchen Sie nach dem Bundle mit dem Namen Jitterbit BFN Integrations - CRM oder der ID 454951.

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

  • 2025.2
  • 2025.1
  • 2024.2
  • 2024.1
  • 2023.2
  • 2023.1

  Jitterbit hat die vorherige Unterstützung für ältere WSDL-Versionen, die nicht mehr von NetSuite unterstützt werden, verifiziert. Legacy WSDL-Versionen sind in der offiziellen NetSuite-Dokumentation aufgeführt. Obwohl diese Versionen technisch weiterhin verfügbar sind, wird die Verwendung von WSDLs, die älter als ein Jahr sind, als nicht empfehlenswert angesehen, und wir empfehlen dringend, auf eine unterstützte WSDL-Version zu aktualisieren.

  Hinweis

  Beim Aktualisieren der WSDL in der NetSuite-Verbindung ist zu beachten, dass das bloße Ändern der URL dazu führt, dass alle Operationen, die die Aktivitäten des Connectors verwenden, zur Laufzeit fehlschlagen, da die Transformationen weiterhin die alte WSDL verwenden. Um korrekt zu aktualisieren, folgen Sie den in Ändern der WSDL-Version beschriebenen Schritten.

• Die WSDL-URL muss im Format einer kontospezifischen WSDL-URL bereitgestellt werden. Anweisungen zum Abrufen der WSDL-URL finden Sie in Verwenden einer NetSuite-kontospezifischen WSDL-URL.

• NetSuite WSDL-Versionen 2021.2 bis 2025.2 erfordern Harmony-Cloud- oder private Agenten in der Version 10.33 oder höher.
• NetSuite WSDL 2020.2 und 2021.1 erfordern Harmony-Cloud- oder private Agenten in der Version 10.26 oder höher.
• NetSuite WSDL 2020.1 erfordert Harmony-Cloud- oder private Agenten in der Version 10.18 oder höher.
• NetSuite WSDL 2019.1 und 2019.2 erfordern Harmony-Cloud- oder private Agenten in der Version 10.4 oder höher.
• NetSuite WSDLs bis 2018.2 erfordern Harmony-Cloud- oder private Agenten in der Version 9.9 oder höher.

Optional: Antwortschema-Felder auf gespeicherte Suchspalten beschränken

Um die Antwortschema-Felder einer NetSuite-Suchaktivität auf die Spalten einer gespeicherten Suche zu beschränken, ist ein Suitelet-Skript zum Abrufen von Metadaten erforderlich. Ein gültiges Suitelet-Skript steht zum Download auf der Harmony Downloads Seite zur Verfügung, aufgeführt unter Connectors.

/**
 * @author Jitterbit
 * @version 1.0.0.0
 * @NApiVersion 2.x
 * @NScriptType Suitelet
 * This Suitelet loads a saved search by its internal ID and returns the search columns.
 */

Das Suitelet-Skript muss hochgeladen und bereitgestellt werden, damit die Ausführungs-URL für den Connector zugänglich ist:

1. Navigieren Sie im NetSuite-Portal zu Anpassung > Scripting > Skripte > Neu, um die Seite Skriptdatei hochladen zu öffnen:

   

2. Fahren Sie mit der Maus über das Dropdown-Menü Skriptdatei und klicken Sie auf das neue Symbol +, um den Dialog Datei zu öffnen:

   

   Geben Sie die folgenden Informationen an:

   

   1. Von anhängen: Wählen Sie Computer, falls nicht standardmäßig ausgewählt.
   2. Ordner: Wählen Sie SuiteScripts, falls nicht standardmäßig ausgewählt.
   3. Datei auswählen: Wählen Sie das Suitelet-Skript, das von der Harmony Downloads Seite erhalten wurde, unter Connectors aufgelistet.
   4. Klicken Sie auf Speichern, um zur Seite Skriptdatei hochladen zurückzukehren.

3. Wählen Sie das neu hochgeladene Skript aus, klicken Sie auf Skriptaufzeichnung erstellen und klicken Sie auf Suitelet, wenn Sie dazu aufgefordert werden, um die Seite Skript zu öffnen. Geben Sie die folgenden Informationen an:

   

   1. Geben Sie einen Namen für den Datensatz im Feld Name ein. Obwohl die Benutzeroberfläche Benutzerdefinierte Plug-In-Typen als erforderlich markiert, kann dies ignoriert werden.
   2. Navigieren Sie zur Registerkarte Bereitstellungen des Datensatzes. Geben Sie einen Titel im Feld Titel ein und setzen Sie das Feld Status auf Veröffentlicht.
   3. Klicken Sie auf Hinzufügen und klicken Sie auf Speichern.

4. Klicken Sie auf Skript bereitstellen, um die Seite Skriptbereitstellung zu öffnen. Geben Sie die folgenden Informationen an:

   

   1. Wählen Sie alle internen Rollen aus, die für den Zugriff auf die gespeicherte Suche erforderlich sind, unter Zielgruppe > Interne Rollen.
   2. Setzen Sie das Feld Status auf Veröffentlicht.
   3. Klicken Sie auf Speichern.

5. Klicken Sie mit der rechten Maustaste und kopieren Sie die URL, die jetzt auf der Seite Skriptbereitstellung sichtbar ist:

   

Um die Ausführungs-URL zu vervollständigen, die Sie mit einer NetSuite-Suchaktivität verwenden werden, fügen Sie &searchid={{YourSavedSearchId}} an die kopierte URL an. {{YourSavedSearchId}} ist die ID der gespeicherten Suche, auf die Sie die Antwortschema-Felder beschränken möchten.

Zum Beispiel sieht eine gültige Ausführungs-URL so aus: https://account123.app.netsuite.com/app/site/hosting/scriptlet.nl?script=123&deploy=2&searchid=456789, wenn Sie eine gespeicherte Suche mit der ID 456789 auf einer Instanz verwenden, die unter https://account123.app.netsuite.com gehostet wird.