Erweiterter NetSuite Connector im Jitterbit Design Studio

Einführung

Auf dieser Seite finden Sie Tipps zur Fehlerbehebung, Anleitungen und erweiterte Funktionen im Zusammenhang mit NetSuite-Integrationen.

Fehlerbehebung und Anleitungen

In diesem Abschnitt werden Probleme und Problemumgehungen für häufige Probleme bei NetSuite-Integrationen beschrieben und Informationen zu NetSuite Änderungen bereitgestellt, die sich auf Ihre Integration auswirken können.

NetSuite -kontospezifische WSDL- URL

Während der Konfiguration eines NetSuite Endpoint, müssen Sie im Feld WSDL-Download URL eine kontospezifische WSDL URL angeben. In diesem Abschnitt wird gezeigt, wie Sie diese URL erhalten, indem Sie die kontospezifische NetSuite-Domäne suchen und dann die kontospezifische Domäne in der WSDL URL verwenden.

Suchen der kontospezifischen NetSuite-Domäne

Diese Schritte müssen von einem NetSuite-Administrator oder einem anderen Benutzer mit der Berechtigung Unternehmen einrichten ausgeführt werden:

1. Melden Sie sich bei der NetSuite-Instanz an.

2. Gehen Sie zu Setup > Unternehmen > Unternehmensinformationen (oder suchen Sie nach Unternehmensinformationen).

3. Gehen Sie auf der Seite Unternehmensinformationen zum Unterregister Unternehmens URLs. Die kontospezifische Domäne befindet sich unter der Überschrift SuiteTalk (SOAP und REST-Webdienste):

   

Weitere Informationen finden Sie unter URLs für kontospezifische Domänen.

Erstellen der WSDL- URL

Sobald Sie die kontospezifische Domäne erhalten haben, verwenden Sie sie zum Erstellen der WSDL URL:

• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2024_2_0/netsuite.wsdl- https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl- https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2023_2_0/netsuite.wsdl- https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2023_1_0/netsuite.wsdl- https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2022_2_0/netsuite.wsdl- https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2022_1_0/netsuite.wsdl

Während der Konfiguration eines NetSuite Endpoint, geben Sie diese kontospezifische WSDL- URL in das Feld WSDL-Download URL ein.

Informationen darüber, welche Jitterbit-Agent-Versionen für die Verwendung mit den oben genannten WSDL-Versionen erforderlich sind, finden Sie unter Voraussetzungen auf dem NetSuite-Connector-Endpoint Seite.

Ändern der WSDL-Version

Es wird empfohlen, die von Ihrem NetSuite Endpoint verwendete WSDL-Version regelmäßig zu aktualisieren, um immer eine vollständig unterstützte Version zu verwenden. Die folgenden Schritte beschreiben die beste Vorgehensweise zum Vornehmen der Änderung, um ein nahtloses Upgrade sicherzustellen.

1. Erstellen Sie einen neuen Endpoint.

2. Tauschen Sie bei jedem NetSuite Operation den alten Endpoint gegen den neuen aus.

3. Aktualisieren Sie die Funktion.

4. Aktualisieren Sie die Transformations.

5. Wiederholen Sie die Schritte 2 bis 4 für jeden NetSuite Operation.

NetSuite Rechenzentrumsfehler

Aufgrund von Änderungen durch NetSuite werden einige zuvor zulässige WSDL URL Formate nicht mehr akzeptiert, darunter generische WSDL URLs und datencenterspezifische URLs. Jitterbit empfiehlt, immer eine kontospezifische WSDL- URL zu verwenden.

Ein NetSuite Endpoint wurde möglicherweise zuvor erfolgreich getestet, schlägt jetzt aber mit diesem Fehler fehl:

Connector-Fehler: Fehler beim Abrufen der Rechenzentrums URL.

Verursacht durch: org.jitterbit.integration.server.engine.connector.exception.NetSuiteWebServiceRuntimeException: FaultString:

In diesem Konto müssen Sie kontospezifische Domänen mit diesem SOAP Webdienst-Endpoint verwenden. Sie können den SOAP Operation „getDataCenterUrls“ verwenden, um die richtige Domäne abzurufen. Oder gehen Sie in der NetSuite-Benutzeroberfläche zu Setup > Unternehmen > Unternehmensinformationen. Ihre Domänen werden auf der Tab „Unternehmens URLs“ aufgeführt.

Unter bestimmten Umständen kann dieser Fehler auftreten:

Sie fragen nicht das richtige Rechenzentrum für Ihr Unternehmen an.

Diese Fehler können durch die Verwendung einer falschen WSDL-Download-URL bei der Konfiguration einer NetSuite-Verbindung entstehen. Aufgrund von Änderungen durch NetSuite werden einige zuvor zulässige WSDL URL Formate nicht mehr akzeptiert, darunter generische WSDL- URLs und datencenterspezifische URLs. Beispiel:

• Generische WSDL URL: https://webservices.netsuite.com/wsdl/v2024_2_0/netsuite.wsdl
• Rechenzentrumsspezifische WSDL- URL: https://webservices.na3.netsuite.com/wsdl/v2024_2_0/netsuite.wsdl

Um das Problem zu beheben, ändern Sie die WSDL URL, um eine kontospezifische Domäne zu verwenden:

• Kontospezifische WSDL URL: https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2024_2_0/netsuite.wsdl

Anweisungen zum Suchen der kontospezifischen NetSuite-Domäne und zur anschließenden Verwendung der kontospezifischen Domäne in der WSDL- URL finden Sie unter Kontospezifische NetSuite-WSDL URL.

NetSuite Zwei-Faktor-Authentifizierung (TFA oder 2FA)

Benutzer der NetSuite Zwei-Faktor-Authentifizierung (TFA oder 2FA) sollten bei der Konfiguration ihres NetSuite Endpoint nicht den Authentifizierungstyp Single Sign-On (SSO) verwenden in Jitterbit. Dies kann dazu führen, dass Ihr NetSuite Endpoint fehlschlägt. Stattdessen wird diesen Benutzern empfohlen, die tokenbasierte Authentifizierung (TBA) für Ihr NetSuite-Konto zu aktivieren und Ihren NetSuite Endpoint in Jitterbit entsprechend einzurichten.

NetSuite Sandbox WSDL- URL

Seit Januar 2018 verwendet NetSuite dieselbe URL für die Produktions- und Sandbox-Domäne. Für Design Studio und Agent Versionen 9.2 und höher ist für Jitterbit-Benutzer mit vorhandenen, für die Sandbox-Domäne konfigurierten NetSuite Endpoints keine Aktion erforderlich, solange die Sandbox seit dieser Änderung aktualisiert wurde.

Die NetSuite-Kontonummer wird jetzt verwendet, um zu bestimmen, ob sich das Konto in der Produktion oder in der Sandbox befindet. 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 angegeben wird, wurde das Kontrollkästchen Sandbox in Design Studio Versionen 9.2 und höher entfernt.

Wenn Ihre NetSuite Sandbox seit der Implementierung dieser NetSuite -Änderungen nicht aktualisiert wurde, müssen Sie möglicherweise eine Sandbox-spezifische WSDL- URL verwenden.

Berechtigungsfehler für TBA

Wenn Sie eine INSUFFICIENT_PERMISSION Fehler beim Ausführen von Vorgängen mit einem NetSuite Endpoint mit tokenbasierter Authentifizierung (TBA) konfiguriert ist, müssen Sie möglicherweise eine andere Rolle zum Generieren der Zugriffstoken verwenden oder der aktuell verwendeten Rolle Berechtigungen hinzufügen. In diesem Fall scheint der Test des Endpoint erfolgreich zu sein, aber zur Laufzeit des Operation tritt die Ausnahme auf.

Um das Problem zu beheben, achten Sie beim Generieren von Zugriffstoken darauf, dass Sie sie entweder mit der Rolle „Vollzugriff“ oder „Administrator“ generieren bzw. dass für die Rolle die entsprechenden Berechtigungen erteilt wurden.

Unerwarteter Fehler für TBA

Wenn Sie eine UNEXPECTED_ERROR Fehler beim Testen der Verbindung zu einem NetSuite Endpoint mit tokenbasierter Authentifizierung (TBA) konfiguriert ist, wird empfohlen, zu überprüfen, ob Sie die richtige WSDL URL verwenden. Der Fehler enthält den folgenden Text:

FaultString: Ein unerwarteter Fehler ist aufgetreten. Der technische Support wurde auf dieses Problem aufmerksam gemacht.

Dieser Fehler kann aus einer Reihe von Gründen auftreten. Es ist jedoch bekannt, dass er durch eine falsche WSDL- URL bei der Verwendung von Agenten der Version 9.2 bis 9.5. In der Agentenversion 9.6 und höher beschreibt der Text der Fehlermeldung das Problem genauer.

NetSuite TLS-Kompatibilitätsupgrade

Informationen zur Verwendung der TLS 1.2 Verschlüsselung finden Sie unter NetSuite TLS-Kompatibilitätsupgrade.

NetSuite Governance

Am 18. August 2017 führte Netsuite in seiner Version 2017.2 „Concurrency Governance“ ein. Wenn Sie Webdienste und/oder RESTlets verwenden, erfahren Sie unter NetSuite 2017.2 Concurrency Governance mehr darüber, wie sich dies auf Ihre Integration auswirken könnte.

Einschränkungen bei gespeicherten NetSuite Suchen

Wenn Sie bei Verwendung der gespeicherten NetSuite Suche nach Objekten suchen, für die mehr als 1.000 gespeicherte Suchvorgänge vorliegen, kann es in Jitterbit Studio so aussehen, als ob für das Objekt keine gespeicherten Suchvorgänge verfügbar wären. In diesem Fall wird das Dropdown-Menü für gespeicherte Suchvorgänge in Jitterbit Studio nicht mit gespeicherten Suchvorgängen gefüllt. Dies liegt an einem von NetSuite auferlegten Limit von 1.000 Datensätzen für API Anfragen.

Bestätigung der Verjährung

Um zu bestätigen, dass das Problem mit der NetSuite Einschränkung zusammenhängt, können Sie das Web Services Usage Log (Webdienst-Nutzungsprotokoll) in Ihrer NetSuite-Instanz überprüfen. Bei einem Fehler dieser Art enthält das Protokoll einen Eintrag ähnlich dem folgenden:

<platformCore:code>MAX_RCRDS_EXCEEDED</platformCore:code>
<platformCore:message>The maximum number (1000 ) of records allowed for a READ operation has been exceeded.</platformCore:message>

Problemumgehung für die Einschränkung

Als Workaround wird empfohlen, nicht mehr verwendete gespeicherte NetSuite Suchen zu bereinigen, um die Anzahl der gespeicherten Suchvorgänge auf weniger als 1.000 zu reduzieren. Nachdem die Anzahl der Suchvorgänge reduziert wurde, können Sie eine gespeicherte Suche aus der Dropdown-Liste in Jitterbit Studio auswählen.

Eine Alternative zur Reduzierung der Anzahl gespeicherter Suchvorgänge besteht darin, die gespeicherte Suche über SOAP auszuführen und dabei die gespeicherte Suche nach ID zu referenzieren. Beachten Sie, dass diese Alternative den NetSuite Connector nicht nutzt und kann beim Migrieren von Umgebungen zu Problemen führen.

Erweiterte Funktionalität

Dieser Abschnitt enthält Informationen zu den Funktionen in Jitterbit, mit denen Sie mehr aus Ihrer NetSuite Integration herausholen können.

Verwenden von NetSuite-Funktionen

NetSuite-spezifische Funktionen, die im Formula Builder unter Funktionen > Connector-Funktionen verfügbar sind, sind unten aufgeführt. Weitere Informationen zur Verwendung dieser Funktionen finden Sie unter Connector-Funktionen.

• NetSuiteGetSelectValue: Ruft die Auswahllistenwerte für ein Feld von NetSuite ab.
• NetSuiteGetServerTime: Ruft die Serverzeit von NetSuite ab.
• NetSuiteLogin: Ruft die Sitzung von NetSuite ab.

Verwenden der asynchronen Einstellung

Standardmäßig werden API Aufrufe an NetSuite synchron ausgeführt, d. h. nachdem eine Anfrage gestellt wurde, bleibt die Verbindung offen. Wenn bei einigen Anfragen während einer synchronen Abfrage eine Zeitüberschreitung auftritt, sollten Sie die asynchrone Einstellung aktivieren. Mit dieser Einstellung führt Jitterbit nach dem Absenden der Anfrage in regelmäßigen Abständen eine Abfrage durch, um festzustellen, ob die Anfrage abgeschlossen ist. Dies ist besonders bei großen Datenmengen nützlich.

Um die asynchrone Option zu aktivieren, setzen Sie $jitterbit.netsuite.async=true in einem Script, das sich beispielsweise am Anfang der Operation oder innerhalb der Operation befindet (siehe Erstellen eines Script). Weitere Informationen finden Sie in der NetSuite Dokumentation zur synchronen und asynchronen Anforderungsverarbeitung.

Übergeben von Nullwerten an benutzerdefinierte Felder

Eine Einschränkung der NetSuite API besteht darin, dass Sie an benutzerdefinierte Felder in NetSuite keine NULL- oder Leerwerte (leere Zeichenfolge) übergeben können.

Laut NetSuites Dokumentation zu CustomFieldList, können benutzerdefinierte Felder auf NULL gesetzt werden, indem das Feld in NetSuites nullFieldList.

Im Design Studio sehen Sie nicht nullFieldList als Feld oder Option.

Stattdessen können Sie NULL- oder leere Werte (leere Zeichenfolge) an benutzerdefinierte Felder übergeben, indem Sie das Quellfeld sowohl dem externalId Und name Felder eines Zielfeldes.

Verwenden von benutzerdefinierten NetSuite Segmenten

Benutzerdefinierte Segmente sowohl für standardmäßige als auch für benutzerdefinierte NetSuite Objekte werden für den NetSuite Connector Erstellen unterstützt, Aktualisieren, GetList, Upsert und Suchen Aktivitäten mithilfe eines NetSuite Endpoint mit einer NetSuite WSDL der Version 2016.2 oder höher. Sie müssen Version 9.4 verwenden oder höher von Design Studio und Agents, um diese Funktion zu verwenden.

Während Sie einen der oben aufgeführten Aktivitätstypen konfigurieren, wird jedes benutzerdefinierte Segment in der NetSuite Antwort- oder Anforderungsstruktur angezeigt:

Sobald die Aktivität in einer Transformation verwendet wird, können Sie von oder zu jedem dieser benutzerdefinierten Segmente eine Zuordnung vornehmen, genau wie bei anderen Feldern. Benutzerdefinierte Segmente befinden sich unter einem Knoten namens customFieldList das in seinem jeweiligen Objektknoten vorhanden ist.

Einschränkung

In einer erweiterten NetSuite-Suche, benutzerdefinierte Segmente vom Typ Liste/Datensatz, wie in NetSuite definiert, werden nicht unterstützt. Beachten Sie jedoch, dass der Typ Mehrfachauswahl in einer erweiterten NetSuite Suche unterstützt wird. Um festzustellen, welcher Typ verwendet wird, überprüfen Sie den in NetSuite in Ihrem Benutzerdefinierten Segment definierten Typ:

Diese Einschränkung gilt nicht für andere Typen von NetSuite-Aktivitäten. Das heißt, sowohl die Typen Liste/Datensatz als auch Mehrfachauswahl werden in Erstellen unterstützt, Aktualisieren, GetList, Upsert, Einfache Suche, Erweiterte Suche und Gespeicherte Suche Aktivitäten.

Verwenden der NetSuite Transaktionssuche nach Status

Wenn Sie nach NetSuite-Transaktionen basierend auf einem bestimmten Status suchen, müssen Sie den richtigen Suchfilterwert angeben, der dem gewünschten Status entspricht. Sie können den entsprechenden Suchfilterwert anhand der folgenden Tabelle ermitteln.

Wenn Sie beispielsweise möchten, dass die Suchkriterien die Artikelerfüllungsdatensätze auf diejenigen beschränken, bei denen der Versandstatus = Versendet ist, müssen Sie statt der Aufzählung für Versendet (_versendet) tatsächlich den Wert von ItemShip:C verwenden, wie in der folgenden Tabelle angegeben. Ähnliche Übersetzungen gelten für eine Vielzahl von NetSuite-Objekten.

Quelle: http://blog.prolecto.com/2013/08/30/netsuite-searchfilter-transaction-internal-status-list/

Entwurfsmuster

Die folgenden Entwurfsmuster können für NetSuite Integrationen nützlich sein:

• Erfassen von Datenänderungen mit einem API-Manager API oder HTTP- Endpoint

• Erfassen von Datenänderungen mit Dateiquellen

• Erfassen von Datenänderungen mit Quellfeldwerten

• Datenänderungen mit Tabellen- oder Dateiänderungen erfassen

• Erfassen von Datenänderungen mit zeitstempelbasierten Abfragen

• Erstellen einer Einzel- oder Mehrfachdatensatzausgabe

• Transformation dynamisch erstellen

• Bewährte Methoden für Harmony

• Verknüpfen von Quell- oder Zieldatensätzen mithilfe gemeinsamer IDs

• Daten während der Laufzeit nachschlagen

• Daten mit einem Wörterbuch nachschlagen

• Daten für spätere Verarbeitung mithilfe des temporären Speichers speichern

• Eingehende Daten zur späteren Verarbeitung speichern

• Zieldatensätze bedingt verarbeiten

• Bedingtes Ausführen der nächsten Operationen mithilfe von Operation

• Ein Team-Kollaborationsprojekt einrichten

• Alarme, Protokollierung und Fehlerbehandlung einrichten

• Aktualisieren mehrerer Ziele aus einem einzigen Quelldatensatz

• Upserting von Clarizen-Daten mit einer Kette von Operationen