Workiva Support Center

Mit dem NetSuite® JDBC-Konnektor können Sie Befehle in einer Kette verwenden, um SQL-Operationen (Structured Query Language) in NetSuite durchzuführen. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

• Ausführen einer SELECT Abfrage in NetSuite
• Abrufen von Tabellen über eine NetSuite-Tabelle

Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Voraussetzungen

Um eine Verbindung zu NetSuite herzustellen, verwendet der Konnektor eine Java-Datenbankverbindung (JDBC), die durch eine einfache Authentifizierung mit Benutzername und Passwort gesichert ist. 

Hinweis: Um JDBC mit Ihrer NetSuite-Umgebung zu aktivieren, konfigurieren Sie den SuiteAnalytics Connect® Service für Ihren Mandanten.

Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Ein designierter Integrationsbenutzer, der in NetSuite für den Konnektor erstellt wurde und Zugriff auf das NetSuite Analytics-Modul hat
• Der Benutzername und das Passwort des Integrationsbenutzers
• Die URL der JDBC-Verbindung, z. B. jdbc:ns://[server_host]:[port];ServerDataSource=[datasource];encrypted=1;CustomProperties=(AccountID=[accountID];RoleID=[roleID])mit demselben Konto und derselben Rolle, die in SuiteAnalytics Connect für den NetSuite-Mandanten eingerichtet wurden

Hinweis: Um eine Verbindung zu einer lokalen Instanz von NetSuite herzustellen, benötigen Sie einen GroundRunner für den Konnektor mit installierter Java Virtual Machine (JVM) in der Umgebung. Um eine Verbindung zu einer Cloud-Instanz von NetSuite herzustellen, verwenden Sie den Standard-CloudRunner.

Einrichten des NetSuite JDBC-Konnektors

Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Org-Sicherheitsadministrator ihn zunächst aktivieren unter Konfiguration.

Dann:

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Unter Connector Connection, wählen Sie NetSuite JDBC und den Runner, der mit der Verbindung verwendet werden soll.
   
3. Geben Sie einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. Geben Sie unter Eigenschaften die Details des Connectors ein:
   
   

   Eigenschaft	Details
   Benutzername	Geben Sie den Benutzernamen des NetSuite-Integrationsbenutzers des Connectors ein.
   Kennwort	Geben Sie das Passwort für die Eigenschaft Benutzername ein.
   Verbindungs-URL	Geben Sie die URL für die JDBC-Verbindung ein, wobei alle optionalen Eigenschaften nach einem Semikolon angefügt werden. Zum Beispiel: jdbc:ns://[server_host]:[port];ServerDataSource=[datasource];encrypted=1;CustomProperties=(AccountID=[accountID];RoleID=[roleID]) Standardmäßig lautet der Anschluss 1708.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert. Vermeiden Sie es aus Sicherheitsgründen, Benutzeranmeldedaten als benutzerdefinierte Eigenschaften in die Eingabe Connection URL aufzunehmen.

5. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
6. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Tabellendefinition beziehen des Konnektors aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Benutzerdefinierte Felder

Bitte beachten Sie, dass die NetSuite-API keine benutzerdefinierten Felder zurückgeben kann. Als Alternative kann Data Prep Transformationen erstellen, die die Logik eines benutzerdefinierten Feldes von Netsuite nachahmen.

Fehlgeschlagene Verbindung

Wenn die Verbindung zu NetSuite fehlschlägt:

• Überprüfen Sie die Authentifizierungsdaten des Integrationsbenutzers
• Überprüfen Sie die URL für die JDBC-Verbindung, einschließlich des Servers und des Ports

Wenn die Verbindung einen Befehl nicht ausführen kann, überprüfen Sie, ob die Eingaben - wie die SQL-Syntax oder die Tabelle - gültig sind.