NetSuite-Connector erweitert im Jitterbit Design Studio

Einführung

Diese Seite behandelt Fehlersuche, Anleitungen und erweiterte Funktionen im Zusammenhang mit NetSuite-Integrationen.

Fehlersuche und Anleitungen

Dieser Abschnitt beschreibt Probleme und Lösungen für häufige Probleme, die bei NetSuite-Integrationen auftreten, und bietet Informationen zu Änderungen in NetSuite, die Ihre Integration beeinflussen können.

Konto-spezifische WSDL-URL für NetSuite

Während der Konfiguration eines NetSuite-Endpunkts müssen Sie eine konto-spezifische WSDL-URL im Feld WSDL-Download-URL angeben. Dieser Abschnitt zeigt, wie Sie diese URL erhalten, indem Sie die konto-spezifische Domain von NetSuite finden und diese dann in der WSDL-URL verwenden.

Finden der konto-spezifischen Domain von NetSuite

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

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

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

3. Auf der Seite Unternehmensinformationen gehen Sie zum Untertab Unternehmens-URLs. Die konto-spezifische Domain befindet sich unter der Überschrift SuiteTalk (SOAP und REST Web Services):

   

Für weitere Informationen siehe URLs für konto-spezifische Domains.

Konstruieren der WSDL-URL

Sobald Sie die konto-spezifische Domain erhalten haben, verwenden Sie diese, um die WSDL-URL zu konstruieren:

• https://abcdef123456.suitetalk.api.netsuite.com/wsdl/v2025_1_0/netsuite.wsdl
• 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

Während der Konfiguration eines NetSuite-Endpunkts geben Sie diese kontospezifische WSDL-URL im Feld WSDL-Download-URL ein.

Informationen darüber, welche Jitterbit-Agentversionen für die Verwendung mit den oben genannten WSDL-Versionen erforderlich sind, finden Sie in den Voraussetzungen auf der Seite NetSuite-Endpunkt.

Ändern der WSDL-Version

Es wird empfohlen, die WSDL-Version, die von Ihrem NetSuite-Endpunkt verwendet wird, regelmäßig zu aktualisieren, um immer eine vollständig unterstützte Version zu verwenden. Die folgenden Schritte skizzieren den besten Weg, um die Änderung vorzunehmen und ein nahtloses Upgrade zu gewährleisten.

1. Erstellen Sie einen neuen Endpunkt.

2. Ersetzen Sie für jede NetSuite-Operation den alten Endpunkt durch den neuen.

3. Aktualisieren Sie die Funktion.

4. Aktualisieren Sie die Transformationen.

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

NetSuite-Datenzentrum-Fehler

Aufgrund von Änderungen, die von NetSuite vorgenommen wurden, werden einige WSDL-URL-Formate, die zuvor erlaubt waren, nicht mehr akzeptiert, einschließlich generischer WSDL-URLs und datenzentrumspezifischer URLs. Jitterbit empfiehlt, immer eine kontospezifische WSDL-URL zu verwenden.

Ein NetSuite-Endpunkt wurde möglicherweise zuvor erfolgreich getestet, schlägt jetzt jedoch mit diesem Fehler fehl:

Connector-Fehler: Fehler beim Abrufen der Datenzentrum-URL.

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

In diesem Konto müssen Sie kontospezifische Domains mit diesem SOAP-Webdienst-Endpunkt verwenden. Sie können die SOAP getDataCenterUrls-Operation verwenden, um die richtige Domain zu erhalten. Oder gehen Sie zu Setup > Company > Company Information in der NetSuite-Benutzeroberfläche. Ihre Domains sind auf der Registerkarte Unternehmens-URLs aufgeführt.

In einigen Fällen kann dieser Fehler auftreten:

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

Diese Fehler können durch die Verwendung einer falschen WSDL-Download-URL in der Konfiguration einer NetSuite-Verbindung verursacht werden. Aufgrund von Änderungen, die von NetSuite vorgenommen wurden, werden einige WSDL-URL-Formate, die zuvor akzeptiert wurden, nicht mehr akzeptiert, einschließlich generischer WSDL-URLs und rechenzentrums-spezifischer URLs. Zum Beispiel:

• Generische WSDL-URL: https://webservices.netsuite.com/wsdl/v2025_1_0/netsuite.wsdl
• Rechenzentrums-spezifische WSDL-URL: https://webservices.na3.netsuite.com/wsdl/v2025_1_0/netsuite.wsdl

Um das Problem zu lösen, ändern Sie die WSDL-URL, um eine kontospezifische Domain zu verwenden:

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

Für Anweisungen zum Finden der kontospezifischen Domain von NetSuite und zur Verwendung der kontospezifischen Domain in der WSDL-URL siehe NetSuite kontospezifische WSDL-URL.

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

Benutzer, die die Zwei-Faktor-Authentifizierung (TFA oder 2FA) von NetSuite verwenden, sollten nicht den Authentifizierungstyp für die einmalige Anmeldung (SSO) bei der Konfiguration Ihres NetSuite-Endpunkts in Jitterbit verwenden. Andernfalls kann Ihr NetSuite-Endpunkt fehlschlagen. Stattdessen wird diesen Benutzern empfohlen, die tokenbasierte Authentifizierung (TBA) in ihrem NetSuite-Konto zu aktivieren und ihren NetSuite-Endpunkt in Jitterbit entsprechend einzurichten.

NetSuite Sandbox WSDL-URL

Seit Januar 2018 verwendet NetSuite dieselbe URL für sowohl ihre Produktions- als auch Sandbox-Domain. Für Design Studio und Agent-Versionen 9.2 und höher sind keine Maßnahmen für Jitterbit-Benutzer mit bestehenden NetSuite-Endpunkten erforderlich, die für die Sandbox-Domain konfiguriert sind, solange die Sandbox seit dieser Änderung aktualisiert wurde.

Die NetSuite-Kontonummer wird jetzt verwendet, um zu bestimmen, ob das Konto in der Produktion oder im Sandbox-Modus ist. Zum Beispiel kann die Kontonummer mit _SB1, _SB2 usw. ergänzt werden. Da NetSuite keine separate Sandbox-URL mehr verwendet und der Sandbox-Modus jetzt durch die Kontonummer angezeigt wird, wurde das Kontrollkästchen "Sandbox" in den Versionen 9.2 und höher von Design Studio 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 beim Ausführen von Operationen mit einem NetSuite-Endpunkt, der mit tokenbasierter Authentifizierung (TBA) konfiguriert ist, einen INSUFFICIENT_PERMISSION-Fehler erhalten, müssen Sie möglicherweise eine andere Rolle zur Generierung der Zugriffstoken verwenden oder Berechtigungen für die Rolle hinzufügen, die Sie derzeit verwenden. In diesem Fall scheint der Test des Endpunkts erfolgreich zu sein, aber beim Ausführen der Operation tritt die Ausnahme auf.

Um das Problem zu lösen, stellen Sie beim Generieren der Zugriffstoken sicher, dass Sie diese entweder mit einer Rolle für vollen Zugriff oder einer Administratorrolle generieren oder sicherstellen, dass die entsprechenden Berechtigungen für die Rolle erlaubt sind.

Unerwarteter Fehler für TBA

Wenn Sie beim Testen der Verbindung zu einem NetSuite-Endpunkt, der mit tokenbasierter Authentifizierung (TBA) konfiguriert ist, einen UNEXPECTED_ERROR-Fehler erhalten, 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 über dieses Problem informiert.

Dieser Fehler kann aus verschiedenen Gründen auftreten; bekannt ist jedoch, dass dieser Fehler auf eine falsche WSDL-URL zurückzuführen ist, wenn Agenten der Version 9.2 bis 9.5 verwendet werden. In Agenten der Version 9.6 und höher beschreibt der Fehlertext das Problem genauer.

NetSuite-Kooperationsverwaltung

Am 18. August 2017 führte Netsuite die "Kooperationsverwaltung" in seiner Version 2017.2 ein. Wenn Sie Webdienste und/oder RESTlets verwenden, erfahren Sie mehr darüber, wie dies Ihre Integration unter NetSuite 2017.2 Kooperationsverwaltung beeinflussen könnte.

Einschränkungen bei gespeicherten Suchen in NetSuite

Wenn Sie eine gespeicherte Suche in NetSuite verwenden und versuchen, nach Objekten zu suchen, die mehr als 1.000 gespeicherte Suchen haben, kann es in Jitterbit Studio so erscheinen, als ob keine gespeicherten Suchen für das Objekt verfügbar sind. In diesem Fall wird das Dropdown-Menü für gespeicherte Suchen in Jitterbit Studio nicht mit gespeicherten Suchen gefüllt. Dies liegt an einer von NetSuite auferlegten Begrenzung von 1.000 Datensätzen für API-Anfragen.

Bestätigung der Einschränkung

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

<platformCore:code>MAX_RCRDS_EXCEEDED</platformCore:code>
<platformCore:message>Die maximale Anzahl ( 1000 ) der für eine Leseoperation zulässigen Datensätze wurde überschritten.</platformCore:message>

Umgehung der Einschränkung

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

Eine Alternative zur Reduzierung der Anzahl der gespeicherten Suchen besteht darin, die gespeicherte Suche über SOAP auszuführen, indem die gespeicherte Suche nach ID referenziert wird. Beachten Sie, dass diese Alternative den NetSuite-Connector nicht verwendet und zu Problemen beim Migrieren von Umgebungen führen kann.

Erweiterte Funktionalität

Dieser Abschnitt bietet Informationen zu Funktionen in Jitterbit, die es Ihnen ermöglichen, mehr aus Ihrer NetSuite-Integration herauszuholen.

Verwendung von NetSuite-Funktionen

NetSuite-spezifische Funktionen, die im Formel-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 Auswahlwerte für ein Feld aus NetSuite ab.
• NetSuiteGetServerTime: Holt die Serverzeit von NetSuite.
• NetSuiteLogin: Holt die Sitzung von NetSuite.

Verwendung der asynchronen Einstellung

Standardmäßig werden API-Aufrufe an NetSuite synchron ausgeführt; d.h. nach einer Anfrage bleibt die Verbindung offen. Wenn einige Anfragen während einer synchronen Abfrage zeitlich begrenzt sind, möchten Sie möglicherweise die asynchrone Einstellung aktivieren. Mit dieser Einstellung wird Jitterbit nach der Einreichung der Anfrage regelmäßig abfragen, ob diese Anfrage abgeschlossen ist. Dies ist besonders nützlich bei großen Datenmengen.

Um die asynchrone Option zu aktivieren, setzen Sie $jitterbit.netsuite.async=true in einem Skript, das sich beispielsweise am Anfang der Operation oder innerhalb der Operationskette befindet (siehe Erstellen eines Skripts). Für weitere Informationen siehe die NetSuite-Dokumentation zu Synchroner vs. Asynchroner Anfrageverarbeitung.

Übergeben von NULL-Werten an benutzerdefinierte Felder

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

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

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

Stattdessen können Sie NULL- oder leere (leere Zeichenfolgen) Werte an benutzerdefinierte Felder übergeben, indem Sie das Quellfeld sowohl dem externalId- als auch dem name-Feld eines Ziel-Feldes zuordnen.

Verwendung von benutzerdefinierten Segmenten in NetSuite

Benutzerdefinierte Segmente auf sowohl standardmäßigen als auch benutzerdefinierten NetSuite-Objekten werden für den NetSuite Connector Erstellen, Aktualisieren, GetList, Upsert und Suchen Aktivitäten unterstützt, die einen NetSuite-Endpunkt mit einem NetSuite WSDL verwenden, das Version 2016.2 oder höher ist. Sie müssen Version 9.4 oder höher von sowohl Design Studio als auch Agents verwenden, um diese Funktion nutzen zu können.

Beim Konfigurieren eines der oben aufgeführten Aktivitätstypen werden Sie sehen, dass jedes benutzerdefinierte Segment in der NetSuite-Antwort- oder Anforderungsstruktur angezeigt wird:

Sobald die Aktivität in einer Transformation verwendet wird, können Sie von oder zu einem dieser benutzerdefinierten Segmente zuordnen, genau wie bei anderen Feldern. Benutzerdefinierte Segmente befinden sich unter einem Knoten namens customFieldList, der innerhalb seines jeweiligen Objektknotens vorhanden ist.

Einschränkung

In einer NetSuite erweiterten Suche werden benutzerdefinierte Segmente des Typs Liste/Datensatz, wie in NetSuite definiert, nicht unterstützt. Beachten Sie jedoch, dass der Typ Mehrfachauswahl in einer NetSuite erweiterten Suche unterstützt wird. Um zu bestimmen, welcher Typ verwendet wird, überprüfen Sie den Typ, der in NetSuite für Ihr benutzerdefiniertes Segment definiert ist:

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

Verwendung der NetSuite-Transaktionssuche nach Status

Bei der Suche nach NetSuite-Transaktionen basierend auf einem bestimmten Status müssen Sie den richtigen Suchfilterwert angeben, der dem gewünschten Status entspricht. Den entsprechenden Suchfilterwert können Sie der folgenden Tabelle entnehmen.

Wenn Sie beispielsweise die Suchkriterien so einschränken möchten, dass die Artikelversanddatensätze nur die enthalten, bei denen der Versandstatus = Versendet ist, müssten Sie anstelle des Enums für Versendet (_shipped) tatsächlich den Wert 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:

• Datenänderungen mit einer API-Manager-API oder HTTP-Endpunkt erfassen

• Datenänderungen mit Dateiquellen erfassen

• Datenänderungen mit Quellfeldwerten erfassen

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

• Datenänderungen mit zeitstempelbasierten Abfragen erfassen

• Einzel- oder Mehrfachdatenausgaben erstellen

• Transformationsiterator dynamisch erstellen

• Best Practices für Harmony

• Quell- oder Zielaufzeichnungen mit gemeinsamen IDs verknüpfen

• Daten zur Laufzeit abrufen

• Daten mit einem Wörterbuch abrufen

• Daten für eine spätere Verarbeitung mit temporärem Speicher speichern

• Eingehende Daten für eine spätere Verarbeitung speichern

• Zielaufzeichnungen bedingt verarbeiten

• Nächste Operationen bedingt mit Operationsketten ausführen

• Ein Team-Kollaborationsprojekt einrichten

• Benachrichtigungen, Protokollierung und Fehlerbehandlung einrichten

• Mehrere Ziele aus einem einzelnen Quell-Datensatz aktualisieren

• Clarizen-Daten mit einer Kette von Operationen upserten