Atualize para a última versão do Microsoft Graph Toolkit

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

Microsoft Graph Toolkit v4.0

Descartando o suporte para ES5 e mgt-loader

O Microsoft Graph Toolkit v4.0 perde o suporte para ES5 e usando mgt-loader como a maneira de importar o kit de ferramentas em seu aplicativo via CDN. Se você estiver usando mgt-loadero , deverá 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>

Remoção do pacote de criação de Web Parts da mgt-spfx Estrutura do SharePoint

O Microsoft Graph Toolkit v4.0 remove o pacote para criar Web Parts da @microsoft/mgt-spfx Estrutura do SharePoint. Para garantir uma ótima experiência para nossos desenvolvedores do SharePoint, aprimoramos nosso @microsoft/mgt-spfx-utils pacote e nossos recursos de desambiguação para oferecer integração perfeita entre o SPFx e o kit de ferramentas. Essa alteração significativa abre caminho para uma melhor experiência do desenvolvedor e mais recursos no futuro.

As enumerações agora são uniões de cadeia de caracteres

O Microsoft Graph Toolkit v4.0 altera a maneira como as enumerações são definidas. Em vez de usar enum para definir os valores, o kit de ferramentas agora usa uniões de cadeia de caracteres. Essa alteração fornece melhores tipificações e uma experiência de desenvolvedor melhor e uniforme, especialmente para desenvolvedores do React. Essa alteração afeta AvatarType, ViewType, UserType, PersonTypeGroupType, , ResponseType, e PersonCardInteraction. Por exemplo, em vez de usar ViewType assim:

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

Agora você usa ViewType assim:

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

mgt-tasks agora é mgt-planner

Para se alinhar melhor com a nomenclatura do Microsoft 365, mgt-tasks foi renomeado para mgt-planner. Isso também significa que o componente atualizado mgt-planner não oferece mais suporte data-source à alternância 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 e mgt-planner.mgt-person

• Em aplicativos que usam mgt-persono , os usuários podem precisar consentir com novos escopos de permissões; para obter detalhes, consulte a tabela de permissões do componente.
• Permissão mínima para mgt-planner alteração de para para Tasks.ReadWrite operações de Group.ReadWrite.All gravação e de para para Tasks.Read operações de Group.Read.All leitura.

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

A prepScopes() função agora aceita uma matriz de escopos que é verificada em relação ao conjunto de escopos de permissão atualmente consentidos para o usuário atual. Se algum dos escopos fornecidos for encontrado, nenhum escopo extra será solicitado. Se nenhuma correspondência for encontrada, o usuário será solicitado a consentir com o primeiro escopo na matriz de escopos fornecida. Isso ajuda na experiência do usuário e permite que os desenvolvedores usem uma abordagem com privilégios mínimos.

O registro de componentes agora é necessário

Os desenvolvedores devem chamar explicitamente a função de registro para todos os componentes da Web usados em seu aplicativo ao usar componentes de @microsoft/mgt-components. A importação da raiz de não tem mais um efeito colateral de @microsoft/mgt-components registro automático. Por exemplo, em vez de usar import { Person } from '@microsoft/mgt-components'; , você deve usar import { Person } from '@microsoft/mgt-components; e chamar registerMgtPersonComponent().

MgtPersonCard Não tem mais uma propriedade de configuração estática

Essa configuração foi movida para a MgtPersonCardConfig classe para permitir que os desenvolvedores importem a configuração e a função associada getMgtPersonCardScopes() no nível superior de seu aplicativo sem adicionar automaticamente o peso do componente completo mgt-person-card e das dependências ao arquivo de entrada de seus aplicativos. Isso ajuda com tamanhos de pacote menores e uma melhor experiência geral do desenvolvedor.

mgt-people-picker Não mostra presença por padrão

O comportamento padrão das alterações para que a presença do usuário não seja mostrada mgt-people-picker , a menos que o show-presence atributo ou a showPresence propriedade estejam definidos. Essa alteração ajuda a melhorar o desempenho de aplicativos que não precisam mostrar presença e adotar uma abordagem com privilégios mínimos.

Microsoft Graph Toolkit v3.0

Alterada a estrutura de design para componentes Web da interface do usuário fluente

Para manter a conformidade e se alinhar à aparência moderna do Microsoft 365, o Microsoft Graph Toolkit agora usa componentes da Web da interface do usuário fluente. Recomendamos que você atualize alguns de seus estilos com o sistema de design Fluent 2.

Muitos dos tokens de design fornecidos para personalizar a aparência de nossos componentes foram alterados. Para obter detalhes, consulte a seção de propriedades personalizadas CSS dos artigos de cada componente.

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

Se você estiver usando o cliente do Microsoft Graph por meio do , ele foi atualizado para 3.x globalProvider. Para obter detalhes sobre como essa alteração pode afetar você, consulte o guia de atualização do SDK do Microsoft Graph JS.

Atualizado de Lit 1.x para Lit 2.x

Se você estiver criando componentes personalizados sobre o kit de ferramentas, revise o guia de atualização do Lit para obter detalhes sobre como essa alteração pode afetar você.

Estruturas de objeto alteradas e tipagem estão disponíveis para eventos emitidos por nossos componentes

Nesta versão, as estruturas de objeto de alguns eventos foram alteradas para fornecer uma melhor experiência ao desenvolvedor. Todos os eventos são digitados com precisão usando o CustomEvent<T> tipo genérico para ajudá-lo a fornecer código de alta qualidade. Para obter detalhes, consulte a seção Eventos dos artigos de cada componente.

Permissões alteradas no seletor de canal do Teams

O MgtTeamsChannelPickerConfig foi removido e o componente seletor de canal do Teams agora usa Team.ReadBasic.All apenas escopos e Channel.ReadBasic.All escopos em vez de escopos e Group.Read.All herdadosUser.Read.All. Essa alteração permite que seu aplicativo use uma abordagem com privilégios mínimos.

Vários provedores removidos

Nesta versão, vários provedores foram removidos para garantir que seus aplicativos permaneçam seguros e forneçam a melhor experiência possível para seus usuários (suporte para acesso condicional, avaliação contínua de acesso e assim por diante). Os seguintes provedores foram removidos:

• Provedor do Teams
• Provedor MSAL2 do Teams
• Provedor MSAL

Próximas etapas

• Atualize suas soluções para o Kit de Ferramentas versão 3.
• Relate bugs ou deixe uma solicitação de recurso no GitHub.