DocuSign

Muestras de configuración de conexión

Esta sección enumera los valores de muestra para los diversos que configuras cuando creas la conexión.

OAUTH 2.0: Tipo de conexión del código de autorización

OAuth 2.0: Tipo de conexión del portador de JWT

Entidades, operaciones y acciones

Todos los Integration Connectors 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 expone como entidades, operaciones y acciones.

• Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

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

• Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Lista
  • Obtén
  • Crear
  • Actualizar
  • Borrar

  Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, tales operaciones operaciones no aparecen en la lista Operations.

• Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y una parámetro. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

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 se debe pasar directamente, como 16ab549b-95d7-47cb-b557-c2476ef62d9d. El ID 16ab549b-95d7-47cb-b557-c2476ef62d9d es el valor de clave primaria único que se debe pasar.

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

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Cuentas de la lista Entity.
3. Selecciona la operación LIST y haz clic en Listo.
4. Task Input de la tarea Connectors, puedes configurar filterClause según tus 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 de la lista Entity.
3. Selecciona la operación LIST y, luego, haz clic en Listo.
4. sección Entrada de tarea de la tarea Conectores, puedes configurar la filterClause según tus requisitos.

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

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Sobres en la lista Entity.
3. Selecciona la operación LIST y, luego, haz clic en Listo.
4. sección Entrada de tarea de la tarea Conectores, puedes configurar la filterClause según tus requisitos.

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 de la lista Entity.
3. Selecciona la operación LIST y, luego, haz clic en Listo.
4. Task Input de la tarea Connectors, puedes configurar filterClause según tus necesidades.

Ejemplo: operación LIST para "Grupos" de entidades

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Grupos de la lista Entity.
3. Selecciona la operación LIST y, luego, haz clic en Listo.
4. sección Entrada de tarea de la tarea Conectores, puedes configurar la filterClause según tus requisitos.

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 de la lista Entity.
3. Selecciona la operación LIST y, luego, haz clic en Listo.
4. sección Entrada de tarea de la tarea Conectores, puedes configurar la filterClause según tus requisitos.

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

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

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

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Cuentas de la lista Entity.
3. Selecciona la operación GET y, luego, haz clic en Listo.
4. Para establecer el ID de la entidad, en la sección Data Mapper de la Data Mapping, haz clic en Open Data Mapping Editor y Luego, ingresa 2.4578824E7 en el campo Input Value y elige la variable EntityId como Local.

Ejemplo: registro único GET para la entidad "Documents"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Documentos de la lista Entity.
3. Selecciona la operación LIST y, luego, haz clic en Listo.
4. Para configurar la cláusula Filtro, la sección Data Mapper de la Data Mapping, haz clic en Open Data Mapping Editor y Luego, ingresa Type='envelopes' AND Id='8e18be14-3254-4cbe-947d-f0d1cd62f5f8' en el campo Input Value y elige la cláusula Filter como variable Local.

Ejemplo: Obtén un solo registro de la entidad "Envelopes"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Sobres en la lista Entity.
3. Selecciona la operación GET y haz clic en Listo.
4. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa 8e18be14-3254-4cbe-947d-f0d1cd62f5f87 en el campo Input Value y elige EntityId como variable local.

Ejemplo: registro único GET para la entidad “Folders”

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Carpetas de la lista Entity.
3. Selecciona la operación GET y, luego, haz clic en Listo.
4. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa 05f76d13-a513-492b-8c58-176702768db0 en el campo Input Value y elige EntityId como variable local.

Ejemplo: registro único GET para "Grupos" de la entidad

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Grupos de la lista Entity.
3. Selecciona la operación GET y, luego, haz clic en Listo.
4. Para establecer el ID de la entidad, en la sección Data Mapper de la Data Mapping, haz clic en Open Data Mapping Editor y Luego, ingresa 1.4167231E7 en el campo Input Value y elige la variable EntityId como Local.

Ejemplo: registro único GET para la entidad "Users"

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Usuarios de la lista Entity.
3. Selecciona la operación GET y, luego, haz clic en Listo.
4. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa 16ab549b-95d7-47cb-b557-c2476ef62d9d en el campo Input Value y elige EntityId como variable local.

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

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