NetSuite-Connector in Jitterbit Studio
Zusammenfassung
Der NetSuite-Connector stellt Zugriff auf NetSuite her.
Der NetSuite-Connector bietet eine Schnittstelle zum Erstellen einer NetSuite-Verbindung, die als Grundlage für die Generierung von NetSuite-Aktivitätsinstanzen dient. Diese Aktivitäten interagieren nach der Konfiguration mit NetSuite über die Verbindung.
Man greift auf den NetSuite-Connector über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten zu (siehe Palette der Designkomponenten).
Tipp
Integrations-Rezepte und Prozessvorlagen sind für diesen Connector über Jitterbit Marketplace verfügbar.
Wichtig
Oracle setzt die NetSuite-SOAP-Webservice-Endpunkte schrittweise außer Kraft. Die letzte geplante SOAP-Webservice-Version (2025.2) wird bis zur Version 2028.2 unterstützt.
Ab NetSuites Version 2027.1 können neue Integrationen nicht mehr mit SOAP-Webservices erstellt werden. Dies liegt daran, dass NetSuite die tokenbasierte Authentifizierung (TBA), die dieser Connector benötigt, ab dieser Version auf bestehende Integrationen beschränkt. Bestehende NetSuite-Endpunkte, die mit diesem Connector vor der Version 2027.1 erstellt wurden, können weiterhin verwendet und geändert werden.
Wenn man die Version 2025.2 des Endpunkts verwendet, ist keine sofortige Maßnahme erforderlich. Es ist jedoch möglich, sich mit dem HTTP v2-Connector mit SuiteTalk-REST-Webservices zu verbinden, um Oracles Zeitplan voraus zu aktualisieren.
Weitere Informationen finden Sie unter Fragen zum NetSuite-SOAP-Abschaltungszeitplan und im Upgrade-Leitfaden von NetSuite-SOAP-Webservices zu REST-Webservices.
Connector-Übersicht
Man verwendet diesen Connector zunächst zum Konfigurieren einer NetSuite-Verbindung. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden sollen.
Zusammen werden eine bestimmte NetSuite-Verbindung und ihre Aktivitäten als NetSuite-Endpunkt bezeichnet:

-
Search: Ruft vorhandene Datensätze aus NetSuite ab und ist als Quelle zur Bereitstellung von Daten in einem Vorgang vorgesehen.
-
Create: Erstellt neue Datensätze in NetSuite und ist als Ziel in einem Vorgang vorgesehen.
-
Update: Aktualisiert vorhandene Datensätze in NetSuite und ist als Ziel in einem Vorgang vorgesehen.
-
Get List: Ruft eine Liste vorhandener Datensätze basierend auf der ID aus NetSuite ab und ist als Ziel in einem Vorgang vorgesehen.
-
Upsert: Aktualisiert vorhandene Datensätze und erstellt neue Datensätze in NetSuite und ist als Ziel in einem Vorgang vorgesehen.
-
Löschen: Löscht Datensätze in NetSuite und ist als Ziel in einem Vorgang vorgesehen.
Dieser Connector ist ein nativer Connector: Seine Updates werden mit der Studio-Anwendung oder dem Agent veröffentlicht, nicht separat. Siehe Studio-Connector-Updates.
Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.
Voraussetzungen und unterstützte API-Versionen
Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.
Bestimmte Voraussetzungen müssen erfüllt sein, um diesen Connector zu verwenden, einschließlich der Aktivierung der tokengestützten Authentifizierung (TBA), der Verwendung einer unterstützten NetSuite-WSDL-Version und der Verwendung von Harmony Cloud- oder privaten Agenten, die die NetSuite-WSDL-Version unterstützen.
Der NetSuite-Connector verwendet die SOAP-Webservices-API der NetSuite-WSDL-Version, die Sie konfiguriert haben. Der NetSuite-Connector kann mit den unterstützten WSDLs konfiguriert werden, die in den Voraussetzungen aufgeführt sind.
Wichtig
Oracle setzt die NetSuite-SOAP-Webservice-Endpunkte schrittweise außer Kraft. Die letzte geplante SOAP-Webservice-Version (2025.2) wird bis zur Version 2028.2 unterstützt.
Ab NetSuites Version 2027.1 können neue Integrationen nicht mehr mit SOAP-Webservices erstellt werden. Dies liegt daran, dass NetSuite die tokengestützte Authentifizierung (TBA), die dieser Connector benötigt, ab dieser Version auf bestehende Integrationen beschränkt. Bestehende NetSuite-Endpunkte, die mit diesem Connector vor der Version 2027.1 erstellt wurden, können weiterhin verwendet und geändert werden.
Jitterbit wird in Zukunft Anleitungen zu NetSuites REST-Webservices bereitstellen. Weitere Informationen finden Sie unter Fragen zur NetSuite-SOAP-Abschaltung.
Die Option Saved Search with result fields as output in einer NetSuite-Suchaktivität erfordert ein bereitgestelltes Suitelet-Skript, um die Metadaten abzurufen, die erforderlich sind, um die Antwortschemafelder auf die Spalten einer gespeicherten Suche zu beschränken.
Hinweis
Die Option Saved Search with result fields as output erfordert Agent-Version 11.49 oder später.
Weitere Informationen zu den Schemafeldern finden Sie in der Dokumentation im NetSuite Help Center.
Einschränkungen
Der NetSuite-Connector unterstützt keine Attach/Detach-Webservices. Um diese Webservices zu verwenden, nutzen Sie Jitterbits SOAP-Connector.
Fehlerbehebung und Anleitungen
Fehlerbehebung
Wenn Sie Probleme mit dem NetSuite-Connector haben, werden diese Schritte zur Fehlerbehebung empfohlen:
-
Stellen Sie sicher, dass die NetSuite-Verbindung erfolgreich ist, indem Sie die Schaltfläche Test im Konfigurationsbildschirm verwenden. Wenn die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler einen Hinweis auf das Problem geben.
-
Überprüfen Sie die Vorgangsprotokolle auf alle Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
-
Aktivieren Sie das Betriebsdebug-Logging (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.
-
Wenn Sie private Agenten verwenden, stellen Sie sicher, dass Sie die Agent-Version 11.30 oder später verwenden, und überprüfen Sie die Agent-Protokolle für weitere Informationen.
-
Überprüfen Sie die Einschränkungen des NetSuite-Connectors.
Wenn Sie weiterhin Probleme haben, finden Sie allgemeine Überlegungen zur Fehlerbehebung unter Betriebsfehlerbehebung. Weitere Informationen zur Fehlerbehebung speziell für den NetSuite-Connector finden Sie auf der Seite NetSuite-Fehlerbehebung und im Leitfaden Connector-Fehlerbehebung, einschließlich:
-
Concurrency Governance: Was zu tun ist, wenn Fehler aufgrund zu vieler gleichzeitiger Anfragen auftreten.
-
Benutzerdefinierte Felder: So machen Sie benutzerdefinierte Felder für ein Objekt verfügbar, wenn Sie einen privaten Agenten verwenden.
-
Benutzerdefinierte Segmente: Was zu überprüfen ist, wenn benutzerdefinierte Segmente nicht wie erwartet angezeigt werden.
-
Datencenter-Fehler: Eine Problemumgehung für einen Fehler im Zusammenhang mit einem falschen Datencenter.
-
Berechtigungsfehler: Eine Problemumgehung für einen Fehler bezüglich unzureichender Berechtigungen.
-
Datensatzlimits: Empfehlungen zum Aktivieren von Chunking, wenn Sie auf NetSuite-API-Datensatzlimits stoßen.
-
NetSuite Create, Update oder Upsert schlägt fehl mit „is not a legal value for Country": Was zu überprüfen ist, wenn NetSuite einen aufgezählten Wert wie ein Land ablehnt.
Anleitungen
Zusätzlich zu den obigen Informationen zur Fehlerbehebung bieten die folgenden Seiten mit Anleitungen detaillierte Anweisungen zum Ausführen spezifischer Aufgaben mit Integrationsprojekten, die den NetSuite-Connector verwenden:
-
Multi-Währung in NetSuite aktivieren: So aktivieren Sie die Multi-Währungs-Funktion in NetSuite.
-
NetSuite-Anfragen asynchron aktivieren: So legen Sie die Jitterbit-Variable
jitterbit.netsuite.asyncfest, um regelmäßiges Polling zu verwenden. -
TBA in NetSuite aktivieren: So aktivieren Sie die tokenbasierte Authentifizierung in NetSuite vor der Konfiguration einer NetSuite-Verbindung.
-
Werte für die Verwendung von NetSuite TBA sammeln: So sammeln Sie die erforderlichen Werte für die Konfiguration einer NetSuite-Verbindung.
-
NULL-Werte an benutzerdefinierte NetSuite-Felder übergeben: So legen Sie benutzerdefinierte Felder in einer Transformation auf NULL fest.
-
Nach Status in NetSuite suchen: So geben Sie den korrekten Suchfilterwert an, wenn Sie eine NetSuite-Suchaktivität konfigurieren.
-
Kontospezifische NetSuite-WSDL-URL verwenden: So erhalten Sie eine kontospezifische WSDL-URL, die für die Konfiguration einer NetSuite-Verbindung erforderlich ist.
-
NetSuite-Funktionen verwenden: So verwendest du eine NetSuite-Verbindung mit NetSuite-Funktionen.
-
Standardformulare in NetSuite verwenden: So verwendest du Standardformulare für benutzerdefinierte Objekte in NetSuite.
Zusätzliche Ressourcen
Ein Jitterbit-Microlearning-Tutorial ist über unsere Jitterbit-Grundlagen-Videoserie verfügbar: