Zum Inhalt springen

NetSuite-Verbindungsanleitung für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und gibt Anweisungen zur Verbindung des App Builders mit einem Oracle NetSuite Cloud-Datenbankserver.

Systemanforderungen

Dies sind die minimalen erforderlichen Browser-Versionen:

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

  • Internet Explorer: 11+

Verbindungsanweisungen

Um den App Builder mit NetSuite zu verbinden, müssen Sie eine Integration in NetSuite konfigurieren und Tokens von dort abrufen, die Sie zur Herstellung der Verbindung verwenden. Die folgenden Abschnitte beschreiben, wie Sie dies tun.

Neue NetSuite-Integration konfigurieren

Befolgen Sie diese Schritte, um eine neue Integration in NetSuite zu erstellen, mit der der App Builder verbunden werden kann. Sie benötigen administrative Zugriffsrechte auf NetSuite.

  1. Melden Sie sich als Administrator bei NetSuite an.

    attachment

  2. Navigieren Sie zu Setup > Integration > Manage Integration > New.

    attachment

  3. Geben Sie die erforderlichen Informationen ein und klicken Sie auf die Schaltfläche Speichern. Wenn die Integration konfiguriert ist, generiert NetSuite eine eindeutige Client-ID und ein Secret. Notieren Sie sich diese Werte. Sie werden sie zur Einrichtung der App Builder-Verbindung verwenden.

    Wichtig

    Die Client-ID und das Secret werden nur einmal angezeigt. Stellen Sie sicher, dass Sie deren Werte vor dem Fortfahren kopieren.

Zugriffstoken generieren

Nachdem Sie die NetSuite-Integration konfiguriert haben, müssen Sie Zugriffstoken generieren, um dem App Builder die Verbindung zu ermöglichen.

Befolgen Sie die Schritte in der NetSuite-Dokumentation, um Tokens zu generieren. Sie benötigen sowohl die Token-ID als auch das Token-Secret.

Fügen Sie einen Datenserver hinzu

Jetzt, da Sie eine NetSuite-Integration konfiguriert und die Zugriffstoken erhalten haben, sind Sie bereit, App Builder damit zu verbinden. Öffnen Sie App Builder und folgen Sie diesen Schritten:

  1. Wählen Sie IDE > Datenserver.

  2. Klicken Sie auf die Schaltfläche + Server.

  3. Die folgenden Felder werden angezeigt:

    1. Im Abschnitt Servereinstellungen:

      1. Servername: Geben Sie einen Namen für diesen Server ein.

      2. Typ: Klicken Sie, um das Menü zu öffnen, und suchen Sie dann nach NetSuite und wählen Sie es aus.

      3. Instanzname: Geben Sie die ID ein, die in Ihrer einzigartigen NetSuite-URL enthalten ist. Wenn Ihre URL beispielsweise https://1234567.app.netsuite.com/ lautet, dann ist Ihr Instanzname 1234567.

    2. Im Abschnitt Sicherheitseinstellungen:

      1. Sicherheitsanbieter: (Optional) Wählen Sie einen Sicherheitsanbieter aus dem Menü aus.

    3. Im Abschnitt Testen:

      1. Verbindung testen: Klicken Sie, um Ihre Verbindungsanmeldeinformationen zu überprüfen. Beachten Sie, dass der Test fehlschlägt, wenn Sie die Erweiterten Einstellungen unten noch nicht abgeschlossen haben. Vervollständigen Sie zuerst die Konfiguration und kehren Sie dann zu diesem Dialog zurück, um die Verbindung zu testen.

      2. Herausforderung zulassen: Aktivieren Sie dieses Kontrollkästchen, um App Builder zu erlauben, den Browser umzuleiten, wenn es eine OAuth-Herausforderung erhält.

  4. Klicken Sie auf die Schaltfläche Speichern.

  5. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen im Abschnitt Servereinstellungen. Der Dialog Server (Erweiterte Einstellungen) öffnet sich.

  6. Klicken Sie auf die Schaltfläche Bearbeiten. Die folgenden Felder werden angezeigt:

    1. Erweitert: Geben Sie in dieses Feld die folgenden Informationen ein:

      Schema={{ Schema }};
OAuthClientId={{ OauthClientID }};
OAuthClientSecret={{ OauthClientSecret }};
OAuthAccessToken={{ AccessToken }};
OAuthAccessTokenSecret={{ AccessSecret }};
IncludeChildTables=true;

      Nehmen Sie die folgenden Änderungen vor:

      1. Ersetzen Sie Schema durch entweder SuiteQL oder SuiteTalk. Siehe SuiteQL und SuiteTalk für Hilfe bei der Auswahl.

      2. Ersetzen Sie OauthClientID durch die Client-ID, die Sie während der Integrationskonfiguration notiert haben (siehe Konfigurieren Sie eine neue NetSuite-Integration).

      3. Ersetzen Sie OauthClientSecret durch das Secret, das Sie während der Integrationskonfiguration notiert haben (siehe Konfigurieren Sie eine neue NetSuite-Integration).

      4. Ersetzen Sie AccessToken durch die Token-ID, die Sie zuvor generiert haben (siehe Zugriffstoken generieren).

      5. Ersetzen Sie AccessSecret durch das Token-Geheimnis, das Sie zuvor generiert haben (siehe Zugriffstoken generieren).

      6. Der Parameter IncludeChildTables ist nur erforderlich, wenn Sie SuiteTalk als Ihr Schema ausgewählt haben und Sie in Tabellen mit Beziehungen schreiben müssen, um die Untertabellen zu sehen.

      Hinweis

      Andere Parameter werden unterstützt, falls Sie diese benötigen. Siehe die NetSuite-Dokumentation, um mehr zu erfahren.

    2. Ping-Timeout: Die Zeit (in Sekunden), die der App Builder auf eine Rückmeldung vom Server wartet, bevor er einen Timeout auslöst. Der Standardwert beträgt 10.

    3. Abfrageparametername escapen: Wählen Sie, um Parameter mit reservierten Namen zu verwenden. Dieses Kontrollkästchen ist standardmäßig aktiviert.

  7. Klicken Sie auf Speichern, um alle Ihre Einstellungen zu bestätigen und zu speichern.

Datenquelle hinzufügen

Nachdem der Server hinzugefügt wurde, muss er im App Builder als Datenquelle hinzugefügt werden. Gehen Sie dazu wie folgt vor:

  1. Navigieren Sie zu IDE > Datenserver.

  2. Suchen Sie in der Tabelle Datenserver den Server, den Sie hinzugefügt haben (siehe Datenserver hinzufügen oben), und wählen Sie dessen Zeile aus. Das Panel Datenquellen rechts zeigt die neue Datenquelle an, die automatisch hinzugefügt wurde. Klicken Sie auf Details.

    Hinweis

    Das Klicken auf die Schaltfläche Details in der Zeile des Servers in der Tabelle Datenserver zeigt nicht die gleichen Optionen an.

  3. Der obere Abschnitt hat den Namen, den Sie unter Servername eingegeben haben, als Sie den Server hinzugefügt haben. Klicken Sie auf die Schaltfläche Bearbeiten, wenn Sie den Datenquellennamen ändern und einen eindeutigen Anzeigenamen haben möchten. (Standardmäßig hat er denselben Namen wie der Server.)

  4. Klicken Sie im Abschnitt Datenbankschicht auf Importieren. Der Dialog Schema importieren öffnet sich.

  5. Geben Sie im Feld Importieren von Muster die Teilmenge von Tabellen ein, die Sie mit mvSQL-Syntax aus der Datenbank importieren möchten. Wenn dieses Feld leer gelassen wird, werden alle Tabellen importiert.

  6. Klicken Sie auf Importieren, dann auf Fortfahren. Der Import wird im Hintergrund geplant. Sobald Sie eine erfolgreiche Bestätigungsnachricht erhalten, werden die importierten Tabellen unten angezeigt.

NetSuite SuiteQL vs. SuiteTalk Web Services

Wenn Sie NetSuite als Datenserver hinzufügen im App Builder, müssen Sie wählen, ob Sie SuiteQL oder SuiteTalk Web Services als Ihr Schema verwenden möchten. Die folgenden Informationen können Ihnen helfen, zu bestimmen, welches am besten zu Ihren Bedürfnissen passt.

SuiteQL ist eine Abfragesprache, die auf der SQL-Datenbankabfragesprache basiert und verwendet wird, um Daten aus NetSuite abzufragen. Der standardmäßige Dienst, der in SuiteTalk unterstützt wird, ist so konzipiert, dass er eine Reihe von SOAP-Anfragen verwendet, um Daten in einem Format abzurufen, das enger mit der gespeicherten Suche in NetSuite verbunden ist. Das bedeutet, dass SuiteQL verwendet werden kann, um viel kompliziertere Abfragen als SuiteTalk zu verarbeiten. Beispielsweise können Joins, Aggregationen, Gruppierungen, Sortierungen und Formeln serverseitig mit SuiteQL verarbeitet werden. Innerhalb des App Builders selbst ermöglicht SuiteQL Ihnen, Objekte als Ansichten anzuzeigen.

attachment

SuiteTalk Web Services ist ein auf SOAP basierender Webdienst, der für die Integration mit externen Systemen, in diesem Fall App Builder, verwendet wird. SuiteTalk unterstützt von Haus aus nur einige Joins und Prädikate. SuiteTalk stellt Ihnen Tabellenendpunkte basierend auf SOAP-Endpunkten in NetSuite zur Verfügung.

attachment

Im Allgemeinen ist SuiteQL eine leistungsstärkere Option, um Abfragen schneller gegen NetSuite auszuführen, aufgrund seiner erweiterten Unterstützung für die Verarbeitung von SQL. Unsere Empfehlung ist, SuiteQL für das Lesen und den Objektaufbau und SuiteTalk für das Schreiben und Aktualisieren von Daten zu verwenden.

Einschränkungen

  • NetSuite begrenzt die gleichzeitige Ausführung von Abfragen, die gegen es ausgeführt werden, nach Verbindung und Lizenzen pro Verbindungspool, was die Leseleistung beeinträchtigt.

  • NetSuite hat einige benutzerdefinierte Regeln für Filter, die Sie benötigen, um Ihr Datenformat zu manipulieren, um richtig filtern zu können.

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

Fehlerbehebung

Wenn Sie Probleme mit dem Oracle NetSuite-Server haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Aktivieren Sie Datenprotokollierung, um Protokolldateien und Daten zu generieren, die Sie herunterladen und überprüfen können.

  2. Konsultieren Sie die CData ADO.NET Provider für NetSuite-Dokumentation für detaillierte Informationen.