Avec le connecteur NetSuite® Token Authentication, vous pouvez utiliser les commandes en chaîne pour interagir avec NetSuite. Par exemple, avec ce connecteur, vous pouvez :
- Télécharger des fichiers depuis NetSuite
- Liste des recherches sauvegardées dans NetSuite
- Récupérer les données d'un enregistrement NetSuite standard ou d'une recherche sauvegardée
Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.
Conditions préalables
Pour activer la connexion, le connecteur utilise l'API REST de NetSuite. Pour configurer le connecteur, vous aurez besoin de :
- NetSuite, avec authentification par jeton (TBA) activée
- L'ID du compte NetSuite auquel se connecter
Note : Pour afficher l'ID de votre compte dans NetSuite, sélectionnez Setup, Integrations, Web Services Preferences. L'ID apparaît aussi généralement dans la première chaîne de l'URL, juste avant
app.netsuite.com. - Un enregistrement d'intégration et un jeton d'accès créés dans NetSuite pour le connecteur.
- Clé et secret du consommateur de l'enregistrement d'intégration
Note : Si vous n'avez pas le secret ou la clé du consommateur, modifiez l'enregistrement d'intégration et réinitialisez ses informations d'identification.
- L'identifiant et le secret du jeton d'accès. Si vous ne disposez pas de l'identifiant ou du mot de passe du jeton d'accès, vous devez créer un nouveau jeton.
Remarque : Pour interagir avec une NetSuite RESTlet en utilisant l'authentification OAuth 2.0, utilisez plutôt un connecteur de requête HTTP.
Activer l'intégration dans NetSuite
Pour permettre au connecteur d'interagir avec NetSuite, il a besoin de token-based authentication (TBA) et de son propre enregistrement d'intégration.
Étape 1. Activer les services web SOAP et l'authentification par jeton
Pour activer les services web SOAP et TBA pour NetSuite :
- Dans NetSuite, sélectionnez Setup, Company, Enable features.
- Dans l'onglet SuiteCloud , sous SuiteScript, sélectionnez Client SuiteScript et Server SuiteScript.
- Sous SuiteTalk (Web Services), sélectionnez SOAP web services.
- Sous Manage authentication, sélectionnez Token-based authentication.
- Cliquez sur Enregistrer.
Étape 2. Créer un enregistrement d'intégration
Après avoir activé TBA, créez un enregistrement d'intégration pour le connecteur :
- Dans NetSuite, sélectionnez Setup, Integrations, Manage integrations, New.
- Pour faciliter l'identification de l'intégration, saisissez un nom et une description uniques, tels que Workiva Integration.
- Sous Authentication, sélectionnez Token-based authentication, et décochez TBA : Flux d'autorisation.
- Cliquez sur Save, et enregistrez la clé et le secret du consommateur à partir de la page de confirmation.
Remarque : La clé et le secret du consommateur apparaissent uniquement sur la page de confirmation de l'enregistrement d'intégration. Veillez à enregistrer ces valeurs dans les propriétés du connecteur et traitez-les comme un mot de passe.
Étape 3. Créer un rôle d'intégration
Pour des raisons de sécurité, créez un rôle dédié dans NetSuite pour gérer vos intégrations :
- Sélectionnez Setup, Users/Roles, Manage roles, New.
- Sous General, saisissez un nom unique pour aider à identifier le rôle, par exemple Workiva/NetSuite Integration.
- Sous Authentication, sélectionnez Web services only role pour permettre au rôle de se connecter uniquement à l'API NetSuite, et ne pas se connecter directement à NetSuite.
- Sous Permissions, ajoutez les permissions pour activer l'intégration, telles que les permissions de plein niveau pour toutes les Transactions, Rapports, et Listes pertinentes dans NetSuite.
- Dans l'onglet Setup sous Permissions, ajoutez les autorisations de plein niveau pour :
- Services web SOAP
- Création d'une entreprise
- Authentification par jeton :
- Pour permettre au rôle de s'authentifier uniquement via des jetons d'accès, Connexion à l'aide de jetons d'accès
- Pour permettre au rôle de créer et de révoquer ses propres jetons d'accès, Jetons d'accès utilisateur
- Cliquez sur Enregistrer.
Étape 4. Attribuer le rôle à l'utilisateur d'intégration
Après avoir créé le rôle d'intégration, attribuez-le à l'utilisateur d'intégration du connecteur :
- Dans NetSuite, sélectionnez Setup, Users/Roles, Manage users.
- Sélectionnez ou créez l'utilisateur d'intégration pour le connecteur.
Note : Nous recommandons un utilisateur distinct pour chaque connecteur ou intégration.
- Sous Roles, attribuez le rôle d'intégration à l'utilisateur.
Étape 5. Créer le jeton d'accès de l'utilisateur d'intégration
Pour créer un jeton d'accès pour l'utilisateur d'intégration :
- Dans NetSuite, sélectionnez Setup, Users/Roles, Access tokens, New.
- Cliquez sur Nouveau jeton d'accès.
- Dans Nom de l'application, sélectionnez l'enregistrement d'intégration.
- Dans User, sélectionnez l'utilisateur d'intégration.
- Dans Role, sélectionnez le rôle d'intégration.
- Cliquez sur Enregistrer.
- Notez l'ID et le secret créés pour le jeton ; vous en aurez besoin pour les propriétés du connecteur.
Note : Pour des raisons de sécurité, l'ID et le secret n'apparaissent que lors de la création du jeton d'accès. Traitez-les comme un mot de passe. Si vous ne disposez pas de l'ID ou du secret du jeton pour les propriétés du connecteur, créez un nouveau jeton pour l'utilisateur de l'intégration.
Configurer le connecteur NetSuite Token Authentication
Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.
- À partir du Générateur de chaînes, cliquez sur Connexions , puis sur Créer en haut à droite.
- Sous Connector Connection, sélectionnez NetSuite Token Authentication et le CloudRunner par défaut.
- Saisissez un nom et une description uniques pour identifier la connexion.
- Sous Propriétés, entrez les détails de la connexion :
Propriété Détails ID du compte Saisissez l'identifiant du compte NetSuite auquel vous souhaitez vous connecter. Clé du consommateur Saisissez la clé de consommation pour l'enregistrement d'intégration du connecteur. Le secret du consommateur Saisissez le secret de la propriété Consumer Key. ID du jeton Saisissez l'ID du jeton d'accès du connecteur. Jeton secret Saisissez le secret de la propriété Token ID. Bac à sable Pour vous connecter à un compte NetSuite de type "bac à sable", cochez cette case. Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256.
- Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
- Pour tester la connexion, créez et exécutez une chaîne avec la commande List Saved Searches du connecteur et vérifiez qu'elle renvoie une sortie valide.
Dépannage
Champs personnalisés
Veuillez noter que l'API de NetSuite ne peut pas renvoyer de champs personnalisés. Comme alternative, Data Prep peut créer des transformations qui imitent la logique d'un champ personnalisé Netsuite.
Connexions
Si la connexion à NetSuite échoue :
- Vérifier l'ID de compte saisi pour le connecteur. Pour afficher l'identifiant du compte dans NetSuite, sélectionnez Setup, Integrations, Web Services Preferences. L'ID apparaît généralement juste avant
app.netsuite.comdans l'URL. - Vérifier la clé du consommateur et le secret de l'enregistrement d'intégration du connecteur. Si nécessaire, modifiez l'enregistrement d'intégration et réinitialisez ses informations d'identification pour créer une nouvelle clé de consommateur et un nouveau secret.
- Vérifier l'ID et le secret du jeton d'accès du connecteur. Si nécessaire, créez un nouveau jeton pour le connecteur.