pac model

Comandes per treballar amb aplicacions basades en models.

Commands

Command Description
pac model create Crea una nova aplicació basada en models.
pac model genpage download Extreu les pàgines generades d'una aplicació basada en models.
pac model genpage generate-types Genera definicions d'esquemes TypeScript per a fonts de dades
pac model genpage list Llista totes les pàgines generades a l'aplicació basada en models especificada.
pac model genpage transpile Transpila un fitxer TypeScript amb tipus d'execució per a proves i depuració
pac model genpage upload Puja i publica una pàgina generada a una aplicació basada en models.
pac model list Llista totes les aplicacions basades en models de l'entorn.
pac model list-languages Llistes habilitades llenguatges a l'entorn Dataverse.
pac model list-tables Llista les taules Dataverse a l'entorn connectat.

pac model create

Crea una nova aplicació basada en models.

Paràmetres requerits per a model create

--name -n

El nom de visualització de la nova aplicació basada en models.

Paràmetres opcionals per a model create

--description -d

Descripció de la nova aplicació basada en models.

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--publish

Publica l'aplicació després de crear-la.

Aquest paràmetre no requereix cap valor. És un canvi.

--solution

Solució amb nom únic per afegir l'aplicació. Per defecte passa a la solució activa.

pac model create Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model create ordre.

Crea una nova aplicació basada en models en l'entorn actiu

pac model create --name "Contoso Sales Hub"

Crea una aplicació amb una descripció i afegeix-la a una solució, després publica-la immediatament

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

Crea una aplicació en un entorn específic proporcionant l'URL de l'entorn

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

Tip

Utilitza pac model list per verificar que l'aplicació ha estat creada i recuperar el seu ID d'aplicació per utilitzar-lo amb altres comandes com pac model genpage upload.

pac model genpage download

Extreu les pàgines generades d'una aplicació basada en models.

Paràmetres requerits per a model genpage download

--app-id

L'ID de l'aplicació basada en models.

Paràmetres opcionals per a model genpage download

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--output-directory -o

Directori per desar pàgines extretes. Per defecte el directori actual.

--page-id

Llista separada per coma d'identificadors de pàgina per extreure.

pac model genpage download Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage download ordre.

Descarrega una sola pàgina generativa amb el seu ID de pàgina a una carpeta local per editar-la

pac model genpage download \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --output-directory ./pages/account-dashboard

Descarrega totes les pàgines generatives d'una aplicació alhora

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

Crea un subdirectori anomenat segons l'ID de pàgina i escriu els fitxers següents

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

Genera definicions d'esquemes TypeScript per a fonts de dades

Paràmetres requerits per a model genpage generate-types

--data-sources

Llista separada per coma de fonts de dades utilitzades (per exemple, 'compte, contacte').

Paràmetres opcionals per a model genpage generate-types

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--output-file -o

Ruta per desar el fitxer d'esquema TypeScript generat (per defecte a RuntimeTypes.ts)

pac model genpage generate-types Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage generate-types ordre.

Genera tipus TypeScript

Genera tipus TypeScript per a les account taules i contact escriu-los a ./src/RuntimeTypes.ts:

pac model genpage generate-types \
  --data-sources "account,contact" \
  --output-file ./src/RuntimeTypes.ts

Genera tipus per a una sola taula en un directori de sortida específic

pac model genpage generate-types \
  --data-sources "opportunity" \
  --output-file ./pages/opportunity/RuntimeTypes.ts

Note

Sempre executa generate-types abans d'escriure codi de pàgina que consulti taules de Dataverse. El fitxer generat conté noms de columna fortament tipats, camps de clau foranya i valors d'enum per a cada taula. Confiar en els tipus generats evita errors en temps d'execució causats per noms de columna mal escrits o inexistents.

pac model genpage list

Llista totes les pàgines generades a l'aplicació basada en models especificada.

Paràmetres requerits per a model genpage list

--app-id

L'ID de l'aplicació basada en models.

Paràmetres opcionals per a model genpage list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac model genpage list Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage list ordre.

Pàgines de llista que utilitzen l'ID de l'aplicació

Llista totes les pàgines generatives de l'aplicació Contoso Sales Hub utilitzant el seu ID d'aplicació:

pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"

Pàgines de llista que utilitzen el nom de l'aplicació

Llista les pàgines generatives pel nom de l'aplicació (la CLI busca automàticament l'ID de l'aplicació):

pac model genpage list --app-id "Contoso Sales Hub"

pac model Sortida d'exemple 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

Transpila un fitxer TypeScript amb tipus d'execució per a proves i depuració

Paràmetres requerits per a model genpage transpile

--code-file

Ruta cap al fitxer que conté el codi de la pàgina.

Paràmetres opcionals per a model genpage transpile

--data-sources

Llista separada per coma de fonts de dades utilitzades (per exemple, 'compte, contacte').

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--output-file

Camí per desar la sortida JavaScript transpilada (per defecte [code-file].compiled.js)

pac model genpage upload

Puja i publica una pàgina generada a una aplicació basada en models.

Paràmetres requerits per a model genpage upload

--app-id

L'ID de l'aplicació basada en models.

--code-file

Ruta cap al fitxer que conté el codi de la pàgina.

Paràmetres opcionals per a model genpage upload

--add-to-sitemap

Afegeix la pàgina a la navegació del mapa del lloc de l'aplicació.

Aquest paràmetre no requereix cap valor. És un canvi.

--agent-message

El missatge de resposta de l'agent.

--agent-message-file

Ruta cap a un fitxer que conté el missatge de resposta de l'agent.

--compiled-code-file

Camí cap al fitxer que conté el codi JavaScript compilat. Si no es proporciona, TypeScript es transpilarà automàticament a JavaScript.

--data-sources

Llista separada per coma de fonts de dades utilitzades (per exemple, 'compte, contacte').

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--model

El model d'IA utilitzat per generar la pàgina (per exemple, 'claude-3-5-sonnet-20241022').

--name -n

El nom de la pàgina.

--page-id

L'ID de la pàgina a actualitzar. Si no es proporciona, es crearà una nova pàgina.

--prompt

L'indicació d'usuari que va generar aquesta pàgina.

--prompt-file

Ruta cap a un fitxer que conté el prompt d'usuari que ha generat aquesta pàgina.

pac model genpage upload Exemples

Els exemples següents mostren maneres comunes d'utilitzar aquesta pac model genpage upload ordre.

Publica una nova pàgina generativa

Publica una nova pàgina generativa a l'aplicació Contoso Sales Hub i afegeix-la al mapa del lloc de l'aplicació:

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

Actualitza una pàgina generativa existent

Actualitza una pàgina generativa existent proporcionant el seu ID de pàgina (ometent --add-to-sitemap per evitar crear una entrada duplicada del mapa del lloc):

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

Publicar una pàgina que utilitzi dades simulades

Publicar una pàgina que utilitzi dades simulades (sense taules Dataverse — omet-ho --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

Tip

El --app-id paràmetre accepta tant el GUID de l'aplicació com el seu nom de visualització. Si diverses aplicacions comparteixen el mateix nom de visualització, utilitza el GUID per evitar ambigüitats. Corre pac model list a buscar els ID de les aplicacions.

pac model genpage upload Referència ràpida de paràmetres

Parameter Required Description
--app-id Yes GUID de l'aplicació o nom de visualització. Corre pac model list a buscar-lo.
--code-file Yes Ruta cap al .tsx fitxer font per desplegar.
--name Només pàgines noves Nom de visualització mostrat al mapa del lloc de l'aplicació.
--page-id Updates only GUID de la pàgina existent per substituir.
--data-sources Dataverse pages Llista separada per coma dels noms lògics de les taules Dataverse (per exemple, "account,contact").
--prompt Recommended Resum en llenguatge natural del que fa la pàgina. Emmagatzemat per al context de regeneració.
--model Recommended ID de model utilitzat per generar la pàgina (per exemple, claude-sonnet-4-6).
--agent-message Recommended Descripció del que es va construir o canviar. Emmagatzemat com a historial de canvis.
--add-to-sitemap Només pàgines noves Afegeix la pàgina automàticament a la navegació de l'aplicació. Omet-ho quan actualitzis.

pac model list

Llista totes les aplicacions basades en models de l'entorn.

Paràmetres opcionals per a model list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac model list Exemple

Llista totes les aplicacions basades en models en l'entorn actiu actualment:

pac model list

Sample output:

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

Llistes habilitades llenguatges a l'entorn Dataverse.

Paràmetres opcionals per a model list-languages

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac model list-tables

Llista les taules Dataverse a l'entorn connectat.

Paràmetres opcionals per a model list-tables

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--search -s

Llista separada per coma de noms a buscar (coincideix amb el nom lògic, el nom de l'esquema o el nom de visualització).

--type -t

Filtra per tipus de taula: 'personalitzat', 'estàndard' o 'tots' (per defecte: tots).

See also

Microsoft Power Platform Grups de Comandament CLI
Microsoft Power Platform Visió general de la CLI

  • Last updated on