Freigeben über

Beispiel: Blazor WebAssembly mit globaler Ermittlung

  • Artikel

Dieses Beispiel zeigt, wie der globale Suchdienst über eine Blazor WebAssembly-Anwendung verwendet wird.

Sie können das Beispiel herunterladen unter https://github.com/microsoft/PowerApps-Samples/tree/master/dataverse/webapi/C#/BlazorCDS

Dieses Beispiel ist eine Modifikation der Schritte im Tutorial: Erstellen einer ASP.NET-Core Blazor WebAssembly-App unter Verwendung von Microsoft Dataverse

Sie können dieses Beispiel hier online ausprobieren: https://blazorcds.mohsinonxrm.com/

Wie man dieses Beispiel ausführt

  1. Um eine lokale Kopie zu erhalten, laden Sie das Beispiele-Repository herunter, oder klonen Sie es.
  2. Befolgen Sie die Anweisungen in Einrichtung, um eine Microsoft Entra ID-App-Registrierung zu erstellen und das Beispiel auszuführen.

Funktionsweise

Dieses Beispiel zeigt, wie ein Auswahlsteuerelement (Dropdown-Steuerelement) in einer Webanwendung bereitgestellt wird, damit Benutzer Umgebungen wechseln können, auf die sie Zugriff haben.

Wie dieses Beispiel funktioniert

Die Pages/EnvironmentChooser.razor-Datei bietet die Benutzeroberfläche, mit der Benutzer nach der Anmeldung aus verfügbaren Umgebungen basierend auf ihren Anmeldeinformationen auswählen können.

Diese Seite hängt von einer benannten Definition eines HttpClient (GDSClient) in Program.cs ab, die für den Zugriff auf den globalen Suchdienst konfiguriert ist. Der Zugriff auf den globalen Suchdienst wird den verfügbaren Bereichen hinzugefügt, wenn sich der Benutzer anmeldet. Wenn der Benutzer eine andere Umgebung auswählt, wird die SelectedEnvUrl in Models/AppState.cs geändert.

Der Zugriff auf die Firmendatensätze erfolgt über Pages/FetchAccounts.razor mit einem Zugriffstoken, das von der ausgewählten Umgebung abhängt.

Einrichtung

Um dieses Beispiel auszuführen, müssen Sie zunächst eine Microsoft Entra ID-Anwendung auf Ihrem Mandanten konfigurieren und die Datei BlazorCDS\wwwroot\appsettings.json aktualisieren, um den Platzhalterwert ClientId durch die Anwendungs-(Client-)ID zu ersetzen. Führen Sie folgende Schritte aus:

Erstellen einer App-Registrierung

  1. Wechseln Sie zu Azure.

  2. Wählen Sie Microsoft Entra ID aus.

  3. Gehen Sie zu App-Registrierungen.

  4. Wählen Sie Neue Registrierung aus.

  5. Geben Sie Folgendes ein:

    Feld Wert
    Name Ihre Wahl. Vielleicht verwenden Sie: BlazorGlobalDiscoverySample
    Unterstützte Kontotypen: Konten nur in diesem Organisationsverzeichnis (Einzelmandant)
    Umleitungs-URI (optional) https://localhost:44363/authentication/login-callback

  6. Klicken Sie auf Registrieren.

  7. Kopieren Sie den Wert Anwendungs- (Client-)ID. Sie werden ihn benötigen, wenn Sie das Projekt aktualisieren.

Authentifizierung konfigurieren

  1. Wechseln Sie zu Authentifizierung.

  2. Wählen Sie unter Implizite Genehmigung und Hybridflows beide der folgenden Optionen aus:

    • Zugriffstoken (verwendet für implizite Flows)
    • ID-Token (verwendet für implizite und hybride Flows)

  3. Klicken Sie auf Speichern.

Berechtigungen konfigurieren

  1. Gehen Sie zu API-Berechtigungen.
  2. Klicken Sie auf Berechtigung hinzufügen.
  3. Wählen Sie im Flyout API-Berechtigungen anfordern unter der Microsoft-APIs-Registerkarte Dynamics CRM aus.
  4. Unter Berechtigungen auswählen wählen Sie user_impersonation aus.
  5. Klicken Sie auf Berechtigungen hinzufügen.
  6. Klicken Sie unter Konfigurierte Berechtigungen auf Administratoreinwilligung erteilen für {Ihr Mandantenname.}
  7. Klicken Sie im Bestätigungsdialogfeld Administratoreinwilligung erteilen auf Ja.

Projekt aktualisieren

  1. Öffnen Sie die BlazorCDS Visual Studio-Lösungsdatei (BlazorCDS.sln) mit Visual Studio.
  2. Im Lösungs-Explorer erweitern Sie wwwroot und öffnen die appsettings.json-Datei.
  3. Ersetzen Sie den Platzhalter-ClientId-Wert (11111111-1111-1111-1111-111111111111) mit dem von Ihnen in Erstellen einer App-Registrierung kopierten Anwendungs-ID-Wert (Client-ID).

Ausführen des Beispiels

Klicken Sie in Visual Studio auf IIS Express, um das Beispiel auszuführen.

Demonstrieren

  1. Klicken Sie in dem sich öffnenden Browserfenster mit der App auf Anmelden.
  2. Geben Sie Ihre Anmeldeinformationen ein, und Sie sehen ein Auswahlsteuerelement mit der Beschriftung: Umgebung auswählen. Das Auswahlsteuerelement sollte alle Umgebungen auflisten, auf die Sie mit den von Ihnen bereitgestellten Anmeldeinformationen zugreifen können.
  3. Klicken Sie auf Konten abrufen. Dies sollte eine Liste der Firmendatensätze anzeigen, auf die Sie Zugriff haben, um sie in der ausgewählten Umgebung anzuzeigen.
  4. Wenn Sie mehr als eine Umgebung zur Auswahl haben, wählen Sie eine andere Umgebung aus, und die Liste der Firmendatensätze wird aktualisiert, um die in dieser Umgebung verfügbaren Datensätze darzustellen.

Bereinigung

Dieses Beispiel nimmt keine Änderungen an Daten in Ihrer Umgebung vor.

Siehe auch

Benutzerorganisationen ermitteln
Beispiel: Globaler Suchdienst (C#)

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).