Provedor do SharePointSharePoint provider

Use o provedor do SharePoint dentro de suas Web Parts do SharePoint para a energia dos componentes com o acesso ao Microsoft Graph.Use the SharePoint provider inside your SharePoint web parts to power the components with Microsoft Graph access.

Para saber mais sobre provedores de autenticação, consulte Provedores.To learn more about authentication providers, see Providers.

IntroduçãoGet started

Inicialize o provedor dentro onInit() do método da Web Part.Initialize the provider inside the onInit() method of your web part.

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

// 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.Now you can add any component in your render() method and it will use the SharePoint context to access Microsoft Graph.

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

Observação: O Microsoft Graph Toolkit requer o Typescript 3.x.Note: The Microsoft Graph Toolkit requires Typescript 3.x. Certifique-se de que você está usando uma versão com suporte do Typescript instalando o compilador correto.Make sure you're using a supported version of Typescript by installing the right compiler.

AmostraSample

Para obter detalhes sobre como inicializar o provedor do SharePoint, consulte o guia de iniciação da Web Part do SharePoint.For details about how to initialize the SharePoint provider, see the Build a SharePoint web part getting started guide.

Para ver um exemplo pré-criado que mostra como usar os vários componentes em suas Web Parts do SharePoint, confira o exemplo de Web Part do SharePoint no repositório do Microsoft Graph Toolkit.For a pre-built example that shows you how to use the various components in your SharePoint web parts, see the SharePoint web part sample in the Microsoft Graph Toolkit repository.

Testar no workbenchTest in the workbench

Se você estiver apenas começando a usar as Web Parts do SharePoint, siga as orientações de Criar sua primeira Web Part.If you're just getting started with SharePoint web parts, you can follow the Build your first web part guidance.

Depois de criar uma Web Part e estar pronto para usar os componentes, você precisará garantir que sua Web Part tenha as permissões corretas para acessar o Microsoft Graph.After you've created a web part, and you're ready to use the components, you will need to make sure that your web part has the right permissions to access Microsoft Graph. Para obter detalhes, consulte Consumir o Microsoft Graph na Estrutura do SharePoint.For details, see Consume Microsoft Graph in the SharePoint Framework.

Em resumo, é importante adicionar a permissão certa ao seu package-solution.json .In short, it's important to add the right permission to your package-solution.json. Você precisará carregar um pacote da Web Part para o SharePoint e pedir para um administrador aprovar as permissões solicitadas.You will need to upload a package of your web part to SharePoint and have an administrator approve the requested permissions.

Dica

O guia de iniciação da Web Part criar uma Web Part do SharePoint fornece instruções passo a passo para configurar e aprovar permissões.The Build a SharePoint web part getting started guide provides step-by-step instructions for configuring and approving permissions.

Observação: se você não tiver certeza de quais permissões adicionar, a documentação de cada componente incluirá todas as permissões de que precisa.Note: if you're not sure what permissions to add, the documentation for each component includes all the permissions it needs.

PolyfillsPolyfills

Se você planeja dar suporte ao IE11 em suas webparts SPFx, deve usar polyfills.If you plan to support IE11 in your SPFx webparts, you must use polyfills.

Para saber mais, consulte Getting started with Microsoft Graph Toolkit.To learn more, see Getting started with Microsoft Graph Toolkit.