¿Qué es el Kit de herramientas de Microsoft Graph?
Al compilar una aplicación web y desea conectarla a Microsoft 365, debe implementar la autorización y llamar a Microsoft Graph para recuperar los datos almacenados en Microsoft 365.
Para simplificar este proceso, el Kit de herramientas de Microsoft Graph proporciona un conjunto de componentes web y proveedores de autenticación para conectar aplicaciones web a Microsoft 365.
En esta unidad, aprenderá qué es el Kit de herramientas de Microsoft Graph y por qué desea usarlo. También obtendrá información sobre los distintos tipos de aplicaciones que pueden usar el kit de herramientas.
Introducción al Kit de herramientas de Microsoft Graph
El Kit de herramientas de Microsoft Graph es un conjunto de componentes web que puede usar con cualquier marco de JavaScript para conectar la aplicación a Microsoft 365. Después de cargar el kit de herramientas en la aplicación, obtendrá acceso a un conjunto de etiquetas HTML personalizadas. Estas etiquetas permiten cargar datos desde Microsoft 365.
Por ejemplo, para mostrar la lista de próximas reuniones para el usuario actual, incluiría en la aplicación el siguiente fragmento de código:
<mgt-agenda></mgt-agenda>
A continuación, la aplicación se representaría:
El Kit de herramientas de Microsoft Graph se actualiza periódicamente con nuevos componentes y características.
¿Por qué debería usar el Kit de herramientas de Microsoft Graph?
En el ejemplo anterior, ¿se ha percatado de que no era necesario emitir una única solicitud web? Este es exactamente el motivo por el que debe considerar el uso del Kit de herramientas de Microsoft Graph.
- Céntrese en crear su propia aplicación web: Kit de herramientas de Microsoft Graph abstrae la autorización y la conexión a Microsoft Graph. No es necesario preocuparse por la autorización, la creación de solicitudes web, el control de respuestas y el tratamiento de excepciones.
- Personalice la representación para que coincida con su aplicación web: todos los componentes del Kit de herramientas de Microsoft Graph están listos para usarse. De forma predeterminada, muestran los datos mediante la interfaz de usuario de Fluent, el lenguaje de diseño Microsoft 365. Cada componente también expone una plantilla, que permite personalizar los datos representados.
¿Cuándo usaría el Kit de herramientas de Microsoft Graph?
Puede usar el Kit de herramientas de Microsoft Graph al crear aplicaciones web y extensiones para Microsoft 365.
- Use el Kit de herramientas de Microsoft Graph en aplicaciones web: Kit de herramientas de Microsoft Graph es más adecuado para su uso en aplicaciones web. Con una configuración mínima, permite a los usuarios iniciar sesión en la aplicación con su cuenta de Microsoft 365. Con los distintos componentes, puede cargar datos directamente desde Microsoft 365, lo que aumenta el valor de la aplicación.
- Crear extensiones de Microsoft 365 con el Kit de herramientas de Microsoft Graph: También puede usar el Kit de herramientas de Microsoft Graph al crear extensiones para Microsoft 365, como pestañas de Teams o elementos web de SharePoint Framework. Para compilar estas extensiones, el kit de herramientas incluye proveedores para usar la información de autenticación existente expuesta por Microsoft 365.
- Use el Kit de herramientas de Microsoft Graph en cualquier marco de JavaScript: los componentes web del kit de herramientas de Microsoft Graph funcionan con cualquier marco de JavaScript. Si compila aplicaciones web mediante React, hay un paquete de kit de herramientas específico creado para React. Este paquete encapsula los componentes del kit de herramientas en los componentes de React, lo que facilita el paso de datos complejos a los componentes y la configuración de controladores de eventos.
Cargar el Kit de herramientas de Microsoft Graph en la aplicación web
Si compila aplicaciones web sin usar un empaquetador, puede cargar el Kit de herramientas de Microsoft Graph directamente desde la red de entrega de contenido. Para cargar el kit de herramientas desde la red de entrega de contenido, agregue el siguiente fragmento de código a la aplicación web:
<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>
Si trabaja en proyectos que usan un administrador de paquetes como npm, agregue el Kit de herramientas de Microsoft Graph a la aplicación web instalando el paquete @microsoft/mgt:
npm install @microsoft/mgt
Si compila aplicaciones de React, instale el paquete de @microsoft/mgt en su lugar:
npm install @microsoft/mgt-react