pac model

Comandos para traballar con aplicacións orientadas a modelos.

Commands

Command Description
pac model create Crea unha nova aplicación baseada en modelos.
pac model genpage download Extrae páxinas xeradas dunha aplicación baseada en modelos.
pac model genpage generate-types Xera definicións de esquema TypeScript para fontes de datos
pac model genpage list Lista todas as páxinas xeradas na aplicación dirixida a modelos especificada.
pac model genpage transpile Transpila un ficheiro TypeScript con tipos de execución para probar e depurar
pac model genpage upload Sube e publica unha páxina xerada nunha aplicación baseada en modelos.
pac model list Lista todas as aplicacións orientadas a modelos no entorno.
pac model list-languages As listas habilitaban linguaxes no entorno Dataverse.
pac model list-tables Lista as táboas Dataverse no entorno conectado.

pac model create

Crea unha nova aplicación baseada en modelos.

Parámetros requiridos para model create

--name -n

O nome de visualización para a nova aplicación baseada en modelos.

Parámetros opcionais para model create

--description -d

Descrición da nova aplicación baseada en modelos.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--publish

Publica a aplicación despois de creala.

Este parámetro non precisa de valor. É un cambio.

--solution

Solución nome único para engadir a aplicación. Por defecto é a solución activa.

pac model create Exemplos

Os seguintes exemplos mostran formas comúns de usar o pac model create comando.

Crea unha nova aplicación baseada en modelos no ambiente activo

pac model create --name "Contoso Sales Hub"

Crea unha aplicación cunha descrición e engádea a unha solución, logo publícaa inmediatamente

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

Crea unha aplicación nun entorno específico proporcionando a URL do entorno

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

Úsase pac model list para verificar que a aplicación foi creada e recuperar o seu ID de aplicación para usalo con outros comandos como pac model genpage upload.

pac model genpage download

Extrae páxinas xeradas dunha aplicación baseada en modelos.

Parámetros requiridos para model genpage download

--app-id

O ID da aplicación guiada por modelos.

Parámetros opcionais para model genpage download

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--output-directory -o

Directorio para gardar páxinas extraídas. Por defecto o directorio actual.

--page-id

Lista separada por comas de IDs de páxina para tirar.

pac model genpage download Exemplos

Os seguintes exemplos mostran formas comúns de usar o pac model genpage download comando.

Descarga unha única páxina xerativa xunto ao seu ID de páxina a unha carpeta local para editar

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

Descarga todas as páxinas xerativas dunha aplicación á vez

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

Crea un subdirectorio chamado segundo o ID da páxina e escribe os seguintes ficheiros

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

Xera definicións de esquema TypeScript para fontes de datos

Parámetros requiridos para model genpage generate-types

--data-sources

Lista separada por comas das fontes de datos usadas (por exemplo, 'conta, lead, contacto').

Parámetros opcionais para model genpage generate-types

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--output-file -o

Ruta para gardar o ficheiro de esquema TypeScript xerado (por defecto RuntimeTypes.ts)

pac model genpage generate-types Exemplos

Os seguintes exemplos mostran formas comúns de usar o pac model genpage generate-types comando.

Xerar tipos TypeScript

Xera tipos TypeScript para as account táboas e contact escríbeos en ./src/RuntimeTypes.ts:

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

Xerar tipos para unha única táboa nun directorio de saída específico

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

Note

Sempre executa generate-types antes de escribir código de páxina que consulte as táboas de Dataverse. O ficheiro xerado contén nomes de columnas fortemente tipados, campos de clave allea e valores de enum para cada táboa. Confiar nos tipos xerados evita erros en tempo de execución causados por nomes de columnas mal escritos ou inexistentes.

pac model genpage list

Lista todas as páxinas xeradas na aplicación dirixida a modelos especificada.

Parámetros requiridos para model genpage list

--app-id

O ID da aplicación guiada por modelos.

Parámetros opcionais para model genpage list

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac model genpage list Exemplos

Os seguintes exemplos mostran formas comúns de usar o pac model genpage list comando.

Páxinas de lista que usan o ID da aplicación

Lista todas as páxinas xerativas na aplicación Contoso Sales Hub usando o seu ID de aplicación:

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

Páxinas de lista usando o nome da aplicación

Lista as páxinas xerativas por nome da aplicación (a CLI busca automaticamente o ID da app):

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

pac model Saída de exemplo 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 ficheiro TypeScript con tipos de execución para probar e depurar

Parámetros requiridos para model genpage transpile

--code-file

Ruta ao ficheiro que contén o código da páxina.

Parámetros opcionais para model genpage transpile

--data-sources

Lista separada por comas das fontes de datos usadas (por exemplo, 'conta, lead, contacto').

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--output-file

Ruta para gardar a saída JavaScript transpilada (por defecto [ficheiro de código].compiled.js)

pac model genpage upload

Sube e publica unha páxina xerada nunha aplicación baseada en modelos.

Parámetros requiridos para model genpage upload

--app-id

O ID da aplicación guiada por modelos.

--code-file

Ruta ao ficheiro que contén o código da páxina.

Parámetros opcionais para model genpage upload

--add-to-sitemap

Engade a páxina á navegación do mapa do sitio da aplicación.

Este parámetro non precisa de valor. É un cambio.

--agent-message

A mensaxe de resposta do axente.

--agent-message-file

Ruta a un ficheiro que contén a mensaxe de resposta do axente.

--compiled-code-file

Ruta ao ficheiro que contén o código JavaScript compilado. Se non se proporciona, TypeScript transpilarase automaticamente a JavaScript.

--data-sources

Lista separada por comas das fontes de datos usadas (por exemplo, 'conta, lead, contacto').

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--model

O modelo de IA usado para xerar a páxina (por exemplo, 'claude-3-5-sonnet-20241022').

--name -n

O nome da páxina.

--page-id

O ID da páxina para actualizar. Se non se proporciona, crearase unha nova páxina.

--prompt

O prompt do usuario que xerou esta páxina.

--prompt-file

Ruta a un ficheiro que contén o prompt de usuario que xerou esta páxina.

pac model genpage upload Exemplos

Os seguintes exemplos mostran formas comúns de usar o pac model genpage upload comando.

Publica unha nova páxina xerativa

Publica unha nova páxina xerativa na aplicación Contoso Sales Hub e engádea ao mapa do sitio da aplicación:

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

Actualizar unha páxina xerativa existente

Actualizar unha páxina xerativa existente proporcionando o seu ID de páxina (omitir --add-to-sitemap para evitar crear unha entrada duplicada no mapa do sitio):

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

Publica unha páxina que use datos simulados

Publicar unha páxina que use datos simulados (sen táboas Dataverse — omitir --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

O --app-id parámetro acepta ou ben o GUID da aplicación ou o seu nome de visualización. Se varias aplicacións comparten o mesmo nome de visualización, usa o GUID para evitar ambigüedades. Corre pac model list a buscar os IDs das aplicacións.

pac model genpage upload Referencia rápida do parámetro

Parameter Required Description
--app-id Yes GUID da aplicación ou nome de visualización. Corre pac model list para atopalo.
--code-file Yes Ruta ao .tsx ficheiro fonte para despregar.
--name Só páxinas novas O nome de visualización móstrase no mapa do sitio da aplicación.
--page-id Updates only GUID da páxina existente para substituír.
--data-sources Dataverse pages Lista separada por comas de nomes lóxicos das táboas Dataverse (por exemplo, "account,contact").
--prompt Recommended Resumo en linguaxe natural do que fai a páxina. Gardado para contexto de rexeneración.
--model Recommended ID de modelo usado para xerar a páxina (por exemplo, claude-sonnet-4-6).
--agent-message Recommended Descrición do que se construíu ou cambiou. Gardado como historial de cambios.
--add-to-sitemap Só páxinas novas Engade a páxina á navegación da aplicación automaticamente. Omitir ao actualizar.

pac model list

Lista todas as aplicacións orientadas a modelos no entorno.

Parámetros opcionais para model list

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac model list Exemplo

Lista todas as aplicacións baseadas en modelos no entorno actualmente activo:

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

As listas habilitaban linguaxes no entorno Dataverse.

Parámetros opcionais para model list-languages

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

pac model list-tables

Lista as táboas Dataverse no entorno conectado.

Parámetros opcionais para model list-tables

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--search -s

Lista separada por comas de nomes a buscar (coincide co nome lóxico, nome do esquema ou nome de visualización).

--type -t

Filtra por tipo de táboa: 'personalizado', 'estándar' ou 'todos' (por defecto: todos).

See also

Microsoft Power Platform Grupos de Mando CLI
Microsoft Power Platform Visión xeral da CLI

  • Last updated on