Provedor do Microsoft Office SharePoint Online

Use o provedor do SharePoint dentro de suas Web Parts do SharePoint para alimentar os componentes com acesso ao Microsoft Graph.

Para saber mais sobre provedores de autenticação, consulte Provedores.

Introdução

Inicialize o provedor dentro do onInit() método da web part. Este exemplo usa o @microsoft/mgt-spfx pacote.

// import the providers at the top of the page
import {Providers, SharePointProvider} from '@microsoft/mgt-spfx';

// add the onInit() method if not already there in your web part class
protected async onInit() {
  Providers.globalProvider = new SharePointProvider(this.context);
}

Agora você pode adicionar qualquer componente em seu render() método e ele usará o contexto do SharePoint para acessar o Microsoft Graph.

public render(): void {
  this.domElement.innerHTML = `
    <mgt-agenda></mgt-agenda>
    `;
}

Usar um ponto de extremidade de nuvem diferente

Use isso quando quiser usar o kit de ferramentas para renderizar seus dados de um ponto de extremidade diferente do Microsoft 365.

// import the providers at the top of the page
import {Providers, SharePointProvider} from '@microsoft/mgt-spfx';
import {GraphEndpoint} from '@microsoft/mgt-element';

const baseUrl: GraphEndpoint = 'https://graph.microsoft.us';

// add the onInit() method if not already there in your web part class
protected async onInit() {
  Providers.globalProvider = new SharePointProvider(this.context, baseUrl=baseUrl);
}

Em seguida, use o kit de ferramentas normalmente.

Observação: O Microsoft Graph Toolkit requer o Typescript 3.7 ou mais recente. Verifique se você está usando uma versão compatível do Typescript instalando o compilador correto.

Amostra

Para obter detalhes sobre como inicializar o provedor do SharePoint, consulte o guia de introdução Criar uma Web Part do SharePoint .

Teste no workbench

Se você acabou de começar a usar as Web Parts do SharePoint, pode seguir a orientação Criar sua primeira Web Part .

Depois de criar uma web part e estiver pronto para usar os componentes, você precisará verificar se sua web part tem as permissões corretas para acessar o Microsoft Graph. Para obter detalhes, consulte Consumir o Microsoft Graph na Estrutura do SharePoint.

Resumindo, é importante adicionar a permissão certa ao seu package-solution.jsonarquivo . Você precisará carregar um pacote da sua web part no SharePoint e pedir para um administrador aprovar as permissões solicitadas.

Observação: se você não tiver certeza de quais permissões adicionar, a documentação de cada componente inclui todas as permissões necessárias.