Adobe Sign para SharePoint Online - Guia do fluxo de trabalho

As Ações de fluxo de trabalho do Adobe Sign para SharePoint Online permitem que os administradores do fluxo de trabalho do SharePoint adicionem ações do Adobe Sign em fluxos de trabalho do SharePoint por meio do designer de fluxo de trabalho do SharePoint. A solução está disponível para instâncias online do Microsoft SharePoint como um plug-in. Ele permite que os usuários de criem um fluxo de trabalho de lista em uma lista personalizada ou em uma biblioteca de documentos, que pode ser usado pelos usuários do SharePoint para

• Enviar documentos a um único destinatário ou envio a um lote de destinatários usando listas do SharePoint e dados de mapeamento de listas do SharePoint em documentos, quando os documentos tiverem sido enviados para assinatura.
• Verificar o status do contrato.
• Cancelar o contrato depois de ser enviado para assinatura.
• Baixar contrato assinado em um anexo da lista (em caso de listas personalizadas) ou como um documento com um nome diferente (no caso de bibliotecas de documentos)

Requisitos

A solução do Adobe Sign somente pode ser instalado e configurado por um administrador do Microsoft SharePoint, você também precisa de privilégios administrativos no servidor do SharePoint para instalar a solução. Consulte a documentação do SharePoint e o administrador do SharePoint da sua organização, para obter as permissões adicionais dos sistemas que podem ser necessárias para instalar os plug-ins do SharePoint. Para configurar a solução, você também precisa ser um administrador de conta no Adobe Sign e ter acesso à sua Chave de API da conta do Adobe Sign. Os requisitos do sistema abaixo abrangem os componentes do servidor e do cliente necessários para instalar e executar com sucesso o Adobe Sign para SharePoint.

• Hospedados no Microsoft SharePoint
• Internet Explorer 11+

Instale o Adobe Sign WSP na coleção de site

Carregue e ative o pacote .wsp

1. Obtenha o pacote .wsp mais recente com seu gerente de sucesso (somente instalações já existentes)

• Observação: o Workflow foi descontinuado e não está disponível para novas instalações. Em vez disso, consulte as instruções do Microsoft Flow

2. Navegue até Coleção do site > Configurações do Site > Galerias de Web Designer > Soluções

Aviso: _catalogs/solutions/Forms/AllItems.aspx

3. Carregue o arquivo .wsp

4. Ative o recurso de site manualmente:

• Navegue para Configurações de site > Ações de site > Gerenciar recursos de site
• Clique no botão Ativar ao lado de Ações do fluxo de trabalho do Adobe eSign
• Clique no botão Ativar ao lado da lista de configurações de ações do fluxo de trabalho do Adobe eSign

Preencha a lista de configurações do eSign

Preencher a lista de configurações do eSign exige que você gere e insira vários campos exclusivos. 

Recomendamos que você abra o bloco de notas ou qualquer outro editor de texto para que possa salvar as chaves geradas e, em seguida, inseri-las ao mesmo tempo.

Você precisa:

• Gerar o eSignIntegrationKey (feito no aplicativo do Adobe Sign)
• Obter spTenantID no SharePoint
• Gerar as teclas spClientID e spClientSecret no SharePoint
• Conceder as permissões de nova entidade de serviço no SharePoint
• Inserir o eSignConnectorURL

Etapa 1: Gerar eSignIntegrationKey

Para gerar uma Chave de integração no Adobe Sign:

1. Faça logon na conta do Adobe Sign com o usuário administrativo

2. Navegue até Conta > API do Adobe Sign > Informações do API

3. Clique no link Chave de integração no meio da página

A interface Criar chave de integração é carregada:

1. Forneça um nome intuitivo para a chave (ex: SharePoint)

2. A Chave de integração deve ter os seguintes elementos habilitados:

• agreement_read
• agreement_write
• agreement_send
• library_read

3. Clique em Salvar quando a chave estiver configurada.

A página Tokens de acesso é exibida, mostrando as chaves definidas na sua conta.

4. Clique na definição da chave criada para SharePoint

• O link da Chave de integração está exposto na parte superior da definição.

5. Clique no link da Chave de integração.

A chave de integração é exibida:

6. Copie esta chave e salve-a para adicioná-lo à lista de configurações do eSign

7. Clique em OK.

• Você concluiu agora com o aplicativo Adobe Sign e pode fazer logout

Etapa 2: Obter spTenantID

Para obter o valor spTenantID:

1.        Vá para Configurações do site > Usuários e permissões > Permissões do aplicativo do site.

2.       Sob o identificador de aplicativo, copie a parte após @

• ie: i:0i.t|ms.sp.ext|d559ac84-d8e6-4515-9229-89w01@870fe83b-ye9d-96d3-n1d0-9et51ar2e792e

3. Salve esse valor para inserir na lista de configurações do eSign

Step 3: Gerar as chaves spClientID e spClientSecret

Para gerar as chaves spClientID e spClientSecret:

1. No URL para o site do SharePoint, após sharepoint.com/sites/ {seu site} cole a seguinte cadeia de caracteres:_layouts/15/appregnew.aspx

• Uma nova página abre permitindo que você gere ambas as chaves

2. Clique nos botões Gerar para a ID do cliente e Segredo do cliente

3. Copie as duas chaves e salve-a para inserir na lista de configurações do eSign

4. Insira os seguintes valores literais nos campos restantes:

• Título - Adobe Sign
• Domínio do aplicativo - spintegration.echosign.com/sharepoint
• Redirecionar URL- https://spintegration.echosign.com/sharepoint

5. Clique em Criar

• Isso coloca uma nova entidade de serviço no Azure AD
• É possível reutilizar a mesma entidade em coleções do site

Etapa 4: Conceder as permissões de nova entidade de serviço

Conceder as permissões de nova entidade de serviço no site por

1. No URL para o site do SharePoint, após sharepoint.com/sites/ {seu site} cole a seguinte cadeia de caracteres:_layouts/15/appinv.aspx

• Isso pode ser feito em cada site onde os fluxos de trabalho devem ser executados

Os campos devem conter o conteúdo para o aplicativo da etapa anterior:

• ID do Aplicativo - essa é a ID do cliente que você acabou de gerar
• Título - Adobe Sign
• Domínio do aplicativo - spintegration.echosign.com/sharepoint
• Redirecionar URL - https://spintegration.echosign.com/sharepoint

2. Copie e cole o código abaixo no campo XML de solicitação de permissão:

3. Clique em Criar

4. Clique em Confiar quando a página é recarregada

É possível exibir as permissões resultantes em Configurações de site > Permissões do aplicativo do site

Etapa 5: Insira eSignConnectorURL

O eSignConnectorURL é o valor literal: https://spintegration.echosign.com/sharepoint

Configurar a lista de eSignConfig

1. Em Conteúdo do site do site em que o recurso Lista de configurações de fluxo de trabalho do Adobe eSign foi ativado, localize e clique na lista eSignConfig

2. Crie novo item para abrir um novo formulário de configuração

3. Preencha os seguintes valores:

• Título - "Config"
• spClientID - Insira o valor de ClientID da etapa 3
• spClientSecret - Insira o valor de ClientSecret da etapa 3
• spTenantID - Insira o TenantID da etapa 2
• eSignIntegrationKey - Insira a chave de integração de login do Adobe Sign da etapa 1
• eSignConnectorURL - Insira: https://spintegration.echosign.com/sharepoint
• debugStatements - Não

4. Clique em Salvar.

Considerações de segurança para ler a lista de eSignConfig de ação de fluxo de trabalho

É uma prática recomendada permitir somente que os administradores da coleção do site acessem a lista de eSignConfig.

Se o fluxo de trabalho for iniciado pelo usuário que tem acesso à lista de eSignConfig, então o fluxo de trabalho será executado sem problemas. No entanto, se o usuário não tiver acesso à lista, as ações fluxo de trabalho precisam ser concluídas na etapa do aplicativo.

1. No site onde o fluxo de trabalho é publicado

• Navegue até Configurações > Recursos do site
• Ative o recurso Fluxos de trabalho podem usar permissões do aplicativo.

2. Obtenha a ID da entidade de serviço de fluxo de trabalho

• Vá para Configurações > Permissões do aplicativo do site

Exemplo: Workflow i:0i.t|ms.sp.ext|d55e6c84-d8e6-4515-9229-896we4554601@870f107b-dc9d-47d3-9ad0-9d851rr2e762e

3. Forneça às permissões da entidade do serviço de fluxo de trabalho em _layouts/15/appinv.aspx semelhante ao que fizemos com o aplicativo real

4. Confie na entidade de serviço de fluxo de trabalho

Agora a etapa do aplicativo deve estar disponível no SharePoint Designer (o reinício é necessário):

Cópia do PDF para download