Pular para o conteúdo principal

Modelos (Microsoft Graph)

A funcionalidade Modelos cria documentos a partir de modelos Word (DOCX) com campos que o usuário preenche na criação do documento. Para gerar o PDF, o Signer converte o DOCX com o Microsoft Graph e um site do SharePoint.

A funcionalidade vem desligada. O Signer só mostra a opção Modelos quando as quatro configurações da seção Graph estão preenchidas.

Pré-requisitos​

  • Um tenant do Microsoft 365 com o SharePoint Online.
  • Permissão para criar um site no SharePoint e um registro de aplicativo no Microsoft Entra ID.
  • Acesso de saída do servidor do Signer a login.microsoftonline.com e graph.microsoft.com.

1. Crie um site no SharePoint​

  1. Crie um site no SharePoint para uso exclusivo do Signer, por exemplo signer-modelos.
  2. Anote o nome do tenant (a parte antes de .sharepoint.com) e o nome do site.

2. Registre um aplicativo no Microsoft Entra ID​

  1. No portal do Azure, abra Microsoft Entra ID e depois App registrations.
  2. Clique em New registration, dê um nome ao aplicativo (por exemplo, Signer Modelos) e clique em Register.
  3. Anote o Application (client) ID.
  4. Em Certificates & secrets, crie um client secret e anote o Value.
  5. Em API permissions, adicione uma permissão de aplicativo (Application permission) do Microsoft Graph que permita ler e gravar arquivos no site criado no passo 1.
  6. Clique em Grant admin consent.
aviso

O client secret tem data de validade. Quando ele vencer, a conversão para de funcionar. Anote a data e crie um secret novo antes do vencimento.

3. Obtenha o DriveId do site​

O DriveId identifica a biblioteca de documentos do site.

  1. Peça um access token ao Entra ID. Troque <tenant>, <client-id> e <client-secret> pelos seus valores:

    curl -X POST https://login.microsoftonline.com/<tenant>.onmicrosoft.com/oauth2/v2.0/token \
      -d client_id=<client-id> \
      -d client_secret=<client-secret> \
      -d scope=https://graph.microsoft.com/.default \
      -d grant_type=client_credentials

  2. Copie o valor de access_token da resposta.

  3. Consulte o drive do site. Troque <tenant>, <site> e <token>:

    curl -H "Authorization: Bearer <token>" \
      "https://graph.microsoft.com/v1.0/sites/<tenant>.sharepoint.com:/sites/<site>:/drive"

  4. Anote o valor do campo id da resposta. Esse é o DriveId.

Se a segunda chamada responder 403, o aplicativo não tem permissão no site. Revise o passo 2.

4. Configure o Signer​

Na seção Graph, informe os quatro valores e reinicie a aplicação:

"Graph": {
  "DomainName": "suaempresa.onmicrosoft.com",
  "ClientId": "<application-client-id>",
  "ClientSecret": "<client-secret>",
  "DriveId": "<drive-id>"
}

DomainName é o domínio do tenant no Entra ID (por exemplo, suaempresa.onmicrosoft.com ou um domínio verificado do tenant). Em variáveis de ambiente, use Graph__DomainName, Graph__ClientId, Graph__ClientSecret e Graph__DriveId. Veja as configurações Graph.

5. Teste​

  1. Entre no Signer e comece a criar um documento.
  2. Verifique se o botão Modelos aparece ao lado do botão de adicionar arquivos.
  3. Crie um modelo com um arquivo DOCX de teste e gere um documento a partir dele.

Se a opção não aparecer, verifique se as quatro configurações estão preenchidas. Se a conversão falhar, procure o erro do Microsoft Graph no log da aplicação. As causas mais comuns são o client secret vencido e a falta de permissão do aplicativo no site.

Veja também​

Ver em Markdown