Configuration

Introduction

Pour établir avec succès une connexion et envoyer des requêtes à l'API de Box, l'activité Étendue de Box ( Box Scope ) doit terminer l'authentification d'une application personnalisée à l'aide de l'une des authentifications JWT prises en charge (des méthodes d'authentification supplémentaires seront prises en charge à l'avenir).

Pour donner à l'activité Box Scope la possibilité de s'authentifier et pour permettre aux autres activités d'envoyer avec succès des requêtes à l'API Box, vous devez suivre les étapes suivantes :

1. Créer une application personnalisée

2. Construisez votre projet

Étapes

1. Créer une application personnalisée (JWT)

Pour créer une application personnalisée d'authentification JWT, suivez les étapes Configurer avec JWT dans la documentation de Box.

Les propriétés d’entrée suivantes sont requises dans l’activité Box Scope :

• Contenu du fichier de configuration ou chemin du fichierde configuration

Pour obtenir les valeurs Contenu du fichier de configuration (Config File Content) et Chemin d'accès au fichier de configuration ( Config File Path) , suivez les étapes de génération d'une paire de clés dans la documentation de Box.

Après avoir téléchargé le fichier de configuration JSON, vous pouvez soit enregistrer le fichier dans un dossier local et saisir cet emplacement dans la propriété Chemin du fichier de configuration ( Config File Path ), soit copier le contenu pour le saisir sous forme de String dans le champ Contenu du fichier de configuration (Config File Content).

À titre de référence rapide, vous trouverez ci-dessous les étapes que nous avons suivies lors du développement et du test des activités Box.

Remarque : les étapes ci-dessous sont fournies à titre d'exemple uniquement. Pour obtenir les dernières étapes de configuration et des informations plus détaillées sur les paramètres de configuration, reportez-vous à la documentation Box référencée.

1. Connectez-vous à https://app.box.com/.
2. Accédez à la console de développement.

3. Cliquez sur Créer une nouvelle application (Create New App).

   
   

   

   
   

4. Sélectionnez Application personnalisée ( Custom App) ou Intégration d'entreprise ( Enterprise Integration).

   
   

   

   
   

5. Sélectionnez OAuth 2.0 avec JWT (Authentification du serveur).

   
   

   

   
   
6. Saisissez un nom pour votre application et cliquez sur Créer une application (Create App).

7. Une fois votre application créée, cliquez sur Afficher votre application (vous n'avez pas besoin de copier le jeton de développeur).

   
   

   

   
   
8. Dans les paramètres de configuration de votre application, sous Fonctionnalités avancées ( Advanced Features), assurez-vous que Perform Actions as Users (Exécuter les actions en tant qu'utilisateurs) et Generate User Access Tokens (Générer des jetons d'accès utilisateur) sont activés.

9. Sous Ajouter et gérer des clés publiques (Add and Manage Public Keys), cliquez sur Générer une paire de clés publique/privée (Generate a Public/Private Keypair) et enregistrez le fichier de configuration JSON localement.

   • Cette étape nécessite que l'application ait l'authentification multifacteur activée.

10. Après avoir téléchargé le fichier, notez son emplacement car vous entrerez cette valeur dans la propriété Chemin d’accès au fichier* de l’activité Box Scope .

    
    

    

    
    
11. Après avoir terminé vos paramètres de configuration , accédez à Général (General) et cliquez sur Soumettre pour autorisation ( Submit for Authorization).

• L'administrateur de l'application (cela peut être vous) doit ensuite autoriser l'application en suivant les instructions de l'e-mail envoyé par Box.

  
  

  

  
  

2. Construisez votre projet

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

   1. Ouvrez UiPath Studio.
   2. Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
   3. Saisissez un nomde projet , un emplacementet une description.
   4. Cliquez sur Créer (Create).

2. Installez le package UiPath.Box.Activities .

   1. Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
   2. Sous Tous les packages, cliquez sur Se connecter
   3. Dans la barre de recherche , entrez Box.

   4. Cliquez sur, installez et acceptez la licence pour UiPath.Box.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 Box à votre projet.

Prochaines étapes

Pour en savoir plus sur les activités de Box (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.