Guide de configuration

Il y a un moyen plus rapide

Tout ce qui se trouve sur cette page peut être fait pour vous. Le serveur MCP de Power Portals Pro connaît ce framework, lit votre environnement Dataverse et votre abonnement Azure, et peut créer les inscriptions à l’application, l’utilisateur de l’application, le service d’application et l’expéditeur de l’email lui-même — vous demandant avant chaque modification et vous indiquant le coût. Les étapes manuelles sont en dessous, et restent précises que vous l’utilisiez ou non. Pour tout le parcours — d’un dossier vide à une page sécurisée de vos propres données — suivez le Quickstart IA.

Laissez un agent IA s’occuper de la configuration

La configuration est la partie de ce cadre qu’aucune documentation composante n’aide : elle couvre dotnet newdeux inscriptions d’applications Entra, un utilisateur d’application Dataverse, une solution gérée, un expéditeur d’e-mail et un service d’application, et chacun produit une valeur qui doit se placer dans la bonne clé de configuration. Le serveur MCP existe parce que cette séquence est connaissable, et c’est le genre de chose qu’un agent avec les bons outils fait bien.

1. Installer

Installez-le à l’échelle utilisateur, afin qu’il soit disponible dans n’importe quel dossier — y compris un dossier vide dans lequel vous allez installer un projet, où il peut vous indiquer quel modèle utiliser et ce que signifient les options :

Visual Studio et Cursor lisent leurs propres .mcp.jsonéléments ; la page MCP Server a le bloc pour chacun. Les projets créés à partir des modèles sont déjà câblés, avec la version épinglée aux paquets utilisés par le projet. dnx est livré avec le SDK .NET 10, que vous avez déjà.

2. Connectez-vous, dans votre dossier de projet

Deux connexions, car ce sont deux choses différentes : une pour l’environnement Dataverse et une pour l’abonnement Azure. Exécutez les deux dans le dossier où se trouve votre projet — chaque liaison appartient uniquement à ce dossier, donc un consultant avec plusieurs clients ouverts a chacun pointé vers son propre environnement et abonnement en même temps :

Les deux utilisent un code de dispositif par défaut, donc ils fonctionnent via SSH, dans un conteneur et en WSL, et vous pouvez les terminer sur votre téléphone. Rien ne change à l’échelle de la machine — le serveur ne lit ni ne modifie jamais ce à quoi az pac ou vous êtes connecté, ce qui permet à deux projets de viser deux clients sans que l’un ne piétine l’autre. La connexion Azure n’est nécessaire que pour les outils de déploiement ; passez-la si vous ne configurez que localement.

3. Demandez-lui de commencer

Il n’existe pas de commande unique qui fasse tout, délibérément — voir la note ci-dessous. Dirigez plutôt votre agent vers le plan, et il le suivra avec vous :

get_setup_plan est la liste ordonnée de ce qui doit exister et de ce que chaque étape produit ; check_setup rapporte ce qui manque encore à ce dossier ; get_setup_script écrit un script révisable pour les étapes que vous préférez exécuter vous-même. Pour le déploiement, get_deployment_plan et check_deployment faites le même travail pour Azure — voir la page de déploiement Azure .

Note

Pourquoi il n’y a pas de commande unique « tout faire ». Chaque outil qui crée quelque chose vous demande en premier et indique le coût, et cette approbation par étape est la raison pour laquelle ces outils sont autorisés à créer des inscriptions d’applications et des services applicatifs. Une commande qui fait tout le lot demanderait soit dix fois, ce qui est pire qu’un agent qui vous guide à travers la lettre, soit une seule demande — ce qui signifierait approuver des objets d’annuaire à l’échelle du locataire, une facture mensuelle et Dataverse écrit sur un seul oui. La séquence est connaissable et l’agent peut la lire ; les approbations vous appartiennent.

Installation manuelle

La même séquence, faite vous-même. Ça vaut la peine d’être lu même si vous utilisez l’agent : c’est ce que font les outils, et le savoir fait la différence entre diagnostiquer une installation ratée et deviner une configuration.

1. Installer les modèles

Les modèles enchaînent un portail complet — connectivité Dataverse, authentification, gestionnaires de sécurité, localisation et pages d’identité — et fonctionnent depuis Visual Studio 2022 et 2026 ou la ligne de commande. Installez le pack une fois :

2. Créer le projet

Le pack installe deux modèles, et le jeu de fonctionnalités Power Portals Pro est identique sur les deux — grilles, éditeurs, sécurité, localisation et les pages d’identité se comportent de la même manière dans les deux cas. Choisissez le front-end dans lequel votre équipe souhaite travailler :

Dans Visual Studio, les deux apparaissent dans la boîte de dialogue du nouveau projet :

Le dialogue de nouveau projet Visual Studio avec un modèle Power Portals Pro sélectionné.

Les deux peuvent être créés à partir de la ligne de commande, ce qui est aussi la façon dont on le scripte. La page Modèles de Projet couvre toutes les options et son code par défaut :


3. Configurer la connexion Dataverse

Program.cs Lit les détails de la connexion depuis la configuration :

Le code Program.cs indiquant où les paramètres de connexion Dataverse sont lus depuis la configuration.

Mettez les valeurs dans les secrets utilisateur plutôt que appsettings.json, afin qu’un secret client n’atteigne jamais le contrôle de version. Faites un clic droit sur le projet et choisissez Gérer les secrets utilisateur :

Le menu contextuel du projet Visual Studio avec l’option Gérer les secrets utilisateur est mis en surbrillance.

Remplacez les placeholders par les vôtres. ClientId et ClientSecret proviennent d’une inscription Entra associée à un utilisateur de l’application Dataverse — l’enregistrement seul authentifie puis est refusé par chaque appel, donc les deux moitiés sont nécessaires. La page Dataverse Connection explique comment les créer :

{
  "D365":
  {
    "Url": "https://yoururl.crm.dynamics.com",
    "ClientId": "",
    "ClientSecret": ""
  }
}

4. Installer la solution gérée

Téléchargez la dernière solution gérée depuis la page Versions et importez-la dans votre environnement. Il fournit les tables propres du cadre et l’action de vérification de licence — tant qu’elle n’est pas installée, chaque endpoint de données est refusé, sans qu’aucun symptôme ne pointe vers la cause.

Ouvrez l’application Power Portals Pro dans votre environnement :

L’application Power Portals Pro pilotée par les modèles s’ouvre dans l’environnement Dataverse.

Dans le site Web du portail, créez un enregistrement pour votre site et saisissez votre clé de licence.

Le formulaire d’enregistrement du site web du portail où la clé de licence est saisie.

Note

Pas encore de clé ? Demande un essai. La page Licence couvre l’obtention et l’enregistrement complet.

5. Connexion Microsoft (optionnel)

La connexion avec Microsoft est structurée mais commentée hors du commentaire. Retirer ce commentaire de ce bloc dans Program.cs:

Le code Program.cs avec la section authentification Microsoft sans commentaire.

Il nécessite sa propre inscription sur l’application Entra — distincte de celle de l’étape 3, afin que la rotation d’un secret ne puisse pas supprimer à la fois la connexion et l’accès aux données. La page de connexion Entra ID traite l’enregistrement et toutes les propriétés nécessaires.

6. Exécutez-le

Appuyez sur F5. Ce qui démarre, c’est un portail fonctionnel plutôt qu’un shell vide : exemples de pages Comptes et Contacts, pages d’identité et de gestion de compte, navigation, et paramètres de thème et de site — tout cela vous appartient à modifier.

La solution comprend également un <YourProject>.Tests.Integration projet avec des bases pour les tests de niveau terminal, d’autorisations et de couche service. Voir Tests d’intégration.