Centro assistenza di Workiva

Con il connettore NetSuite® Token Authentication, puoi utilizzare i comandi in catena per interagire con NetSuite. Ad esempio, con questo connettore puoi:

• Scaricare i file da NetSuite
• Elencare le ricerche salvate in NetSuite
• Recuperare i dati relativi a un record NetSuite standard o a una ricerca salvata

Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.

Prerequisiti

Per attivare la connessione, il connettore utilizza l'API REST di NetSuite. Per configurare il connettore, avrai bisogno di:

• NetSuite, con l'autenticazione basata su token (TBA) abilitata
• L'ID dell'account NetSuite a cui connettersi

  Nota: Per visualizzare l'ID del tuo account in NetSuite, seleziona Impostazione, Integrazioni, Preferenze servizi Web. L'ID compare di solito anche nella prima stringa dell'URL, subito prima di app.netsuite.com.

• Un record di integrazione e un token di accesso creati in NetSuite per il connettore
• La chiave e il segreto del consumatore del record di integrazione

  Nota: Se non disponi del segreto o della chiave del consumatore, modifica il record di integrazione e reimposta le credenziali.

• L'ID e il segreto del token di accesso. Se non hai l'ID o la password del token di accesso, dovrai creare un nuovo token.

Nota: Per interagire con una RESTlet di NetSuite utilizzando l'autenticazione OAuth 2.0, utilizza invece un connettore HTTP Request.

Abilita l'integrazione in NetSuite

Per poter interagire con NetSuite, il connettore richiede l'autenticazione basata su token (TBA) e il proprio record di integrazione.

Passo 1. Abilita i servizi web SOAP e l'autenticazione basata su token

Per abilitare i servizi web SOAP e TBA per NetSuite:

1. In NetSuite, seleziona Impostazione, Azienda, Abilita funzionalità.
2. Nella scheda SuiteCloud , alla voce SuiteScript, seleziona Client SuiteScript e Server SuiteScript.
   
3. In SuiteTalk (Servizi Web), seleziona Servizi Web SOAP.
   
4. In Gestisci l'autenticazione, seleziona Autenticazione basata su token.
5. Clicca su Salva.

Passo 2. Crea un record di integrazione

Dopo aver abilitato la TBA, crea un record di integrazione per il connettore:

1. In NetSuite, seleziona Impostazione, Integrazioni, Gestisci integrazioni, Nuova.
2. Per identificare l'integrazione, inserisci un nome e una descrizione univoci, ad esempio Integrazione Workiva.
   
3. In Autenticazione, seleziona Autenticazione basata su token e deseleziona TBA: Flusso di autorizzazione.
4. Clicca su Salva e registra la chiave e il segreto del consumatore dalla pagina di conferma.

Nota: La chiave e il segreto del consumatore appaiono solo nella pagina di conferma del record di integrazione. Assicurati di registrare questi valori per le proprietà del connettore e di trattarli come una password.

Passo 3. Crea un ruolo di integrazione

Per motivi di sicurezza, crea un ruolo dedicato in NetSuite per gestire le tue integrazioni:

1. Seleziona Impostazione, Utenti/Ruoli, Gestisci ruoli, Nuovo.
   
2. In Generale, inserisci un nome unico per identificare il ruolo, ad esempio Integrazione Workiva/NetSuite.
3. In Autenticazione, seleziona Ruolo solo per servizi web per abilitare il ruolo a connettersi solo all'API di NetSuite e non accedere direttamente a NetSuite.
4. Alla voce Permessi, aggiungi i permessi per abilitare l'integrazione, come ad esempio i permessi di livello completo per tutte le Transazioni, i Report e gli Elenchi di NetSuite.
5. Nella scheda Impostazione, alla voce Permessi, aggiungi i permessi di livello completo per:
   
   • Servizi web SOAP
   • Creare un'azienda
   • Autenticazione basata su token:
     • Per abilitare il ruolo all'autenticazione solo attraverso i token di accesso, Accedi utilizzando i token di accesso
     • Per consentire al ruolo di creare e revocare i propri token di accesso, Token di accesso utente
       
     
6. Clicca su Salva.

Passo 4. Assegna il ruolo all'utente dell'integrazione

Dopo aver creato il ruolo di integrazione, assegnalo all'utente di integrazione del connettore:

1. In NetSuite, seleziona Impostazione, Utenti/Ruoli, Gestisci utenti.
2. Seleziona o crea l'utente di integrazione per il connettore.
   

   Nota: Si consiglia di creare un utente separato per ogni connettore o integrazione.

3. In Ruoli, assegna il ruolo di integrazione all'utente.

Passo 5. Crea il token di accesso dell'utente dell'integrazione

Per creare un token di accesso per l'utente dell'integrazione:

1. In NetSuite, seleziona Impostazione, Utenti/Ruoli, Token di accesso, Nuovo.
2. Clicca su Nuovo token di accesso.
   
3. In Nome dell'applicazione, seleziona il record di integrazione.
4. In Utente, seleziona l'utente dell'integrazione.
5. In Ruolo, seleziona il ruolo di integrazione.
6. Clicca su Salva.
7. Prendi nota dell'ID e del segreto creati per il token; ti serviranno per le proprietà del connettore.

   Nota: Per motivi di sicurezza, l'ID e il segreto appaiono solo quando viene creato il token di accesso. Trattali come se fossero una password. Se non disponi dell'ID o del segreto del token per le proprietà del connettore, crea un nuovo token per l'utente dell'integrazione.

Configura il connettore di autenticazione Token di NetSuite

Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.

1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
2. Sotto Connector Connection, seleziona NetSuite Token Authentication e il CloudRunner predefinito.
   
3. Inserisci un nome e una descrizione unici per identificare la connessione.
4. In Proprietà, inserisci i dettagli della connessione:
   
   

   Proprietà	Dettagli
   ID account	Inserisci l'ID dell'account NetSuite a cui collegarti.
   Chiave del consumatore	Inserisci la chiave del consumatore per il record di integrazione del connettore.
   Segreto del consumatore	Inserisci il segreto per la proprietà Chiave del consumatore.
   ID token	Inserisci l'ID del token di accesso del connettore.
   Segreto token	Inserisci il segreto per la proprietà ID token.
   Sandbox	Per connetterti a un account NetSuite sandbox, seleziona questa casella.

   Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.

5. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
6. Per testare la connessione, crea ed esegui una catena con il comando Elenca ricerche salvate del connettore e verifica che restituisca un output valido.

Risoluzione dei problemi

Campi personalizzati

Tieni presente che l'API di NetSuite non può restituire campi personalizzati. In alternativa, Data Prep può creare trasformazioni che imitano la logica di un campo personalizzato di Netsuite.

Connessioni

Se la connessione a NetSuite fallisce:

• Controlla l'ID dell'account inserito per il connettore. Per visualizzare l'ID dell'account in NetSuite, seleziona Impostazione, Integrazioni, Preferenze servizi Web. L'ID compare di solito anche prima di app.netsuite.com nell'URL.
• Verifica la chiave del consumatore e il segreto del record di integrazione del connettore. Se necessario, modifica il record di integrazione e reimposta le sue credenziali per creare una nuova chiave e un nuovo segreto del consumatore.
• Verifica l'ID e il segreto del token di accesso del connettore. Se necessario, crea un nuovo token per il connettore.