O Microsoft Graph oferece uma única interface de programação de aplicativos para acessar todos os dados armazenados no SharePoint, OneDrive, Outlook e demais serviços do Microsoft 365, impactando a forma como desenvolvemos aplicativos para o SharePoint.
O SharePoint, como um sistema de gestão de conteúdo empresarial, pode ser considerado tradicional, mas não está estagnado. A Microsoft constantemente atualiza a plataforma, introduzindo novas funcionalidades, substituindo as antigas e transformando características do SharePoint em aplicativos separados.
À medida que o SharePoint transita de um método de trabalho para outro, frequentemente é necessário reescrever e ajustar nossos aplicativos e códigos de extensão para se adaptarem às mudanças. Atualmente, o SharePoint está passando por uma transição desse tipo, abandonando suas APIs de busca em favor de um novo modelo baseado no Microsoft Graph.
Felizmente, a capacidade de adaptação do SharePoint é uma das principais razões por trás de seu sucesso, graças ao seu quadro de extensibilidade e um modelo de programação simples de dominar.
Por qual motivo optar pelo Microsoft Graph?
Apesar de não ter sido definida uma data de encerramento para as APIs de pesquisa atuais, futuras atualizações só estarão disponíveis por meio do Microsoft Graph. Por isso, é aconselhável iniciar a reescrita do código agora, especialmente porque o Microsoft Graph é fundamental para o suporte aos assistentes Microsoft Copilot AI para Microsoft 365. Essas alterações afetam não só o SharePoint, mas também o OneDrive.
Nesta alteração, todas as buscas serão unificadas em uma única interface de programação de aplicativos (API). Isso implica que o código desenvolvido para o SharePoint será compatível com outros serviços do Microsoft 365, como o Outlook, sempre que houver um índice de pesquisa disponível. A utilização de uma API de pesquisa compartilhada para todo o conteúdo do Microsoft 365 é lógica, especialmente considerando o foco da Microsoft em Inteligência Artificial (IA), onde esse conteúdo servirá como base para IA generativa e modelos de linguagem extensos.
Criar uma API de pesquisa unificada para todos os serviços do Microsoft 365 representa o início de uma transformação duradoura, afastando-se da ideia de pastas envelhecidas. Com funcionalidades sólidas de pesquisa e marcadores eficientes de metadados, não há a real necessidade de uma estrutura artificial para auxiliar na navegação de arquivos. Em vez disso, as informações são disponibilizadas conforme necessário a partir de um único índice, criando uma conexão transparente entre os diferentes aplicativos.
Realizando uma pesquisa utilizando a interface de programação de aplicativos (API) do Microsoft Graph.
A API do Microsoft Graph segue o padrão de uma API REST com o uso de POST e JSON. As requisições são compostas por pedidos que são executados em entidades e contêm consultas em formato de strings para delimitar o escopo das solicitações, permitindo inclusão ou exclusão de determinados elementos do inquilino no SharePoint.
Alguns pequenos problemas precisam ser levados em conta ao elaborar uma consulta. Por exemplo, devido ao fato de um repositório do OneDrive for Business ser essencialmente uma entidade SharePoint, é necessário realizar a consulta de maneira distinta em comparação a um repositório de OneDrive pessoal.
Após criar a sua consulta JSON inicial, é possível aprimorar o processo. É viável ordenar os resultados utilizando métodos tradicionais de paginação, por exemplo, e adicionar filtros extras, como restrições temporais específicas.
Observe que não há restrição à estrutura hierárquica de consultas de gráficos, uma vez que é possível empregar a linguagem de consulta de palavras-chave da Microsoft (KQL) em suas pesquisas. Isso possibilita a combinação de consultas e a construção de pesquisas complexas que abrangem diversas entidades do Microsoft 365. Dessa forma, é viável reunir não apenas documentos correlacionados a uma pesquisa, mas também e-mails pertinentes e listas de contatos.
Você não está restrito a buscar somente dados do Microsoft Graph. Ao utilizar um conector Graph para integrar sistemas de negócios em sua instância do Graph, as buscas podem obter diversos tipos de informações corporativas, como recursos humanos, ERP, CRM e outros. Além de uma variedade de conectores pré-configurados, a Microsoft oferece ferramentas para criar seus próprios conectores personalizados para aplicações específicas ou para lidar com dados antigos em mainframes ou minicomputadores.
Considere o Microsoft Graph como um índice em constante atualização para seus dados não relacionais, que se renova automaticamente à medida que novos conteúdos são adicionados no Microsoft 365 e em plataformas como o SharePoint Online, garantindo a disponibilidade dessas informações para todos os usuários em seu ambiente Microsoft 365.
Trabalhando com a linguagem de consulta KQL no Microsoft Graph.
Após dominar conceitos fundamentais, é recomendado progredir para técnicas mais complexas de uso do Microsoft Graph. Neste ponto, é possível aplicar as habilidades já adquiridas através do Keyword Query Language (KQL), que difere do KQL da Microsoft utilizado para consultas em larga escala com o Kusto.
KQL possibilita a utilização do texto livre como base para uma consulta, buscando palavras ou frases em conteúdos e oferecendo suporte para o uso de curingas simples. Além de buscar texto, o KQL permite utilizar metadados de documentos para restringir pesquisas a arquivos e autores específicos. É possível combinar diversas restrições para elaborar consultas mais complexas, utilizando parênteses para agrupar termos de pesquisa, algo equivalente a uma declaração “E” em SQL ou em linguagens de consulta similares.
Alguns requisitos de KQL podem parecer complicados inicialmente. Por exemplo, é necessário expressar datas e horários no formato ISO 8601, utilizando YYYY-MM-DD para datas e YYYY-MM-DDThh:mm:ss para datas e horas (sendo o T usado como separador entre data e hora). Também é possível utilizar tempos relativos, como “hoje” e “este ano”, que retornam resultados diferentes dependendo do dia em que são executados. Outras opções úteis incluem Booleans, operadores de proximidade e o operador ONEAR, que leva em consideração a ordem dos termos para retornar resultados.
Se estiver a utilizar o KQL no Microsoft Graph para pesquisas, é aconselhável utilizar modelos de consulta em KQL. Estes modelos fornecem uma consulta KQL pronta a usar, facilitando a passagem do termo de pesquisa específico. Esta abordagem pode ser valiosa ao criar programaticamente a carga de JSON de uma pesquisa, ao utilizar uma consulta pré-definida e inserir o termo de pesquisa como uma cadeia de consulta.
Uma interface de programação de aplicativos (API) para realizar buscas abrangentes.
Costumamos considerar o SharePoint como uma ferramenta isolada, porém atualmente ele se tornou uma das tecnologias essenciais para o Microsoft 365 e a Power Platform. A utilização do Microsoft Graph para acessar toda a plataforma representa uma mudança significativa, com o objetivo de unificar todas as atividades de um usuário ou equipe em todas as ferramentas que eles utilizam em seu cotidiano de trabalho.
Outra vantagem de utilizar uma única API de pesquisa é assegurar que apenas usuários autorizados tenham acesso aos dados regulamentados. Ao envolver as consultas do Microsoft Graph em um esquema de autenticação baseado em funções, é possível garantir que o acesso aos dados seja auditado e que os usuários só consigam visualizar as informações permitidas para sua função ou grupo.
Mais uma vez, não há uma data final definida para a descontinuação das antigas ferramentas de busca do SharePoint, permitindo que você as utilize sem restrições. No entanto, considerando que a Microsoft está direcionando seus esforços de desenvolvimento para o Microsoft Graph, essa pode ser uma oportunidade para começar a reformular aplicativos e extensões atuais do SharePoint, além de explorar as funcionalidades de aplicação em diferentes ambientes oferecidas pelo Microsoft Graph.
Em vista disso, considerando a grande quantidade de dados disponíveis no Microsoft Graph, podemos utilizá-lo como recurso. Ao pesquisar por meio do SharePoint, Outlook e OneDrive, você terá acesso integrado a uma vasta base de conhecimento da sua empresa, o que possibilita extrair informações e insights que poderiam passar despercebidos de outra maneira. Essa é a principal motivação para realizar essa ação.