Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
(Préversion) Commandes permettant d’utiliser des applications basées sur des modèles.
Commands
| Command | Descriptif |
|---|---|
| pac model genpage download | (Préversion) Extraire des pages générées à partir d’une application basée sur un modèle. |
| pac model genpage generate-types | (Préversion) Génère des définitions de schéma TypeScript pour les sources de données |
| pac model genpage list | (Préversion) Répertorie toutes les pages générées dans l’application pilotée par modèle spécifiée. |
| pac model genpage transpile | (Préversion) Transpile un fichier TypeScript avec des types d’exécution pour le test et le débogage |
| pac model genpage upload | (Préversion) Chargez et publiez une page générée sur une application basée sur un modèle. |
| pac model list | (Préversion) Répertorie toutes les applications basées sur des modèles dans l’environnement. |
| pac model list-languages | (Préversion) Répertorie les langues activées dans l’environnement Dataverse. |
pac model genpage download
(Préversion) Extraire des pages générées à partir d’une application basée sur un modèle.
Paramètres requis pour model genpage download
--app-id
ID de l’application pilotée par modèle.
Paramètres facultatifs pour model genpage download
--environment
-env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--output-directory
-o
Répertoire pour enregistrer les pages extraites. La valeur par défaut est le répertoire actif.
--page-id
Liste séparée par des virgules d’ID de page à extraire.
Exemples
Téléchargez une page générative unique par son ID de page dans un dossier local pour modification :
pac model genpage download \
--app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
--page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
--output-directory ./pages/account-dashboard
Téléchargez toutes les pages dégénératives dans une application en même temps :
pac model genpage download \
--app-id "Contoso Sales Hub" \
--output-directory ./pages
La commande crée un sous-répertoire nommé après l’ID de page et écrit les fichiers suivants :
./pages/account-dashboard/
e5f6a7b8-abcd-ef01-2345-000000000010/
page.tsx ← TypeScript source code
page.js ← Transpiled JavaScript
RuntimeTypes.ts ← Dataverse type definitions
config.json ← Page metadata
prompt.txt ← Original generation prompt
pac model genpage generate-types
(Préversion) Génère des définitions de schéma TypeScript pour les sources de données
Paramètres requis pour model genpage generate-types
--data-sources
Liste séparée par des virgules des sources de données utilisées (par exemple, « compte, prospect, contact »).
Paramètres facultatifs pour model genpage generate-types
--environment
-env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--output-file
-o
Chemin d’accès pour enregistrer le fichier de schéma TypeScript généré (valeur par défaut RuntimeTypes.ts)
Exemples
Générez des types TypeScript pour les account tables et contact écrivez-les dans ./src/RuntimeTypes.ts:
pac model genpage generate-types \
--data-sources "account,contact" \
--output-file ./src/RuntimeTypes.ts
Générez des types pour une table unique dans un répertoire de sortie spécifique :
pac model genpage generate-types \
--data-sources "opportunity" \
--output-file ./pages/opportunity/RuntimeTypes.ts
Note
Exécutez generate-types toujours avant d’écrire du code de page qui interroge les tables Dataverse.
Le fichier généré contient des noms de colonnes fortement typés, des champs de clé étrangère et des valeurs d’énumération pour chaque table. L’utilisation des types générés empêche les erreurs d’exécution provoquées par des noms de colonnes mal orthographiés ou inexistants.
pac model genpage list
(Préversion) Répertorie toutes les pages générées dans l’application pilotée par modèle spécifiée.
Paramètres requis pour model genpage list
--app-id
ID de l’application pilotée par modèle.
Paramètres facultatifs pour model genpage list
--environment
-env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
Exemples
Répertoriez toutes les pages génératives de l’application Contoso Sales Hub à l’aide de son ID d’application :
pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"
Répertoriez les pages génératives par nom d’application (l’interface CLI recherche automatiquement l’ID d’application) :
pac model genpage list --app-id "Contoso Sales Hub"
Exemple de sortie :
Found 2 generated page(s):
Account Dashboard
Page ID: e5f6a7b8-abcd-ef01-2345-000000000010
Description: Created: 2026-01-15T10:22:00Z
Opportunity Tracker
Page ID: e5f6a7b8-abcd-ef01-2345-000000000011
Description: Created: 2026-02-03T14:05:00Z
pac model genpage transpile
(Préversion) Transpile un fichier TypeScript avec des types d’exécution pour le test et le débogage
Paramètres requis pour model genpage transpile
--code-file
Chemin d’accès au fichier contenant le code de page.
Paramètres facultatifs pour model genpage transpile
--data-sources
Liste séparée par des virgules des sources de données utilisées (par exemple, « compte, prospect, contact »).
--environment
-env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--output-file
Chemin d’accès pour enregistrer la sortie JavaScript transpilée (valeur par défaut pour [code-file].compiled.js)
pac model genpage upload
(Préversion) Chargez et publiez une page générée sur une application basée sur un modèle.
Paramètres requis pour model genpage upload
--app-id
ID de l’application pilotée par modèle.
--code-file
Chemin d’accès au fichier contenant le code de page.
Paramètres facultatifs pour model genpage upload
--add-to-sitemap
Ajoutez la page à la navigation de l’application.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--agent-message
Message de réponse de l’agent.
--agent-message-file
Chemin d’accès à un fichier contenant le message de réponse de l’agent.
--compiled-code-file
Chemin d’accès au fichier contenant le code JavaScript compilé. S’il n’est pas fourni, TypeScript est automatiquement transpilé en JavaScript.
--data-sources
Liste séparée par des virgules des sources de données utilisées (par exemple, « compte, prospect, contact »).
--environment
-env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--model
Modèle IA utilisé pour générer la page (par exemple, « claude-3-5-sonnet-20241022 »).
--name
-n
Nom de la page.
--page-id
ID de la page à mettre à jour. S’il n’est pas fourni, une nouvelle page est créée.
--prompt
Invite de l’utilisateur qui a généré cette page.
--prompt-file
Chemin d’accès à un fichier contenant l’invite utilisateur qui a généré cette page.
Exemples
Publiez une nouvelle page générative sur l’application Contoso Sales Hub et ajoutez-la à l’application :
pac model genpage upload \
--app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
--code-file ./pages/account-dashboard.tsx \
--name "Account Dashboard" \
--data-sources "account,contact" \
--prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
--model "claude-sonnet-4-6" \
--agent-message "Created account dashboard with card grid, revenue chart, and contact list. Uses account and contact tables." \
--add-to-sitemap
Mettez à jour une page générative existante en fournissant son ID de page (omettez --add-to-sitemap pour éviter de créer une entrée de plan dupliquée) :
pac model genpage upload \
--app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
--page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
--code-file ./pages/account-dashboard.tsx \
--data-sources "account,contact" \
--prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
--model "claude-sonnet-4-6" \
--agent-message "Updated card layout to use a two-column grid; added revenue sparkline chart."
Publiez une page qui utilise des données fictives (aucune table Dataverse — omettre --data-sources) :
pac model genpage upload \
--app-id "Contoso Sales Hub" \
--code-file ./pages/welcome-screen.tsx \
--name "Welcome" \
--prompt "A branded welcome screen with Contoso logo, quick-action tiles, and a news feed placeholder." \
--model "claude-sonnet-4-6" \
--agent-message "Welcome page with static mock data. No Dataverse queries." \
--add-to-sitemap
Conseil / Astuce
Le --app-id paramètre accepte le GUID de l’application ou son nom complet.
Si plusieurs applications partagent le même nom d’affichage, utilisez le GUID pour éviter toute ambiguïté.
Exécutez pac model list pour rechercher des ID d’application.
Informations de référence rapides sur les paramètres
| Paramètre | Obligatoire | Descriptif |
|---|---|---|
--app-id |
Oui | GUID de l’application ou nom complet. Exécutez-la pac model list pour la trouver. |
--code-file |
Oui | Chemin d’accès au .tsx fichier source à déployer. |
--name |
Nouvelles pages uniquement | Nom complet affiché dans le plan de l’application. |
--page-id |
Mises à jour uniquement | GUID de la page existante à remplacer. |
--data-sources |
Pages Dataverse | Liste séparée par des virgules des noms logiques de table Dataverse (par exemple "account,contact"). |
--prompt |
Recommandé | Résumé du langage naturel de ce que fait la page. Stocké pour le contexte de régénération. |
--model |
Recommandé | ID de modèle utilisé pour générer la page (par exemple claude-sonnet-4-6). |
--agent-message |
Recommandé | Description de ce qui a été généré ou modifié. Stocké en tant qu’historique des modifications. |
--add-to-sitemap |
Nouvelles pages uniquement | Ajoute automatiquement la page à la navigation de l’application. Omettez-le lors de la mise à jour. |
pac model list
(Préversion) Répertorie toutes les applications basées sur des modèles dans l’environnement.
Paramètres facultatifs pour model list
--environment
-env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
Exemples
Répertoriez toutes les applications basées sur des modèles dans l’environnement actuellement actif :
pac model list
Exemple de sortie :
Found 3 model-driven app(s):
Contoso Sales Hub
App ID: a1b2c3d4-1234-5678-abcd-000000000001
Unique Name: contoso_SalesHub
Contoso Field Service
App ID: a1b2c3d4-1234-5678-abcd-000000000002
Unique Name: contoso_FieldService
Contoso Customer Portal
App ID: a1b2c3d4-1234-5678-abcd-000000000003
Unique Name: contoso_CustomerPortal
pac model list-languages
(Préversion) Répertorie les langues activées dans l’environnement Dataverse.
Paramètres facultatifs pour model list-languages
--environment
-env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
Voir aussi
Groupes de commandes Microsoft Power Platform CLI
Microsoft Power PlatformVue d’ensemble d’un processus CLI