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:
- Selecteer in NetSuite Setup, Bedrijf, Functies inschakelen.
- Op het tabblad SuiteCloud , onder SuiteScript, selecteert u Client SuiteScript en Server SuiteScript.
- Selecteer onder SuiteTalk (Web Services), SOAP web services.
- Selecteer onder Verificatie beheren Tokengebaseerde verificatie.
- Klik op Opslaan.
Stap 2. Een integratierecord aanmaken
Nadat u TBA hebt ingeschakeld, maakt u een integratierecord voor de connector:
- Selecteer in NetSuite Setup, Integraties, Integraties beheren, Nieuw.
- Om de integratie te helpen identificeren, voert u een unieke naam en beschrijving in, zoals Workiva Integration.
- Selecteer onder Authenticatie Tokengebaseerde authenticatie, en wis TBA: Autorisatiestroom.
- 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:
- Selecteer Instelling, Gebruikers/rollen, Rollen beheren, Nieuw.
- Voer onder General een unieke naam in waarmee u de rol kunt identificeren, zoals Workiva/NetSuite Integration.
- 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.
- 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.
- 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
- 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:
- Selecteer in NetSuite Instellingen, Gebruikers/rollen, Gebruikers beheren.
- Selecteer of maak de integratiegebruiker voor de connector.
Opmerking: Wij raden aan om voor elke connector of integratie een aparte gebruiker aan te wijzen.
- 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:
- Selecteer in NetSuite Setup, Users/Roles, Access tokens, New.
- Klik op Nieuw toegangstoken.
- In Toepassingsnaam, selecteert u de integratierecord.
- In User, selecteert u de integratiegebruiker.
- Selecteer in Rol de integratierol.
- Klik op Opslaan.
- 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.
- Ga naar Chain Builder, klik op Connections, en vervolgens op Create rechtsboven.
- Selecteer onder Connector Verbinding, NetSuite Token Authentication en de standaard CloudRunner.
- Voer een unieke naam en beschrijving in om de verbinding te helpen identificeren.
- 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.
- Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
- 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.comin 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.