Proveedor de SharePoint

Use el proveedor de SharePoint dentro de los elementos web de SharePoint para alimentar los componentes con acceso a Microsoft Graph.

Para más información sobre los proveedores de autenticación, consulte Proveedores.

Introducción

Inicialice el proveedor dentro del onInit() método del elemento web. En este ejemplo se usa el @microsoft/mgt-spfx paquete .

// 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);
}

Ahora puede agregar cualquier componente en el render() método y usará el contexto de SharePoint para acceder a Microsoft Graph.

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

Uso de un punto de conexión en la nube diferente

Úselo cuando quiera usar el kit de herramientas para representar los datos de un punto de conexión de Microsoft 365 diferente.

// 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);
}

A continuación, use el kit de herramientas como de costumbre.

Nota: Microsoft Graph Toolkit requiere Typescript 3.7 o posterior. Asegúrese de que usa una versión compatible de Typescript mediante la instalación del compilador correcto.

Muestra

Para obtener más información sobre cómo inicializar el proveedor de SharePoint, consulte la guía de introducción a la compilación de un elemento web de SharePoint .

Prueba en el área de trabajo

Si acaba de empezar a trabajar con elementos web de SharePoint, puede seguir la guía Compilar el primer elemento web .

Una vez que haya creado un elemento web y esté listo para usar los componentes, deberá asegurarse de que el elemento web tiene los permisos adecuados para acceder a Microsoft Graph. Para obtener más información, consulte Consumo de Microsoft Graph en el SharePoint Framework.

En resumen, es importante agregar el permiso adecuado a package-solution.json. Tendrá que cargar un paquete del elemento web en SharePoint y hacer que un administrador apruebe los permisos solicitados.

Sugerencia

La guía de introducción a crear un elemento web de SharePoint proporciona instrucciones paso a paso para configurar y aprobar permisos.

Nota: si no está seguro de qué permisos agregar, la documentación de cada componente incluye todos los permisos que necesita.