Conectar um formulário adaptável ao Microsoft® SharePoint

A ação de envio Enviar para o SharePoint permite que você conecte facilmente seu Formulário adaptável a um armazenamento do Microsoft® SharePoint. Ele envia os dados do formulário para o armazenamento SharePoint de sua escolha depois que você envia o formulário.

O AEM as a Cloud Service oferece várias ações de envio prontas para uso para manipular envios de formulários. Você pode saber mais sobre essas opções no artigo Ação de envio do formulário adaptável.

Vantagens

Algumas das vantagens de enviar dados de um Formulário adaptável para o armazenamento do SharePoint são:

  • Ele facilita o envio direto de dados de formulário para o SharePoint, fornecendo um local centralizado para armazenar e gerenciar informações.
  • Ao aplicar os recursos de controle de acesso e permissões do SharePoint, ele garante que somente indivíduos autorizados possam visualizar ou modificar os dados enviados.

Usando o Enviar para o SharePoint, você pode:

Conectar um formulário adaptável à biblioteca de documentos do SharePoint connect-af-sharepoint-doc-library

Para usar a Ação Enviar Enviar para a Biblioteca de Documentos do SharePoint em um Formulário adaptável:

  1. Criar uma Configuração da Biblioteca de Documentos da SharePoint: ela conecta o AEM Forms ao Armazenamento do Microsoft® Sharepoint.
  2. Use a ação enviar para o SharePoint em um Formulário adaptável: ele conecta seu Formulário adaptável ao Microsoft® SharePoint configurado.

Criar uma configuração da Biblioteca de documentos da SharePoint create-sharepoint-configuration

Para conectar o AEM Forms ao seu armazenamento da Biblioteca de Documentos do Microsoft® Sharepoint:

  1. Vá para sua instância do AEM Forms Author > Tools > Cloud Service > Microsoft® SharePoint.

  2. Após selecionar o Microsoft® SharePoint, você será redirecionado para o Navegador SharePoint.

  3. Selecione um Contêiner de Configuração. A configuração é armazenada no Contêiner de configuração selecionado.

  4. Clique em Criar > Biblioteca de Documentos da SharePoint na lista suspensa. O assistente de configuração do SharePoint é exibido.

    Configuração do SharePoint

  5. Especifique o Título, ID do Cliente, Segredo do Cliente e URL do OAuth. Para obter informações sobre como recuperar a ID do cliente, o Segredo do cliente e a ID do locatário para a URL do OAuth, consulte a Documentação da Microsoft®.

    • Você pode recuperar os Client ID e Client Secret de seu aplicativo do portal do Microsoft® Azure.

    • No portal do Microsoft® Azure, adicione o URI de redirecionamento como https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Substitua [author-instance] pela URL da sua instância de Autor.

    • Adicione as permissões de API offline_access e Sites.Manage.All para fornecer permissões de leitura/gravação. O Sites.Manage.All é um escopo de permissão na API Graph do Microsoft que concede a um aplicativo a capacidade de gerenciar todos os aspectos dos Sites do SharePoint, como excluir ou modificar Sites.

      note note
      NOTE
      Você também pode configurar os Sites do SharePoint com acesso limitado usando o escopo de permissão Sites.Selected na API gráfica do Microsoft. O Sites.Selected é um escopo de permissão na API gráfica do Microsoft que permite acesso mais granular e restrito aos sites do SharePoint.
    • Usar URL do OAuth: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Substitua <tenant-id> pelo tenant-id do seu aplicativo no portal do Microsoft® Azure.

    note note
    NOTE
    O campo segredo do cliente é obrigatório ou opcional, depende da configuração do aplicativo do Azure Ative Diretory. Se o aplicativo estiver configurado para usar um segredo do cliente, é obrigatório fornecer o segredo do cliente.
  6. Clique em Conectar. Em uma conexão bem-sucedida, a mensagem Connection Successful é exibida.

  7. Agora, selecione Site do SharePoint > Biblioteca de Documentos > Pasta do SharePoint para salvar os dados.

    note note
    NOTE
    • Por padrão, forms-ootb-storage-adaptive-forms-submission está presente no site do SharePoint selecionado.
    • Crie uma pasta como forms-ootb-storage-adaptive-forms-submission, se ainda não estiver presente na biblioteca Documents do Site do SharePoint selecionado clicando em Criar Pasta.

Agora, você pode usar essa configuração do SharePoint Sites para a ação enviar em um Formulário adaptável.

Usar a configuração da biblioteca de documentos SharePoint em um formulário adaptável use-sharepoint-configuartion-in-af

Você pode usar a configuração criada da Biblioteca de documentos da SharePoint em um Formulário adaptável para salvar dados ou o Documento de registro gerado em uma pasta do SharePoint. Execute as seguintes etapas para usar uma configuração de armazenamento da Biblioteca de documentos da SharePoint em um Formulário adaptável como:

  1. Crie um Formulário adaptável.

    note note
    NOTE
    • Selecione o mesmo Contêiner de configuração para um Formulário adaptável, onde você criou seu armazenamento da Biblioteca de documentos da SharePoint.
    • Se nenhum Contêiner de Configuração for selecionado, as pastas de Configuração de Armazenamento globais serão exibidas na janela de propriedades da Ação de Envio.
  2. Selecione Enviar Ação como Enviar para o SharePoint.
    GIF do Sharepoint

  3. Selecione a Configuração de Armazenamento, onde você deseja salvar seus dados.

  4. Clique em Salvar para salvar as configurações de Envio.

Ao enviar o formulário, os dados são salvos no Armazenamento da Biblioteca de Documentos do Microsoft® Sharepoint especificado.
A estrutura de pasta para salvar dados é /folder_name/form_name/year/month/date/submission_id/data.

Conectar um formulário adaptável à lista Microsoft® SharePoint connect-af-sharepoint-list

Para usar a ação enviar Enviar para a Lista do SharePoint em um formulário adaptável:

  1. Criar uma Configuração de Lista do SharePoint: ela conecta o AEM Forms ao Armazenamento de Lista do Microsoft® Sharepoint.
  2. Usar o Enviar usando o Modelo de Dados de Formulário (FDM) em um Formulário Adaptável: ele conecta seu Formulário Adaptável ao Microsoft® SharePoint configurado.

Criar uma configuração de lista do SharePoint create-sharepoint-list-configuration

Para conectar o AEM Forms à sua lista do Microsoft® Sharepoint:

  1. Vá para Ferramentas > Cloud Service > Microsoft® SharePoint.

  2. Selecione um Contêiner de Configuração. A configuração é armazenada no Contêiner de configuração selecionado.

  3. Clique em Criar > Lista do SharePoint na lista suspensa. O assistente de configuração do SharePoint é exibido.

  4. Especifique o Título, ID do Cliente, Segredo do Cliente e URL do OAuth. Para obter informações sobre como recuperar a ID do cliente, o Segredo do cliente e a ID do locatário para a URL do OAuth, consulte a Documentação da Microsoft®.

    • Você pode recuperar os Client ID e Client Secret de seu aplicativo do portal do Microsoft® Azure.

    • No portal do Microsoft® Azure, adicione o URI de redirecionamento como https://[author-instance]/libs/cq/sharepointlist/content/configurations/wizard.html. Substitua [author-instance] pela URL da sua instância de Autor.

    • Adicione as permissões de API offline_access e Sites.Manage.All na guia Microsoft® Graph para fornecer permissões de leitura/gravação. Adicione a permissão AllSites.Manage na guia Sharepoint para interagir remotamente com os dados do SharePoint.

    • Usar URL do OAuth: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Substitua <tenant-id> pelo tenant-id do seu aplicativo no portal do Microsoft® Azure.

      note note
      NOTE
      O campo segredo do cliente é obrigatório ou opcional, depende da configuração do aplicativo do Azure Ative Diretory. Se o aplicativo estiver configurado para usar um segredo do cliente, é obrigatório fornecer o segredo do cliente.
  5. Clique em Conectar. Em uma conexão bem-sucedida, a mensagem Connection Successful é exibida.

  6. Selecione Site do SharePoint e Lista do SharePoint na lista suspensa.

  7. Selecione Criar para criar a configuração de nuvem do Microsoft® SharePointList.

Usar o Enviar usando o Modelo de dados de formulário (FDM) em um formulário adaptável use-submit-using-fdm

Você pode usar a configuração da Lista do SharePoint criada em um Formulário adaptável para salvar dados ou o Documento de registro gerado em uma Lista do SharePoint. Execute as seguintes etapas para usar uma Lista SharePoint em um Formulário adaptável como:

Ao enviar o formulário, os dados são salvos no Armazenamento de Lista do Microsoft® Sharepoint especificado.

NOTE
Na Lista do Microsoft® SharePoint, os seguintes tipos de coluna não são suportados:
  • coluna de imagem
  • coluna de metadados
  • coluna de pessoa
  • coluna de dados externos

Artigos relacionados

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab