Box Scope

UiPath.Box.Activities.BoxScope

Les activités Box utilisent l' authentification JWT pour établir une connexion entre UiPath et votre application personnalisée Box. 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 Box personnalisée 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 Box personnalisée avec l’authentification OAuth. Pour plus d'informations et avant de créer votre premier projet d'automatisation, consultez le Guide de Configuration (Setsp ).

After creating your Custom App, you select the type of authentication that you want to use (Authentication Type) and enter the location of your configuration file (Config File Path) or the contents of the file (Config File Content) into the Box Scope activity if you are using JWT authentication or enter the (Client ID) and (Client Secret) if you are using OAuth Authentication.

After establishing a connection, a parent Box Scope activity can output a record of the connection in a BoxClient object (Box Connection) that you can use in subsequent child scope activities.

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. Add the Box Scope activity to your project.
3. Saisissez des valeurs pour les propriétés Entrée et Authentification JWT (si vous utilisez JWT).
4. Créez et entrez une variable BoxClient pour la propriété Output (Sortie) .

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

     

Propriétés

Commun

• ContinueOnError - Specifies if you want the activity to continue running when an error is thrown. This field supports only Boolean values.
• NomAffichage (DisplayName) - Nom affiché de l'activité. Ce champ ne prend en charge que les variables Strings ou String.

Connexion existante

• Box Connection - A connection record from a parent Box Scope activity that you can use instead of establishing a new connection. This field supports only BoxClient variables.
  • The BoxClient variable must be from a previously run Box 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 Box Scope activity.

Entrée

• AuthenticationType - The type of authentication that you want to use to connect to your Custom App. Select one of the three items from the drop-down list:
  • JWT - To specify JWT Authentication. Required for the first run of the Box Scope activity (i.e., parent scope).
  • OAuth - To specify OAuth authentication. Required for the first run of the Box Scope activity (i.e., parent scope).
  • BoxConnection - Optional for subsequent runs of the Box Scope activity within the same automation project that includes a parent scope.

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 et String . Pour plus d'informations sur le fichier de configuration, consultez le guide de configuration Box.
• Chemin du fichier de configuration : l'emplacement du fichier de configuration téléchargé. Ce champ ne prend en charge que les variables Strings ou String . Pour plus d'informations sur le fichier de configuration, consultez le guide de configuration Box.
• User ID - The ID of the user account that you want to use for authentication. This field supports only Strings or String variables. If left empty, authentication is done for the service account.

Divers

• Private - If this checkbox is selected, the values of variables and arguments are no longer logged at Verbose level.

Authentification OAuth 2

• ID client : ID client de l'application Box. Ce champ ne prend en charge que les variables Strings ou String . Pour plus d'informations sur le fichier de configuration, consultez le guide de configuration Box.
• CléSecrèteClient : la 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 de configuration Box.

Sortie

• Box Connection - A record of your established connection that you can use in other Box Scope activities that are included in this scope activity. This field supports only BoxClient variables.

  Remarque :

  Vous pouvez transmettre cette variable à une activité d'étendue dans un workflow qui se situe à l'intérieur de l'activité d'étendue parente. Par exemple, vous pouvez avoir 3 workflows. Le premier inclut l’activité d’étendue parente qui établit la connexion à votre application enregistrée (c’est-à-dire au 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 parente. Lorsque les workflows s'exécutent, l'activité d'étendue parente transmet la variable BoxClient à la propriété BoxConnection existante dans les deuxième et troisième workflows (voir l'image ci-dessous).