Configuration

Introduction

Pour établir avec succès une connexion et envoyer des requêtes à l'API ServiceNow, l'activité Étendue ServiceNow a besoin d'une URL de point de terminaison pour votre locataire ServiceNow (URL du point de terminaison), d'un nom d' utilisateur et d'un mot de passe (Mot de passe). 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, il a besoin de votre ID de client d'instance ServiceNow, de la clé secrète du client et de l'URL du point de terminaison.

If you choose to use OAuth, you must give the ServiceNow Scope activity the ability to retrieve the OAuth access token and enable the other activities to successfully send requests to the ServiceNow API, you must complete the following steps:

1. Configurez OAuth.

2. Créer des ressources d'identifiants.

3. Créez votre projet.

   

Configurer OAuth

Suivez les étapes de configuration OAuth dans la documentation 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, AD, New York, etc.)

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

Remarque :

Si vous configurez déjà OAuth pour votre instance ServiceNow, notez l' ID client et le secret client attribués à votre registre d'application et passez à l'étape 2. Créer des ressources d'informations d'identification .

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

2. Go to System Definitions > Plugins and verify the OAuth plugin Status is set to Active.

   

3. Go to System OAuth > Application Registry and click New.

   • When asked What kind of OAuth application?, click Create an OAuth API endpoint for external clients.

     

4. Enter a Name for your application (e.g., UiPathQuickstart) and click Submit (if successful, you are redirected back to your Application Registries list).

   

5. In the Application Registries list, find your new application and click on its Name to open the details page.

6. Click on the lock icon next to Client Secret to show the value.

7. Take note of the Client Id and Client Secret values (you'll enter these in the ServiceNow Scope activity).

   

8. Si vous souhaitez que cette application OAuth prenne en charge OAuth2, vous devez définir l’ URL de redirection 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 l’étendue de l’application ServiceNow, 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 nécessite des entrées SecureString pour vos informations d'identification ServiceNow (Mot de passe et CléSecrèteClient). Pour générer les variables SecureString , il est recommandé de créer deux ressources d'informations d’identification dans votre locataire Orchestrator.

1. Connectez-vous au locataire Orchestrator que vous souhaitez utiliser pour votre projet.

2. In the left-hand navigation, click Assets (this opens the Assets page).

3. Click the + icon to create a new Asset (this opens the Create Asset window).

   

4. Enter a Name and select Credential under Type.

5. In the Username field, enter the ClientId of your ServiceNow application registry.

6. In the Password field, enter the ClientSecret of your ServiceNow application registry.

7. Cliquez sur Créer (Create).

   

8. Repeat steps 3-7 to create another Asset for your ServiceNow Username and Password.

   

Construisez votre projet

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

   1. Open UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Enter a project Name, Location, and Description.

   4. Cliquez sur Créer (Create).

      

2. Install the UiPath.ServiceNowActivities package.
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Beta
   3. In the Search bar, enter ServiceNow.
   4. Click, install and accept the license for the UiPath.ServiceNow.Activities.
      • Pour plus d’informations sur les packages Uipath Studio, consultez la section 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 de ServiceNow et vous familiariser avec les propriétés d’entrée/de sortie.

Pour en savoir plus sur les activités ServiceNow, consultez la page Activités pour obtenir une liste complète des activités et des liens vers les pages de détails de l'activité.