Workiva Support Center

Mit dem NetSuite® Token Authentication Connector können Sie Befehle in der Kette verwenden, um mit NetSuite zu interagieren. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

• Dateien von NetSuite herunterladen
• Gespeicherte Suchen in NetSuite auflisten
• Abrufen von Daten über einen NetSuite-Standarddatensatz oder eine gespeicherte Suche

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 die Verbindung zu aktivieren, verwendet der Connector die NetSuite REST API. Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• NetSuite, mit tokenbasierter Authentifizierung (TBA) aktiviert
• Die ID des NetSuite-Kontos, mit dem eine Verbindung hergestellt werden soll

  Hinweis: Um Ihre Konto-ID in NetSuite anzuzeigen, wählen Sie Setup, Integrations, Web Services Preferences. Die ID erscheint normalerweise auch in der ersten Zeichenfolge der URL, direkt vor app.netsuite.com.

• Ein -Integrationsdatensatz und ein -Zugangstoken wurden in NetSuite für den Konnektor erstellt.
• Verbraucherschlüssel und -geheimnis des Integrationsdatensatzes

  Hinweis: Wenn Sie nicht über das Verbrauchergeheimnis oder den Schlüssel verfügen, bearbeiten Sie den Integrationsdatensatz und setzen Sie seine Anmeldedaten zurück.

• Die ID und das Geheimnis des Zugangstokens. Wenn Sie die ID oder das Passwort des Zugangstokens nicht haben, müssen Sie ein neues Token erstellen.

Hinweis: Um mit einem NetSuite RESTlet mit OAuth 2.0-Authentifizierung zu interagieren, verwenden Sie stattdessen einen HTTP-Request-Connector.

Aktivieren Sie die Integration in NetSuite

Damit der Connector mit NetSuite interagieren kann, benötigt er token-based authentication (TBA) und einen eigenen Integrationsdatensatz.

Schritt 1. Aktivieren von SOAP-Webdiensten und tokenbasierter Authentifizierung

Um SOAP-Webdienste und TBA für NetSuite zu aktivieren:

1. Wählen Sie in NetSuite Setup, Company, Enable features.
2. Auf der Registerkarte SuiteCloud , unter SuiteScript, wählen Sie Client SuiteScript und Server SuiteScript.
   
3. Wählen Sie unter SuiteTalk (Web Services), SOAP Web Services.
   
4. Wählen Sie unter Authentifizierung verwalten die Option Token-basierte Authentifizierung.
5. Klicken Sie auf Speichern.

Schritt 2. Erstellen Sie einen Integrationsdatensatz

Nachdem Sie TBA aktiviert haben, erstellen Sie einen Integrationsdatensatz für den Connector:

1. Wählen Sie in NetSuite Setup, Integrations, Manage integrations, New.
2. Um die Integration zu identifizieren, geben Sie einen eindeutigen Namen und eine Beschreibung ein, z. B. Workiva Integration.
   
3. Wählen Sie unter Authentifizierung die Option Token-basierte Authentifizierung, und deaktivieren Sie TBA: Autorisierungsablauf.
4. Klicken Sie auf Speichern, und notieren Sie den Verbraucherschlüssel und das Geheimnis auf der Bestätigungsseite.

Hinweis: Der Verbraucherschlüssel und das Secret erscheinen nur auf der Bestätigungsseite des Integrationsdatensatzes. Achten Sie darauf, diese Werte für die Eigenschaften des Konnektors zu notieren, und behandeln Sie sie wie ein Passwort.

Schritt 3. Erstellen Sie eine Integrationsrolle

Erstellen Sie aus Sicherheitsgründen eine eigene Rolle in NetSuite, um Ihre Integrationen zu verwalten:

1. Wählen Sie Einrichtung, Benutzer/Rollen, Rollen verwalten, Neu.
   
2. Unter Allgemein geben Sie einen eindeutigen Namen ein, um die Rolle zu identifizieren, z. B. Workiva/NetSuite Integration.
3. Wählen Sie unter Authentifizierung die Rolle Nur Webservices , damit die Rolle nur eine Verbindung zur NetSuite-API herstellen kann und sich nicht direkt bei NetSuite anmeldet.
4. Unter Berechtigungen, fügen Sie die Berechtigungen hinzu, um die Integration zu aktivieren, wie z. B. Vollberechtigung für alle relevanten Transaktionen, Berichte und Listen in NetSuite.
5. Fügen Sie auf der Registerkarte Setup unter Berechtigungen die Berechtigungen auf voller Ebene für hinzu:
   
   • SOAP-Webdienste
   • Unternehmen gründen
   • Token-basierte Authentifizierung:
     • Um die Rolle so zu konfigurieren, dass sie sich nur über Zugriffstoken authentifiziert, Login using access tokens
     • Um die Rolle in die Lage zu versetzen, ihre eigenen Zugriffstokens zu erstellen und zu widerrufen, Benutzerzugriff-Token
       
     
6. Klicken Sie auf Speichern.

Schritt 4. Weisen Sie dem Integrationsbenutzer die Rolle zu

Nachdem Sie die Integrationsrolle erstellt haben, weisen Sie sie dem Integrationsbenutzer des Konnektors zu:

1. Wählen Sie in NetSuite Setup, Users/Roles, Manage users.
2. Wählen oder erstellen Sie den Integrationsbenutzer für den Konnektor.
   

   Hinweis: Wir empfehlen, für jeden Anschluss oder jede Integration einen eigenen Benutzer anzulegen.

3. Weisen Sie dem Benutzer unter Roles die Integrationsrolle zu.

Schritt 5. Erstellen Sie das Zugriffstoken für den Integrationsbenutzer

So erstellen Sie ein Access-Token für den Integrationsbenutzer:

1. Wählen Sie in NetSuite Setup, Users/Roles, Access tokens, New.
2. Klicken Sie auf Neues Zugangstoken.
   
3. Wählen Sie unter Anwendungsname den Integrationsdatensatz aus.
4. Wählen Sie unter Benutzer den Integrationsbenutzer aus.
5. Wählen Sie unter Role die Integrationsrolle aus.
6. Klicken Sie auf Speichern.
7. Notieren Sie sich die ID und das Secret, die für das Token erstellt wurden; Sie benötigen sie für die Eigenschaften des Konnektors.

   Hinweis: Aus Sicherheitsgründen erscheinen die ID und das Geheimnis nur bei der Erstellung des Zugangstokens. Behandeln Sie sie wie ein Passwort. Wenn Sie die ID oder das Geheimnis des Tokens für die Eigenschaften des Connectors nicht haben, erstellen Sie ein neues Token für den Integrationsbenutzer.

Einrichten des NetSuite Token-Authentifizierungskonnektors

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

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Connection, NetSuite Token Authentication und den Standard CloudRunner.
   
3. Geben Sie einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   
   

   Eigenschaft	Details
   Konto-ID	Geben Sie die ID des NetSuite-Kontos ein, mit dem eine Verbindung hergestellt werden soll.
   Verbraucherschlüssel	Geben Sie den Verbraucherschlüssel für den Integrationsdatensatz des Konnektors ein.
   Secret des Verbrauchers	Geben Sie das Geheimnis für die Eigenschaft Consumer Key ein.
   Token-ID	Geben Sie die ID des Zugriffstokens des Connectors ein.
   Token Geheimnis	Geben Sie das Geheimnis für die Eigenschaft Token ID ein.
   Sandkasten	Um eine Verbindung zu einem NetSuite-Konto in der Sandbox herzustellen, markieren Sie dieses Feld.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

5. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
6. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Gespeicherte Suchen auflisten 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.

Verbindungen

Wenn die Verbindung zu NetSuite fehlschlägt:

• Überprüfen Sie die für den Konnektor eingegebene Konto-ID. Um die Konto-ID in NetSuite anzuzeigen, wählen Sie Setup, Integrations, Web Services Preferences. Die ID erscheint in der Regel auch direkt vor app.netsuite.com in der URL.
• Überprüfen Sie den Verbraucherschlüssel und das Secret des Integrationsdatensatzes des Konnektors. Bearbeiten Sie gegebenenfalls den Integrationsdatensatz und setzen Sie seine Anmeldedaten zurück, um einen neuen Verbraucherschlüssel und ein neues Geheimnis zu erstellen.
• Überprüfen Sie die ID und das Geheimnis des Zugriffstokens des Connectors. Erstellen Sie bei Bedarf ein neues Token für den Konnektor.