O que é o Kit de ferramentas do Microsoft Graph?
Quando você cria um aplicativo Web e deseja conectá-lo ao Microsoft 365, você precisa implementar a autorização e chamar Microsoft Graph para recuperar dados armazenados em Microsoft 365.
Para simplificar esse processo, Microsoft Graph Toolkit fornece um conjunto de componentes Web e provedores de autenticação para conectar aplicativos Web Microsoft 365.
Nesta unidade, você aprenderá o que é Microsoft Graph Toolkit e por que deseja usá-lo. Você também aprenderá sobre diferentes tipos de aplicativos que podem usar o kit de ferramentas.
visão geral do Kit de ferramentas do Microsoft Graph
Microsoft Graph Toolkit é um conjunto de componentes Web que você pode usar com qualquer estrutura JavaScript para conectar seu aplicativo ao Microsoft 365. Depois de carregar o kit de ferramentas em seu aplicativo, você obtém acesso a um conjunto de marcas HTML personalizadas. Essas marcas permitem carregar dados de Microsoft 365.
Por exemplo, para mostrar a lista de reuniões futuras para o usuário atual, você incluiria em seu aplicativo o seguinte snippet de código:
<mgt-agenda></mgt-agenda>
Em seguida, seu aplicativo renderizaria:
Microsoft Graph Toolkit é atualizado regularmente com novos componentes e recursos.
Por que você usaria Microsoft Graph Toolkit?
No exemplo anterior, você percebeu que não era necessário emitir uma única solicitação da Web? É exatamente por isso que você deve considerar o uso Microsoft Graph Toolkit.
- Concentre-se em criar seu próprio aplicativo Web: Microsoft Graph Toolkit abstrai a autorização e a conexão com Microsoft Graph. Você não precisa se preocupar com autorização, criação de solicitações da Web, tratamento de respostas e lidar com exceções.
- Personalize a renderização para corresponder ao seu aplicativo Web: todos Microsoft Graph componentes do Kit de Ferramentas estão prontos para uso. Por padrão, eles mostram dados usando a IU do Fluent, a linguagem Microsoft 365 design. Cada componente também expõe um modelo, que permite personalizar os dados renderizados.
Quando você usaria o Microsoft Graph Toolkit?
Você pode usar Microsoft Graph Toolkit quando estiver criando aplicativos Web e extensões para Microsoft 365.
- Use Microsoft Graph Toolkit em aplicativos Web: Microsoft Graph Toolkit é mais adequado para uso em aplicativos Web. Com a configuração mínima, ele permite que as pessoas se conectem ao seu aplicativo com sua Microsoft 365 conta. Usando os diferentes componentes, você pode carregar dados diretamente do Microsoft 365, aumentando o valor do seu aplicativo.
- Crie extensões Microsoft 365 com o kit de ferramentas do Microsoft Graph: Você também pode usar o kit de ferramentas do Microsoft Graph quando estiver criando extensões para Microsoft 365, como guias do Teams ou Web Parts da Estrutura do SharePoint. Para criar essas extensões, o kit de ferramentas vem com provedores para usar as informações de autenticação existentes expostas por Microsoft 365.
- Use Microsoft Graph Toolkit em qualquer estrutura JavaScript: os Microsoft Graph Web do Kit de Ferramentas funcionam com qualquer estrutura JavaScript. Se você criar aplicativos Web usando o React, haverá um pacote de kit de ferramentas específico criado para o React. Esse pacote encapsula os componentes do kit de ferramentas em componentes react, facilitando a passagem de dados complexos em componentes e a configuração de manipuladores de eventos.
Carregar Microsoft Graph Toolkit em seu aplicativo Web
Se você criar aplicativos Web sem usar um empacotador, poderá carregar Microsoft Graph Toolkit diretamente da rede de distribuição de conteúdo. Para carregar o kit de ferramentas da rede de distribuição de conteúdo, adicione o seguinte snippet de código ao seu aplicativo Web:
<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>
Se você trabalha em projetos que usam um gerenciador de pacotes como npm, adicione Microsoft Graph Toolkit ao seu aplicativo Web instalando o pacote @microsoft/mgt:
npm install @microsoft/mgt
Se você compilar aplicativos React, instale o pacote @microsoft/mgt-react em vez disso:
npm install @microsoft/mgt-react