Configurer le Oracle spoke NetSuite

Configurez votre instance et Oracle votre ServiceNow application NetSuite de manière à ce qu’elles soient intégrées.

Avant de commencer

• Demandez un Centre d'intégration abonnement.
• Activez le spoke Oracle NetSuite.
• Rôle requis : admin

Configurer OAuth 2.0 dans Oracle NetSuite

Configurez un profil OAuth 2.0 sur Oracle NetSuite qui permet l’intégration entre celui-ci et l’instance ServiceNow via le cadre de travail OAuth 2.0.

Avant de commencer

Rôle requis : admin

Procédure

1. Connectez-vous à Oracle NetSuite.
2. Accédez à la Configuration > Intégration > Gérer les intégrations.
3. Sélectionnez Nouveau.
4. Remplissez le formulaire.

   Tableau 1. Formulaire OAuth 2.0

   Champ	Description
   Nom	Option permettant de saisir un nom unique pour le profil d’intégration OAuth.
   Description	Option permettant de saisir une description du profil d’intégration OAuth.
   Octroi du code d’autorisation	Option permettant d’indiquer le flux que l’instance ServiceNow utilisera pour accéder à Oracle NetSuite.
   URI de redirection	Option permettant d’entrer l’URI de redirection de l’instance ServiceNow au format : https://<instancename>.service-now.com/oauth_rediect.do.
   Services Web REST	Option permettant d’indiquer le champ d’application.

5. Sélectionnez Enregistrer.
   L’ID client et le secret client sont générés.
6. Copiez et stockez l’ID et le secret client dans un endroit sûr.
   Vous aurez besoin de l’ID client et du secret client lorsque vous configurerez l’alias de connexion et d’informations d’identification sur votre instance ServiceNow.

Charger l’ensemble de mises à jour

Chargez et validez l’ensemble de mises à jour dans votre ServiceNow instance pour déployer un include de script appelé OAuthCustomOracleNetsuitGlobal sur l’instance ServiceNow.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Le script OAuthCustomOracleNetsuitGlobal dans l’ensemble de mises à jour contient des méthodes pour les connexions Oracle OAuth, conçues spécifiquement pour Oracle l’intégration de NetSuite. Vous pouvez charger et valider l’ensemble de mises à jour sur les instances ServiceNow et leur permettre de gérer Oracle l’intégration NetSuite.

Procédure

1. À partir de la page de spoke Oracle NetSuite sur ServiceNow Store, téléchargez l’ensemble de mises à jour OAuthCustomOracleNetsuitGlobal sur votre disque local.
2. Accédez à la Ensembles de mises à jour système > Ensembles de mises à jour récupérés.
3. Sous Liens connexes, sélectionnez Importer un ensemble de mises à jour à partir de XML.
4. Sélectionnez Choisir un fichier , puis accédez à l’emplacement de l’ensemble de mises à jour OAuthCustomOracleNetsuitGlobal .
5. Sélectionnez Charger.
6. Sélectionnez Valider l’ensemble de mises à jour.
   Le script OAuthCustomOracleNetsuitGlobal est déployé dans l’instance ServiceNow.

Configurer un enregistrement de connexion pour Oracle NetSuite

Configurez un enregistrement de connexion entre votre ServiceNow instance et Oracle NetSuite. L’enregistrement stocke de manière centralisée les informations d’identification, les jetons OAuth, l’ID client et le secret client, et constitue une connexion réutilisable entre les flux.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tous > Automatisation des processus > Studio de workflow.
2. Facultatif : Fermez la notification, si elle apparaît.
   
3. Sélectionnez Intégrations.
4. Sélectionnez l’onglet Connexions .
5. Dans le champ Rechercher toutes les connexions, saisissez Oracle NetSuite.
   Si l’onglet sortant est sélectionné par défaut, vous pouvez effectuer cette étape. Si elle n’est pas sélectionnée, confirmez que vous l’avez sélectionnée.
6. Sur la carte Oracle NetSuite, sélectionnez Afficher les détails.
   
7. Sélectionnez Configurer.
   
8. Remplissez le formulaire.

   Tableau 2. Formulaire Configurer la connexion

   Champ	Description
   Nom de la connexion	Option permettant de fournir un nom unique à l’enregistrement de connexion.
   URL de connexion	Option permettant de fournir l’URL de l’API de base de l’application tierce à laquelle votre ServiceNow instance se connecte.
   Nom de l’entité OAuth	Option permettant de fournir le nom de l’enregistrement de configuration de l’entité OAuth dans ServiceNow.
   ID client OAuth	Option permettant de fournir l’ID client OAuth que vous avez généré précédemment.
   Secret client OAuth	Option permettant de fournir le secret client OAuth que vous avez généré précédemment.
   Script de l'API OAuth	Option permettant de fournir un include ServiceNow de script facultatif permettant de personnaliser le flux OAuth. Vous devez sélectionner le script OAuthCustomOracleNetsuitGlobal que vous avez téléchargé.
   URL de redirection OAuth	Option permettant d’entrer l’URI de redirection de l’instance ServiceNow au format : https://<instancename>.service-now.com/oauth_rediect.do.
   URL d’autorisation OAuth	Option permettant de fournir l’URL du serveur d’autorisation d’Oracle NetSuite.
   URL du jeton OAuth	Option permettant de fournir le point de terminaison qui émet les jetons d’accès après autorisation.

9. Sélectionnez Configurer et obtenir le jeton OAuth.
   Le jeton d’accès OAuth est généré pour le spoke Oracle NetSuite.

   Remarque :

   Vous devez vous connecter à Oracle NetSuite avant que le jeton d’accès OAuth ne soit accordé.

   

Générer un jeton d’authentification de webhook

Générez un jeton d’authentification qui permet Oracle aux demandes NetSuite adressées à votre ServiceNow instance d’être authentifiées. Les demandes contiennent des événements qui se produisent dans NetSuite Oracle en temps réel. Par exemple, Oracle NetSuite envoie une notification lorsqu’un enregistrement client est créé.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Important :

Ignorez cette procédure si vous n’avez pas besoin de lancer un appel entrant de Oracle NetSuite vers ServiceNow.

Oracle NetSuite Webhook, un exemple d’API REST scriptée préconfiguré, est disponible sur votre ServiceNow instance. Il écoute les événements qui se produisent sur NetSuite Oracle en temps réel et consigne l’état des événements comme réussite ou échec dans votre instance ServiceNow. Pour activer l’authentification des événements qu’Oracle NetSuite envoie à l’API REST scriptée, vous devez générer un jeton d’authentification dans le registre de webhook Oracle NetSuite. Le jeton est inclus dans le webhook envoyé Oracle par NetSuite.

Pour accéder au webhook, accédez à Tous>Services Web du système> Services Web scriptés>API REST scriptées, dans le champ Nom, saisissez Webhook Oracle NetSuite, puis appuyez sur Entrée.

Procédure

1. Accédez à la Tous > Oracle Netsuite Spoke > Registre Webhook.
2. Sélectionnez Nouveau.
3. Remplissez le formulaire.

   Tableau 3. Registre de webhook Oracle Netsuite

   Champ	Description
   Numéro de compte Oracle Netsuite	Option permettant de saisir le numéro de compte fourni par Oracle NetSuite.
   Nom d'objet	Option permettant de fournir le type de l’objet dans Oracle NetSuite qu’il inclut dans le webhook. Par exemple, client.
   Jetons d'authentification	Option permettant de générer le jeton d’authentification qu’Oracle NetSuite utilise pour que ses demandes soient authentifiées sur votre ServiceNow instance. Le jeton est généré une fois que vous avez sélectionné Générer un jeton d’authentification.
   Description	Option permettant de saisir une description du webhook.

4. Sélectionnez Générer un jeton d’authentification.
   Le jeton d’authentification est généré.

   

5. Copiez et stockez le jeton d’authentification dans un endroit sûr.
6. Sélectionnez Mettre à jour.
   Le webhook est enregistré dans le registre webhook.

   

Déployer SuiteScript dans Oracle NetSuite

Déployez un SuiteScript qui permet à NetSuite Oracle d’envoyer des détails d’événements en temps réel à l’API scriptée de votre ServiceNow instance à l’aide du webhook.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Important :

Ignorez cette procédure si vous n’avez pas besoin de lancer un appel entrant de Oracle NetSuite vers ServiceNow.

ServiceNow fournit un exemple de SuiteScript préconfiguré que vous pouvez mettre à jour et permettre à Oracle NetSuite d’envoyer des événements en temps réel à l’API scriptée dans votre instance ServiceNow. Vous mettez à jour le script SuiteScript en fournissant le jeton d’authentification que vous avez généré, l’URL Webhook ServiceNow, l’objet et le numéro de Oracle compte NetSuite aux emplacements appropriés dans le script NetSuite. Après avoir configuré l’exemple de script NetSuite, vous devez le déployer sur l’application Oracle NetSuite afin qu’elle puisse envoyer des événements à l’API scriptée dans votre instance ServiceNow.

Procédure

1. À partir de la page de spoke Oracle NetSuite sur ServiceNow Store, téléchargez le fichier servicenow_webhook_call.js sur votre disque local.
2. Connectez-vous à Oracle NetSuite.
3. Accédez à la Personnalisation > Écriture de scripts > Scripts > Nouveau.
4. Sélectionnez Nouveau script.
   
5. Placez le pointeur sur le champ Fichier de script et cliquez sur l’icône plus (« + »)
   
6. Remplissez le formulaire.

   Tableau 4. Table de fichiers

   Champ	Description
   Joindre à partir de	Option permettant d’indiquer l’emplacement à partir duquel vous joindrez le SuiteScript.
   Nom du fichier	Option permettant de fournir le nom du fichier SuiteScript. Important : Vous devez fournir l’extension (.js) du fichier SuiteScript avec son nom.
   Dossier	Option permettant de fournir le nom du dossier qui contient le fichier SuiteScript.
   Sélectionner un fichier	Option permettant de sélectionner le fichier SuiteScript.

   

7. Sélectionnez Enregistrer.
8. Sélectionnez Créer un enregistrement de script.
   
9. Dans le champ Nom, saisissez un nom unique.
   Par exemple, servicenow_webhook_call_customer.
10. Fournissez un format d’ID avec des traits de soulignement.
    Par exemple, _servicenow_webhook_call_cus
11. Sélectionnez Enregistrer.
    
    L’écran d’enregistrement de script s’affiche.
12. Sélectionnez Déployer le script.
    
13. Sur la page Déploiement de script, saisissez le nom de l’objet dans le champ S’applique à.
    Exemple d’un objet : Client.
14. Entrez l’ID que vous avez déjà créé précédemment dans la procédure.
15. Entrez les informations dans les autres champs, selon vos besoins.
16. Sélectionnez Enregistrer.
    Le script NetSuite est déployé.