Provedor do Microsoft Office SharePoint Online

  • Artigo

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

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

Introdução

Inicialize o provedor dentro do onInit() método de sua 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 como de costume.

Nota: O Kit de Ferramentas do Microsoft Graph requer Typescript 3.7 ou mais recente. Verifique se você está usando uma versão com suporte do Typescript instalando o compilador certo.

Amostra

Para obter detalhes sobre como inicializar o provedor do SharePoint, consulte o guia Criar uma Web Part do SharePoint que está sendo iniciado.

Teste no workbench

Se você está apenas começando com web parts do SharePoint, você pode seguir as diretrizes Criar sua primeira Web Part .

Depois de criar uma Web Part e estiver pronto para usar os componentes, você precisará garantir que sua Web Part tenha as permissões certas para acessar o Microsoft Graph. Para obter detalhes, consulte Consumir o Microsoft Graph no Estrutura do SharePoint.

Em suma, é importante adicionar a permissão certa ao seu package-solution.json. Você precisará carregar um pacote de sua Web Part no SharePoint e fazer com que um administrador aprove as permissões solicitadas.

Dica

O guia Criar uma Web Part do SharePoint fornece instruções passo a passo para configurar e aprovar permissões.

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.