Partager via

Comment : Obtenir des données de contexte (aperçu)

La getContext fonction récupère des informations contextuelles sur l’application et l’utilisateur connecté. Ces informations permettent aux applications de fournir des expériences personnalisées et de prendre des décisions éclairées au moment de l’exécution en fonction des métadonnées. La getContext fonction communique avec le lecteur web pour obtenir des données de contexte. Il est conçu pour être léger et se concentre sur les métadonnées et les propriétés liées à l’authentification.

Pourquoi utiliser des données de contexte ?

Les données de contexte retournées par la getContext fonction fournissent des détails complets sur l’application et l’utilisateur, ce qui permet d’activer des scénarios qui vont au-delà des fonctionnalités de base de l’application. Voici pourquoi ces propriétés sont importantes :

  • Télémétrie et débogage améliorés : les paramètres tels que sessionId vous permettent de mettre en corrélation les sessions d’application avec les données de télémétrie de plateforme, ce qui facilite la résolution des problèmes. L’accès aux identificateurs tels que IAppContext.appId et IUserContext.userPrincipalName permet de suivre les modèles d’utilisation et de diagnostiquer rapidement les problèmes.

  • Expériences personnalisées : les propriétés de contexte utilisateur simplifient la personnalisation sans nécessiter d’appels de données supplémentaires. Vous pouvez personnaliser le comportement de l’application en fonction de l’identité de l’utilisateur, en fournissant des expériences dynamiques pour différents rôles ou individus.

  • Contrôle des fonctionnalités et logique conditionnelle : les paramètres peuvent agir en tant que portes ou indicateurs de fonctionnalité, ce qui vous permet d’activer ou de désactiver des fonctionnalités pour des utilisateurs ou des environnements spécifiques. Ils peuvent également être utilisés pour afficher différents éléments d’interface utilisateur ou flux de travail en fonction du contexte.

  • Cohérence avec canvas Apps : ces paramètres s’alignent sur les détails de session disponibles dans les applications de canevas, mais vous pouvez désormais les utiliser directement dans le code, déverrouillant plus de flexibilité.

Étapes

  1. Importer les fonctions initialize et getContext

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

  2. Initialize

    Vous devez appeler et attendre que la initialize fonction se termine avant d’effectuer des appels de données pour vous assurer que le Kit de développement logiciel (SDK) est entièrement initialisé.

    await initialize();

  3. Récupérer le contexte

    Appelez getContext en tant que fonction asynchrone pour obtenir l’objet de contexte.

    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

Réponse de l’API

Le contexte retourné implémente l’interface IContext .

IContext

Le tableau suivant décrit les propriétés disponibles dans l’interface IContext :

Propriété Type Descriptif
app IAppContext Contexte de l’application
user IUserContext Contexte de l’utilisateur
host IHostContext Contexte de l’hôte

IAppContext

Le tableau suivant décrit les propriétés disponibles dans l’interface IAppContext :

Propriété Type Descriptif
appId ficelle L'ID de l'application en train d'être utilisée
environmentId ficelle ID de l’environnement dans lequel se trouve l’application
queryParams Enregistrement<chaîne, chaîne> Paramètres de requête ajoutés à l’URL

IUserContext

Le tableau suivant décrit les propriétés disponibles dans l’interface IUserContext :

Propriété Type Descriptif
fullName ficelle Nom complet de l’utilisateur jouant l’application
objectId ficelle ID de l’utilisateur jouant l’application
tenantId ficelle ID du locataire où se trouve l’application
userPrincipalName ficelle UPN de l’utilisateur jouant l’application

IHostContext

Le tableau suivant décrit la propriété disponible dans l’interface IHostContext :

Propriété Type Descriptif
sessionId ficelle ID de la session active. Cela change chaque fois que l’application est ouverte
  • Last updated on