Exemple : Blazor WebAssembly avec service de découverte global

  • Article

Cet exemple montre comment utiliser le service de découverte global à partir d’une application Blazor WebAssembly.

Vous pouvez télécharger l’exemple depuis https://github.com/microsoft/PowerApps-Samples/tree/master/dataverse/webapi/C#/BlazorCDS

Cet exemple est une modification des étapes du Tutoriel : Créer une application ASP.NET Core Blazor WebAssembly avec Microsoft Dataverse

Vous pouvez essayer cet exemple en ligne ici :https://blazorcds.mohsinonxrm.com/

Comment exécuter cet exemple

  1. Télécharger ou cloner le référentiel Exemples pour en avoir une copie locale.
  2. Suivez les instructions dans Configuration pour créer un enregistrement d’application Microsoft Entra ID et exécuter l’exemple.

En quoi consiste cet exemple

Cet exemple montre comment fournir un contrôle de sélection (liste déroulante) dans une application Web pour permettre aux utilisateurs de changer d’environnement auquel ils ont accès.

Utiliser cet exemple

Le fichier Pages/EnvironmentChooser.razor fournit l’interface utilisateur pour permettre aux utilisateurs de choisir parmi les environnements disponibles en fonction de leurs informations d’identification après s’être connectés.

Cette page dépend d’une définition nommée d’un HttpClient (GDSClient) dans Program.cs qui est configuré pour accéder au service de découverte global. L’accès au service de découverte global est ajouté aux étendues disponibles lorsque l’utilisateur se connecte. Lorsque l’utilisateur sélectionne un autre environnement, le SelectedEnvUrl dans Models/AppState.cs change.

L’accès aux enregistrements de compte est fourni par Pages/FetchAccounts.razor avec un jeton d’accès qui dépend de l’environnement sélectionné.

Configuration

Pour exécuter cet exemple, vous devez d’abord configurer une application Microsoft Entra ID sur votre locataire et mettre à jour le fichier BlazorCDS\wwwroot\appsettings.json pour remplacer la valeur d’espace réservé ClientId par l’ID de l’application (client). Suivez les étapes suivantes :

Créer une inscription d’application

  1. Accédez à Azure.

  2. Sélectionnez Microsoft Entra ID.

  3. Accédez à Inscriptions d’applications.

  4. Sélectionnez Nouvel enregistrement.

  5. Renseignez ce qui suit :

    Champ Valeur
    Nom Votre choix. Vous pourriez utiliser : BlazorGlobalDiscoverySample
    Types de compte pris en charge : Comptes dans ce répertoire organisationnel uniquement (client unique)
    URI de redirection (facultatif) https://localhost:44363/authentication/login-callback

  6. Cliquez sur S’inscrire.

  7. Copiez la valeur ID de l’application (client). Vous en aurez besoin lorsque vous Mettez à jour le projet.

Configurer l’authentification

  1. Accédez à Authentification.

  2. Sous Octroi implicite et flux hybrides, sélectionnez les deux options suivantes :

    • Jetons d’accès (utilisés pour les flux implicites)
    • Jetons d’identification (utilisés pour les flux implicites et hybrides)

  3. Cliquez sur Enregistrer.

Configurer les autorisations

  1. Accédez à Autorisations API.
  2. Cliquez sur Ajouter une autorisation.
  3. Dans la fenêtre volante Demander des autorisations d’API, sous l’onglet API Microsoft, sélectionnez Dynamics CRM.
  4. Sous Sélectionner des autorisations, sélectionnez user_impersonation.
  5. Cliquez sur Ajouter des autorisations.
  6. Sous Autorisations configurées, cliquez sur Accorder un consentement à l’administrateur à {Votre nom du client.}
  7. Dans la boîte de dialogue de confirmation Accorder un consentement à l’administrateur, cliquez sur Oui.

Mettre à jour le projet

  1. Ouvrez le fichier de solution BlazorCDS Visual Studio (BlazorCDS.sln) avec Visual Studio.
  2. Dans Explorateur de solutions, développez wwwroot et ouvrez le fichier appsettings.json.
  3. Remplacez la valeur ClientId de l’espace réservé (11111111-1111-1111-1111-111111111111) avec la valeur d’ID d’application (client) que vous avez copiée dans Créer un enregistrement d’application.

Exécuter l’exemple

Dans Visual Studio, cliquez sur IIS Express pour exécuter l’échantillon.

Démontrer

  1. Dans la fenêtre du navigateur qui s’ouvre avec l’application, cliquez sur Se connecter.
  2. Entrez vos informations d’identification et vous verrez un contrôle de sélection avec l’étiquette : Choisir un environnement. Le contrôle de sélection doit répertorier tous les environnements auxquels vous avez accès avec les informations d’identification que vous avez fournies.
  3. Cliquez sur Récupérer des comptes. Cela devrait afficher une liste des enregistrements de compte auxquels vous avez accès dans l’environnement sélectionné.
  4. Si vous avez le choix entre plusieurs environnements, sélectionnez un autre environnement et la liste des enregistrements de compte sera actualisée pour représenter les enregistrements disponibles dans cet environnement.

Nettoyer

Cet exemple n’apporte aucune modification aux données de votre environnement.

Voir aussi

Découvrir les organisations d’utilisateur
Exemple : service de découverte global (C #)

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).