ServiceNow Application Scope

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

Astuce :

While the ServiceNow Application Scope activity can use standard authentication (UserName) and (Password), it is highly recommend to use OAuth security for all your connections per the steps below.

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 client et une clé secrète client pour activer l’accès authentifié à votre instance.

After creating your endpoint, you enter your ServiceNow credentials along with the application endpoint URL, Client ID, and Client Secret in the ServiceNow Application Scope activity.

Astuce :

Les rôles d'utilisateur d'intégration doivent uniquement se voir attribuer les autorisations minimales nécessaires pour effectuer les tâches activées par les activités de ce package (par exemple, admin, itil, sao_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ème appropriés. Pour plus d'informations, consultez la section Rôles 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 SecureString propriété d’entrée (par exemple, deux au total - une pour Mot de passe et une pour CléSecrèteClient)
3. Add the ServiceNow Application Scope activity to your project.
4. Saisissez des valeurs pour les propriétés Authentification et Connexion .
5. Créez et entrez une variable IConnection pour les propriétés de sortie .

   • You can use this variable in subsequent uses of the ServiceNow Application Scope activity.

     

Si vous rencontrez des problèmes en utilisant l’authentification standard, veuillez consulter les Conseils d’authentification standard.

Dans le corps de l’activité

To build your project and enable the Object Wizard in other activities, you must use the Connection Wizard by clicking the Configure button.

Pour en savoir plus, consultez la section Assistants de la page À propos .

Propriétés

Authentification

• Username - The username for your ServiceNow instance. Enter a String variable.
  • 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 ressource d'informations d'identification (voir l'exemple ci-dessous).
• Password - The password (associated with the Username) to your ServiceNow instance. Enter a String or String variable.
  • 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 ressource d'informations d'identification (voir l'exemple ci-dessous).
• Client Secret - The SecureString used to authorize communications between UiPath and your ServiceNow instance. Enter a SecureString variable.
  • La valeur CléSecrèteClient est générée pour votre instance ServiceNow lorsque vous remplissez un registre d'application. Pour plus d’informations, consultez la section Configurer OAuth du guide 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 ressource d'informations d'identification (voir l'exemple ci-dessous).
• ClientId - The auto-generated, unique ID of your application registry. Enter a String variable.
  • L’ IDClient est généré pour votre instance ServiceNow lorsque vous remplissez un registre d’application. Pour plus d’informations, consultez la section Configurer OAuth du guide Configuration .
  • L'IDClient est associé à la valeur CléSecrèteClient. 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 ressource 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. Saisissez une variable de type String ou String .
• Use OAuth 2.0 - Check this to use OAuth2 code grant flow of ServiceNow.

Commun

• DisplayName - The display name of the activity. Enter a String or String variable.

Connexion (Connection)

• EndpointURL - The URL of your ServiceNow instance. Enter a String or String variable. The URL should be to your ServiceNow instance and not the Redirect URL in your application registry.

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 - When selected, API error responses are reported in BusinessActivityExecutionException by all child activities that use this application scope. When cleared, the child activity populates the API error message in the ResponseStatus output property and workflow execution continues. Check the ResponseStatus property to confirm successful execution.

Sortie

• ServiceNowConnection - A record of your established connection that you can use in subsequent ServiceNow Application Scope activities. Enter a IConnection variable (UiPath.BAF.Models.Connection.IConnection).

Utiliser la connexion existante

• ExistingServiceNowConnection - A connection record from a parent ServiceNow Application Scope activity that you can use instead of establishing a new connection. Enter a IConnection variable (UiPath.BAF.Models.Connection.IConnection).
  • The IConnection variable must be from a previously run SeriviceNow Scope activity (parent) that still has an active connection.
  • If you're unable to establish a connection using this property, try re-running your parent ServiceNow Application Scope activity.

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 et des exemples étape par étape, 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.

If the credentials (Username, Password, EndpointUrl) are correct the entities will be populated in the activity dropdown like below:

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 :