Provedor do Microsoft Office SharePoint Online

Utilize o fornecedor do SharePoint dentro das suas peças Web do SharePoint para alimentar os componentes com acesso ao Microsoft Graph.

Para saber mais sobre os fornecedores de autenticação, veja Fornecedores.

Introdução

Inicialize o fornecedor dentro do onInit() método da peça Web. Este exemplo utiliza 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, pode adicionar qualquer componente no seu render() método e este irá utilizar o contexto do SharePoint para aceder ao Microsoft Graph.

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

Utilizar um ponto final de cloud diferente

Utilize esta opção quando quiser utilizar o toolkit para compor os seus dados a partir de um ponto final 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, utilize o toolkit como habitualmente.

Nota: O Microsoft Graph Toolkit requer o Typescript 3.7 ou mais recente. Certifique-se de que está a utilizar uma versão suportada do Typescript ao instalar o compilador correto.

Amostra

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

Testar no workbench

Se estiver apenas a começar a utilizar peças Web do SharePoint, pode seguir a documentação de orientação Criar a sua primeira peça Web .

Depois de criar uma peça Web e de estar pronto para utilizar os componentes, terá de se certificar de que a peça Web tem as permissões certas para aceder ao Microsoft Graph. Para obter detalhes, veja Consume Microsoft Graph in the Estrutura do SharePoint (Consumir o Microsoft Graph no Estrutura do SharePoint).

Em suma, é importante adicionar a permissão certa ao seu package-solution.json. Terá de carregar um pacote da sua peça Web para o SharePoint e pedir a um administrador que aprove as permissões pedidas.

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