NetSuite Verbindungshandbuch für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zum Anschließen App Builder zu einem Oracle NetSuite Cloud-Datenbankserver. In diesem Handbuch werden zwei verschiedene NetSuite Komponenten 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 ist so konzipiert, dass er mithilfe einer Reihe von SOAP Anfragen Daten in einem Format abruft, das stärker mit der gespeicherten Suche in NetSuite verknüpft ist. Dies bedeutet, dass SuiteQL zum Verarbeiten viel komplizierterer Abfragen verwendet werden kann als SuiteTalk. Beispielsweise können Verknüpfungen, Aggregationen, Gruppieren nach, Sortieren nach und Formeln alle serverseitig mit SuiteQL verarbeitet werden.

SuiteTalk Web Services unterstützt konzeptgemäß nur einige Verknüpfungen und Prädikate. Im Allgemeinen ist SuiteQL aufgrund seiner erweiterten Unterstützung für die Verarbeitung von SQL eine leistungsfähigere Option zum schnelleren Ausführen 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+

Anschlussanleitung

NetSuite Integration

Bevor Sie mit dem App Builder Konfiguration für die Verbindung, müssen Sie zunächst eine neue Integration in NetSuite konfigurieren. Diese Einrichtung erfordert Administratorzugriff auf NetSuite. Diese Integrationseinrichtung gibt eine eindeutige ClientID und ein Secret aus, Informationen, die für die App Builder Konfiguration.

• 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 sicher auf, da Sie diese Informationen nur einmal abrufen können und sie für die Einrichtung der App Builder Konfiguration.

Hinzufügen eines Servers

1. Navigieren Sie zu App Builder Kontrollzentrum

2. Klicken Sie im Menü „Verbinden“ auf den Link Verbindungen

   

3. Klicken Sie oben links im Datenserver-Bereich auf die Schaltfläche Erstellen. Dadurch wird die Seite Server hinzufügen aufgerufen.

Anmeldeinformationen ausfüllen

Geben Sie die folgenden Informationen ein, 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/ > ergibt 4201843 als Instanznamen.

  

• Erweiterte Einstellungen: Enthält zusätzliche Konfigurationsoptionen, einschließlich der Einstellung „Ping-Timeout“, die die Zeitspanne (in Sekunden) bestimmt, die App Builder wartet auf einen Pingback vom Server, bevor ein Timeout erklärt wird.

  • Erweitert: Dieses Feld muss richtig 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 }}; //Wird ausgegeben, wenn Sie Ihre NetSuite Integration registrieren

    • OAuthClientSecret={{ OauthClientSecret }}; //Wird ausgegeben, wenn Sie Ihre NetSuite Integration registrieren

    • OAuthAccessToken={{ AccessToken }}; //Geben Sie einen Testaufruf aus, um dies zunächst zu generieren

    • OAuthAccessTokenSecret={{ AccessSecret }}; //Geben Sie einen Testaufruf aus, 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 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 Anmeldeinformationen eingegeben haben, klicken Sie auf die Schaltfläche 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. Sie sehen an App Builder„Erfolgreich“-Meldung, wenn die Konfiguration korrekt ist.

Hinzufügen einer Datenquelle

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

1. Navigieren Sie zu App Builder Kontrollzentrum

2. Klicken Sie im Menü „Verbinden“ auf den Link „Verbindungen“

3. Klicken Sie auf den NetSuite-Servereintrag im Fenster Datenserver und klicken Sie dann im Fenster Datenquellen auf Neue Datenquelle hinzufügen > Neue Datenbank erstellen. Einige Datenquellen werden automatisch in das App Builder Datenspeicherseite. Wenn die Datenquelle bereits hinzugefügt wurde, klicken Sie auf die zugehörige Schaltfläche Details, um die Detailseite aufzurufen.

4. Klicken Sie auf die Schaltfläche Bearbeiten

5. 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: Dadurch können Benutzer nur bestimmte Tabellen 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 gelassen wird, werden alle Tabellen importiert.

   

6. Klicken Sie auf Speichern, um die Datenquelleneinstellungen zu aktualisieren.

7. Sobald die Seite aktualisiert ist, klicken Sie auf die Schaltfläche Importieren, die unter den Quellanmeldeinformationen angezeigt wird. Klicken Sie bei entsprechender Aufforderung auf Fortfahren. Der Import wird so geplant, dass er im Hintergrund ausgeführt wird.

   

8. 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 wesentliche Unterschiede in der Art und Weise, wie Sie mit NetSuite SuiteQL vs. SuiteTalk Web Services arbeiten in App Builder, sowie welche Informationen nach Herstellung der Verbindung abgerufen werden können.

SuiteQL ist eine Abfrage, die auf der SQL- Abfrage basiert. Sie unterstützt erweiterte Abfrage, die Sie zum Anzeigen von NetSuite Datensätzen und-Daten nutzen können. Wir empfehlen, SuiteQL zum Lesen und Erstellen von Objekten zu verwenden. Innerhalb App Builder SuiteQL selbst ermöglicht es Ihnen, Objekte als Ansichten anzuzeigen.

SuiteTalk Web Services ist ein SOAP -basierter Webdienst, der zur Integration mit externen Systemen verwendet wird. In diesem Fall App Builder. SuiteTalk unterstützt standardmäßig nur einige Joins und Prädikate.

Nach der richtigen Konfiguration in App Builder, SuiteTalk stellt Ihnen Endpoints basierend auf SOAP Endpoints in NetSuite bereit.

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 hat einige benutzerdefinierte Regeln für Filter, die Sie Ihr Datenformat manipulieren müssen, um richtig filtern zu können

• NetSuite unterstützt nicht die Verwendung von Klammern in Objektnamen