DocuSign

Ejemplos de configuración de conexiones

En esta sección se indican los valores de ejemplo de los distintos campos que se configuran al crear la conexión.

OAUTH 2.0 - Tipo de conexión de código de autorización

Tipo de conexión OAuth 2.0 - JWT Bearer

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o no tenga ninguna entidad. En ese caso, la lista Entities estará vacía.

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Acciones

En esta sección se enumeran todas las acciones admitidas por la conexión de DocuSign.

Acción CreateAndSendEnvelope

Crea y envía un sobre o crea un borrador de sobre.

Parámetros de entrada de la acción CreateAndSendEnvelope

Para ver un ejemplo de cómo configurar la acción CreateAndSendEnvelope, consulta Ejemplos.

Ejemplos de acciones

En esta sección se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: CreateAndSendEnvelope

Esta acción crea y envía un sobre o crea un borrador de sobre.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateAndSendEnvelope y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el 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"
   }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

El valor de un ID de entidad debe transferirse directamente, como 16ab549b-95d7-47cb-b557-c2476ef62d9d. El ID 16ab549b-95d7-47cb-b557-c2476ef62d9d es el valor de clave principal único que se debe transferir.

Ejemplo: operación LIST para la entidad "Accounts"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Seleccione Cuentas en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según sus necesidades.

Ejemplo: operación LIST para la entidad "Documents"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Documentos en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según sus necesidades.

Ejemplo: operación LIST para la entidad "Envelopes"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Envelopes en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según sus necesidades.

Ejemplo: operación LIST para la entidad "Folders"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Carpetas en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según sus necesidades.

Ejemplo: operación LIST para la entidad "Groups"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Grupos en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según sus necesidades.

Ejemplo: operación LIST para la entidad "Users"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Usuarios en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según sus necesidades.

También puedes realizar operaciones LIST en las siguientes entidades:

• UserInfo
• UserSignatures
• Espacios de trabajo
• Destinatarios
• AccountBrands
• AccountCustomFields
• EnvelopeTemplates
• EnvelopeAttachments
• EnvelopeConsumerDisclosures
• CloudStorageProviders
• CustomTabs
• Cerraduras
• GroupBrands
• GroupUsers
• PowerForms
• RecipientTabs
• SigningGroups
• SigningGroupUsers
• Plantillas

Ejemplo: GET de un solo registro de la entidad "Accounts"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Seleccione Cuentas en la lista Entity.
3. Selecciona la operación GET y, a continuación, haz clic en Hecho.
4. Para definir el ID de entidad, en la sección Asignador de datos de Asignación de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca 2.4578824E7 en el campo Valor de entrada y elija EntityId como variable local.

Ejemplo: GET de un solo registro de la entidad "Documents"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Documentos en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. Para definir la cláusula de filtro, en la sección Asignación de datos de Asignador de datos, haz clic en Abrir editor de asignación de datos y, a continuación, introduce Type='envelopes' AND Id='8e18be14-3254-4cbe-947d-f0d1cd62f5f8' en el campo Valor de entrada y elige la cláusula de filtro como variable local.

Ejemplo: GET de un solo registro de la entidad "Envelopes"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Envelopes en la lista Entity.
3. Selecciona la operación GET y, a continuación, haz clic en Hecho.
4. Para definir el ID de entidad, en la sección Asignador de datos de Asignación de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca 8e18be14-3254-4cbe-947d-f0d1cd62f5f87 en el campo Valor de entrada y elija EntityId como variable local.

Ejemplo: GET de un solo registro de la entidad "Folders"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Carpetas en la lista Entity.
3. Selecciona la operación GET y, a continuación, haz clic en Hecho.
4. Para definir el ID de entidad, en la sección Asignador de datos de Asignación de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca 05f76d13-a513-492b-8c58-176702768db0 en el campo Valor de entrada y elija EntityId como variable local.

Ejemplo: GET de un solo registro de la entidad "Groups"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Grupos en la lista Entity.
3. Selecciona la operación GET y, a continuación, haz clic en Hecho.
4. Para definir el ID de entidad, en la sección Asignador de datos de Asignación de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca 1.4167231E7 en el campo Valor de entrada y elija EntityId como variable local.

Ejemplo: GET de un solo registro de la entidad "Users"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Usuarios en la lista Entity.
3. Selecciona la operación GET y, a continuación, haz clic en Hecho.
4. Para definir el ID de entidad, en la sección Asignador de datos de Asignación de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca 16ab549b-95d7-47cb-b557-c2476ef62d9d en el campo Valor de entrada y elija EntityId como variable local.

También puedes realizar operaciones GET en las siguientes entidades:

• UserInfo
• UserSignatures
• Espacios de trabajo
• Destinatarios
• AccountBrands
• AccountCustomFields
• EnvelopeTemplates
• EnvelopeAttachments
• EnvelopeConsumerDisclosures
• CloudStorageProviders
• CustomTabs
• Cerraduras
• GroupBrands
• GroupUsers
• RecipientTabs
• SigningGroups
• SigningGroupUsers
• Plantillas