Gewusst wie: Abrufen von Kontextdaten (Vorschau)

Die getContext Funktion ruft kontextbezogene Informationen über die App und den angemeldeten Benutzer ab. Mit diesen Informationen können Apps personalisierte Erfahrungen bereitstellen und fundierte Entscheidungen zur Laufzeit basierend auf Metadaten treffen. Die getContext Funktion kommuniziert mit dem Webplayer, um Kontextdaten abzurufen. Es ist so konzipiert, dass es leicht ist und sich auf Metadaten und Authentifizierungsbezogene Eigenschaften konzentriert.

Warum Kontextdaten verwenden?

Die von der getContext Funktion zurückgegebenen Kontextdaten enthalten umfassende Details zur App und zum Benutzer, was Szenarien ermöglicht, die über die grundlegenden App-Funktionen hinausgehen. Dies ist der Grund, warum diese Eigenschaften wichtig sind:

• Erweiterte Telemetrie und Debugging: Parameter wie sessionId ermöglichen es Ihnen, App-Sitzungen mit Plattform-Telemetrie zu korrelieren, wodurch es einfacher wird, Probleme zu beheben. Der Zugriff auf Bezeichner wie "IAppContext.appId " und "IUserContext.userPrincipalName " hilft dabei, Verwendungsmuster nachzuverfolgen und Probleme schnell zu diagnostizieren.

• Personalisierte Erfahrungen: Benutzerkontexteigenschaften vereinfachen die Personalisierung, ohne dass zusätzliche Datenaufrufe erforderlich sind. Sie können das App-Verhalten basierend auf der Benutzeridentität anpassen und dynamische Erfahrungen für verschiedene Rollen oder Einzelpersonen bereitstellen.

• Featuresteuerung und bedingte Logik: Parameter können als Funktionsschalter oder Flags fungieren und es Ihnen ermöglichen, Funktionen für bestimmte Benutzer oder Umgebungen zu aktivieren oder zu deaktivieren. Sie können auch verwendet werden, um je nach Kontext verschiedene UI-Elemente oder Workflows anzuzeigen.

• Konsistenz mit Canvas-Apps: Diese Parameter richten sich an Sitzungsdetails, die in Canvas-Apps verfügbar sind, aber jetzt können Sie sie direkt im Code verwenden, um mehr Flexibilität zu bieten.

Steps

1. Importieren Sie die Funktionen initialize und getContext

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

2. Initialisieren

   Sie müssen die Funktion aufrufen und warten, bis die initialize Funktion abgeschlossen ist, bevor Sie Datenaufrufe ausführen, um sicherzustellen, dass das SDK vollständig initialisiert ist.

   await initialize(); 
   

3. Abrufen des Kontexts

   Rufen Sie getContext als asynchrone Funktion auf, um das Kontextobjekt abzurufen.

   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
   

API-Antwort

Der zurückgegebene Kontext implementiert die IContext-Schnittstelle .

IContext

In der folgenden Tabelle werden die eigenschaften beschrieben, die in der IContext Schnittstelle verfügbar sind:

Eigentum	Typ	Description
app	IAppContext	Kontext der App
user	IUserContext	Der Kontext des Benutzers
host	IHostContext	Der Kontext des Hosts

IAppContext

In der folgenden Tabelle werden die eigenschaften beschrieben, die in der IAppContext Schnittstelle verfügbar sind:

Eigentum	Typ	Description
appId	Schnur	Die ID der abgespielten App
environmentId	Schnur	Die ID der Umgebung, in der sich die App befindet
queryParams	<Zeichenfolge, Zeichenfolge> aufzeichnen	Die Abfrageparameter, die der URL hinzugefügt wurden

IUserContext

In der folgenden Tabelle werden die eigenschaften beschrieben, die in der IUserContext Schnittstelle verfügbar sind:

Eigentum	Typ	Description
fullName	Schnur	Der vollständige Name des Benutzers, der die App spielt
objectId	Schnur	Die ID des Benutzers, der die App spielt
tenantId	Schnur	Die ID des Mandanten, wo die App ist
userPrincipalName	Schnur	UpN des Benutzers, der die App abspielt

IHostContext

In der folgenden Tabelle wird die in der IHostContext Schnittstelle verfügbare Eigenschaft beschrieben:

Eigentum	Typ	Description
sessionId	Schnur	Die ID der aktuellen Sitzung. Dies ändert sich jedes Mal, wenn die App geöffnet wird.