DocuSign

Esempi di configurazione della connessione

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

OAUTH 2.0 - Authorization Code connection type

Tipo di connessione OAuth 2.0 - JWT Bearer

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca tutte le azioni supportate dalla connessione DocuSign.

Azione CreateAndSendEnvelope

Crea e invia una busta o crea una bozza di busta.

Parametri di input dell'azione CreateAndSendEnvelope

Per un esempio di come configurare l'azione CreateAndSendEnvelope, consulta Esempi.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: CreateAndSendEnvelope

Questa azione crea e invia una busta o crea una bozza di busta.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateAndSendEnvelope, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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"
   }
   

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

 [{
"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"
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Il valore di un ID entità deve essere passato direttamente, ad esempio 16ab549b-95d7-47cb-b557-c2476ef62d9d. L'ID 16ab549b-95d7-47cb-b557-c2476ef62d9d è il valore univoco della chiave primaria che deve essere trasmesso.

Esempio: operazione LIST per l'entità "Accounts"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Account dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base alle tue esigenze.

Esempio: operazione LIST per l'entità "Documents"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Documenti dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base alle tue esigenze.

Esempio: operazione LIST per l'entità "Buste"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Buste dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base alle tue esigenze.

Esempio: operazione LIST per l'entità "Cartelle"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Cartelle dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base alle tue esigenze.

Esempio: operazione LIST per l'entità "Groups"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Gruppi dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base alle tue esigenze.

Esempio: operazione LIST per l'entità "Users"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Utenti dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base alle tue esigenze.

Puoi eseguire operazioni LIST anche sulle seguenti entità:

• UserInfo
• UserSignatures
• Aree di lavoro
• Destinatari
• AccountBrands
• AccountCustomFields
• EnvelopeTemplates
• EnvelopeAttachments
• EnvelopeConsumerDisclosures
• CloudStorageProviders
• CustomTabs
• Serrature
• GroupBrands
• GroupUsers
• PowerForms
• RecipientTabs
• SigningGroups
• SigningGroupUsers
• Modelli

Esempio: GET di un singolo record per l'entità "Account"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Account dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 2.4578824E7 nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: GET di un singolo record per l'entità "Documents"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Documenti dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Per impostare la clausola di filtro, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor mappatura dei dati, poi inserisci Type='envelopes' AND Id='8e18be14-3254-4cbe-947d-f0d1cd62f5f8' nel campo Valore di input e scegli la clausola di filtro come variabile locale.

Esempio: GET di un singolo record per l'entità "Buste"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Buste dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 8e18be14-3254-4cbe-947d-f0d1cd62f5f87 nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: GET di un singolo record per l'entità "Cartelle"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Cartelle dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 05f76d13-a513-492b-8c58-176702768db0 nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: GET di un singolo record per l'entità "Groups"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Gruppi dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 1.4167231E7 nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: GET di un singolo record per l'entità "Utenti"

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Utenti dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 16ab549b-95d7-47cb-b557-c2476ef62d9d nel campo Valore di input e scegli EntityId come variabile locale.

Puoi eseguire operazioni GET anche sulle seguenti entità:

• UserInfo
• UserSignatures
• Aree di lavoro
• Destinatari
• AccountBrands
• AccountCustomFields
• EnvelopeTemplates
• EnvelopeAttachments
• EnvelopeConsumerDisclosures
• CloudStorageProviders
• CustomTabs
• Serrature
• GroupBrands
• GroupUsers
• RecipientTabs
• SigningGroups
• SigningGroupUsers
• Modelli