Exemple : Blazor WebAssembly avec service de découverte global
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
- Télécharger ou cloner le référentiel Exemples pour en avoir une copie locale.
- 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
Accédez à Azure.
Sélectionnez Microsoft Entra ID.
Accédez à Inscriptions d’applications.
Sélectionnez Nouvel enregistrement.
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
Cliquez sur S’inscrire.
Copiez la valeur ID de l’application (client). Vous en aurez besoin lorsque vous Mettez à jour le projet.
Configurer l’authentification
Accédez à Authentification.
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)
Cliquez sur Enregistrer.
Configurer les autorisations
- Accédez à Autorisations API.
- Cliquez sur Ajouter une autorisation.
- Dans la fenêtre volante Demander des autorisations d’API, sous l’onglet API Microsoft, sélectionnez Dynamics CRM.
- Sous Sélectionner des autorisations, sélectionnez user_impersonation.
- Cliquez sur Ajouter des autorisations.
- Sous Autorisations configurées, cliquez sur Accorder un consentement à l’administrateur à {Votre nom du client.}
- Dans la boîte de dialogue de confirmation Accorder un consentement à l’administrateur, cliquez sur Oui.
Mettre à jour le projet
- Ouvrez le fichier de solution BlazorCDS Visual Studio (BlazorCDS.sln) avec Visual Studio.
- Dans Explorateur de solutions, développez
wwwroot
et ouvrez le fichierappsettings.json
. - 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
- Dans la fenêtre du navigateur qui s’ouvre avec l’application, cliquez sur Se connecter.
- 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.
- 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é.
- 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é).