Workiva kundestøttesenter

Med NetSuite® Token Authentication Connector kan du bruke kommandoer i kjeden for å samhandle med NetSuite. Med denne kontakten kan du for eksempel

• Last ned filer fra NetSuite
• Liste over lagrede søk i NetSuite
• Hent data om en standard NetSuite-post eller et lagret søk

Merk: Denne kontakten er bygget av Workiva og kobles til et tredjepartssystem. Supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, men vi kan ikke feilsøke eller på annen måte hjelpe deg med problemer som oppstår utenfor Workiva-plattformen.

Forutsetninger

For å aktivere tilkoblingen bruker kontakten NetSuite REST API. For å sette opp kontakten trenger du

• NetSuite, med tokenbasert autentisering (TBA) aktivert
• ID-en til NetSuite-kontoen som skal kobles til

  Merk: Hvis du vil vise konto-ID-en din i NetSuite, velger du Setup, Integrations, Web Services Preferences. ID-en vises også vanligvis i den første strengen i URL-en, rett før app.netsuite.com.

• En integrasjonspost og tilgangstoken opprettet i NetSuite for koblingen
• Integrasjonspostens forbrukernøkkel og -hemmelighet

  Merk: Hvis du ikke har forbrukerhemmeligheten eller -nøkkelen, må du redigere integrasjonsposten og tilbakestille legitimasjonen.

• Tilgangstokenets ID og hemmelighet. Hvis du ikke har tilgangstokenets ID eller passord, må du opprette et nytt token.

Merk: Hvis du vil samhandle med en NetSuite RESTlet ved hjelp av OAuth 2.0-autentisering, bruker du an HTTP Request connector i stedet.

Aktiver integrasjonen i NetSuite

For at connectoren skal kunne samhandle med NetSuite, trenger den tokenbasert autentisering (TBA) og sin egen integrasjonspost.

Trinn 1. Aktiver SOAP-nettjenester og tokenbasert autentisering

For å aktivere SOAP-nettjenester og TBA for NetSuite:

1. I NetSuite velger du Setup, Company, Enable features.
2. På SuiteCloud -fanen, under SuiteScript, velger du Client SuiteScript og Server SuiteScript.
   
3. Under SuiteTalk (Web Services) velger du SOAP web services.
   
4. Under Administrer autentisering velger du Tokenbasert autentisering.
5. Klikk på Lagre.

Trinn 2. Opprett en integrasjonspost

Når du har aktivert TBA, oppretter du en integrasjonspost for kontakten:

1. I NetSuite velger du Oppsett, Integrasjoner, Administrer integrasjoner, Ny.
2. For å identifisere integrasjonen kan du angi et unikt navn og en beskrivelse, for eksempel Workiva Integration.
   
3. Under Autentisering velger du Tokenbasert autentisering, og fjerner merket for TBA: Autorisasjonsflyt.
4. Klikk på Lagre, og registrer brukernøkkelen og hemmeligheten fra bekreftelsessiden.

Merk: Forbrukernøkkelen og hemmeligheten vises bare på bekreftelsessiden for integrasjonsposten. Sørg for å registrere disse verdiene for kontaktens egenskaper, og behandle dem som et passord.

Trinn 3. Opprett en integrasjonsrolle

Av sikkerhetsgrunner bør du opprette en dedikert rolle i NetSuite for å administrere integrasjonene dine:

1. Velg Oppsett, Brukere/roller, Administrer roller, Ny.
   
2. Under General angir du et unikt navn for å identifisere rollen, for eksempel Workiva/NetSuite Integration.
3. Under Authentication velger du Web services only role for å aktivere rollen slik at den kun kan koble seg til NetSuite API, og ikke logge på NetSuite direkte.
4. Under Tillatelser, legger du til tillatelsene for å aktivere integrasjonen, for eksempel Fullstendige tillatelser til alle relevante Transaksjoner, Rapporter, og Lister i NetSuite.
5. I fanen Setup under Permissions legger du til fullstendige tillatelser for:
   
   • SOAP-nettjenester
   • Opprett selskap
   • Tokenbasert autentisering:
     • For å aktivere rollen slik at den bare kan autentiseres via tilgangstokener, Login using access tokens
     • For å gjøre det mulig for rollen å opprette og tilbakekalle sine egne tilgangstokener, User access tokens
       
     
6. Klikk på Lagre.

Trinn 4. Tildel rollen til integrasjonsbrukeren

Når du har opprettet en integrasjonsrolle, tilordner du den til kontaktens integrasjonsbruker:

1. I NetSuite velger du Setup, Users/Roles, Manage users.
2. Velg eller opprett integrasjonsbrukeren for kontakten.
   

   Merk: Vi anbefaler en egen bruker for hver kontakt eller integrasjon.

3. Under Roles tilordner du integrasjonsrollen til brukeren.

Trinn 5. Opprett integrasjonsbrukerens tilgangstoken

For å opprette et tilgangstoken for integrasjonsbrukeren:

1. I NetSuite velger du Setup, Users/Roles, Access tokens, New.
2. Klikk på New access token.
   
3. I Application name velger du integrasjonsposten.
4. I User velger du integrasjonsbrukeren.
5. I Role velger du integrasjonsrollen.
6. Klikk på Lagre.
7. Legg merke til ID-en og hemmeligheten som er opprettet for tokenet; du trenger dem for koblingens egenskaper.

   Merk: Av sikkerhetshensyn vises ID og hemmelighet bare når tilgangstokenet opprettes. Behandle dem som du ville gjort med et passord. Hvis du ikke har tokenets ID eller hemmelighet for koblingens egenskaper, oppretter du et nytt token for integrasjonsbrukeren.

Konfigurer NetSuite Token Authentication-kontakten

Merk: For å gjøre kontakten tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Configuration.

1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
2. Under Connector Connection velger du NetSuite Token Authentication og standard CloudRunner.
   
3. Angi et unikt navn og en beskrivelse for å identifisere tilkoblingen.
4. Under Properties angir du detaljer om tilkoblingen:
   
   

   Egenskap	Detaljer
   Konto-ID	Skriv inn ID-en til NetSuite-kontoen du vil koble til.
   Forbrukernøkkel	Skriv inn forbrukernøkkelen for kontaktens integrasjonspost.
   Forbrukerhemmelighet	Skriv inn hemmeligheten for egenskapen Consumer Key.
   Token-ID	Skriv inn ID-en til kontaktens tilgangstoken.
   Token hemmelig	Skriv inn hemmeligheten for egenskapen Token ID.
   Sandkasse	Merk av i denne boksen for å koble til en NetSuite-konto i sandkassen.

   Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.

5. Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
6. For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens List Saved Searches -kommando, og kontrollere at den returnerer en gyldig utdata.

Feilsøking

Tilpassede felt

Vær oppmerksom på at NetSuite API ikke kan returnere egendefinerte felt. Som et alternativ kan Data Prep opprette transformasjoner som etterligner logikken til et Netsuite-tilpasset felt.

Forbindelser

Hvis tilkoblingen til NetSuite mislykkes:

• Kontroller konto-ID-en som er angitt for kontakten. Hvis du vil vise konto-ID-en i NetSuite, velger du Setup, Integrations, Web Services Preferences. ID-en vises også vanligvis rett før app.netsuite.com i URL-adressen.
• Verifiser brukernøkkelen og hemmeligheten til kontaktens integrasjonspost. Rediger om nødvendig integrasjonsposten og tilbakestill legitimasjonen for å opprette en ny brukernøkkel og -hemmelighet.
• Bekreft ID-en og hemmeligheten til kontaktens tilgangstoken. Opprett om nødvendig et nytt token for kontakten.