Guia do Usuário Cancelar

Adobe Acrobat Sign for Salesforce: guia de resolução de problemas

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

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:

Usar mapeamento de dados e mesclagem para enviar contratos: Cenário de exemplo

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:

  1. No objeto “Contrato” do Acrobat Sign, crie um campo de pesquisa para o objeto “Demonstração 1”.
  2. 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. 
  3. Crie um modelo de mapeamento de dados da seguinte maneira:
    1. Forneça um nome exclusivo para o modelo.
    2. Em Mapeamentos de campos, selecione Objeto selecionado e, em seguida, no menu suspenso, selecione Demonstração 1
    3. Na segunda lista suspensa que é carregada, selecione ID da demonstração 2.
    4. No terceiro menu suspenso que é carregado, escolha a opção “Nenhum” e clique em Selecionar.
    5. Em “Qual campo do Salesforce deve ser atualizado?”, escolha o nome do campo que você precisa atualizar. 
    6. 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.
  4. Crie um modelo de mapeamento de mesclagem da seguinte maneira:
    1. Forneça um nome exclusivo para o modelo.
    2. Selecione Adicionar mapeamento de campo
    3. Em Valor de origem, selecione Objeto selecionado e, em seguida, no menu suspenso, selecione Demonstração 1
    4. Na segunda lista suspensa que é carregada, selecione ID da demonstração 2.
    5. 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.
    6. 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.
  5. Crie um modelo de contrato seguindo as etapas da seção Criar fluxos de trabalho de modelos.
  6. 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”.
  7. Na seção Detalhes do modelo do modelo do contrato, selecione o objeto Salesforce como Demonstração 1.
  8. Selecione Mapear dados nos campos do contrato e, em seguida, na caixa de diálogo exibida:
    1. Selecione a opção Selecionar do objeto.
    2. Em Tipo de origem, selecione ID da demonstração 1.
    3. Em Campo do contrato de destino, selecione o objeto Demonstração 1 no campo de pesquisa.
    4. Selecione Salvar
  9. 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. 
  10. 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.
  11. 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. 
  12. Clique em Próximo e Salvar.
  13. Navegue até o registro do objeto “Demonstração 1” e atualize a página. O painel “AgreementPanel” que você adicionou deverá ser exibido.
  14. Selecione Enviar contrato para assinatura. Isso exibe o modelo de contrato que você criou.
  15. 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”. 
  16. Assine o contrato. Isso mostra o registro da “Demonstração 2” atualizado com o valor do contrato. 

Solucionar problemas ao enviar contratos do Salesforce

Se você não conseguir enviar contratos do Salesforce, execute as seguintes etapas de solução de problemas:  

  1. Certifique-se de estar em uma versão compatível do Adobe Acrobat Sign. Consulte as versões compatíveis.

  2. 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.

  3. 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.

  4. 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>

  5. 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
    Ou

    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:

    1. 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.
    2. Navegue até a página Detalhes do usuário do remetente no Salesforce e verifique se o campo Email contém um endereço de email válido e uma licença ativa do Sign Enterprise. Para verificar se o endereço de email tem uma licença ativa do Sign Enterprise:
      1. Faça logon no Acrobat Sign com as credenciais de administrador.
      2. Navegue até Conta > Usuários e procure o endereço de email.
      3. O status do usuário deve ser “ativo”. 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 é ‘ativo’”.
      4. Se a opção Enviar em nome de (SOB) for usada, valide o endereço de email, marcando o campo Enviar em nome de no objeto Contrato. Faça logon no Acrobat Sign para verificar se o endereço de email desse usuário tem uma licença válida do Sign. Verifique se o campo Permitir envio como outros usuários está habilitado na página Detalhes do usuário do usuário SOB. Esse campo pode não estar visível no layout da página do objeto do usuário por padrão.
    3. Verifique as permissões do usuário conforme mencionado na Etapa 2 acima.Consulte como conceder acesso necessário aos usuários.

    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.

Solucionar problemas na atualização de status automática

Se um contrato não for atualizado com o status correto, execute as seguintes etapas de solução de problemas:

  1. 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

  2. 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.

    salesforce-faq-status-update-enabled

    Se a mensagem não for exibida, siga estas etapas:

    1. Faça logout e logon novamente como administrador do sistema.
    2. Acesse Administrador do Adobe Acrobat Sign > Ativar atualizações de status automáticas e selecione Ativar.
    3. Na caixa de diálogo “Permitir acesso ao Acrobat Sign”:
      1. Anote o endereço de email na parte inferior da caixa de diálogo.
      2. Verifique se este endereço de email tem uma licença válida do Sign e se é um administrador de sistema no Salesforce.
      3. Verifique se o usuário tem o conjunto de permissões “Usuário de integração do Adobe Sign” atribuído. 
      4. Selecione Permitir.

    A mensagem “As atualizações de status automáticas estão ativadas para esta organização” deve ser exibida.

  3. 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>'

  4. 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.

  5. Acesse Configuração > Configurações personalizadas > Configurações de atualização do contrato do Adobe Sign > Gerenciar > Novo (ou Editar). Na página que é aberta, verifique se a caixa de seleção Atualizar status do contrato (localizada em “Valor de nível de organização padrão”) está marcada. 

  6. Clique na guia Contratos, selecione todos os contratos com falha na atualização e, no canto superior direito, selecione Atualizar contrato

    salesforce-faq-update-agreement

  7. 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. 

  8. 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    

Solucionar problemas que podem ocorrer após habilitar domínios aprimorados 

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.

Solucionar problemas ao procurar leads no ambiente da Government Cloud

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:

  1. Acesse Configuração > Gerenciador de objeto e pesquise por Lead.
  2. No painel esquerdo, selecione Campos e relações.
  3. Para todos os campos obrigatórios (como Nome, Email, Dispositivo móvel e outros), verifique a acessibilidade para os usuários. Para fazer isso:
    1. Selecione qualquer campo que deseja verificar. Por exemplo, selecione Dispositivos móveis.
    2. Para todos os usuários para os quais você deseja habilitar o acesso ao campo, marque a caixa de seleção Visível.
    3. Clique em Salvar.
Envie contratos para seus leads do Acrobat Sign for Salesforce na Government Cloud.

Envie contratos para seus leads do Acrobat Sign for Salesforce na Government Cloud.

Contate o suporte

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>

Receba ajuda com mais rapidez e facilidade

Novo usuário?