ServiceNow Application Scope

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

Conseil : bien que l’activité Étendue de l’application ServiceNow puisse utiliser l’authentification standard (Nomd’utilisateur ) et (Motde passe ), il est fortement recommandé d’utiliser la sécurité OAuth pour toutes vos connexions en suivant les étapes ci-dessous.

Les activités ServiceNow utilisent le protocole OAuth 1.0 pour établir une connexion authentifiée entre UiPath et votre instance ServiceNow. Cette connexion autorise un Robot à appeler les API ServiceNow et à accéder aux ressources en votre nom.

Pour activer l'autorisation, vous créez un point de terminaison d'application OAuth pour votre instance ServiceNow. La création de ce point de terminaison génère un enregistrement d'application client OAuth, un ID de client et une clé secrète du client pour activer l'accès authentifié à votre instance.

Après avoir créé votre point de terminaison, entrez vos informations d'identification ServiceNow ainsi que l'URL du point de terminaison de l'application, l'ID client et la clé secrète du client dans l'activité Étendue de l'application ServiceNow .

Astuce :

Les rôles d'utilisateur d'intégration ne doivent se voir attribuer que les autorisations minimales nécessaires pour effectuer les tâches activées par les activités de ce package (par exemple, admin, itil, soap_ecc, etc. ne doivent pas être utilisés pour les rôles d'utilisateur d'intégration). Les services Web entrants qui modifient les tables doivent être limités aux rôles systèmeappropriés .

Pour plus d'informations, consultez la section Rôles (Roles) dans la documentation ServiceNow.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de configuration .
2. Ajoutez une activité pour chaque propriété d'entrée SecureString (par exemple, deux au total - un pour le mot de passe et un pour CléSecrète (ClientSecret) )
3. Ajoutez l’activité ServiceNow Application Scope à votre projet.
4. Entrez des valeurs pour les propriétés Authentification ( Authentication ) et Connexion ( Connection ).
5. Créez et entrez une variable IConnection pour les propriétés de sortie .

   • Vous pouvez utiliser cette variable lors d'utilisations ultérieures de l'activité Étendue de l'application ServiceNow .

     
     

     

     
     

Si vous rencontrez des problèmes lors de l'utilisation de l'authentification standard, consultez les Conseils d'authentification standard.

Dans le corps de l’activité

Pour créer votre projet et activer l' Assistant Objet dans d'autres activités, vous devez utiliser l' Assistant Connexion en cliquant sur le bouton Configurer (Configure).

Pour en savoir plus, consultez la section Assistants ( Wizards ) sur la page À propos (About).

Propriétés

Authentification

• Nom d'utilisateur : le nom d'utilisateur de votre instance ServiceNow. Saisissez une variable String .
  • Cette valeur peut être différente de celle de votre compte ServiceNow si vous avez plusieurs instances.
  • Le nom d ' utilisateur est associé au mot de passe. Il est recommandé de générer une variable String en suivant la section Créer des ressources d'informations d'identification du guide de configuration .
  • Pour saisir votre variable String , utilisez une activité qui génère votre actif d'informations d'identification (voir l' exemple ci-dessous).
• Mot de passe : le mot de passe (associé au Nomd'utilisateur) de votre instance ServiceNow. Saisissez une variable String ou String .
  • Cette valeur peut être différente de celle de votre compte ServiceNow si vous avez plusieurs instances.
  • Le nom d ' utilisateur est associé au mot de passe. Il est recommandé de générer une variable String en suivant la section Créer des ressources d'informations d'identification du guide de configuration .
  • Pour saisir votre variable String , utilisez une activité qui génère votre actif d'informations d'identification (voir l' exemple ci-dessous).
• Clé secrète du client - Le SecureString utilisé pour autoriser les communications entre UiPath et votre instance ServiceNow. Saisissez une variable SecureString .
  • La CléSecrèteClient est générée pour votre instance ServiceNow lorsque vous remplissez un registre d'applications. Pour plus d'informations, consultez la section Configuration d'OAuth (Setup OAuth) du guide de configuration .
  • Pour générer une variable SecureString , consultez la section Créer des ressources d'informations d'identification du guide de configuration .
  • Pour saisir votre variable SecureString , utilisez une activité qui génère votre actif d'informations d'identification (voir l' exemple ci-dessous).
• IDClient : l'ID unique généré automatiquement du registre de votre application. Saisissez une variable String .
  • ClientId est généré pour votre instance ServiceNow lorsque vous remplissez un registre d'applications. Pour plus d'informations, consultez la section Configuration d'OAuth (Setup OAuth) du guide de configuration .
  • ClientId est associé à ClientSecret. Il est recommandé de générer une variable String en suivant la section Créer des ressources d'identification du guide de configuration .
  • Pour saisir votre variable String , utilisez une activité qui génère votre actif d'informations d'identification (voir l' exemple ci-dessous).
• Port local (facultatif) : le port local pour la redirection. La valeur par défaut est 10001. Entrez une variable String ou String .
• Utiliser OAuth 2.0 - Cochez cette case pour utiliser le flux d'octroi de code OAuth2 de ServiceNow.

Commun

• DisplayName : le nom complet de l'activité. Saisissez une variable String ou String .

Connexion (Connection)

• EndpointURL : l'URL de votre instance ServiceNow. Saisissez une variable String ou String . L'URL doit être celle de votre instance ServiceNow et non l' URL de redirection dans le registre de votre application.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• ReportApiErrorAsException : lorsque cette option est sélectionnée, les réponses d'erreur d'API sont signalées dans BusinessActivityExecutionException par toutes les activités enfants qui utilisent cette étendue d'application. Lorsqu'elle est décochée, l'activité enfant renseigne le message d'erreur d'API dans la propriété de sortie ResponseStatus et l'exécution du workflow se poursuit. Vérifiez la propriété ResponseStatus pour confirmer la réussite de l'exécution.

Sortie

• ServiceNowConnection - Un enregistrement de votre connexion établie que vous pouvez utiliser dans les activités ultérieures de l'étendue de l' application ServiceNow . Saisissez une variable IConnection (UiPath.BAF.Models.Connection.IConnection).

Utiliser la connexion existante

• ExistingServiceNowConnection - Un enregistrement de connexion d'une activité parente ServiceNow Application Scope que vous pouvez utiliser au lieu d'établir une nouvelle connexion. Saisissez une variable IConnection (UiPath.BAF.Models.Connection.IConnection).
  • La variable IConnection doit provenir d'une activité d'étendue SeriviceNow (parent) précédemment exécutée et qui dispose toujours d'une connexion active.
  • Si vous ne parvenez pas à établir une connexion à l'aide de cette propriété, essayez de réexécuter votre activité parente ServiceNow Application Scope .

Exemple

L'image suivante montre un exemple de la relation de dépendance d'activité et des valeurs de propriété d'entrée/sortie.

Pour obtenir des instructions étape par étape et des exemples, consultez le guide de démarrage rapide .

Conseils d'authentification standard

Dans le pack d'activités ServiceNow, l'authentification de base (nom d'utilisateur et mot de passe) peut être utilisée pour exécuter des activités. Les étapes sont décrites ci-dessous :

Heure de conception

Au moment de la conception, entrez le nom d'utilisateur et le mot de passe avec l'URL du point de terminaison et ces détails seront enregistrés. Notez que les informations d'identification ne sont pas validées avec ServiceNow pour l'authentification de base au niveau de l'étendue. Ce n’est qu’à un stade ultérieur, lorsque les entités ServiceNow sont récupérées dans une activité individuelle ou au moment de l’exécution lors de l’exécution d’une activité, que ces informations d’authentification de base sont utilisées pour l’authentification.

Si les informations d'authentification de base fournies sont incorrectes, une erreur sera générée lors du chargement de la liste d'entités, car elle utilise les informations d'authentification de base enregistrées pour se connecter à ServiceNow et obtenir les noms d'entités/tables.

Si les informations d'identification (Nomd'utilisateur , Motde passe , EndpointUrl) sont correctes, les entités seront renseignées dans la liste déroulante des activités comme ci-dessous :

Runtime

Assurez-vous que les informations d'identification sont renseignées dans le volet des propriétés sur la droite.

Si les informations d'identification sont correctes, l'activité sera exécutée. Si elle est incorrecte, elle générera une erreur au moment de l'exécution, comme indiqué ci-dessous :