NetSuite Verbindungshandbuch für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zum Verbinden von App Builder mit einem Oracle NetSuite Cloud-Datenbankserver. Zwei verschiedene NetSuite Komponenten werden in dieser Anleitung behandelt: Suite QL und SuiteTalk Web Services.

SuiteQL ist eine Abfrage, die auf der SQL- Abfrage basiert und zum Abfrage von Daten aus NetSuite verwendet wird. Der in SuiteTalk unterstützte Standarddienst nutzt eine Reihe von SOAP -Anfragen, um Daten in einem Format abzurufen, das den gespeicherten Suchvorgängen in NetSuite besser entspricht. Dadurch kann SuiteQL deutlich komplexere Abfragen verarbeiten als SuiteTalk. Beispielsweise können Verknüpfungen, Aggregationen, Gruppieren nach, Sortieren nach und Formeln serverseitig mit SuiteQL verarbeitet werden.

SuiteTalk Web Services unterstützt standardmäßig nur bestimmte Joins und Prädikate. SuiteQL ist aufgrund seiner erweiterten SQL-Unterstützung generell eine leistungsfähigere Option für die schnellere Ausführung von Abfragen an NetSuite.

Wir empfehlen, Suite QL zum Lesen und Erstellen von Objekten und SuiteTalk zum Schreiben und Aktualisieren von Daten zu verwenden.

Systemanforderungen

Datenbankserver

Oracle NetSuite

Client-Webbrowser

Chrome: 84+

Firefox: 73+
Safari: 13.0.1+

Kante: 84+

Internet Explorer: 11+

Anschlusshinweise

NetSuite Integration

Bevor Sie mit der App Builder-Konfiguration für die Verbindung beginnen, müssen Sie zunächst eine neue Integration in NetSuite konfigurieren. Diese Einrichtung erfordert Administratorzugriff auf NetSuite. Diese Integrationseinrichtung gibt eine eindeutige Client-ID und ein Geheimnis aus, die für die App Builder-Konfiguration erforderlich sind.

Melden Sie sich als Administrator bei NetSuite an
Navigieren Sie zu Setup > Integration > Integration verwalten > Neu

Nach Abschluss der Integrationskonfiguration generiert NetSuite eine eindeutige Client-ID und ein Geheimnis. Bewahren Sie diese Informationen sorgfältig auf, da sie nur einmal abgerufen werden können und für die App Builder-Konfiguration erforderlich sind.

Hinzufügen eines Servers

Navigieren Sie zum App Builder Kontrollzentrum
Klicken Sie im Menü „Verbinden“ auf den Link „Verbindungen“
Klicken Sie oben links im Datenserver-Bereich auf die Schaltfläche Erstellen. Die Seite Server hinzufügen wird geöffnet.

Ausfüllen der Anmeldeinformationen

Geben Sie die folgenden Informationen an, um eine Verbindung mit einem NetSuite Datenbankserver herzustellen:

Servername: Ein identifizierbarer und eindeutiger Servername.
Typ: Wählen Sie „Net Suite“ aus dem Menü.
Hostname: Der Hostname Ihres Servers.
Port: Die Port für den Server. Der Port ist 1433.
Instanzname: Erforderliche Informationen - dies ist der ID-Teil Ihrer eindeutigen NetSuite URL. Beispiel: < https://4201843.app.netsuite.com/ > entspricht 4201843 als Instanzname.
Erweiterte Einstellungen: Enthält zusätzliche Konfigurationsoptionen, einschließlich der Einstellung „Ping-Timeout“, die die Zeit (in Sekunden) bestimmt, die App Builder auf einen Pingback vom Server wartet, bevor ein Timeout erklärt wird.
- Erweitert: Dieses Feld muss korrekt ausgefüllt werden, um die Verbindung zu unterstützen
  - Schema={{ Schema }}; //Dies ist entweder auf SuiteQL oder SuiteTalk eingestellt (Suite Talk wird zum Schreiben und Aktualisieren von Daten verwendet). Hat ein völlig anderes Schema als SuiteQL.
  - OAuthClientId={{ OauthClientID }}; //Ausgestellt, wenn Sie Ihre NetSuite Integration registrieren
  - OAuthClientSecret={{ OauthClientSecret }}; //Wird ausgegeben, wenn Sie Ihre NetSuite Integration registrieren
  - OAuthAccessToken={{ AccessToken }}; //Testaufruf ausführen, um dies zunächst zu generieren
  - OAuthAccessTokenSecret={{ AccessSecret }}; //Testaufruf ausführen, um dies zunächst zu generieren
  - IncludeChildTables=true; // Optionaler Parameter, aber erforderlich, wenn das Schema auf SuiteTalk eingestellt ist und Sie in Tabellen mit Beziehungen schreiben müssen, um die Untertabellen anzuzeigen
Hinweis

Bei Bedarf werden zusätzliche Parameter unterstützt. Diese werden hier näher erläutert: https://cdn.cdata.com/help/DNG/ado/pg_suiteql.htm
Ping-Timeout: {Standardwert ist 10}
Name des Escape-Abfrageparameters: {Standard ist aktiviert}

Nachdem Sie alle erforderlichen Anmeldedaten eingegeben haben, klicken Sie auf Speichern, um die Einstellungen zu speichern.

Testen der Verbindung

Klicken Sie unter den Serverinformationen auf die Schaltfläche Verbindung testen, um sicherzustellen, dass der Server ordnungsgemäß verbunden ist. Bei korrekter Konfiguration wird die App Builder Meldung „Erfolgreich“ angezeigt.

Hinzufügen einer Datenquelle

Nachdem die NetSuite-Servereinstellungen gespeichert wurden, muss die Datenbank mit dem App Builder verbunden werden. Mit dem App Builder verbundene Datenbanken werden als „Datenquelle“ bezeichnet.

Navigieren Sie zum App Builder Kontrollzentrum
Klicken Sie im Menü „Verbinden“ auf den Link „Verbindungen“
Wählen Sie im Bereich Datenserver den NetSuite-Servereintrag aus und klicken Sie anschließend im Bereich Datenquellen auf Neue Datenquelle hinzufügen > Neue Datenbank erstellen. Einige Datenquellen werden automatisch in die Datenspeicherseite des App Builder importiert. Wenn die Datenquelle bereits hinzugefügt wurde, klicken Sie auf die zugehörige Schaltfläche Details, um die Detailseite aufzurufen.
Klicken Sie auf die Schaltfläche Bearbeiten
Geben Sie die folgenden Anmeldeinformationen für die Datenquelle ein:
1. Datenquellenserver: Der Name des Servers, von dem die Daten bezogen werden
2. Datenquellenname: Geben Sie der Datenquelle einen eindeutigen Anzeigenamen
3. Importmuster: Ermöglicht Benutzern, nur bestimmte Tabellen zu importieren, indem sie diese im Feld auflisten. Präfixe können auch verwendet werden, um nur eine Teilmenge von Tabellen zu importieren (z. B. importiert MyApp_* nur Tabellen, die mit „MyApp_“ beginnen). Wenn das Feld leer bleibt, werden alle Tabellen importiert.
Klicken Sie auf Speichern, um die Datenquelleneinstellungen zu aktualisieren.
Klicken Sie nach dem Aktualisieren der Seite auf die Schaltfläche Importieren, die unter den Quellanmeldeinformationen angezeigt wird. Klicken Sie anschließend auf Fortfahren. Der Import wird im Hintergrund ausgeführt.
Klicken Sie nach Abschluss des Imports auf Tabellen, um die aktuell erstellten Tabellen anzuzeigen.

NetSuite SuiteQL vs. SuiteTalk-Webdienste

Wie im Abschnitt Info dieses Handbuchs erwähnt, gibt es wichtige Unterschiede in der Art und Weise, wie Sie mit NetSuite SuiteQL im Vergleich zu SuiteTalk Web Services im App Builder arbeiten, sowie darin, welche Informationen abgerufen werden können, nachdem die Verbindung hergestellt wurde.

SuiteQL ist eine Abfrage, die auf der SQL- Abfrage basiert. Sie unterstützt erweiterte Abfrage, mit denen Sie NetSuite Datensätze und-Daten anzeigen können. Wir empfehlen SuiteQL zum Lesen und Erstellen von Objekten. Im App Builder selbst ermöglicht SuiteQL die Anzeige von Objekten als Ansichten.

Anhang

SuiteTalk Web Services ist ein SOAP -basierter Webdienst zur Integration mit externen Systemen, in diesem Fall App Builder. SuiteTalk unterstützt standardmäßig nur bestimmte Verknüpfungen und Prädikate.

Nach der ordnungsgemäßen Konfiguration im App Builder stellt SuiteTalk Ihnen Endpoints basierend auf SOAP Endpoints in NetSuite bereit.

Anhang

Einschränkungen

NetSuite begrenzt die Parallelität von Abfragen, die nach Verbindung und Lizenzen nach Verbindungspool ausgeführt werden. Dies wirkt sich auf die Leseleistung aus.
NetSuite verfügt über einige benutzerdefinierte Filterregeln, die Sie an Ihrem Datenformat anpassen müssen, um richtig filtern zu können
NetSuite unterstützt nicht die Verwendung von Klammern in Objektnamen