Med NetSuite® Token Authentication Connector kan du använda kommandon i kedjan för att interagera med NetSuite. Med den här kontakten kan du t.ex:
- Hämta filer från NetSuite
- Lista sparade sökningar i NetSuite
- Hämta data om en standardpost eller sparad sökning i NetSuite
Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.
Förkunskapskrav
För att aktivera anslutningen använder connectorn NetSuite REST API. För att sätta upp kontakten behöver du:
- NetSuite, med tokenbaserad autentisering (TBA) aktiverad
- ID för det NetSuite-konto som du vill ansluta till
Obs: Om du vill visa ditt konto-ID i NetSuite väljer du Setup, Integrations, Web Services Preferences. ID:t visas också vanligtvis i den första strängen i URL:en, precis före
app.netsuite.com. - En integrationspost och åtkomsttoken som skapats i NetSuite för anslutningen
- Integrationspostens konsumentnyckel och hemlighet
Obs: Om du inte har konsumenthemligheten eller nyckeln redigerar du integrationsposten och återställer dess autentiseringsuppgifter.
- Åtkomstens ID och hemlighet. Om du inte har ID eller lösenord för åtkomst-token måste du skapa en ny token.
Obs: Om du vill interagera med en NetSuite RESTlet med OAuth 2.0-autentisering använder du en HTTP Request connector istället.
Aktivera integrationen i NetSuite
För att connectorn ska kunna interagera med NetSuite krävs TBA (token-based authentication) och en egen post för integration.
Steg 1. Aktivera SOAP-webbtjänster och tokenbaserad autentisering
För att aktivera SOAP-webbtjänster och TBA för NetSuite:
- I NetSuite väljer du Setup, Company, Enable features.
- På fliken SuiteCloud , under SuiteScript, väljer du Client SuiteScript och Server SuiteScript.
- Under SuiteTalk (Web Services) väljer du SOAP web services.
- Under Hantera autentisering väljer du Tokenbaserad autentisering.
- Klicka på Spara.
Steg 2. Skapa en post för integration
När du har aktiverat TBA skapar du en integrationspost för kontakten:
- I NetSuite väljer du Setup, Integrations, Manage integrations, New.
- För att identifiera integrationen anger du ett unikt namn och en beskrivning, t.ex. Workiva Integration.
- Under Authentication, välj Token-based authentication, och avmarkera TBA: Auktoriseringsflöde.
- Klicka på Spara, och posta konsumentnyckeln och hemligheten från bekräftelsesidan.
Obs: Konsumentens nyckel och hemlighet visas endast på bekräftelsesidan för integrationsposten. Var noga med att posta dessa värden för kontaktens egenskaper och behandla dem som ett lösenord.
Steg 3. Skapa en integrationsroll
Av säkerhetsskäl bör du skapa en särskild roll i NetSuite för att hantera dina integrationer:
- Välj Setup, Users/Roles, Manage roles, New.
- Under General anger du ett unikt namn som hjälper dig att identifiera rollen, t.ex. Workiva/NetSuite Integration.
- Under Authentication väljer du Web services only role för att aktivera rollen så att den endast kan ansluta till NetSuite API och inte logga in direkt i NetSuite.
- Under Behörigheter, lägger du till behörigheterna för att aktivera integrationen, t.ex. fullständig behörighet till alla relevanta Transaktioner, Rapporter och Listor i NetSuite.
- På fliken Setup under Permissions lägger du till Full level permissions for:
- SOAP-webbtjänster
- Starta företag
- Tokenbaserad autentisering:
- För att aktivera rollen att endast autentisera via åtkomsttokens, Logga in med hjälp av åtkomsttokens
- För att rollen ska kunna skapa och återkalla sina egna åtkomsttokens, Användarens åtkomsttokens
- Klicka på Spara.
Steg 4. Tilldela rollen till integrationsanvändaren
När du har skapat en integrationsroll ska du tilldela den till connectorens integrationsanvändare:
- I NetSuite väljer du Setup, Users/Roles, Manage users.
- Välj eller skapa integrationsanvändaren för anslutningen.
Obs: Vi rekommenderar en separat användare för varje anslutning eller integration.
- Under Roles, tilldela användaren integrationsrollen.
Steg 5. Skapa åtkomst till integrationsanvändarens token
För att skapa en åtkomst token för integrationsanvändaren:
- I NetSuite väljer du Setup, Users/Roles, Access tokens, New.
- Klicka på Ny åtkomst.
- I Application name väljer du integrationsposten.
- I User väljer du integrationsanvändaren.
- I Role väljer du integrationsrollen.
- Klicka på Spara.
- Notera det ID och den hemlighet som skapats för token
Obs: Av säkerhetsskäl visas ID och hemlighet endast när åtkomsttoken skapas. Behandla dem som du skulle behandla ett lösenord. Om du inte har token-ID:t eller hemligheten för connector-egenskaperna skapar du en ny token för integrationsanvändaren.
Konfigurera NetSuite Token Authentication-anslutningen
Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connection väljer du NetSuite Token Authentication och standard CloudRunner.
- Ange ett unikt namn och en beskrivning som hjälper till att identifiera anslutningen.
- Under Properties anger du information om anslutningen:
Egenskap Information Konto ID Ange ID för det NetSuite-konto som du vill ansluta till. Konsumentnyckel Ange konsumentnyckeln för anslutningens integrationspost. Konsumenternas hemlighet Ange hemligheten för Consumer Key egendom. Token-ID Ange ID för kontaktpersonens åtkomst-token. Token hemlighet Ange hemligheten för egenskapen Token ID. Sandlåda Markera den här rutan om du vill ansluta till ett NetSuite-konto i sandlådan. Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.
- Välj de miljöer som ska använda anslutningen och klicka på Save.
- Testa anslutningen genom att skapa och köra en kedja med -anslutningens List Saved Searches kommando, och kontrollera att den returnerar en giltig utdata.
Felsökning
Anpassade fält
Observera att NetSuite API inte kan returnera anpassade fält. Som ett alternativ kan Data Prep skapa transformationer som efterliknar logiken i ett anpassat fält i Netsuite.
Anslutningar
Om anslutningen till NetSuite går fel:
- Kontrollera det konto-ID som angetts för anslutningen. Om du vill visa konto-ID i NetSuite väljer du Setup, Integrations, Web Services Preferences. ID:t brukar också visas precis före
app.netsuite.comi URL:en. - Verifiera konsumentnyckeln och hemligheten för anslutningens integrationspost. Om det behövs kan du redigera integrationsposten och återställa dess autentiseringsuppgifter för att skapa en ny konsumentnyckel och hemlighet.
- Verifiera ID och hemlighet för kontaktpersonens åtkomst. Om det behövs skapar du en ny token för kontakten.