Adobe Sign para Salesforce: Simple Sign

O Simple Sign é um componente de fácil uso que permite que os usuários do portal da comunidade assinem contratos usando autoatendimento. É fácil adicionar o Simple Sign a qualquer portal do Salesforce Experience Cloud (sendo cliente, parceiro ou funcionário) ou incorporá-lo perfeitamente em outros componentes do Lightning.

O recurso “Simple Sign” está disponível nos seguintes portais de algumas edições diferentes da nuvem da comunidade do Salesforce:

  • Portal B2C: as opções de logon de usuários da comunidade e logon de usuários licenciados da comunidade são usadas por clientes
  • Portal B2B: licença de usuário da comunidade de parceiros

Visto que a comunidade é composta por usuários externos, seu acesso aos dados organizacionais é restrito. Por padrão, esses usuários não podem acessar dados gerados por usuários internos.

Para usar o Simple Sign para assinar contratos em portais da comunidade, é necessário realizar as seguintes etapas:

Pré-requisitos

Para acessar e usar a funcionalidade do Simple Sign, verifique o seguinte:

  • Se a versão 21.0 ou posterior do pacote do Adobe Acrobat Sign for Salesforce está instalada.
  • Para que o portal funcione, verifique se o Lightning está habilitado na sua organização do Salesforce. Para habilitar a interface do Lightning, no menu superior, selecione Alternar para o Lightning Caso contrário, selecione seu nome e, no menu suspenso, selecione Alternar para a experiência do Lightning.
  • Certifique-se de que a opção Gerar modelos de contrato de exemplo esteja selecionada ao vincular o Salesforce ao Adobe Acrobat Sign.
link-accounts

  • Se os modelos não foram gerados durante a instalação ou se você atualizou de uma versão anterior do pacote para a v19, acesse a guia Admin do Adobe Acrobat Sign e selecione Gerar modelo de exemplo de contrato de autoassinatura.
  • Verifique se a guia Modelos de contrato tem o modelo Contrato de teste da comunidade.
verify-test-community-agreement

Habilite o Chatter

Para habilitar o Chatter na sua organização SFDC:

  1. Acesse  Configuração > Ferramentas da plataforma > Configurações dos recursos > Chatter > Configurações do Chatter.
  2. Selecione Editar.
  3. Marque a caixa de seleção Habilitar.
  4. Selecione Salvar.

Ativar experiências digitais

Para ativar as experiências digitais:

  1. Acesse Configuração >  Ferramentas da plataforma > Configurações dos recursos > Experiências digitais > Configurações.
  2. Marque a caixa de seleção Ativar experiências digitais.
  3. Forneça um nome de domínio para as experiências.
    Se a conta já tem um domínio configurado, você pode usar o mesmo valor para as experiências.
  4. Selecione Salvar.
  5. Na caixa de diálogo com o aviso Seu domínio não pode ser alterado depois de estabelecido, selecione OK.

Ativar dois sites CSP confiáveis

Você deve configurar dois sites confiáveis com CSPs (Política de segurança de conteúdo) para permitir os URLs de base na sua conta do Adobe Acrobat Sign. Para fazer isso:

  1. Obtenha o fragmento de valor da sua conta do Acrobat Sign da seguinte maneira:

    1. Faça logon em sua conta do Adobe Acrobat Sign.
    2. No URL, copie o parâmetro imediatamente antes da parte echosign.com (possivelmente adobesign.com) (esse é o valor do fragmento). 
      Por exemplo, o URL https://caseyjones.na1.echosign.com tem um valor de fragmento de na1.
    3. Feche a guia.

    Veja como identificar o Ambiente de conta do Adobe Acrobat Sign.

    global-settings

  2. Navegue até Configuração > Configurações > Segurança > Sites confiáveis CSP e selecione Novo site confiável.

    csp-trusted-sites

  3. Na página Nova definição de site que é exibida, preencha os campos obrigatórios da seguinte forma:

    1. Nome do site confiável: forneça um nome como AcrobatSign
    2. URL de site confiável: digite o URL do site https://secure.<shard>.adobesign.com
      Por exemplo, https://secure.na1.adobesign.com
      Se sua conta não estiver atualizada para o domínio adobesign.com, você pode usar echosign.com.
    3. Marque a caixa de seleção Ativo.
    4. Contexto - selecione Sites do Construtor de experiências para contexto.
    5. Marque a caixa de seleção Diretiva CSP: Permitir site para frame-src.
    6. Selecione Salvar.
    csp-trusted-site-definition

  4. Navegue de volta para Configuração > Configurações > Segurança > Sites confiáveis CSP e selecione Novo site confiável.

  5. Na página Nova definição de site que é exibida, preencha os campos obrigatórios da seguinte forma:

    1. Nome do site confiável: forneça um nome como AcrobatSign2
    2. URL de Site Confiável: insira o URL do site https://secure.adobesign.com
    3. Marque a caixa de seleção Ativo.
    4. Contexto - selecione Sites do Construtor de experiência para contexto.
    5. Marque a caixa de seleção Diretiva CSP: Permitir site para frame-src.
    6. Selecione Salvar.
    Segundo site confiável do CSP

  6. Verifique os dois Sites confiáveis da CSP.

    Sites confiáveis da CSP

Clonar o perfil de usuário da comunidade

Para configurar seus perfis de usuário para usar o portal de autoatendimento do Adobe Acrobat Sign, você deve clonar e editar um dos perfis padrão. Para fazer isso:

  1. Navegue até Configuração > Administração > Usuários > Perfis.

  2. Para qualquer um dos perfis de cliente padrão, selecione Clonar.

    Há quatro perfis de Comunidade do cliente e você pode usar qualquer um deles para clonar e criar um perfil de usuário. Observe o tipo de Licença de usuário do perfil que você clonará.

    setup-profiles

  3. Forneça um nome intuitivo para o perfil clonado e clique em Salvar.

    cloned-profile-name

  4. Na página de perfil clonado que é exibida, selecione Editar.

    cloned-profile-edit

  5. Na página Edição personalizada, role a tela para baixo até Permissões de objeto personalizadas e ative todos os objetos do Adobe Acrobat Sign. Você pode marcar a caixa de seleção Modificar tudo ou selecionar apenas as permissões necessárias para ter mais segurança.

    cloned-prodile-custom-object-permissions

Criar uma conta, contato e usuário para a comunidade

Você deve criar uma Conta, um Contato e um Usuário para a Comunidade. 

Um proprietário de conta deve ser associado a uma Função para ativar os usuários do portal. Para associar uma função ao usuário do Salesforce, acesse Configuração > Administração > Usuários > Usuários. Em seguida, na lista de usuários, selecione Editar em um usuário e, na página que é exibida, abra o menu suspenso Função > selecione uma função > selecione Salvar.

Para criar uma conta:

  1. Inicie o aplicativo de Vendas pelo Inicializador de aplicativos.

  2. Abra o Menu suspenso Conta e selecione +Nova conta.

  3. Na página Nova conta, insira um Nome de conta e clique em Salvar.

    O nome inserido deve identificá-la como uma conta do Portal do Adobe Acrobat Sign. O nome da conta é o único valor que você precisa fornecer aqui.

    create-new-account

Configurar a página da comunidade SFDC

  1. Acesse: Configuração > Ferramentas da plataforma > Configurações de recursos > Experiências digitais > Todos os sites.

  2. Selecione Novo.

  3. Selecione a experiência Atendimento ao cliente.

    A experiência do Atendimento ao cliente é necessária para os componentes de autoatendimento.

  4. Quando a página Atendimento ao cliente carregar, clique em Começar.

  5. Na página que é aberta:

    1. Insira um nome para a comunidade. Opcionalmente, você pode adicionar um nome específico do site ao URL, o que é útil se houver várias comunidades
    2. Quando o nome estiver configurado, selecione Criar.

    Gráficos atraentes mostram as execuções enquanto a Comunidade é criada. Uma vez concluído, a página da Comunidade é exibida. 

    O nome da comunidade é exibido na parte superior da janela (destacado em amarelo).

    A string específica do site no URL pode ser vista na barra de endereços (destacada em azul-petróleo).

Configurar o workspace da experiência para ativar usuários

  1. Acesse Configuração > Ferramentas da plataforma > Configurações de recursos > Experiências digitais > Todos os sites.

  2. Selecione Espaços de trabalho para a sua comunidade.

  3. Na página Meus espaços de trabalho que é aberta, selecione Administração.

  4. Na página “Administração” da sua comunidade:

    1. No painel esquerdo, selecione Configurações e, em seguida, Ativar no indicador de status.
    2. No painel esquerdo, selecione Membros.
    3. No menu suspenso de pesquisa, selecione Tudo.
    4. Na lista Perfis disponíveis, selecione o perfil personalizado que você criou.
    5. Selecione Adicionar para mover o perfil para a lista Perfis selecionados.
    6. Selecione Salvar.

Defina as configurações de Visibilidade do perfil da configuração Email do usuário da comunidade para Público

  1. Abra a página Contato do usuário cujo nome você usará para enviar e, em seguida, selecione Fazer logon na experiência como usuário.

    Fazer logon na experiência como usuário

  2. No canto superior direito da interface do portal aberta, selecione o nome de usuário e, em seguida, Minhas configurações no menu suspenso.

  3. Na página Minhas configurações que é aberta:

    1. Na seção Visibilidade do perfil, defina o Email como Público.
    2. Clique em Salvar.

Adicione o componente Adobe Simple Sign ao espaço de trabalho

  1. Acesse Configuração Ferramentas da plataforma Configurações de recursos > Experiências digitais > Todos os sites.

  2. Selecione Espaços de trabalho para a sua comunidade.

  3. Na seção Meus espaços de trabalho da página, selecione Construtor.

  4. Na parte superior esquerda da página, selecione o ícone Componentes, role até a parte inferior do menu e arraste e solte a opção Adobe Simple Sign no layout da página.

    Solte o componente em qualquer lugar que você quiser exibir os contratos do Adobe Sign

    Arraste o Simple Sign para o modelo do portal

    A página será atualizada para mostrar o componente adicionado no layout de página e exibirá o painel de gerenciamento do componente no canto superior direito.

  5. No painel de gerenciamento, selecione Modelo de contrato e clique em Publicar para disponibilizar o portal.

    Observação:

    Após cada alteração feita no portal ou nas configurações, é necessário republicar o portal.

Incorpore o código do Simple Sign nos componentes do Lightning

Você pode incorporar o componente do Simple Sign em outro componente do Lightning com o seguinte código de exemplo:

<echosign_dev1:SimpleSign templateId="a0L190000019xUrEAI" />

Ao incorporar o componente programaticamente em outro componente, você pode especificar parâmetros adicionais:

  • agreementId: a ID do Salesforce do contrato em andamento ou de rascunho. Os contratos de rascunho devem ter a opção “Em nome de” configurada.
  • templateId: a ID do Salesforce do modelo que rege os contratos gerados.
  • pollingInterval: tempo em milissegundos antes de cada tentativa de obter o URL de assinatura. O valor mínimo é 500, o máximo é 50.000 e o padrão é 1.000.
  • showSigningModal: se definido como falso, apenas o signingURL é retornado, sem carregar a página de assinatura eletrônica em um modal de sobreposição. Se definido como verdadeiro, o signingURL é retornado e a página de assinatura eletrônica é carregada no modal de sobreposição. O valor padrão é “verdadeiro”.

Os parâmetros seguem estas regras:

  • A agreementID ou a templateID deve ser especificada. Se os dois forem especificados, a agreementID será usada. Se nenhum for especificado, um erro será retornado.
  • Ao usar uma agreementID, o contrato deve estar no status de rascunho ou ter sido enviado para assinatura, com pelo menos um destinatário restante para assinar.
  • Se o contrato estiver em status de rascunho, ele será enviado como está, e o URL de assinatura será mostrado.
  • Se o contrato estiver em andamento, o URL de assinatura será obtido e exibido.
  • Se o contrato estiver concluído, um erro será exibido.
  • Ao usar uma templateID, o envio automático é habilitado mesmo assim.
  • Quando uma agreementID é usada, a configuração de envio automático no modelo é respeitada.
  • Os modelos de contrato do Simple Sign devem ter um objeto principal do tipo Contato.
  • A configuração “Enviar em nome de” é altamente recomendada, visto que boa parte dos usuários da comunidade geralmente não tem uma licença para o envio.

O componente também pode publicar eventos para clientes. Veja um exemplo do manipulador de eventos:

<aura:handler name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"/>

A tabela a seguir lista os eventos disponíveis:

Contrato enviado

name="notifyAgreementSent" event="echosign_dev1:AgreementSentEvent" action="{!c.onAgreementSent}"

Contrato carregado do modelo

name="notifyAgreementLoaded" event="echosign_dev1:AgreementLoadedEvent" action="{!c.onAgreementLoaded}"

Página de assinatura aberta

name="notifySigningLoaded" event="echosign_dev1:SigningLoadedEvent" action="{!c.onSigningLoaded}"

Assinado

name="notifyRecipientCompleted" event="echosign_dev1:RecipientCompletedEvent" action="{!c.onRecipientCompleted}"

Nenhum assinado

name="notifyRecipientNotCompleted" event="echosign_dev1:RecipientNotCompletedEvent" action="{!c.onRecipientNotCompleted}"

Erro durante alguma ação

name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"

Configure o modelo de contrato do Simple Sign

Os modelos no ambiente do Simple Sign devem ser configurados para atribuir o destinatário a um objeto principal com base em uma pesquisa, e esse objeto deve ser um contato.

  1. Na guia Detalhes do modelo:

    1. Abra o menu suspenso Objeto do Salesforce e selecione Escolher a partir de outros objetos.
    2. No novo campo suspenso exibido, selecione Contato.
  2. Na guia Destinatários:

    1. Exclua o destinatário existente no modelo.
    2. Selecione Adicionar destinatário do objeto ou da variável do tempo de execução.
    3. Na sobreposição Adicionar destinatário exibida:
      1. No campo Escolher o objeto ou a variável do tempo de execução, selecione Pesquisar com base no campo do objeto principal.
      2. Defina o primeiro Tipo de destinatário como o objeto principal (Contato) e o campo de origem do objeto principal como a ID de contato.
      3. Clique em Salvar.

Para usar o Simple Sign, é necessário anexar um arquivo ao modelo. Ao contrário de um processo de envio ativo, o remetente não pode anexar o documento posteriormente. Para anexar um arquivo ao modelo:

  1. Acesse a guia Anexo e faça o upload de um documento do seu dispositivo.

    Como alternativa, escolha o local do documento na seção “Selecione para adicionar documentos”.

  2. Selecione o campo de pesquisa para exibir todos os documentos disponíveis nessa seção.

  3. Selecione um documento de cada vez para anexar ao modelo.

  4. Quando todos os documentos forem anexados, selecione Salvar.

    Observação:

    Todo arquivo carregado é armazenado no Salesforce, na seção CRM e arquivos do Salesforce.

Se alguns usuários do seu portal não tiverem licenças do Adobe Sign, é possível habilitar o recurso “Enviar em nome de” para contornar as limitações de licenciamento. Isso permite que um usuário da comunidade crie um contrato com a licença de outro usuário.

Para configurar isso, siga estas três etapas:

  1. Habilite a opção “Permitir envio em nome de outras pessoas” nas configurações personalizadas.
  2. Permitir que um usuário licenciado envie em nome de outras pessoas.
  3. Configure o modelo de contrato com a ID do Salesforce do usuário licenciado mencionado acima.

Habilite a configuração

  1. Acesse Configuração > Ferramentas da plataforma > Código personalizado > Configurações personalizadas.

    A página Configurações personalizadas é carregada.

  2. Para ver a lista de Configurações do Adobe Sign, selecione Gerenciar.

  3. Clique em Novo (ou Editar, se já tiver configurado isso antes).

    A página Configurações do Adobe Sign é carregada.

  4. Localize e marque a caixa de seleção Permitir envio em nome de outras pessoas.

  5. Clique em Salvar.

Configurar o usuário para que contratos possam ser enviados em seu nome

Para habilitar a funcionalidade Enviar em nome de para um usuário, dois campos têm de ser adicionados ao layout de registro do usuário:

  1. Acesse Configuração > Ferramentas da plataforma > Objetos e campos > Gerenciador de objetos.

  2. Na guia Gerenciador de objetos, selecione o rótulo Usuário

  3. No painel esquerdo da página Usuário, clique em Layouts de páginas do usuário e selecione o layout de um usuário.

    configure-user-1

  4. Em Layout do usuário, selecione a opção Campos e arraste e solte os dois campos a seguir na seção Informações adicionais (cabeçalho visível somente na edição) do layout:

    • Permitir envio como outros usuários
    • O email do Acrobat Sign foi verificado 
  5. Depois de configurar os campos, siga estas etapas para habilitar o usuário específico:

    1. Acesse Configuração > Administração > Usuários > Usuários.
    2. Para o usuário “Contato da comunidade”, selecione Editar.
    3. Na página Editar usuário, localize a seção Informações adicionais.
    4. Marque as caixas de seleção Permitir envio como outros usuários e O email do Acrobat Sign foi verificado.
    5. Ainda na página “Editar usuário”, copie a UserID do URL na barra de endereços do seu navegador.

    Você encontrará a UserID no URL da página (destacado em amarelo abaixo):

  6. No URL (realçado acima), copie e guarde a UserID (em negrito) para a próxima etapa. Certifique-se de excluir o %2F no início e o %3 no fim. Uma vez concluído, clique em Salvar.

    URL: https://adobedocwinter18test-dev-ed.lightning.force.com/one/one.app?source=aloha#/setup/page?nodeId=ManageUsers&address=%2F0051I000000TA5N%3F

Atualizar o modelo com a userID

  1. Acesse Iniciador de aplicativos > Adobe Acrobat Sign > Modelos de contrato.

  2. Clique no nome do modelo de contrato que deseja editar.

  3. Na guia Destinatários, selecione o campo Enviar em nome de e cole a UserID do Salesforce no campo.

    Não há problema em excluir a ID de espaço reservado.

  4. Clique em Salvar

Conceder acesso aos dados de integração do Salesforce

Os objetos personalizados do nosso pacote são definidos como “privados” para usuários externos por padrão. Os conjuntos de permissões de usuários da comunidade fornecem acesso a objetos personalizados e seus campos, mas não a registros criados por outros usuários (internos e externos).

Nos portais da comunidade, admins têm duas opções para configurar fluxos de assinatura eletrônica:

  • Usar os nossos componentes pré-criados (autoassinatura e Simple Sign).
  • Criar os seus próprios fluxos com as APIs do Apex. 

Em ambos os casos, admins geralmente usam modelos de contrato para permitir que usuários da comunidade iniciem ou participem de fluxos de assinatura eletrônica. Para que isso funcione, usuários da comunidade precisam de acesso somente leitura aos modelos de contrato e recursos relacionados, como objetos de mapeamento de dados e mesclagem, que geralmente são criados por usuários internos.

O tipo de licença do usuário da comunidade determina como o acesso pode ser concedido:

  • Licença de logon de usuário da comunidade: admins podem habilitar a opção “Exibir tudo” para modelos de contrato e objetos de mapeamento de dados/mesclagem por meio do perfil de usuário da comunidade para conceder acesso.
  • Logon de usuário da comunidade COM licença e licença de usuário da comunidade de parceiros: não é possível habilitar a permissão “Exibir tudo” por meio do perfil. Admins precisam usar regras de compartilhamento baseadas em funções para fornecer acesso.

Conceder acesso a modelos de contrato e objetos relacionados

Para que usuários da comunidade criem contratos com base nos modelos de contrato, é necessária a permissão “Exibir tudo” para modelos de contrato e objetos associados.

  • Modelo de contrato (echosign_dev1__Agreement_Template__c)
  • Mapeamento de mesclagem (echosign_dev1__SIGN_Merge_Mapping__c)
  • Mapeamento de dados (echosign_dev1__SIGN_Data_Mapping__c)

Se os modelos do Acrobat Sign Document Builder forem usados com o modelo de contrato como arquivo anexo, os objetos abaixo precisarão de acesso a usuários da comunidade:

  • Modelo do Document Builder (adobesign__Document_Template__c)

  • Mapeamento de campos de objeto (adobesign__Object_Field_Mapping__c)

Limitações do Simple Sign

  • Se o modelo não for configurado com a opção Somente o remetente pode assinar habilitada, os usuários da comunidade verão um erro, informando que nenhum URL de assinatura está disponível para eles.

  • Se o modelo não tiver a opção “Habilitar os campos de visualização e posição”, o contrato permanecerá em um estado pré-envio, e nenhum URL de assinatura será carregado.

  • Se o modelo não tiver a opção Habilitar assinatura hospedada, as assinaturas hospedadas não serão compatíveis.

  • O Simple Sign não é compatível com delegação. Outros destinatários não acessarão o URL de assinatura.

  • O Simple Sign não é compatível com a troca de signatários (uma forma de delegação). Novos signatários não acessarão o URL de assinatura.

  • Para acessar as observações e anexos de qualquer objeto do Salesforce, admins precisam habilitar a opção “Permitir que usuários clientes acessem as observações e anexos” nas configurações das comunidades.

 Adobe

Receba ajuda com mais rapidez e facilidade

Novo usuário?

Adobe MAX 2024

Adobe MAX:
a conferência da criatividade

14 a 16 de outubro, Miami Beach e online

Adobe MAX

A conferência da criatividade

14 a 16 de outubro, Miami Beach e online

Adobe MAX 2024

Adobe MAX:
a conferência da criatividade

14 a 16 de outubro, Miami Beach e online

Adobe MAX

A conferência da criatividade

14 a 16 de outubro, Miami Beach e online