Configuration

Pour établir avec succès une connexion et envoyer des requêtes à l'API DocuSign, l'activité Étendue DocuSign ( DocuSign Scope) doit terminer l'authentification à l'aide de l'authentification OAuth 2.0 prise en charge.

DocuSign prend en charge JWT et OAuth pour l’authentification.

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

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

1. Créer une clé d'intégration

2. Construisez votre projet

   
   

   

   
   

Étapes

1. Créer une clé d'intégration

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

Pour obtenir la valeur Clé d'intégration ( Integration Key ), suivez les étapes d' octroi de jeton Web JSON (JWT) dans la documentation de DocuSign.

Après avoir généré les valeurs, copiez les valeurs pour les saisir sous la forme d'un SecureString dans le paramètre Clé d'intégration et d'un String pour le paramètre Nom d'utilisateur de l'API . Ensuite, entrez sélectionnez le type d'environnement sur lequel vous souhaitez exécuter les activités (production ou développement).

Remarque : si vous utilisez un OAuth 2.0 et que pour l'application utilisateur, vous utilisez l'option Octroi de code d'autorisation (Authorization Code Grant), vous devrez ajouter (http://127.0.0.1:10001/authorize/) sous Paramètres supplémentaires ( http://127.0.0.1:10001/authorize/ ) comme l'un des éléments de redirection URI

2 : Utilisation de JWT

JWT est pris en charge avec la version 1.1.0 du module d’activités DocuSign. Pour utiliser JWT, vous suivrez la section Comment obtenir un jeton d'accès avec l'authentification JWT Accord. Le format du fichier JWT est le suivant :

{
  "typ": "JWT",
  "alg": "RS256",
  "iss": "3662508e-851e-4b16-b5b0-xxxxxxxxxxxx",
  "sub": "0099b00b-990f-4666-98d7-xxxxxxxxxxxx",
   "aud": "account-d.docusign.com",
  "scope": "signature impersonation",
  "privatekey": "your private key text"
}

Ce sera un fichier .json fichier. Les clés et les valeurs que vous souhaitez définir sont les suivantes

"iss" : clé d'intégration (également appelée ID de client) de l'application.

"sub" : le nom d'utilisateur de l'API au format GUID (un e-mail ou un ID normal ne suffira pas) "aud" : l'environnement de l'API. Utilisez account-d.docusign.com pour le développement et account.docusign.com pour la production. "privatekey" : il s'agit de la clé privée que vous avez créée conformément à la documentation DocuSign. Cela apparaîtra comme une seule longue ligne de texte sur la plupart des éditeurs de texte.

Remarque :

Vous devrez supprimer les instructions ci-dessous des données de clé privée que vous utilisez pour le paramètre de clé privée .

"-----BEGIN RSA PRIVATE KEY-----"

"-----END RSA PRIVATE KEY-----"

3. 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.DocuSign.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 , saisissez DocuSign.

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

Pour en savoir plus sur les activités DocuSign (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.