Partilhar via


visão geral do Kit de ferramentas do Microsoft Graph

Cuidado

O Toolkit do Microsoft Graph foi preterido. O período de reforma começa a 1 de setembro de 2025, com a reforma completa prevista para 28 de agosto de 2026. Os programadores devem migrar para utilizar os SDKs do Microsoft Graph ou outras ferramentas suportadas do Microsoft Graph para criar experiências Web. Para obter mais informações, veja o anúncio de preterição.

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 estão totalmente funcionais, com fornecedores incorporados que se autenticam com e obtêm dados do Microsoft Graph.

O Kit de ferramentas do Microsoft Graph facilita o uso do Microsoft Graph em sua aplicação. No exemplo seguinte, um utilizador com sessão iniciada e os respetivos eventos de calendário são apresentados com apenas duas linhas de código através dos componentes Início de Sessão e Agenda .

Porquê utilizar o Microsoft Graph Toolkit?

O Microsoft Graph Toolkit permite-lhe integrar rápida e facilmente experiências comuns com tecnologia do Microsoft Graph na sua própria aplicação. O toolkit:

  • Reduz o tempo de desenvolvimento. O trabalho para ligar às APIs do Microsoft Graph e compor os dados numa IU que parece e parece ser uma experiência do Microsoft 365 é feito por si, sem necessidade de personalização.

  • Funciona em todo o lado. Todos os componentes baseiam-se em padrões Web e funcionam perfeitamente com qualquer browser e arquitetura Web modernas (como React, Angular ou Vue).

  • É bonito, mas flexível. Os componentes foram concebidos para se parecerem com experiências do Microsoft 365, mas também personalizáveis com propriedades personalizadas E modelos CSS.

Quem deve utilizá-lo?

O Microsoft Graph Toolkit é ótimo para programadores de todos os níveis de experiência que pretendem desenvolver uma aplicação que se liga e acede a dados do Microsoft Graph, como:

  • Aplicativo Web
  • Separador Microsoft Teams
  • Aplicação Web Progressiva (PWA)
  • Aplicação electron
  • Peça Web do SharePoint

O que há no Microsoft Graph Toolkit?

Componentes

O Microsoft Graph Toolkit inclui uma coleção de componentes Web para as experiências mais comuns criadas com tecnologia das APIs do Microsoft Graph.

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

Componente Descrição
Agenda Apresenta eventos no calendário de um utilizador ou grupo.
Chat (pré-visualização) Apresenta uma conversação de grupo ou 1:1 a partir do Microsoft Teams
Arquivo Representa um ficheiro ou pasta com um ícone, um nome de ficheiro, um autor e muito mais.
Lista de arquivos Apresenta uma lista de vários ficheiros ou pastas.
Get Permite-lhe fazer uma consulta GET a qualquer microsoft API do Graph diretamente no seu HTML.
Logon Um botão e um controlo de lista de opções para autenticar um utilizador com a plataforma de Identidade da Microsoft e apresentar as informações de perfil do utilizador quando iniciam sessão.
Nova conversa (pré-visualização) Um formulário para criar uma nova conversação de grupo ou 1:1 no Microsoft Teams
Pessoas Apresenta um grupo de pessoas ou contactos pelas respetivas fotografias ou iniciais.
seletor de Pessoas Procure pessoas e compõe a lista de resultados.
Pessoa Apresenta uma pessoa ou contacto através da respetiva fotografia, nome e/ou endereço de e-mail.
Cartão pessoal Uma lista de opções utilizada no componente de pessoa para apresentar mais informações de perfil sobre um utilizador.
Seletor Compõe um controlo de lista pendente que permite uma seleção de um único recurso a partir de uma matriz de recursos.
Tarefas do Planner Apresenta e permite adicionar, remover, concluir ou editar tarefas do Microsoft Planner ou do Microsoft To Do.
Caixa de pesquisa Procure canais do Microsoft Teams para selecionar um canal a partir de uma lista composta de resultados.
Resultados da pesquisa Permite-lhe fazer uma consulta ao ponto final de pesquisa do Microsoft Graph diretamente no seu HTML.
Seletor de taxonomia Utilize o componente do seletor de taxonomia para consultar o microsoft API do Graph para Taxonomia e compor um controlo pendente com termos.
Selecionador de Canal do Teams Procure canais do Microsoft Teams para selecionar um canal a partir de uma lista composta de resultados.
To Do Apresenta e permite adicionar, remover, concluir ou editar tarefas do Microsoft To Do.

Provedores

Os fornecedores ativam 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 utilizados com um fornecedor, mas os fornecedores podem ser utilizados por si próprios.

Provedores Descrição
Personalizados Cria um fornecedor personalizado para ativar a autenticação e o acesso ao Microsoft Graph através do código de autenticação existente da sua aplicação.
Electrão Autentica e fornece ao Microsoft Graph acesso a componentes dentro de aplicações Electron.
MSAL2 Utiliza o msal-browser para iniciar sessão de utilizadores e adquirir tokens para utilizar com o Microsoft Graph.
Proxy Permite a utilização da autenticação de back-end ao encaminhar todas as chamadas para o Microsoft Graph através do seu back-end.
SharePoint Autentica e fornece ao Microsoft Graph acesso a componentes dentro de peças Web do SharePoint.
TeamsFx Utilize o fornecedor do TeamsFx nas suas aplicações do Microsoft Teams para fornecer aos componentes do Microsoft Graph Toolkit acesso ao Microsoft Graph.

Onde posso utilizá-lo?

O Microsoft Graph Toolkit é suportado nos seguintes browsers:

Borda Firefox Chrome Safari Opera Samsung Internet
Borda Firefox Chrome Safari Opera Samsung

Próximas etapas