Na página do Salesforce Lightning, navegue até a guia Administrador do Adobe Acrobat Sign.
- Integrações do Adobe Acrobat Sign
- Novidades
- Versões e ciclo de vida do produto
- Acrobat Sign para Salesforce
- Instalar o pacote
- Configurar o pacote
- Guia do usuário
- Manual do desenvolvedor
- Manual avançado de personalização
- Guia de mapeamento de campo e modelos
- Guia do usuário do aplicativo móvel
- Guia de automação de fluxos
- Guia do Document Builder
- Configurar documentos grandes
- Guia de atualização
- Notas de versão
- Perguntas frequentes
- Manual de solução de problemas
- Artigos adicionais
- Acrobat Sign para Microsoft
- Acrobat Sign para Microsoft 365
- Acrobat Sign para Outlook
- Acrobat Sign para Word/PowerPoint
- Acrobat Sign para Teams
- Acrobat Sign para Microsoft PowerApps e Power Automate
- Conector do Acrobat Sign para Microsoft Search
- Acrobat Sign para Microsoft Dynamics
- Acrobat Sign para Microsoft SharePoint
- Visão geral
- SharePoint local: guia de instalação
- SharePoint local: guia de mapeamento de modelo
- SharePoint local: guia do usuário
- SharePoint local: notas de versão
- SharePoint Online: guia de instalação
- SharePoint Online: guia de mapeamento de modelo
- SharePoint Online: guia do usuário
- SharePoint Online: guia de mapeamento de formulário web
- SharePoint Online: notas de versão
- Acrobat Sign para Microsoft 365
- Acrobat Sign for ServiceNow
- Acrobat Sign for HR ServiceNow
- Acrobat Sign for SAP SuccessFactors
- Acrobat Sign for Workday
- Acrobat Sign for NetSuite
- Acrobat Sign for SugarCRM
- Acrobat Sign for VeevaVault
- Acrobat Sign for Coupa BSM Suite
- Documentação do desenvolvedor do Acrobat Sign
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:
-
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.
Verifique se o campo “Resultado do mapeamento de dados” no objeto “Contrato” tem o valor de “Concluído” ou “Falha”. Se não houver nenhum valor, isso 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 |
Resoluçã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 “Demonstração 1”, crie um campo de pesquisa para o objeto “Demonstração 2”.
Você não pode extrair 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 do contrato, selecione Salvar.
Isso cria um modelo de contrato vinculado ao objeto “Demonstração 1” com a opção de mapeamento de dados/mesclagem habilitada. - 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 o 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, desative todas as personalizações e envie um contrato de teste para ver se ele funciona.
Se o contrato for enviado com êxito após a desativação das personalizações, consulte nosso guia do desenvolvedor para obter orientações.
Observação: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>
-
Os erros “ID de usuário ou email inválido fornecido no cabeçalho x-api-user” e “Você não tem uma conta de usuário válida do Adobe Acrobat Sign” indicam que o remetente não tem uma licença válida do Acrobat Sign. Siga estas etapas para solucionar o problema:
- Marque o campo “Remetente registrado” no registro do contrato para identificar o remetente.
Se um usuário no campo “Remetente registrado” não puder ser encontrado no Salesforce, o pacote do Acrobat Sign usará o campo “Criado por” como o “remetente” do contrato. - Navegue até a página “Detalhes do usuário” do remetente no Salesforce e verifique se o campo Email tem um endereço de email válido e uma licença ativa do Sign.
Para verificar se o endereço de email tem uma licença ativa do Sign: - Faça logon no Acrobat Sign usando credenciais de administrador.
- Navegue até Conta > Usuários e procure o endereço de email.
O status do usuário deve estar ativo. Os usuários que não têm um status “ativo” não podem enviar contratos. Se o usuário não estiver ativo, veja como Adicionar e gerenciar usuários e consulte as etapas na seção “O email está em uso, mas o status do usuário não está Ativo”. - Se a opção Enviar em nome de (SOB) for usada, valide o endereço de email do usuário SOB marcando o campo chamado “Enviar em nome de” no objeto “Contrato”. Verifique se o endereço de email deste usuário tem uma licença válida do Sign fazendo logon no Acrobat Sign conforme mencionado acima. Verifique se o campo “Permitir envio como outros usuários” está ativado na página Detalhes do usuário da opção SOB. Esse campo pode não estar visível no layout da página do objeto Usuário por padrão.
- Verifique as permissões do usuário conforme mencionado na Etapa # 2 acima. Consulte como conceder acesso necessário aos usuários.
- Marque o campo “Remetente registrado” no registro do contrato para identificar o remetente.
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.
-
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.
Observação: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>