Módulos do DocuSign

Os módulos do Adobe Workfront Fusion DocuSign permitem monitorar e recuperar o status do envelope, pesquisar e recuperar envelopes, ou baixar e enviar um documento para entrar em sua conta do DocuSign.

Para obter instruções sobre como criar um cenário, consulte os artigos em Criar cenários: índice do artigo.

Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Novo: Padrão

Ou

Atual: trabalho ou superior

Licença do Adobe Workfront Fusion**

Atual: nenhum requisito de licença do Workfront Fusion

Ou

Herdados: Automação e integração do Workfront Fusion for Work

Produto

Novo menu:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

Ou

Atual: sua organização deve comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.

Pré-requisitos

Para usar módulos DocuSign, você deve ter uma conta DocuSign.

Informações da API do DocuSign

O conector DocuSign usa o seguinte:

Tag da API
1.18.11

Conectar o DocuSign ao Workfront Fusion connect-docusign-to-workfront-fusion

Para criar uma conexão para seus módulos do DocuSign:

  1. Clique em Adicionar ao lado da caixa Conexão ao começar a configurar o primeiro módulo DocuSign.

  2. Insira o seguinte:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Nome da Conexão Insira um nome para a nova conexão DocuSign.
    Ambiente Selecione se você está se conectando a uma produção em um ambiente de não produção.
    Nome da Conexão Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    Tipo de conta Selecione se a conta à qual deseja se conectar é uma conta de produção ou uma conta de demonstração.
  3. Clique em Continuar para salvar a conexão e retornar ao módulo.

DocuSign módulos e seus campos

Ao configurar módulos do DocuSign, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos DocuSign adicionais podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Alternância de mapa

Acionadores

Assistir a envelopes

Esse módulo de acionamento inicia um cenário quando um envelope é enviado, entregue, assinado, concluído ou recusado.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar Documentação ao Workfront Fusion neste artigo.
Conta
Selecione a conta que contém os registros que você deseja observar.
Tipo de evento

Selecione o tipo de evento que deseja assistir.

  • Documento concluído
  • Documento recusado
  • Documento enviado
  • Documento assinado
  • Novo documento na Caixa de Entrada
Saídas
Selecione os campos que deseja incluir na saída do módulo.
Limite
Insira ou mapeie o número máximo de registros com os quais você deseja que o módulo funcione durante cada ciclo de execução de cenário.

Ações

Adicionar um campo personalizado

Este módulo de ação adiciona um campo personalizado ao documento

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar DocuSign ao Workfront Fusion neste artigo.
Conta
Selecione a conta que contém o documento ao qual você deseja adicionar um campo personalizado.
ID de Envelope
Insira ou mapeie a ID do envelope que contém o documento ao qual você deseja adicionar um campo personalizado.
Nome do campo
Insira ou mapeie um nome para o novo campo que deseja adicionar.
Necessário
Ative essa opção se desejar que o campo adicionado seja um campo obrigatório.
Mostrar campo
Ative essa opção se desejar que o campo fique visível.
Valor
Insira ou mapeie o valor (conteúdo) do campo adicionado.

Adicionar Destinatário ao Envelope

Este módulo de ação adiciona um ou mais destinatários a um envelope existente. Se o envelope já tiver sido enviado, o recipient receberá um email. Este módulo não é válido para envelopes que já foram concluídos.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Criar uma conexão - Instruções básicas.
Conta
Selecione a conta que contém o envelope no qual deseja adicionar recipients.
ID de Envelope
Selecione ou mapeie a ID do envelope ao qual deseja adicionar o recipient.
Tipo de destinatário

Selecione o tipo de destinatário que deseja adicionar ao envelope.

  • Agent

  • Cópia carbono

  • Entrega certificada

  • Assinante presencial

  • Intermediário

  • Signatário

Email
Insira ou mapeie o endereço de email do destinatário que deseja adicionar ao envelope.
Nome
Insira ou mapeie o nome do destinatário que deseja adicionar ao envelope.
Ordem de roteamento
Insira ou mapeie o número do roteamento do recipient. O número do banco determina a ordem na qual os destinatários recebem e assinam seus documentos.
corpo do email
Insira ou mapeie o corpo (conteúdo) do email enviado ao destinatário.
Assunto do email
Insira ou mapeie o assunto do email enviado ao recipient.
Mensagem privada

Se desejar enviar uma mensagem privada para o recipient, insira ou mapeie o texto da mensagem.

Somente o recipient selecionado vê a mensagem privada, bem como a mensagem geral. A mensagem privada é limitada a 1000 caracteres.

Autenticação

Selecione o método de autenticação que deseja usar para confirmar a identidade do recipient.

  • Nenhum

  • Código de acesso

    Insira ou mapeie o código de acesso.

  • Telefone

    Insira ou mapeie o número de telefone.

  • SMS

    Insira ou mapeie o número de telefone.

Criar um novo envelope

Este módulo de ação cria um novo envelope a partir de um modelo. Ele retorna a ID do novo envelope, bem como o status do novo envelope.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte os artigos em Criar uma conexão - Instruções básicas.
Conta
Selecione a conta que contém o envelope no qual você deseja carregar um arquivo.
Modelo
Selecione o modelo a partir do qual deseja criar o novo envelope. Os modelos estão disponíveis com base na Account selecionada.
Após criação
Selecione se deseja salvar o envelope como rascunho ou enviá-lo para assinatura.
Destinatários do modelo

Para cada destinatário que você deseja adicionar a este envelope, clique em Adicionar item e insira os seguintes detalhes:

  • Código de acesso

    Insira ou mapeie o código que o destinatário usa para acessar o envelope.

  • Email

    Insira ou mapeie o endereço de email do recipient.

  • Nome

    Insira ou mapeie o nome do recipient.

  • Nome da função

    Insira ou mapeie o nome da função do recipient.

  • Ordem de roteamento

    Insira ou mapeie o número do roteamento do recipient. O número do banco determina a ordem na qual os destinatários recebem e assinam seus documentos.

Permitir Impressão e Assinatura
Habilite esta opção para permitir que o destinatário imprima o documento e assine o papel.
Permitir Reatribuição
Ative essa opção se desejar que o recipient possa reatribuir os documentos a outro usuário.
Permitir Recursão de Destinatário
Habilite esta opção para permitir a recursão do destinatário.
Cópia Autoritativa
Habilite esta opção para marcar os documentos deste envelope como cópias autoritativas.
Navegação Automática
Habilite esta opção para definir a navegação automática para o recipient.
Identificação da Marca
Insira ou mapeie a ID da marca.
Marcação Habilitada
Habilite esta opção para habilitar a Marcação do documento.
Expirar Habilitado

Habilite esta opção para definir uma expiração para este envelope. Se você ativar essa opção, preencha os seguintes campos:

  • Expirar após

    Insira ou mapeie o número de dias após o qual este envelope expira.

  • Aviso de expiração

    Insira ou mapeie o número de dias antes da expiração em que um email de lembrete é enviado ao destinatário.

Corpo
Insira ou mapeie o corpo (conteúdo) do email que acompanha este envelope.
Assunto
Insira ou mapeie o assunto do email que acompanha este envelope.

Chamada de API personalizada

Esse módulo de ação permite executar uma chamada de API personalizada.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar DocuSign ao Workfront Fusion neste artigo.
Conta
Insira ou mapeie a conta que deseja usar para acessar a API DocuSign.
URL
Insira ou mapeie um caminho relativo a https://<BASE_URI>/v2/accounts/<ACCOUNT_ID>.
Método
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Cabeçalhos

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão. Isso determina o tipo de conteúdo da solicitação.

Por exemplo, {"Content-type":"application/json"}

Observação: se você estiver recebendo erros e for difícil determinar sua origem, considere modificar cabeçalhos com base na documentação do Workfront. Se sua chamada de API personalizada retornar um erro de solicitação HTTP 422, tente usar um cabeçalho "Content-Type":"text/plain".

Cadeia de Consulta

Adicione a consulta da chamada à API na forma de um objeto JSON padrão.

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

Corpo

Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.

Observação:

Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.

Limite
Insira ou mapeie o número máximo de resultados com os quais trabalhar durante um ciclo de execução.
recommendation-more-help

Exemplo: Envelopes de Lista

A chamada de API a seguir retorna envelopes a partir da data especificada em sua conta DocuSign:

URL: /v2.1/accounts/{accountId}/envelopes/

Método: GET

Cadeia de Caracteres de Consulta:

  • Chave: from_date

  • Valor: YYYY-MM-DD

Especifica quando a solicitação começa a verificar alterações de status para envelopes na conta.

Exemplo de configuração de Documentação

O resultado pode ser encontrado na Saída do módulo em Pacote > Corpo > envelopes.

No nosso exemplo, 6 envelopes foram retornados:

Exemplo de saída de documento

Baixar um documento

Este módulo de ação baixa um único documento.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar DocuSign ao Workfront Fusion neste artigo.
Conta
Selecione a conta que contém o documento que você deseja baixar.
ID de Envelope
Insira ou mapeie a ID do envelope que deseja baixar.
ID de Documento
Insira ou mapeie a ID do documento que deseja baixar.
Certificado
Habilite esta opção para incluir o certificado de assinatura do envelope no download.
Documentos por ID de Usuário
Habilite esta opção para permitir que os destinatários recuperem documentos por ID de usuário. Por exemplo, se um usuário estiver incluído em duas ordens de roteiro diferentes com visibilidades diferentes, o uso dessa opção retornará todos os documentos de ambos os roteiros.
Criptografar
Habilite esta opção se quiser que os bytes do PDF retornados na resposta sejam criptografados para todos os gerenciadores de chaves configurados na sua conta DocuSign.
Idioma
Selecione o idioma.
Mostrar Alterações
Habilite esta opção para realçar quaisquer campos alterados para o PDF retornado são realçados em amarelo, e destacar assinaturas opcionais ou iniciais em vermelho.
Marca D'Água
Habilite essa opção para habilitar o recurso de marca d'água.

Modificar campo personalizado

Esse módulo de ação modifica um campo personalizado usando o nome do campo.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar DocuSign ao Workfront Fusion neste artigo.
Conta
Selecione a conta que contém o documento no qual você deseja modificar um campo personalizado.
ID de Envelope
Insira ou mapeie a ID do envelope que contém o documento no qual você deseja modificar um campo personalizado.
ID de Campo
Insira ou mapeie a ID do campo que você deseja modificar.
Nome do campo
Insira ou mapeie o nome do campo que você deseja modificar.
Necessário
Habilite essa opção se desejar que o campo modificado seja obrigatório.
Mostrar campo
Ative essa opção se desejar que o campo fique visível.
Valor
Insira ou mapeie o valor (conteúdo) do campo modificado.

Ler um envelope

Este módulo de ação lê informações sobre um envelope em DocuSign usando a ID de envelope.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar DocuSign ao Workfront Fusion neste artigo.
Conta
Selecione a conta que contém o documento do qual deseja ler informações.
ID de Envelope
Insira ou mapeie a ID do envelope que contém o documento do qual você deseja ler as informações.
Saídas
Selecione as propriedades que você deseja que apareçam na saída do módulo.

Enviar envelope

Esse módulo de ação envia um envelope de rascunho para seus recipients.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar DocuSign ao Workfront Fusion neste artigo.
Conta
Selecione a conta que contém o envelope de rascunho que você deseja enviar aos recipients.
ID de Envelope
Insira ou mapeie a ID do envelope de rascunho que você deseja enviar aos recipients.

Carregar um arquivo em um envelope

Este módulo carrega um arquivo especificado em um envelope existente no DocuSign.

Conexão
Para obter instruções sobre como conectar sua conta do DocuSign ao Workfront Fusion, consulte Conectar DocuSign ao Workfront Fusion neste artigo.
Conta
Selecione a conta que contém o envelope no qual você deseja carregar um arquivo.
ID de Envelope
Insira ou mapeie a ID do envelope no qual deseja fazer upload de um arquivo.
arquivo Source
Selecione um arquivo de origem de um módulo anterior ou insira o nome e os dados do arquivo de origem.
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3