DocuSign

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion.

Type de connexion avec un code d'autorisation OAuth 2.0

Type de connexion avec un jeton de support JWT OAuth 2.0

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

Dans cette section, vous trouverez la liste des actions compatibles avec la connexion DocuSign.

Action CreateAndSendEnvelope

Cette action crée et envoie une enveloppe, ou crée un brouillon d'enveloppe.

Paramètres d'entrée de l'action CreateAndSendEnvelope

Pour obtenir des exemples de configuration de l'action CreateAndSendEnvelope, consultez Exemples.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : CreateAndSendEnvelope

Cette action crée et envoie une enveloppe, ou crée un brouillon d'enveloppe.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateAndSendEnvelope, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "EmailSubject": "Please Sign this Document",
   "FileName": "test.txt\ntest.pdf",
   "SignersEmail": "cloudysanfrancisco@gmail.com",
   "SignersRecipientId": "53386460",
   "CcRecipientId": "67173451",
   "CcEmail": "baklavainthebalkans@gmail.com",
   "DocumentId": "1",
   "Status": "sent",
   "CustomFieldAggregate": "CustomFieldName",
   "ContentBytes": "abcd***",
   "HasBytes": true,
   "SignersName": "\"test\"",
   "CcName": "\"test\"",
   "Content": "test content in file"
   }
   

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

 [{
"Success":"true",
"envelopeid":"542a77ff-b533-4b39-9d82-e397ef5a70c9",
"uri":"/envelopes/542a77ff-b533-4b39-9d82-e397ef5a70c9",
"statusdatetime":"2025-04-09T12:33:47.1130000Z",
"status":"sent",
"customfieldaggregate": "CustomFieldName"
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

La valeur d'un ID d'entité doit être transmise directement, par exemple 16ab549b-95d7-47cb-b557-c2476ef62d9d. L'ID 16ab549b-95d7-47cb-b557-c2476ef62d9d est la valeur de clé primaire unique qui doit être transmise.

Exemple : Opération LIST pour l'entité Accounts

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Accounts" dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.

Exemple : Opération LIST pour l'entité Documents

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Documents" dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.

Exemple : Opération LIST pour l'entité Envelopes

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Envelopes" dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.

Exemple : Opération LIST pour l'entité Folders

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Folders" dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.

Exemple : Opération LIST pour l'entité Groups

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Groups" dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.

Exemple : Opération LIST pour l'entité Users

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Users" dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.

Vous pouvez également effectuer des opérations LIST sur les entités suivantes :

• UserInfo
• UserSignatures
• Workspaces
• Recipients
• AccountBrands
• AccountCustomFields
• EnvelopeTemplates
• EnvelopeAttachments
• EnvelopeConsumerDisclosures
• CloudStorageProviders
• CustomTabs
• Locks
• GroupBrands
• GroupUsers
• PowerForms
• RecipientTabs
• SigningGroups
• SigningGroupUsers
• Templates

Exemple : Opération GET sur un enregistrement unique pour l'entité Accounts

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Accounts" dans la liste Entity.
3. Sélectionnez l'opération GET, puis cliquez sur OK.
4. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 2.4578824E7 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Opération GET sur un enregistrement unique pour l'entité Documents

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Documents" dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Pour définir la clause de filtre, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez Type='envelopes' AND Id='8e18be14-3254-4cbe-947d-f0d1cd62f5f8' dans le champ Valeur d'entrée et sélectionnez la clause de filtre comme variable locale.

Exemple : Opération GET sur un enregistrement unique pour l'entité Envelopes

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Envelopes" dans la liste Entity.
3. Sélectionnez l'opération GET, puis cliquez sur OK.
4. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 8e18be14-3254-4cbe-947d-f0d1cd62f5f87 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Opération GET sur un enregistrement unique pour l'entité Folders

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Folders" dans la liste Entity.
3. Sélectionnez l'opération GET, puis cliquez sur OK.
4. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 05f76d13-a513-492b-8c58-176702768db0 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Opération GET sur un enregistrement unique pour l'entité Groups

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Groups" dans la liste Entity.
3. Sélectionnez l'opération GET, puis cliquez sur OK.
4. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 1.4167231E7 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Exemple : Opération GET sur un enregistrement unique pour l'entité Users

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez "Users" dans la liste Entity.
3. Sélectionnez l'opération GET, puis cliquez sur OK.
4. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 16ab549b-95d7-47cb-b557-c2476ef62d9d dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

Vous pouvez également effectuer des opérations GET sur les entités suivantes :

• UserInfo
• UserSignatures
• Workspaces
• Recipients
• AccountBrands
• AccountCustomFields
• EnvelopeTemplates
• EnvelopeAttachments
• EnvelopeConsumerDisclosures
• CloudStorageProviders
• CustomTabs
• Locks
• GroupBrands
• GroupUsers
• RecipientTabs
• SigningGroups
• SigningGroupUsers
• Templates