Box Scope

UiPath.Box.Activities.BoxScope

Les activités Box utilisent l' authentification JWT pour établir une connexion entre UiPath et votre application Box personnalisée. Cette connexion autorise un Robot à appeler les API Box et à accéder aux ressources en votre nom.

Pour activer l'authentification, vous pouvez créer une application personnalisée Box avec l'authentification JWT. Après avoir créé votre application, Box génère un fichier de configuration qui contient les informations nécessaires pour établir une connexion authentifiée. Vous pouvez également choisir de créer une application personnalisée Box avec l'authentification OAuth. Pour plus d'informations et avant de créer votre premier projet d'automatisation, consultez le Guide de configuration .

Après avoir créé votre application personnalisée, vous sélectionnez le type d'authentification que vous souhaitez utiliser (Type d'authentification) et entrez l'emplacement de votre fichier de configuration ( Chemin du fichier de configuration (Config File Path) ou le contenu du fichier (Contenudu fichier de configuration ) dans l'activité Étendue de boîte ( Box Scope ) si vous utilisez l'authentification JWT ou saisissez les (ID de client) et (Clé secrète du client) si vous utilisez l'authentification OAuth.

Après avoir établi une connexion, une activité Box Scope parente peut générer un enregistrement de la connexion dans un objet BoxClient (Box Connection) que vous pouvez utiliser dans les activités d'étendue enfant suivantes.

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 l’activité Box Scope à votre projet.
3. Entrez des valeurs pour les propriétés d' authentification d' entrée et JWT (si vous utilisez JWT).
4. Créez et entrez une variable BoxClient pour la propriété Output (Sortie).

   • Vous pouvez utiliser cette variable dans des utilisations ultérieures de l'activité Box Scope .

     
     

     

     
     

Propriétés

Commun

• ContinuerSurErreur (ContinueOnError) : spécifie si vous souhaitez que l'activité continue de s'exécuter lorsqu'une erreur est générée. Ce champ ne prend en charge que les valeurs Boolean .
• NomAffichage (DisplayName) : nom affiché de l'activité. Ce champ prend uniquement en charge les variables Strings et String.

Connexion existante

• Connexion Box : un enregistrement de connexion d'une activité Étendue Box parente que vous pouvez utiliser au lieu d'établir une nouvelle connexion. Ce champ ne prend en charge que BoxClient variables.
  • La variable BoxClient doit provenir d’une activité Box Scope (parente) 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é Box Scope parente.

Entrée

• TypeAuthentification : le type d'authentification que vous souhaitez utiliser pour vous connecter à votre application personnalisée. Sélectionnez l'un des trois éléments dans la liste déroulante :

  • JWT - Pour spécifier l'authentification JWT. Requis pour la première exécution de l'activité Étendue de la boîte (c'est-à-dire l'étendue parent).
  • OAuth - Pour spécifier l'authentification OAuth. Requis pour la première exécution de l'activité Étendue de la boîte (c'est-à-dire l'étendue parent).
  • BoxConnection - Facultatif pour les exécutions ultérieures de l'activité Box Scope dans le même projet d'automatisation qui comprend une étendue parent.

Authentification JWT

• Contenu du fichier de configuration : le contenu du fichier de configuration JSON dans un objet String . Ce champ prend uniquement en charge les variables Strings ou String . Pour plus d'informations sur le fichier de configuration, consultez le guide d' installation de Box.
• Chemin du fichier de configuration (Config File Path ) : l'emplacement du fichier de configuration téléchargé. Ce champ prend uniquement en charge les variables Strings ou String . Pour plus d'informations sur le fichier de configuration, consultez le guide d' installation de Box.
• ID d'utilisateur (User ID ) : l'ID du compte d'utilisateur que vous souhaitez utiliser pour l'authentification. Ce champ prend en charge uniquement les variables Strings ou String . Si ce champ est laissé vide, l'authentification est effectuée pour le compte de service.

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).

Authentification OAuth 2

• ID de client (Client ID ) - IDClient de l'application Box. Ce champ prend uniquement en charge les variables Strings ou String . Pour plus d'informations sur le fichier de configuration, consultez le guide d' installation de Box.
• Clé secrète duclient (Client Secret) - Clé secrète du client de l'application Box. Saisissez une variable SecureString ou SecureString . Pour plus d'informations sur le fichier de configuration, consultez le guide d' installation de Box.

Sortie

• Connexion à Box - Un enregistrement de votre connexion établie que vous pouvez utiliser dans d'autres activités d' étendue Box incluses dans cette activité d'étendue. Ce champ ne prend en charge que BoxClient variables.
  Remarque :

  Vous pouvez transmettre cette variable à une activité d'étendue dans un workflow qui provient de l'activité d'étendue parente.

  Par exemple, vous pouvez avoir 3 workflows. La première comprend l'activité d'étendue parente qui établit la connexion à votre application enregistrée (c'est-à-dire le workflow parent). Le deuxième workflow crée un nouvel enregistrement de contact et le troisième crée un nouvel enregistrement de compte ; les deux sont inclus dans l’activité d’étendue parent.

  Lorsque les workflows s'exécutent, l'activité d'étendue parente transmet la variable BoxClient à la propriété BoxConnection de la connexion existante dans les deuxième et troisième workflows (voir l'image ci-dessous).