Configuration

Introduction

Pour établir avec succès une connexion et envoyer des requêtes à l'API ServiceNow, l'activité Étendue ServiceNow (ServiceNow Scope) a besoin d'une URL de point de terminaison pour votre locataire ServiceNow (Endpoint URL), d'un nom d'utilisateur (UserName) et d'un mot de passe (Password). Vous pouvez éventuellement récupérer un jeton d'accès OAuth auprès de votre locataire ServiceNow. Pour récupérer le jeton d'accès OAuth, vous avez besoin de l'ID de client de votre instance ServiceNow, de la clé secrète du client et de l'URL du point de terminaison.

Si vous choisissez d'utiliser OAuth, vous devez donner à l'activité Étendue ServiceNow la possibilité de récupérer le jeton d'accès OAuth et permettre aux autres activités d'envoyer avec succès des requêtes à l'API ServiceNow. Vous devez suivre les étapes suivantes :

1. Configurez OAuth.
2. Créer des ressources d'identifiants.
3. Créez votre projet.
   
   

   

   
   

Configurer OAuth

Suivez les étapes de Configuration d'OAuth dans la documentation de ServiceNow. Bien que les étapes documentées soient probablement les mêmes dans toutes les régions de la plate-forme ServiceNow, il est recommandé de suivre les étapes de votre région spécifique en cas de différences (par exemple, Modern, New York, etc.)

Pour référence, voici comment nous configurons OAuth pour nos exemples.

Remarque : si vous avez déjà configuré OAuth pour votre instance de ServiceNow, notez l ' ID client et la clé secrète du client attribués à votre registre d'applications et passez à l'étape 2. Créer des ressources d'identification.

1. Connectez-vous à votre instance ServiceNow (par exemple, https://dev74293.service-now.com/login)

2. Accédez à Définitions du système ( System Definitions) > Plugins (Plugins) et vérifiez que le statut du plug-in OAuth est défini sur Actif(Active).

   
   

   

   
   

3. Accédez à Système OAuth > Registre d'applications (Application Registry) et cliquez sur Nouveau (New).

   • Lorsqu'on lui a demandé Quel type d'application OAuth ?, cliquez sur Créer un point de terminaison d'API OAuth pour les clients externes.

     
     

     

     
     

4. Saisissez un nom pour votre application (par exemple, UiPathQuickstart) et cliquez sur Soumettre (En cas de réussite, vous êtes redirigé vers votre liste de registres d'applications ).

   
   

   

   
   
5. Dans la liste Registres d'applications ( Application Registries ), recherchez votre nouvelle application et cliquez sur son nom pour ouvrir la page de détails.
6. Cliquez sur l'icône de verrouillage à côté de Clé secrète du client (Client Secret) pour afficher la valeur.

7. Prenez note des valeurs ID du client ( Client Id ) et Clé secrète du client (Client Secret) (vous les saisirez dans l'activité Étendue de ServiceNow ).

   
   

   

   
   
8. Si vous souhaitez que cette application OAuth prenne en charge OAuth2, vous devez définir l' URL de redirection ( Redirect URL ) sur http://127.0.0.1:10001/authorize/.
   Important :

   À partir de la version v1.3.8, nous avons ajouté la prise en charge du port local. Le paramètre Port local , disponible dans Étendue d'application ServiceNow ( ServiceNow Application Scope), est facultatif et configurable. Par défaut, sa valeur est définie sur 10001 (par exemple, http://127.0.0.1:10001/authorize/). Lorsque vous configurez votre application OAuth, définissez l' URL de redirection sur : http://127.0.0.1:{LocalPort}/authorize/. Par exemple, pour le port local 10002, l' URL de redirection serait http://127.0.0.1:10002/authorize/. Il n’est pas conseillé de modifier le port local dans le même projet. Si le port change, créez un nouveau projet ou workflow pour éviter les erreurs de mise en cache, le cas échéant.
   
   

   

   
   

Créer des ressources d'identification

L'activité Étendue ServiceNow ( ServiceNow Scope ) nécessite des entrées SecureString pour vos informations d'identification ServiceNow ( Mot de passe (Password ) et CléSecrèteClient(ClientSecret))). Pour générer les variables SecureString , il est recommandé de créer deux actifs d'informations d'identification dans votre locataire Orchestrator.

1. Connectez-vous au locataire Orchestrator que vous souhaitez utiliser pour votre projet.
2. Dans la navigation de gauche, cliquez sur Ressources ( Assets ) (cela ouvre la page Ressources (Assets)).

3. Cliquez sur l'icône + pour créer un nouvel actif (cela ouvre la fenêtre Créer un actif ( Create Asset )).

   
   

   

   
   
4. Entrez un nom et sélectionnez Informations d'identification sous Type.
5. Dans le champ Nom d'utilisateur (Username), saisissez le ClientId de votre registre d'applications ServiceNow.
6. Dans le champ Mot de passe (Password), entrez le ClientSecret de votre registre d'applications ServiceNow.

7. Cliquez sur Créer (Create).

   
   

   

   
   

8. Répétez les étapes 3 à 7 pour créer une autre ressource pour votre nom d' utilisateur et votre mot de passe ServiceNow .

   
   

   

   
   

Construisez votre projet

1. Créez un nouveau projet d'automatisation.

   1. Ouvrez UiPath Studio.
   2. Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
   3. Saisissez un nomde projet , un emplacementet une description.

   4. Cliquez sur Créer (Create).

      
      

      

      
      

2. Installez le package UiPath.ServiceNowActivities .

   1. Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
   2. Sous Tous les packages, cliquez sur Bêta
   3. Dans la barre de recherche , entrez ServiceNow.

   4. Cliquez sur, installez et acceptez la licence pour UiPath.ServiceNow.Activities.

      • Pour plus d'informations sur les packages Uipath Studio, consultez Gestion des packages dans le Guide de Studio.

Vous avez terminé !

Maintenant que vous avez terminé la configuration, vous pouvez commencer à ajouter les activités ServiceNow à votre projet.

Prochaines étapes

Pour une expérience d'apprentissage pratique et pour commencer rapidement à utiliser les activités, consultez le guide de démarrage rapide . Ce guide fournit des instructions étape par étape pour vous aider à créer un exemple pratique des différentes activités afin que vous puissiez vérifier la connexion à votre instance ServiceNow et vous familiariser avec les propriétés d'entrée/de sortie.

Pour en savoir plus sur les activités ServiceNow (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.