Editar e visualizar arquivos eletrônicos com OneDrive
Pré-requisitos
- Acesso ao menu Configuração > Parâmetros gerais (DC035).
- Acesso ao menu Cadastro > Documento (DC003/DC010).
- Usuário do Microsoft Entra ID com privilégio de Administrador Global.
- Usuário do SoftExpert Documento com controle “Visualizar” e “Alterar” permitido na lista de segurança do documento.
- Documento em etapa de “Revisão” ou “Indexação”.
Apresentação
O componente Documento permite a utilização do Microsoft OneDrive para a edição e visualização de arquivos eletrônicos durante as etapas de revisão ou indexação.
Ao utilizar este recurso, o arquivo é aberto diretamente nos aplicativos do Office 365 (Word, Excel, PowerPoint, entre outros) e, após a conclusão da revisão, é automaticamente armazenado novamente no componente Documento.
Para habilitar essa funcionalidade, é necessária a integração da API do Microsoft 365 ao componente Documento, garantindo a edição posterior dos arquivos eletrônicos com o pacote Office.
A seguir, são apresentados os procedimentos necessários para utilizar este recurso.
Criar site no SharePoint da empresa
1. Acesse o SharePoint.
2. Faça login com sua conta Microsoft corporativa.
3. Clique em SharePoint, ou acesse diretamente: https://yourdomain.sharepoint.com.
4. Clique no botão + Criar site do canto superior esquerdo da tela.
5. Escolha o tipo de site desejado para a equipe.
3. Configure o site, preenchendo os seguintes campos:
- Nome do site: insira o nome do seu site.
- Descrição (opcional): descreva a finalidade do site.
- Privacidade (para sites de equipe):
- Público: qualquer pessoa na organização pode acessar.
- Privado: somente membros convidados podem acessar.
- O SharePoint gera automaticamente o endereço do site (URL), mas é possível ajustá-lo se desejar.
4. Adicione os proprietários e membros do site (ou pule e adicione depois).
5. Clique em Concluir.
Para realizar os passos acima, é necessário ter uma conta Microsoft 365 com acesso ao SharePoint e permissão para criar sites na organização.
Configurar API do Microsoft 365
1. Acesse o portal Microsoft Entra.
2. No painel lateral, clique em Registros de aplicativo.
3. Selecione a opção Novo registro.
4. Preencha os campos que serão apresentados:
| Nome | Informe o nome “SE Document”. |
| Tipos de conta com suporte | Selecione a opção Contas somente neste diretório organizacional. |
| URL de redirecionamento | Selecione a opção Web e preencha o campo ao lado com “http://localhost”. |
5. Clique em Registrar.
6. Na tela que será apresentada, copie os valores dos campos ID do aplicativo (cliente) e ID do diretório (locatário) e guarde-os em local seguro, pois serão usados posteriormente.
7. Na seção Gerenciar do painel lateral, clique em Identidade visual e propriedades. Preencha o campo URL da home page com “http://localhost” e salve.
8. Ainda na seção Gerenciar, clique em Proprietários.
9. Caso o usuário conectado não apareça na listagem, selecione a opção Adicionar proprietários, localize, selecione o usuário e clique no botão Selecionar.
10. Volte à tela inicial do aplicativo, acesse a seção Permissões de APIs e clique na opção Microsoft Graph > User.read.
11. No painel que será apresentado, clique na opção Remover permissão e confirme a exclusão.
Se ocorrer o erro “Unable to complete due to service connection error, please try again later”, espere algumas horas e tente novamente.
12. Feito isso, clique na opção Adicionar uma permissão que será apresentada.
13. No painel lateral, clique em Microsoft Graph > Permissões de aplicativo.
14. Localize e marque a opção Sites.Selected.
15. Feito isso, clique no botão Adicionar permissões.
16. Ainda na seção Permissões de APIs, clique em Conceder consentimento e confirme.
17. No painel que será apresentado, preencha o campo Descrição com o valor “admin” e no campo Expira em selecione a opção 24 meses. Por fim, clique em Adicionar.
18. Em certificados e segredos, clique em Novo segredo do cliente, preencha o campo Descrição com o valor “admin” e, no campo Expira em, selecione a opção “24 meses”. Por fim, clique em Adicionar.
19. Neste momento, o segredo do cliente será apresentado na listagem. Copie o conteúdo apresentado na coluna Valor e guarde-o, pois ele será usado posteriormente.
Obter ID do site
1. Para obter o ID do site, acesse o Graph Explorer.
2. Execute uma requisição GET para a URL https://graph.microsoft.com/v1.0/sites/{hostname}:/sites/{site-path}, sendo {hostmname} o host da empresa no SharePoint, e {site-path} o nome do site.
Exemplo: se o site é https://yourdomain.sharepoint.com/sites/yoursite, o host é “yourdomain.sharepoint.com” e o nome do site é “yoursite”.
3. Ao executar a requisição, copie o valor do campo ID.
4. Em seguida, conceda permissão para o aplicativo acessar o site. Para isso, use o ID copiado no passo anterior para fazer outra requisição via Graph Explorer:
POST https://graph.microsoft.com/v1.0/sites/{siteId}/permissions
Content-Type: application/json
{
"roles": ["write"],
"grantedToIdentities": [
{
"application": {
"id": "<client-id-do-seu-app>",
"displayName": "<nome-do-seu-app>"
}
}
]
}
Se ocorrer erro 403 na requisição, siga as instruções abaixo:
1. Clique na aba Modify permissions da parte superior do Graph Explorer.
2. Procure por Sites.Selected.
3. Clique em Consent as admin (se você for global admin ou SharePoint admin).
4. Na tela de login do Microsoft que será aberta, confirme a permissão para o Graph Explorer.
Até que a permissão seja concedida, o Graph Explorer não conseguirá executar o POST /permissions para atribuir o acesso do aplicativo ao site.
Configurar integração no componente Documento
1. Acesse o menu Configuração > Parâmetros gerais (DC035) e vá até a seção Microsoft 365.
2. Marque a opção Habilitar edição com Microsoft 365.
3. Preencha os campos necessários:
| ID do locatário | Informe o ID do diretório (locatário) obtido nas propriedades do aplicativo no Microsoft Entra. |
| ID do site | Informe o ID do site do Microsoft SharePoint configurado. |
| Client ID | Informe o ID do aplicativo (cliente) obtido durante a configuração do aplicativo no Microsoft Entra. |
| Client Secret | Informe o valor do segredo do cliente obtido durante a configuração do aplicativo no Microsoft Entra. |
4. Marque a opção Converter arquivo para PDF utilizando o Microsoft 365, se desejar. Com esta opção marcada, o sistema usará a integração com o Microsoft 365 para converter arquivos eletrônicos dos documentos para PDF, desde que na categoria do documento esteja configurada a publicação em PDF.
- A API do o Microsoft 365 é compatível com arquivos com as seguintes extensões: .doc, .docx, .odt, .xls, .xlsx, .xlsm, .ods, .ppt, .pptx, .pps, .ppsx, .potm, .odp e .pdf.
- Quando houver troca do site, os arquivos permanecerão vinculados ao site antigo. Para não haver perda de informações, certifique-se que os documentos estão homologados antes de trocar o site.
- Ao utilizar esta API, recursos como as marcas d'água não serão aplicados.
Utilizar Microsoft 365 para editar e visualizar arquivos eletrônicos
1. Acesse o menu Cadastro > Documento (DC003) ou Documento (DC010).
2. Localize e selecione o documento desejado.
3. Clique no botão 
para editar o arquivo eletrônico, salvando as alterações ao sair.
4. Clique no botão 
para visualizar o arquivo eletrônico.
- Se a opção Visualizar arquivo eletrônico com duplo clique estiver marcada na aba Geral dos parâmetros gerais, os arquivos poderão ser visualizados também ao dar um duplo clique sobre o documento ao qual eles pertencem. Essa opção não estará disponível se a situação do documento for “Emissão”.
- É possível visualizar o arquivo eletrônico de forma rápida ao clicar no ícone apresentado na coluna AE. Se houverem mais de um arquivo eletrônico associado ao documento, uma tela será aberta com uma lista com todos os arquivos eletrônicos associados. Clique no arquivo que deseja e visualize-o.
- Além do menu Cadastro > Documento (DC003), também é possível visualizar ou editar os arquivos eletrônicos pelo Microsoft 365 nos menus abaixo. Em outros menus, o arquivo será aberto pelo visualizador configurado na aba Aplicativo dos parâmetros gerais.
- Execução > Revisão (DC016).
- Minhas tarefas (execução) > Revisão de documento.
- Minhas tarefas (acompanhamento) > Acompanhamento de revisão.
Conclusão
Desta forma, o Microsoft 365 foi integrado com sucesso e será possível editar e visualizar os arquivos eletrônicos com o pacote Office.