Workiva-ondersteuningscentrum

Met de NetSuite® Token Authentication-connector kunt u commando's in chain gebruiken voor interactie met NetSuite. Met deze connector kunt u bijvoorbeeld:

• Bestanden downloaden van NetSuite
• Lijst met opgeslagen zoekopdrachten in NetSuite
• Gegevens ophalen over een standaard NetSuite record of opgeslagen zoekopdracht

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding in te schakelen, gebruikt de connector de NetSuite REST API. Om de connector in te stellen, hebt u het volgende nodig:

• NetSuite, met op token gebaseerde verificatie (TBA) ingeschakeld
• De ID van de NetSuite-account waarmee u verbinding wilt maken

  Opmerking: Als u uw account-ID in NetSuite wilt weergeven, selecteert u Setup, Integrations, Web Services Preferences. De ID verschijnt meestal ook in de eerste tekenreeks van de URL, net voor app.netsuite.com.

• Een integratierecord en toegangstoken gemaakt in NetSuite voor de connector
• De gebruikerssleutel en het geheim van de integratierecord

  Opmerking: Als u het geheim of de sleutel van de consument niet hebt, bewerkt u de integratierecord en stelt u de referenties opnieuw in.

• De ID en het geheim van het toegangstoken. Als u de ID of het wachtwoord van het toegangstoken niet hebt, moet u een nieuw token aanmaken.

Opmerking: Als u wilt communiceren met een NetSuite RESTlet met OAuth 2.0-authenticatie, gebruikt u in plaats daarvan een HTTP Request-connector.

De integratie in NetSuite inschakelen

Om de connector in staat te stellen met NetSuite te communiceren, heeft deze tokengebaseerde authenticatie (TBA) en zijn eigen integratierecord nodig.

Stap 1. SOAP-webservices en op token gebaseerde verificatie inschakelen

SOAP-webservices en TBA inschakelen voor NetSuite:

1. Selecteer in NetSuite Setup, Bedrijf, Functies inschakelen.
2. Op het tabblad SuiteCloud , onder SuiteScript, selecteert u Client SuiteScript en Server SuiteScript.
   
3. Selecteer onder SuiteTalk (Web Services), SOAP web services.
   
4. Selecteer onder Verificatie beheren Tokengebaseerde verificatie.
5. Klik op Opslaan.

Stap 2. Een integratierecord aanmaken

Nadat u TBA hebt ingeschakeld, maakt u een integratierecord voor de connector:

1. Selecteer in NetSuite Setup, Integraties, Integraties beheren, Nieuw.
2. Om de integratie te helpen identificeren, voert u een unieke naam en beschrijving in, zoals Workiva Integration.
   
3. Selecteer onder Authenticatie Tokengebaseerde authenticatie, en wis TBA: Autorisatiestroom.
4. Klik op Opslaan, en noteer de gebruikerssleutel en het geheim van de bevestigingspagina.

Opmerking: De gebruikerssleutel en het geheim verschijnen alleen op de bevestigingspagina van de integratierecord. Zorg ervoor dat u deze waarden vastlegt voor de eigenschappen van de connector, en behandel ze als een wachtwoord.

Stap 3. Een integratierol aanmaken

Maak voor veiligheidsdoeleinden een speciale rol aan in NetSuite om uw integraties te beheren:

1. Selecteer Instelling, Gebruikers/rollen, Rollen beheren, Nieuw.
   
2. Voer onder General een unieke naam in waarmee u de rol kunt identificeren, zoals Workiva/NetSuite Integration.
3. Selecteer onder Authenticatie Alleen webservices rol om de rol in te schakelen om alleen verbinding te maken met de NetSuite API, en niet rechtstreeks in te loggen bij NetSuite.
4. Voeg onder Machtigingen, de machtigingen toe om de integratie mogelijk te maken, zoals Machtigingen op volledig niveau voor alle relevante Transacties, Rapporten, en Lijsten in NetSuite.
5. Op het tabblad Setup onder Permissions, voegt u machtigingen op volledig niveau toe voor:
   
   • SOAP-webservices
   • Bedrijf opzetten
   • Token-gebaseerde verificatie:
     • Om de rol alleen via toegangsmunten te laten verifiëren, Inloggen met toegangsmunten
     • Om de rol in staat te stellen zijn eigen toegangstokens te maken en in te trekken, Gebruikerstoegangstokens
       
     
6. Klik op Opslaan.

Stap 4. Wijs de rol toe aan de integratiegebruiker

Nadat u de integratierol hebt gemaakt, wijst u deze toe aan de integratiegebruiker van de connector:

1. Selecteer in NetSuite Instellingen, Gebruikers/rollen, Gebruikers beheren.
2. Selecteer of maak de integratiegebruiker voor de connector.
   

   Opmerking: Wij raden aan om voor elke connector of integratie een aparte gebruiker aan te wijzen.

3. Onder Rollen, wijs de integratierol toe aan de gebruiker.

Stap 5. Het toegangstoken voor de integratiegebruiker aanmaken

Om een toegangstoken voor de integratiegebruiker te maken:

1. Selecteer in NetSuite Setup, Users/Roles, Access tokens, New.
2. Klik op Nieuw toegangstoken.
   
3. In Toepassingsnaam, selecteert u de integratierecord.
4. In User, selecteert u de integratiegebruiker.
5. Selecteer in Rol de integratierol.
6. Klik op Opslaan.
7. Noteer de ID en het geheim die voor het token zijn gemaakt; u hebt deze nodig voor de eigenschappen van de connector.

   Opmerking: Om veiligheidsredenen verschijnen de ID en het geheim alleen wanneer het toegangstoken wordt aangemaakt. Behandel ze als een wachtwoord. Als u de ID of het geheim van het token niet hebt voor de eigenschappen van de connector, maak dan een nieuw token aan voor de integratiegebruiker.

De NetSuite Token Authentication-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Verbinding, NetSuite Token Authentication en de standaard CloudRunner.
   
3. Voer een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Onder Eigenschappen, voert u de details van de verbinding in:
   
   

   Eigendom	Details
   Rekening-ID	Voer de ID in van de NetSuite-account waarmee u verbinding wilt maken.
   Consumentensleutel	Voer de gebruikerssleutel in voor het integratierecord van de connector.
   Consumentengeheim	Voer het geheim in voor de eigenschap Consumer Key.
   Token-ID	Voer de ID van het toegangstoken van de connector in.
   Token geheim	Voer het geheim in voor de eigenschap Token ID.
   Sandbox	Schakel dit selectievakje in als u verbinding wilt maken met een sandbox NetSuite-account.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.

5. Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de connector's List Saved Searches opdracht, en controleer of deze een geldige uitvoer oplevert.

Probleemoplossing

Aangepaste velden

Houd er rekening mee dat de NetSuite API geen aangepaste velden kan retourneren. Als alternatief kan Data Prep transformaties maken die de logica van een Netsuite aangepast veld nabootsen.

Verbindingen

Als de verbinding met NetSuite mislukt:

• Controleer de account-ID die voor de connector is ingevoerd. Om de account-ID in NetSuite weer te geven, selecteert u Setup, Integrations, Web Services Preferences. De ID staat meestal ook vlak voor app.netsuite.com in de URL.
• Controleer de gebruikerssleutel en het geheim van het integratierecord van de connector. Bewerk indien nodig de integratierecord en reset de referenties om een nieuwe gebruikerssleutel en geheim te maken.
• Controleer de ID en het geheim van het toegangstoken van de connector. Maak indien nodig een nieuw token aan voor de connector.