Na página do Salesforce Lightning, navegue até a guia Administrador do Adobe Acrobat Sign.
Última atualização em
16 de out de 2024
Não é possível enviar contratos do Salesforce? Os mapeamentos de dados não atualizam os campos do Salesforce?
O Guia de solução de problemas do Adobe Acrobat Sign for Salesforce foi desenvolvido para ajudar você a resolver problemas no envio de contratos do Salesforce, com mapeamentos de dados ou com atualizações automáticas de status. Veja como:
- Solucionar problemas de falha de mapeamentos de dados
- Solucionar problemas ao enviar contratos
- Solucionar problemas em atualizações automáticas de status
- Solucionar problemas que podem ocorrer após habilitar domínios aprimorados
- Solucionar problemas ao procurar leads no ambiente da Government Cloud
- Contate o suporte
Os mapeamentos de dados do Acrobat Sign atualizam os objetos do Salesforce quando o contrato do Acrobat Sign é assinado ou em um estágio especificado no fluxo de trabalho do contrato. Cada Mapeamento de dados é configurado com antecedência e inclui regras de mapeamento de dados. Cada regra de mapeamento de dados define a fonte de dados e o campo do Salesforce de destino que ela precisa atualizar. Para obter detalhes, consulte Mapeamento de dados do Salesforce.
Se o mapeamento de dados não conseguir atualizar um campo do Salesforce, execute as seguintes etapas de solução de problemas para identificar e corrigir o problema:
Para fazer isso:
Selecione Permitir. A seguinte mensagem será exibida: “As atualizações automáticas de status estão habilitadas para esta organização.”
Verifique se o usuário da atualização automática de status (geralmente o administrador de conta do Sign que você usou para configurar a integração) e o remetente têm acesso aos objetos que você está tentando atualizar com o mapeamento de dados.
Para verificar o valor do campo, você pode adicioná-lo à exibição de lista Contratos, ou usar o Developer Console ou Workbench.
Certifique-se de que o campo 'Resultado do mapeamento de dados' no objeto 'Agreement' tenha o valor 'Concluído' ou 'Falhado'. Se não houver valor, significa que o mapeamento de dados não foi acionado.Se o valor estiver vazio e se o campo “Mapeamento de dados” tiver a ID de usuário preenchida, tente acionar novamente o mapeamento de dados da seguinte maneira:
O campo Erro de mapeamento de dados armazena erros do mapeamento de dados. Você pode verificar o valor do campo adicionando o campo à exibição de lista Contratos, usando o Developer Console ou o Workbench. Veja abaixo uma lista de erros comuns e as etapas de resolução correspondentes:
| Erro | Failed to map data field: System.DmlException Update failed. Primeira exceção na linha 0 com a ID 00ZxxqwertasdmjVUAR; primeiro erro: STRING_TOO_LONG, título do proprietário: o valor dos dados é muito grande: Adobe Acrobat Sign Adobe inc (max length=20): [Owner_Title__c] (echosign_dev1) 165 |
Resolução: Esse erro significa que os dados no campo de formulário do documento atualizado excedem o limite de tamanho do campo do Salesforce que você está tentando atualizar. Para resolver:
|
|
| Erro |
Tentativa de mapear para uma referência de objeto relacionada que não foi definida no contrato: <api name of field on the Salesforce object you are trying to update>” |
Resolução: Esse erro significa que não há uma conexão estabelecida entre o objeto Contrato e o objeto Salesforce que você está tentando atualizar. Consulte a etapa 4 acima. |
|
| Erro |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Solução Este erro indica que houve uma falha no mapeamento de dados porque não foi possível acessar um objeto obrigatório. Execute as etapas a seguir para solucionar o problema:
|
Usuário de exemplo:
John Smith
Caso de uso de exemplo:
John deseja:
- Enviar contratos de um objeto personalizado chamado “Demonstração 1” usando um modelo de contrato;
- Extrair informações de outro objeto personalizado chamado “Demonstração 2”, que está associado ao objeto “Demonstração 1”, e enviá-las para o contrato;
- Enviar as informações para o registro do objeto “Demonstração 2” assim que o contrato for assinado.
Etapas para obter o caso de uso:
- No objeto “Contrato” do Acrobat Sign, crie um campo de pesquisa para o objeto “Demonstração 1”.
- No objeto 'Demo 1', crie um campo de pesquisa para o objeto 'Demo 2'.
Não é possível obter ou enviar informações de/para uma lista relacionada. - Crie um modelo de mapeamento de dados da seguinte maneira:
- Forneça um nome exclusivo para o modelo.
- Em Mapeamentos de campos, selecione Objeto selecionado e, em seguida, no menu suspenso, selecione Demonstração 1.
- Na segunda lista suspensa que é carregada, selecione ID da demonstração 2.
- No terceiro menu suspenso que é carregado, escolha a opção “Nenhum” e clique em Selecionar.
- Em “Qual campo do Salesforce deve ser atualizado?”, escolha o nome do campo que você precisa atualizar.
- Para concluir a configuração do mapeamento de dados, siga as etapas na seção Usar mapeamentos de dados para enviar dados e arquivos do signatário para os registros do Salesforce do Guia de mapeamentos e modelos.
- Crie um modelo de mapeamento de mesclagem da seguinte maneira:
- Forneça um nome exclusivo para o modelo.
- Selecione Adicionar mapeamento de campo.
- Em Valor de origem, selecione Objeto selecionado e, em seguida, no menu suspenso, selecione Demonstração 1.
- Na segunda lista suspensa que é carregada, selecione ID da demonstração 2.
- Na próxima lista suspensa que for carregada, selecione o nome de campo com o valor que você precisa extrair e clique em Concluído.
- Para concluir a configuração do mapeamento de mesclagem, siga a seção Usar mapeamentos de mesclagem para gerar documentos com dados do Salesforce do Guia de mapeamentos e modelos.
- Crie um modelo de contrato seguindo as etapas da seção Criar fluxos de trabalho de modelos.
- No modelo de contrato criado acima, certifique-se de que os modelos de mapeamento de mesclagem e de mapeamento de dados estejam incluídos na seção “Mapeamento de dados”.
- Na seção Detalhes do modelo do modelo do contrato, selecione o objeto Salesforce como Demonstração 1.
- Selecione Mapear dados nos campos do contrato e, em seguida, na caixa de diálogo exibida:
- Selecione a opção Selecionar do objeto.
- Em Tipo de origem, selecione ID da demonstração 1.
- Em Campo do contrato de destino, selecione o objeto Demonstração 1 no campo de pesquisa.
- Selecione Salvar.
- No modelo de acordo, selecione Salvar.
Isso cria um modelo de acordo vinculado ao objeto 'Demo 1' com mapeamento de mesclagem e mapeamento de dados habilitados. - Abra um registro de objeto da “Demonstração 1” e selecione
> Editar página. Em seguida, na seção Gerenciamento personalizado do painel esquerdo, arraste e solte o AgreementPanel e clique em Salvar. - Selecione Ativação e atribua a página de registro conforme suas necessidades. Para fins de teste, escolha “Atribuir como padrão da organização”, o que expõe o “AgreementPanel” a todos os usuários.
- Clique em Próximo e Salvar.
- Navegue até o registro do objeto “Demonstração 1” e atualize a página. O painel “AgreementPanel” que você adicionou deverá ser exibido.
- Selecione Enviar contrato para assinatura. Isso exibe o modelo de contrato que você criou.
- Selecione o modelo de contrato e siga as etapas na tela para enviar o contrato. Verifique se o contrato inclui os dados mesclados da “Demonstração 2”.
- Assine o contrato. Isso mostra o registro da “Demonstração 2” atualizado com o valor do contrato.
Se você não conseguir enviar contratos do Salesforce, execute as seguintes etapas de solução de problemas:
Certifique-se de estar em uma versão compatível do Adobe Acrobat Sign. Consulte as versões compatíveis.
Certifique-se de que você, como remetente, tenha as permissões necessárias.
Consulte como conceder acesso necessário aos usuários. Além dos objetos e campos mencionados no guia, o remetente deve ter acesso a outros objetos do Salesforce que estão sendo usados no fluxo de trabalho.
Verifique se o objeto “Contrato” ou outros objetos do Acrobat Sign no Salesforce têm personalizações, como acionadores, fluxos de trabalho ou regras. Se sim, desabilite todas as personalizações e envie um acordo de teste para ver se funciona.
Se o acordo for enviado com sucesso após desabilitar as personalizações, consulte nosso guia do desenvolvedor para orientações.
Nota
Não oferecemos suporte para solução de problemas de personalizações.
Use uma das seguintes maneiras para identificar o tipo de erro recebido ao enviar o contrato:
- Abra o registro de contrato afetado no Salesforce e verifique se há um banner vermelho com uma mensagem de erro. Esse erro deve indicar a causa raiz.
- Verifique o campo “Mensagem de erro” no objeto “Notificação do contrato”.
- Para verificar por meio do Developer Console, execute a seguinte consulta SOQL:
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<enter agreement id>
Consulte a seguinte tabela de erros e etapas para solucioná-los:
|
Erro |
Solução |
|---|---|
|
ID do usuário ou email inválido fornecido no cabeçalho x-api-user Você não tem uma conta de usuário do Adobe Acrobat Sign válida |
Estes erros indicam que o remetente não tem uma licença válida do Acrobat Sign. Para solucioná-los:
|
|
Formato de arquivo incompatível |
Este erro ocorre quando o documento que você está tentando enviar para assinatura não está em um formato compatível. Consulte a seção Formatos de documento compatíveis em Requisitos do sistema do Acrobat Sign para verificar quais formatos de arquivo podem ser enviados para o Acrobat Sign. |
|
ID do objeto incorreta usado no botão de assinatura |
Este erro ocorre quando a ID do modelo ou a ID principal do objeto do botão Enviar em nome de não é válida. Sugerimos que você insira a ID do objeto correta e, em seguida, tente repetir o processo. |
Se um contrato não for atualizado com o status correto, execute as seguintes etapas de solução de problemas:
Verifique se você implementou os pré-requisitos e as configurações pós-instalação (obrigatório) mencionados no Adobe Acrobat Sign para Salesforce: manual de instalação.
Na página do Salesforce Lightning, acesse Administrador do Adobe Acrobat Sign > Ativar atualizações de status automáticas e verifique se a mensagem “As atualizações de status automáticas estão ativadas para esta organização” é exibida.
Se a mensagem não for exibida, siga estas etapas:
- Faça logout e logon novamente como administrador do sistema.
- Acesse Administrador do Adobe Acrobat Sign > Ativar atualizações de status automáticas e selecione Ativar.
- Na caixa de diálogo “Permitir acesso ao Acrobat Sign”:
- Anote o endereço de email na parte inferior da caixa de diálogo.
- Verifique se este endereço de email tem uma licença válida do Sign e se é um administrador de sistema no Salesforce.
- Verifique se o usuário tem o conjunto de permissões “Usuário de integração do Adobe Sign” atribuído.
- Selecione Permitir.
A mensagem “As atualizações de status automáticas estão ativadas para esta organização” deve ser exibida.
No objeto “Notificação de contrato”, verifique o campo Mensagem de erro. Para verificar o valor no campo, execute a consulta SOQL abaixo no Developer Console:
SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'
Se for um contrato por push criado fora do ambiente do Salesforce, siga o Adobe Acrobat Sign para Salesforce: manual de serviço de documentos grandes e contratos por push.
Clique na guia Contratos, selecione todos os contratos com falha na atualização e, no canto superior direito, selecione Atualizar contrato.
Verifique se o status é atualizado nesses contratos. Se estiverem atualizados, verifique se o problema ainda pode ser reproduzido com um novo contrato de teste. Se ocorrer novamente, continue com as etapas de solução de problemas abaixo.
Se o problema não ocorrer de novo, pode ter sido uma instância única e sugerimos que você consulte este manual de solução de problemas quando o problema ocorrer novamente.
Verifique se o objeto “Contrato” ou outros objetos do Acrobat Sign no Salesforce têm personalizações, como acionadores, fluxos de trabalho ou regras.
Em caso afirmativo, desative todas as personalizações e envie um contrato de teste seguindo as etapas usuais e veja se ele é aprovado. O status deve mudar de “Rascunho” para “Enviado para assinatura”.
Se o status do contrato muda para “Enviado para assinatura” após a desativação das personalizações, consulte nosso manual do desenvolvedor para obter as diretrizes.
Se o status não for atualizado, envie um contrato de teste diretamente da guia “Contratos” com as personalizações desativadas e verifique se ele é aprovado. Se mesmo assim o status não mudar, verifique as etapas 1 e 2 mencionadas acima.
Nota
Não oferecemos suporte para solução de problemas de personalizações.
| Objetos do Acrobat Sign | ||
|---|---|---|
| Adicionar anexos | Mapeamentos de arquivos | Mapear dados nos campos do contrato |
| Adicionar modelos de campo de formulário | Importações do campo de formulário | Mesclar mapeamentos |
| Adicionar destinatários | Mapeamento secundário do campo de formulário | Mutexes |
| Contratos | Entrada do mapeamento secundário do campo de formulário | Mapeamentos de objeto |
| Eventos do contrato | Mapeamentos de campo de formulário | Destinatários |
| Modelos de contrato | Entradas de mapeamento do campo de formulário | Contrato assinado |
| Mapeamentos de dados | Mapeamentos de grupo | Disparadores |
| Mapeamentos de campo | Modelos de biblioteca | Resultados de sincronização de usuário |
| Tipo de contrato | ||
Todas as organizações agora têm a opção de domínios aprimorados do Salesforce habilitada por padrão, o que não afeta o pacote do Acrobat Sign para Salesforce. No entanto, os clientes que configuraram seus sites para fazer download de arquivos grandes e permitir contratos por push enfrentam problemas quando seus domínios aprimorados estão habilitados, resultando na alteração dos URLs do site e gerando contratos corrompidos.
Para garantir o bom funcionamento dos contratos, os clientes precisam atualizar as configurações personalizadas de download de arquivos grandes para refletir o URL atualizado do site.
Para atualizar o URL de callback dos contratos por push, os clientes precisam entrar em contato com o suporte e fornecer as informações necessárias. Para obter mais detalhes, consulte como Obter serviços individuais configurados para sua conta do Acrobat Sign.
O Acrobat Sign for Salesforce permite pesquisar e adicionar leads como destinatários de contratos quando Leads é selecionado como o tipo de destinatário. No entanto, se os usuários da Government Cloud criarem leads, contatos ou usuários, mas não conseguirem localizá-los usando o campo Pesquisar, os administradores da organização do Salesforce podem seguir estas etapas de resolução:
- Acesse Configuração > Gerenciador de objeto e pesquise por Lead.
- No painel esquerdo, selecione Campos e relações.
- Para todos os campos obrigatórios (como Nome, Email, Dispositivo móvel e outros), verifique a acessibilidade para os usuários. Para fazer isso:
- Selecione qualquer campo que deseja verificar. Por exemplo, selecione Dispositivos móveis.
- Para todos os usuários para os quais você deseja habilitar o acesso ao campo, marque a caixa de seleção Visível.
- Clique em Salvar.
Se o problema não for resolvido mesmo após seguir as etapas de solução acima, entre em contato com o suporte e forneça os seguintes detalhes:
- Descrição do problema
- Endereço de email do administrador da conta do Acrobat Sign usado para configurar a integração
- Endereço de email do administrador da conta do Acrobat Sign que foi usado para ativar as atualizações de status automáticas:
- Versão do pacote do Acrobat Sign instalada no Salesforce
- ID organizacional do Salesforce
- IDs de registros do Salesforce de contratos afetados
- Endereço de email do usuário afetado
- O problema pode ser reproduzido de maneira consistente, é intermitente ou só ocorreu uma vez?
- Data da última ocorrência: <Informe a data/hora/fuso horário da última ocorrência conhecida>
- Etapas para replicar o problema
- Comportamento esperado: <Descreva o comportamento que você espera quando as etapas são executadas>
- Notas sobre solução de problemas: <Forneça detalhes da solução de problemas feita até agora com esta documentação>
Simplifique seu trabalho com o Acrobat Sign
Gerencie e assine documentos online de forma rápida e fácil.
