Cómo: Obtener datos de contexto

La función recupera información contextual sobre la aplicación y el usuario que ha iniciado sesión. Esta información permite a las aplicaciones ofrecer experiencias personalizadas y tomar decisiones fundamentadas en tiempo de ejecución en función de los metadatos. La función se comunica con el reproductor web para obtener datos de contexto. La función es ligera y se centra en metadatos y propiedades relacionadas con la autenticación.

¿Por qué usar datos de contexto?

Los datos de contexto devueltos por la función proporcionan detalles completos sobre la aplicación y el usuario, lo que permite escenarios que van más allá de la funcionalidad básica de la aplicación. Este es el motivo por el que importan estas propiedades:

• Telemetría mejorada y depuración: Los parámetros como te permiten correlacionar sesiones de la app con la telemetría de la plataforma, lo que facilita la identificación de problemas. El acceso a identificadores como IAppContext.appId e IUserContext.userPrincipalName ayuda a realizar un seguimiento de los patrones de uso y diagnosticar problemas rápidamente.

• Experiencias personalizadas: las propiedades de contexto del usuario simplifican la personalización sin necesidad de más llamadas a datos. Puede adaptar el comportamiento de la aplicación en función de la identidad del usuario, ofreciendo experiencias dinámicas para diferentes roles o individuos.

• Control de características y lógica condicional: los parámetros pueden actuar como puertas o marcas de características, lo que le permite activar o desactivar características para usuarios o entornos específicos. También se pueden usar para mostrar diferentes elementos de interfaz de usuario o flujos de trabajo en función del contexto.

• Coherencia con las aplicaciones de Canvas: estos parámetros se alinean con los detalles de la sesión disponibles en las aplicaciones de lienzo, pero ahora puede usarlos directamente en el código, lo que permite desbloquear más flexibilidad.

Steps

1. Importación de la función

   import { getContext } from '@microsoft/power-apps/app'; 
   

2. Recuperación del contexto

   Llame a como una función asincrónica para obtener el objeto de contexto.

   const ctx = await getContext();
   
   // Now you can access these context properties
   const appId = ctx.app.appId
   const environmentId = ctx.app.environmentId
   const queryParams = ctx.app.queryParams
   const fullName = ctx.user.fullName
   const objectId = ctx.user.objectId
   const tenantId = ctx.user.tenantId
   const userPrincipalName = ctx.user.userPrincipalName
   const sessionId = ctx.host.sessionId
   

Respuesta de la API

El contexto devuelto implementa la interfaz .

IContext

En la tabla siguiente se describen las propiedades disponibles en la interfaz:

IAppContext

En la tabla siguiente se describen las propiedades disponibles en la interfaz:

IUserContext

En la tabla siguiente se describen las propiedades disponibles en la interfaz:

IHostContext

En la tabla siguiente se describe la propiedad disponible en la interfaz :