visão geral do Kit de ferramentas do Microsoft Graph

Artigo
07/01/2022
3 minutos para o fim da leitura

Kit de ferramentas do Microsoft Graph é uma coleção de componentes e fornecedores de autenticação reutilizáveis e agnósticos de quadro para acessar e trabalhar com o Microsoft Graph. Os componentes são totalmente funcionais de fábrica, com fornecedores integrados que se autenticam com e buscam dados do Microsoft Graph.

O Kit de ferramentas do Microsoft Graph facilita o uso do Microsoft Graph em sua aplicação. No exemplo a seguir, um usuário conectado e seus eventos de calendário são exibidos com apenas duas linhas de código usando os componentes Logon e Agenda .

Abra este exemplo em mgt.dev.

O que há no Kit de Ferramentas do Microsoft Graph?

Componentes

O Kit de Ferramentas do Microsoft Graph inclui uma coleção de componentes da Web para as experiências mais comumente criadas alimentadas pelas APIs do Microsoft Graph.

Os componentes também estão disponíveis como React componentes.

Componente	Descrição
Logon	Um botão e um controle de submenu para autenticar um usuário com a plataforma de Identidade da Microsoft e exibir as informações de perfil do usuário ao entrar.
Pessoa	Exibe uma pessoa ou contato por sua foto, nome e/ou endereço de email.
Pessoas	Exibe um grupo de pessoas ou contatos por suas fotos ou iniciais.
Agenda	Exibe eventos no calendário de um usuário ou grupo.
Seletor de pessoas	Fornece a capacidade de pesquisar por pessoas e renderiza a lista de resultados.
Cartão pessoal	Um submenu usado no componente pessoa para exibir mais informações de perfil sobre um usuário.
Arquivo	Representa um arquivo ou pasta com um ícone, um nome de arquivo, um autor e muito mais.
Lista de arquivos	Exibe uma lista de vários arquivos ou pastas.
Get	Permite que você faça uma consulta GET para qualquer microsoft API do Graph diretamente em seu HTML.
Seletor de canal	Fornece a capacidade de pesquisar canais do Microsoft Teams para selecionar um canal em uma lista renderizada de resultados.
To Do	Exibe e habilita a adição, remoção, conclusão ou edição de tarefas do Microsoft To Do.
Tarefas	Exibe e habilita a adição, remoção, conclusão ou edição de tarefas do Microsoft Planner ou Microsoft To Do.

Provedores

Os provedores habilitam a autenticação, fornecem a implementação para adquirir tokens de acesso em várias plataformas e expõem um cliente do Microsoft Graph para chamar as APIs do Microsoft Graph. Os componentes funcionam melhor quando usados com um provedor, mas os provedores podem ser usados por conta própria.

Provedores	Descrição
MSAL	Usa msal.js para conectar usuários e adquirir tokens para usar com o Microsoft Graph.
MSAL2	Usa o msal-browser para conectar usuários e adquirir tokens para usar com o Microsoft Graph.
Elétron	Autentica e fornece acesso do Microsoft Graph a componentes dentro de aplicativos Electron.
SharePoint	Autentica e fornece acesso do Microsoft Graph a componentes dentro de Web Parts do SharePoint.
Teams	Usa msal.js para conectar usuários e adquirir tokens no cliente nas guias do Microsoft Teams.
Teams MSAL2	Usa o msal-browser para conectar usuários e adquirir tokens nas guias do Microsoft Teams. Dá suporte ao SSO (logon único) com um back-end personalizado.
Proxy	Permite o uso da autenticação de back-end roteando todas as chamadas para o Microsoft Graph por meio do back-end.
Personalizados	Cria um provedor personalizado para habilitar a autenticação e o acesso ao Microsoft Graph usando o código de autenticação existente do aplicativo.

Por que usar o Kit de Ferramentas do Microsoft Graph?

O Kit de Ferramentas do Microsoft Graph permite que você integre de forma rápida e fácil experiências comuns da plataforma Microsoft Graph em seu próprio aplicativo. O kit de ferramentas:

Reduz o tempo de desenvolvimento. O trabalho para se conectar às APIs do Microsoft Graph e renderizar os dados em uma interface do usuário que parece e se parece com uma experiência do Microsoft 365 é feito para você, sem necessidade de personalização.
Funciona em todos os lugares. Todos os componentes são baseados em padrões da Web e funcionam perfeitamente com qualquer navegador moderno e estrutura da Web (como React, Angular ou Vue).
É bonita, mas flexível. Os componentes são projetados para parecer experiências do Microsoft 365, mas também são personalizáveis usando propriedades personalizadas css e modelagem.

Quem deve usá-lo?

O Kit de Ferramentas do Microsoft Graph é ótimo para desenvolvedores de todos os níveis de experiência que querem desenvolver um aplicativo que se conecta e acessa dados do Microsoft Graph, como: