Partager via

pac model

(Préversion) Commandes permettant d’utiliser des applications basées sur des modèles.

Commands

Command Descriptif
pac model create (Préversion) Crée une application basée sur un modèle.
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 create

(Préversion) Crée une application basée sur un modèle.

Paramètres requis pour model create

--name -n

Nom complet de la nouvelle application pilotée par modèle.

Paramètres facultatifs pour model create

--description -d

Description de la nouvelle application pilotée par modèle.

--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.

--publish

Publiez l’application après la création.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--solution

Nom unique de la solution à laquelle ajouter l’application. Valeur par défaut de la solution active.

Exemples pac model create

Les exemples suivants montrent des façons courantes d’utiliser la pac model create commande.

Créer une application basée sur un modèle dans l’environnement actif

pac model create --name "Contoso Sales Hub"

Créer une application avec une description et l’ajouter à une solution, puis publier immédiatement

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --solution "ContosoSales" \
  --publish

Créer une application dans un environnement spécifique en fournissant l’URL de l’environnement

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --environment "https://contoso.crm.dynamics.com" \
  --solution "ContosoSales" \
  --publish

Conseil / Astuce

Permet pac model list de vérifier que l’application a été créée et récupérer son ID d’application à utiliser avec d’autres commandes telles que pac model genpage upload.

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 pac model genpage download

Les exemples suivants montrent des façons courantes d’utiliser la pac model genpage download commande.

Télécharger 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écharger toutes les pages génératives dans une application à la fois

pac model genpage download \
  --app-id "Contoso Sales Hub" \
  --output-directory ./pages

Créer 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 pac model genpage generate-types

Les exemples suivants montrent des façons courantes d’utiliser la pac model genpage generate-types commande.

Générer des types TypeScript

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érer 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 pac model genpage list

Les exemples suivants montrent des façons courantes d’utiliser la pac model genpage list commande.

Répertorier les pages à l’aide de l’ID d’application

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épertorier les pages à l’aide du nom de l’application

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"

pac model Exemple de sortie genpage

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 pac model genpage upload

Les exemples suivants montrent des façons courantes d’utiliser la pac model genpage upload commande.

Publier une nouvelle page générative

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

Mettre à jour une page générative existante

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."

Publier une page qui utilise des données fictives

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.

pac model genpage upload 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.

pac model list exemple

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

  • Last updated on