Módulos de DocuSign

Los módulos DocuSign de Adobe Workfront Fusion le permiten supervisar y recuperar el estado de los sobres, buscar y recuperar sobres o descargar y enviar un documento para iniciar sesión en su cuenta de DocuSign.

Para obtener instrucciones sobre cómo crear un escenario, vea los artículos en Crear escenarios: índice de artículos.

Para obtener información acerca de los módulos, vea los artículos en Módulos: índice de artículos.

Requisitos de acceso

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Work
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere ninguna licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo

Producto

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Ultimate Workfront.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.

Requisitos previos

Para usar módulos DocuSign, debe tener una cuenta de DocuSign.

Información de API de DocuSign

El conector de DocuSign utiliza lo siguiente:

Etiqueta de API
1.18.11

Conectar DocuSign a Workfront Fusion connect-docusign-to-workfront-fusion

Para crear una conexión para los módulos de DocuSign:

  1. Haga clic en Add junto al cuadro Connection cuando empiece a configurar el primer módulo de DocuSign.

  2. Introduzca lo siguiente:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name Escriba un nombre para la nueva conexión de DocuSign
    Account type Seleccione si la cuenta a la que desea conectarse es una cuenta de producción o una cuenta de demostración.
  3. Continúe tal como se describe en Crear una conexión a Adobe Workfront Fusion : instrucciones básicas.

Módulos de DocuSign y sus campos

Al configurar módulos de DocuSign, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse DocuSign campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.

Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro.

Conmutador Asignar

Activadores

Watch envelopes

Este módulo de activador inicia un escenario cuando se envía, entrega, firma, completa o rechaza un sobre.

Connection
Para obtener instrucciones acerca de cómo conectar su cuenta de DocuSign a Workfront Fusion, vea Crear una conexión: instrucciones básicas.
Account
Seleccione la cuenta que contiene los registros que desea ver.
Event type

Seleccione el tipo de evento que desea ver.

  • Document completed
  • Document declined
  • Document sent
  • Document signed
  • New document in Inbox
Output fields
Seleccione los campos que desea incluir en la salida del módulo.
Limit
Introduzca o asigne el número máximo de registros con los que desea que trabaje el módulo durante cada ciclo de ejecución de escenario.

Acciones

Custom API Call

Este módulo de acción le permite realizar una llamada de API personalizada.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de DocuSign a Workfront Fusion, consulte Conectar DocuSign a Workfront Fusion en este artículo.
Account
Introduzca o asigne la cuenta que desea usar para acceder a la API de DocuSign.
URL

Escriba la dirección del servidor web con el que desea que interactúe el módulo.

Puede escribir una dirección URL relativa, lo que significa que no tiene que incluir el protocolo (como http://) al principio. Esto sugiere al servidor web que la interacción se está produciendo en el servidor.

Por ejemplo: /api/conversations.create

Method
Seleccione el método de petición HTTP que necesita para configurar la llamada de la API. Para obtener más información, vea Métodos de solicitud HTTP.
Headers

Añada los encabezados de la solicitud en forma de objeto JSON estándar. Determina el tipo de contenido de la petición.

Por ejemplo: {"Content-type":"application/json"}

Nota: Si se producen errores y es difícil determinar su origen, considere la posibilidad de modificar los encabezados basándose en la documentación de Workfront. Si la llamada de API personalizada devuelve un error de petición HTTP 422, intente utilizar un encabezado “Content-Type”:“text/plain”.

Query String

Añada la consulta para la llamada de API en forma de objeto JSON estándar.

Por ejemplo: {"name":"something-urgent"}

Body

Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.

Nota:

Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.

Limit
Introduzca o asigne el número máximo de resultados con los que se va a trabajar durante un ciclo de ejecución.
INFO
Ejemplo: enumerar sobres
La siguiente llamada de la API devuelve sobres a partir de la fecha especificada en su cuenta de DocuSign:
URL: /v2.1/accounts/{accountId}/envelopes/
MétodoGET
Cadena de consulta:
  • Clavefrom_date

  • ValorYYYY-MM-DD

Especifica cuándo comienza la solicitud a comprobar los cambios de estado de los sobres de la cuenta.
Ejemplo de configuración de Docusign
El resultado se puede encontrar en la salida del módulo en Paquete > Cuerpo > Sobres.
En nuestro ejemplo, se devolvieron 6 sobres:
Ejemplo de salida de docusign

Download a document

Este módulo de acción descarga un solo documento.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de DocuSign a Workfront Fusion, consulte Conectar DocuSign a Workfront Fusion en este artículo.
Account
Seleccione la cuenta que contiene el documento que desea descargar.
Envelope ID
Introduzca o asigne el ID del sobre que desea descargar.
Document ID
Introduzca o asigne el ID del documento que desea descargar.
Certificate
Seleccione Yes si desea incluir el certificado de firma de sobre en la descarga.
Documents by User ID
Seleccione Yes si desea permitir que los destinatarios recuperen documentos por identificador de usuario. Por ejemplo, si un usuario se incluye en dos órdenes de enrutamiento diferentes con distintas visibilidades, al utilizar esta opción se devuelven todos los documentos de ambas rutas.
Encrypt
Seleccione Yes si desea que los bytes de PDF devueltos en la respuesta se cifren para todos los administradores de claves configurados en su cuenta de DocuSign.
Language
Seleccione el idioma.
Show Changes
Cuando se establece en Yes, los campos modificados para el PDF devuelto se resaltan en amarillo y las firmas o iniciales opcionales se resaltan en rojo.
Watermark
Seleccione No para eliminar la marca de agua de los documentos del PDF.

Read an envelope

Este módulo de acción lee información sobre un sobre en DocuSign mediante el identificador del sobre.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de DocuSign a Workfront Fusion, consulte Conectar DocuSign a Workfront Fusion en este artículo.
Account
Seleccione la cuenta que contiene el documento del que desea leer información.
Envelope ID
Introduzca o asigne el ID que contiene el documento del que desea leer información.
Outputs
Seleccione las propiedades que desea que aparezcan en la salida del módulo.

Upload a file to an envelope

Este módulo carga un archivo especificado en un sobre existente de DocuSign.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de DocuSign a Workfront Fusion, consulte Conectar DocuSign a Workfront Fusion en este artículo.
Account
Seleccione la cuenta que contiene el sobre en el que desea cargar un archivo.
Envelope ID
Introduzca o asigne el ID del sobre en el que desea cargar un archivo.
Source file
Seleccione un archivo de origen de un módulo anterior o introduzca el nombre y los datos del archivo de origen.

Create a new envelope

Este módulo de acción crea un nuevo sobre a partir de una plantilla. Devuelve el ID del nuevo sobre, así como el estado del nuevo sobre.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de DocuSign a Workfront Fusion, consulte los artículos en Crear una conexión: instrucciones básicas.
Account
Seleccione la cuenta que contiene el sobre en el que desea cargar un archivo.
Template
Seleccione la plantilla a partir de la que desea crear el nuevo sobre. Las plantillas están disponibles según el(la) Account que haya seleccionado.
After creation
Seleccione si desea guardar el sobre como borrador o enviarlo para su firma.
Template recipients
Seleccione el destinatario de este sobre

Add Recipient to Envelope

Este módulo de acción añade uno o más destinatarios a un sobre existente. Si el sobre ya se ha enviado, se envía un correo electrónico al destinatario. Este módulo no es válido para sobres que ya se han completado.

Connection
Para obtener instrucciones sobre cómo conectar su cuenta de DocuSign a Workfront Fusion, consulte Crear una conexión: instrucciones básicas.
Account
Seleccione la cuenta que contiene el sobre en el que desea añadir destinatarios.
Envelope ID
Seleccione o asigne el ID del sobre en el que desea añadir el destinatario.
Recipient type

Seleccione el tipo de destinatario que desea añadir al sobre.

  • Agent

  • Carbon copy

  • Certified delivery

  • In-person signer

  • Intermediary

  • Signer

Email
Introduzca o asigne la dirección de correo electrónico del destinatario que desea añadir al sobre.
Name
Introduzca o asigne el nombre del destinatario que desea añadir al sobre.
Routing order
Introduzca o asigne el número de enrutamiento del destinatario. El número de enrutamiento determina el orden en que los destinatarios reciben y firman los documentos.
Email body
Introduzca o asigne el cuerpo (contenido) del correo electrónico que se envía al destinatario.
Email subject
Introduzca o asigne el asunto del correo electrónico que se envía al destinatario.
Private message
  • Solo el destinatario seleccionado ve el mensaje privado, así como el mensaje general. El mensaje privado tiene un límite de 1000 caracteres.
Authentication

Seleccione el método de autenticación que desee utilizar para confirmar la identidad del destinatario.

  • None

  • Access code

    Introduzca o asigne el código de acceso.

  • Phone

    Introduzca o asigne el número de teléfono

  • SMS

    Introduzca o asigne el número de teléfono

Add custom field

Este módulo de acción añade un campo personalizado al documento

Connection
Para obtener instrucciones sobre la conexión de su cuenta de DocuSign a Workfront Fusion, consulte Conectar DocuSign a Workfront Fusion en este artículo.
Account
Seleccione la cuenta que contiene el documento en el que desea añadir un campo personalizado.
Envelope ID
Introduzca o asigne el ID del sobre que contiene el documento en el que desea añadir un campo personalizado.
Field name
Introduzca o asigne un nombre para el nuevo campo que desea añadir.
Required
Habilite esta opción si desea que el campo añadido sea un campo obligatorio.
Show field
Habilite esta opción si desea que el campo sea visible.
Value
Introduzca o asigne el valor (contenido) del campo añadido.

Modify custom field

Este módulo de acción modifica un campo personalizado mediante el nombre del campo.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de DocuSign a Workfront Fusion, consulte Conectar DocuSign a Workfront Fusion en este artículo.
Account
Seleccione la cuenta que contiene el documento en el que desea modificar un campo personalizado.
Envelope ID
Introduzca o asigne el ID del sobre que contiene el documento en el que desea modificar un campo personalizado.
Field ID
Introduzca o asigne el ID del campo que desea modificar.
Field name
Introduzca o asigne el nombre del campo que desea modificar.
Required
Habilite esta opción si desea que el campo modificado sea obligatorio.
Show field
Habilite esta opción si desea que el campo sea visible.
Value
Introduzca o asigne el valor (contenido) del campo modificado.

Send envelope

Este módulo de acción envía un sobre borrador a sus destinatarios.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de DocuSign a Workfront Fusion, consulte Conectar DocuSign a Workfront Fusion en este artículo.
Account
Seleccione la cuenta que contiene el sobre borrador que desea enviar a sus destinatarios.
Envelope ID
Introduzca o asigne el ID del sobre borrador que desea enviar a sus destinatarios.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3