Adobe Acrobat Sign for Salesforce: manual de atualização

A partir da v21.0, o objeto SIGN_Signed_Agreement__c (nome do rótulo: Contrato assinado") foi descontinuado.

Os clientes que desejam obter o URL do contrato assinado devem usar a chamada de contrato da API REST GET /agreements/{agreementId}/combinedDocument/url

Nota: o URL retornado da chamada de API é protegido e só é viável por tempo limitado.

Veja abaixo a nova sequência (a partir de v21.0) em que o contrato e seus objetos relacionados são atualizados:

1. Anexos 
2. Destinatários 
3. Contrato (status e outros atributos)
4. Eventos do contrato 
5. Feeds do Chatter 

A partir da v21.x, todos os processos assíncronos que incluem atualizações automáticas e mapeamentos de dados são alternados de métodos futuros para métodos de enfileiramento, uma nova abordagem recomendada pelo Salesforce.

Devido a essa alteração, todas as personalizações na organização do assinante que adicionam processos à fila do Salesforce como parte da atualização automática e/ou do processo de mapeamento de dados falharão com um erro “System.LimitException: muitos processos foram adicionados à fila: 2”

Isso acontece porque um processo em fila pode adicionar somente uma tarefa secundária em fila, que já foi usada pelo Adobe Sign (consulte a seção "Limites de Apex em fila" aqui).

"Ao alterar tarefas, é possível adicionar somente uma tarefa de uma tarefa em execução com System.enqueueJob, o que significa que somente uma tarefa secundária pode existir para cada tarefa principal em fila. Iniciar várias tarefas secundárias a partir da mesma tarefa em fila não é compatível."

O sintoma desse erro é que o status do contrato não é alterado e/ou o mapeamento de dados não é executado corretamente. 

Para solucionar esse erro, localize o acionador, construtor de processo ou fluxo de trabalho com problema e desative ou alterne-o para usar uma chamada assíncrona ou agende ele para futuramente, uma hora mais tarde, por exemplo.

• Agora o status do contrato é atualizado após a atualização dos documentos e destinatários.
  Na v21 e em versões anteriores, o status era definido antes da atualização.

• O objeto Contrato assinado que armazena os URLs de imagem não está inserido agora.
  Na v21, ele era inserido após a conclusão de todas as outras atualizações.
• O tamanho máximo da solicitação ou resposta de callout é limitado a 12 MB para um processo assíncrono do Apex, de acordo com os limites do administrador do Salesforce: https://developer.salesforce.com/docs/atlas.pt-BR.210.0.apexcode.meta/apexcode/apex_gov_limits.htm
  Documentos maiores que 12 MB não podem ser obtidos do Sign devido ao limite acima.

• As descrições do evento do contrato agora correspondem à descrição retornada pela API do Sign e nos relatórios de auditoria.
• O processo de atualização agora é executado como um processo em lote nativo do Apex (um processo assíncrono) no Salesforce.
  Anteriormente, a atualização era feita usando chamadas de API de fora do Salesforce. Desativar essas atualizações de status que iniciam processos assíncronos não funciona mais porque o Salesforce limita a chamada de outro processo assíncrono de um processo assíncrono já em execução.
• O objeto do contrato agora é atualizado em uma única transação.
  Antes da v21, as atualizações de atributo do contrato eram divididas em chamadas de atualização separadas.
• Agora as atualizações são mais confiáveis porque o back-end do Sign repete automaticamente os eventos com falha por um número de vezes especificado.
  Antes da v21, os contratos com falha só podiam ser repetidos ao realizar uma atualização manual no Salesforce
• Agora as atualizações manuais atualizam todos os aspectos dos contratos, incluindo os objetos relacionados.
• Os contratos por push agora são executados no modo assíncrono, da mesma maneira que as atualizações regulares e outros atributos são atualizados.
• Novas configurações foram inseridas para habilitar e desabilitar atualizações de diferentes aspectos do contrato.
• Quando um PDF assinado for armazenado no Salesforce, não haverá mais um descritor (assinado ou aprovado) adicionado ao final do nome do arquivo PDF.

Após a conclusão da atualização, siga as etapas abaixo para restabelecer uma conexão OAuth com o Acrobat Sign:

1. Selecione a guia Administrador do Adobe Acrobat Sign.
2. Selecione Habilitar atualizações automáticas de status.
3. Selecione Habilitar.
4. Selecione Permitir.

Na v20, o usuário de callback do Salesforce não precisava ser um usuário licenciado do Adobe Sign. 

Na v21, as melhorias no mapeamento por push exigem que o usuário de callback tenha uma ID de usuário ativa na conta do Acrobat Sign que está conectada à organização do Salesforce.

Os clientes da v20 que usam o mapeamento por push devem garantir que o usuário de callback já esteja provisionado no Adobe Acrobat Sign antes da atualização. Caso contrário, o mapeamento por push deixará de funcionar (até que o usuário seja provisionado) após a atualização para a v21.

A funcionalidade de mapeamento por push que vinculava automaticamente os objetos relacionados usando a configuração “Copiar conta do contato/oportunidade” foi expandida para incluir os contratos enviados do Salesforce.

• Por exemplo, os contratos enviados do Salesforce copiarão automaticamente o primeiro contato de oportunidade da pesquisa do destinatário para a pesquisa de oportunidade do contrato, bem como o primeiro contato de conta para a pesquisa de conta do contrato, se os contratos enviados não tiverem nenhuma conta/oportunidade vinculada

Antes da v21, os feeds do Chatter foram preenchidos somente quando o contrato foi enviado no Salesforce.

Esta atualização expande o feed do Chatter para incluir contratos enviados de fora do Salesforce (contratos por push)

Antes da v21, a exibição de contrato só atualiza a imagem e URL do PDF depois que o primeiro destinatário concluir a ação.

A imagem e o URL agora atualizam anteriormente, quando em um status Pré-preenchimento ou Enviado para assinatura para o primeiro destinatário.

Nenhuma configuração é necessária para ativar essa funcionalidade.

Um novo status de contrato Aguardando minha delegação está sendo introduzido para refletir quando um contrato está aguardando o remetente delegar a autoridade de destinatário atual.

Nenhuma configuração é necessária para ativar esse status.

O Modelo de contrato possui um campo "Dias até a expiração" (echosign_dev1__Days_Until_Expiration__c).  Ele é um campo numérico, e foi descontinuado na v21.

Um novo campo “Dias até a expiração” (nome da api: echosign_dev1__Days_Until_Expiration2__c) foi adicionado, porém, esse é um campo de texto que permite referenciar outros campos no objeto principal (por exemplo: {!Expiry_Date__c})

Ao atualizar de uma versão anterior, todos os dados do formulário mapeados para o campo de expiração herdado são copiados automaticamente para o novo campo, portanto, nenhuma ação direta é necessária.

Os campos Conta, Oportunidade, e Contrato não estarão mais disponíveis na página do modelo.

Os administradores podem configurar esses campos no modelo usando o recurso Mapear dados nos campos do contrato

Anteriormente, os remetentes podiam definir sua posição absoluta na fila de assinatura como “Remetente assina primeiro” ou “Remetente assina por último”.

Este campo não está mais disponível nas páginas do novo modelo. Os remetentes têm a opção de se inserir em qualquer posição da fila de assinatura.

A opção de alternar o controle do fluxo geral de assinatura entre “Sequencial” ou “Paralelo” foi removida.

O estilo do novo modelo permite um fluxo de trabalho totalmente configurável que pode ser completamente sequencial (índice do signatário 1 até 1+N), paralelo (todos os índices do signatário são 1) ou uma mistura de sequencial e paralelo, na qual o índice da assinatura é configurado para o fluxo de trabalho específico.

Cinco configurações foram descontinuadas na v21. Todas as configurações estavam na seção Configurações do Adobe Sign de Configurações personalizadas.

As cinco configurações são:

• Adicionar PDF de auditoria à lista de anexos - ative esta configuração para anexar o PDF da trilha de auditoria ao registro depois que o contrato for assinado.
• Adicionar PDF assinado como anexos separados - ative esta configuração para anexar o PDF dos contratos assinados como anexos separados quando houver vários documentos enviados em uma única transação. Para interromper o recebimento do contrato assinado como um PDF mesclado, entre em contato com o Atendimento ao cliente da Adobe para obter assistência.
• Adicionar arquivos de suporte à lista de anexos - ative esta configuração para anexar os PDFs dos documentos de suporte ao registro de contrato depois que o contrato for assinado. Por meio dos campos de documento de suporte no contrato, os signatários carregam e anexam os documentos de suporte à transação de contrato.
• Adicionar link do PDF assinado para contratos por push (habilitada por padrão): esta configuração se aplica apenas a contratos por push enviados de fora do Salesforce. Habilite essa configuração para adicionar um link para o PDF assinado ao registro do contrato.
• Adicionar PDF assinado para contratos por push (habilitada por padrão): a configuração se aplica aos contratos enviados de fora do Salesforce e inseridos no Salesforce. Habilite essa configuração para anexar o PDF assinado ao registro do contrato. 

Os clientes que estão usando as configurações acima podem configurar a nova configuração em Configurações de atualização de contrato do Adobe Sign.