Atualizar para a versão mais recente do Microsoft Graph Toolkit

Este artigo fornece um resumo das alterações interruptivas introduzidas nas versões do Microsoft Graph Toolkit e como estas alterações podem afetar a sua solução.

Microsoft Graph Toolkit v4.0

Remover o suporte para o ES5 e mgt-loader

O Microsoft Graph Toolkit v4.0 remove o suporte para o ES5 e utiliza mgt-loader como forma de importar o toolkit na sua aplicação através da CDN. Se estiver a utilizar mgt-loadero , tem de alterar o código para importar os módulos.

O seguinte código:

<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>
<mgt-msal2-provider client-id="[CLIENT-ID]"></mgt-msal2-provider>
<mgt-login></mgt-login>

Torna-se o seguinte:

<script type="module">
  import { registerMgtComponents, Providers, Msal2Provider } from 'https://unpkg.com/@microsoft/mgt@4';
  Providers.globalProvider = new Msal2Provider({clientId: '[CLIENT-ID]'});
  registerMgtComponents();
</script>

<mgt-login></mgt-login>

Remover o mgt-spfx pacote para criar peças Web Estrutura do SharePoint

O Microsoft Graph Toolkit v4.0 remove o @microsoft/mgt-spfx pacote para a criação de peças Web Estrutura do SharePoint. Para garantir uma excelente experiência para os nossos programadores do SharePoint, melhorámos o nosso @microsoft/mgt-spfx-utils pacote e as nossas capacidades de desambiguação para oferecer uma integração totalmente integrada entre o SPFx e o toolkit. Esta alteração interruptiva abre caminho para uma melhor experiência de programador e mais funcionalidades no futuro.

As enumerações são agora uniões de cadeias de carateres

O Microsoft Graph Toolkit v4.0 altera a forma como as enumerações são definidas. Em vez de utilizar enum para definir os valores, o toolkit utiliza agora uniões de cadeias. Esta alteração proporciona melhores escritas e uma experiência de programador melhor e uniforme, especialmente para programadores React. Esta alteração afeta AvatarType, ViewType, UserType, PersonType, GroupType, e ResponseTypePersonCardInteraction. Por exemplo, em vez de utilizar ViewType desta forma:

<Person personQuery="me" view={ViewType.twolines}></Person>

Agora, utilize ViewType desta forma:

<Person personQuery="me" view="twolines"></Person>

mgt-tasks é agora mgt-planner

Para se alinhar melhor com a nomenclatura do Microsoft 365, mgt-tasks o nome foi mudado para mgt-planner. Também significa que o componente atualizado mgt-planner já não suporta data-source a mudança para tarefas do Outlook.

Permissões necessárias para mgt-person e mgt-planner

Aproveitamos a oportunidade para simplificar e aderir a uma abordagem menos privilegiada para as permissões exigidas pelo mgt-person e mgt-planner.

• Nas aplicações que utilizam mgt-persono , os utilizadores poderão ter de consentir novos âmbitos de permissões. Para obter detalhes, consulte a tabela de permissões do componente.
• Permissão mínima para mgt-planner alterada de Group.ReadWrite.All para para Tasks.ReadWrite operações de escrita e de Group.Read.All para para Tasks.Read operações de leitura.

prepScopes() está agora ciente dos âmbitos de permissão consentidos

A prepScopes() função aceita agora uma matriz de âmbitos que é verificada relativamente ao conjunto de âmbitos de permissão atualmente consentidos para o utilizador atual. Se algum dos âmbitos fornecidos for encontrado, não são pedidos âmbitos adicionais. Se não for encontrada nenhuma correspondência, é pedido ao utilizador que consoante o primeiro âmbito na matriz de âmbitos fornecida. Isto ajuda com a experiência do utilizador e permite que os programadores utilizem uma abordagem com menos privilégios.

O registo de componentes é agora necessário

Os programadores têm de chamar explicitamente a função de registo para todos os componentes Web utilizados na respetiva aplicação ao utilizar componentes do @microsoft/mgt-components . Importar a partir da raiz de @microsoft/mgt-components já não tem um efeito colateral de registo automático. Por exemplo, em vez de utilizar import { Person } from '@microsoft/mgt-components'; , tem de utilizar import { Person } from '@microsoft/mgt-components; e chamar registerMgtPersonComponent().

MgtPersonCard já não tem uma propriedade de configuração estática

Esta configuração foi movida para a MgtPersonCardConfig classe para permitir que os programadores importem a configuração e a função associada getMgtPersonCardScopes() no nível superior da respetiva aplicação sem adicionar automaticamente o peso do componente completo mgt-person-card e das dependências ao ficheiro de entrada para as respetivas aplicações. Isto ajuda com tamanhos de pacotes mais pequenos e uma melhor experiência geral de programador.

mgt-people-picker não mostra a presença por predefinição

O comportamento predefinido das mgt-people-picker alterações para que a presença do utilizador não seja apresentada, a menos que o show-presence atributo ou a showPresence propriedade esteja definido. Esta alteração ajuda a melhorar o desempenho de aplicações que não precisam de mostrar presença e a adotar uma abordagem com menos privilégios.

Microsoft Graph Toolkit v3.0

Alterou a estrutura de estrutura para componentes Web fluentes da IU

Para se manter em conformidade e para se alinhar com o aspeto e funcionalidade modernos do Microsoft 365, o Microsoft Graph Toolkit utiliza agora componentes Web Fluent UI. Recomendamos que atualize alguns dos seus estilos com o sistema de design Fluent 2.

Muitos dos tokens de design fornecidos para personalizar o aspeto e funcionalidade dos nossos componentes foram alterados. Para obter detalhes, veja a secção Propriedades personalizadas do CSS dos artigos para cada componente.

SDK JS do Microsoft Graph atualizado de 2.x para 3.x

Se tiver utilizado o cliente do Microsoft Graph através do globalProvider, este foi atualizado para 3.x. Para obter detalhes sobre como esta alteração pode afetá-lo, veja Guia de atualização do SDK JS do Microsoft Graph.

Atualizado do Lit 1.x para o Lit 2.x

Se tiver vindo a criar componentes personalizados sobre o toolkit, reveja o Guia de atualização do Lit para obter detalhes sobre como esta alteração poderá afetá-lo.

As estruturas de objetos alteradas e escritas estão disponíveis para eventos emitidos pelos nossos componentes

Nesta versão, as estruturas de objetos de alguns eventos mudaram para proporcionar uma melhor experiência de programador. Todos os eventos são escritos com precisão através do CustomEvent<T> tipo genérico para ajudá-lo a fornecer código de alta qualidade. Para obter detalhes, veja a secção Eventos dos artigos para cada componente.

Permissões alteradas no seletor de canais do Teams

O MgtTeamsChannelPickerConfig foi removido e o componente selecionador de canais do Teams utiliza agora apenas Team.ReadBasic.All âmbitos e Channel.ReadBasic.All em vez dos âmbitos e Group.Read.All legadosUser.Read.All. Esta alteração permite que a sua aplicação utilize uma abordagem com menos privilégios.

Foram removidos vários fornecedores

Nesta versão, foram removidos vários fornecedores para garantir que as suas aplicações se mantêm seguras e proporcionam a melhor experiência possível aos seus utilizadores (suporte para acesso condicional, avaliação de acesso contínuo, etc.). Os seguintes fornecedores foram removidos:

• Fornecedor do Teams
• Fornecedor do Teams MSAL2
• Fornecedor MSAL

Próximas etapas

• Atualize as suas soluções para a versão 3 do Toolkit.
• Relate bugs ou deixe uma solicitação de recurso no GitHub.