pac model

Comandos para traballar con aplicacións orientadas a modelos.

Comandos

Comando Descripción
pac model create Crea unha nova aplicación baseada en modelos.
pac model genpage add Adxunta unha ou máis páxinas xerativas existentes ao mapa do sitio dunha aplicación baseada en modelos (sen volver subir). Usa 'pac model genpage upload' para crear ou actualizar a propia páxina; usa este verbo para que unha páxina xa subida apareza noutra aplicación.
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 get-connector-schema Obtén un esquema de columna de táboa de conectores ou esquema de operacións REST para páxinas xeradas.
pac model genpage list Lista páxinas xeradas — por defecto en todo o ambiente, ou para unha aplicación cando se fornece --app-id. Pasa --include-unpublished para tamén listar páxinas de borradores.
pac model genpage list-connector-operations Lista operacións REST do conector para páxinas xeradas.
pac model genpage list-connector-tables Lista as táboas conectoras para páxinas xeradas.
pac model genpage remove Desvincula páxina(s) existente(s) de IA xerativa do sitemap dunha aplicación baseada en modelos. A fila de páxina en Dataverse mantense (aínda pode ser referenciada desde outras aplicacións).
pac model genpage transpile Transpila un ficheiro TypeScript con tipos de execución para probar e depurar
pac model genpage upload Sube unha páxina xerada a Dataverse e publícaa. Crea unha nova páxina cando se omite --page-id; actualiza a páxina existente cando se fornece --page-id. Para anexar unha páxina que xa existe no entorno ao mapa do sitio doutra aplicación sen volver subir, usa 'pac model genpage add' no seu lugar.
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 é 'Default' se non está especificado.

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

Suxestión

Ú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 add

Adxunta unha ou máis páxinas xerativas existentes ao mapa do sitio dunha aplicación baseada en modelos (sen volver subir). Usa 'pac model genpage upload' para crear ou actualizar a propia páxina; usa este verbo para que unha páxina xa subida apareza noutra aplicación.

Parámetros requiridos para model genpage add

--page-id

IDs xerativos de páxina separados por comas (GUIDs) para engadir á aplicación.

Parámetros opcionais para model genpage add

--app-id

O ID (GUID) da aplicación guiada por modelos. Excluínte mutuamente con --app-name.

--app-name

O nome único da aplicación baseada en modelos. Mutuamente excluínte con --app-id.

--area

ID de área opcional no mapa do sitio para colocar a páxina debaixo. Por defecto vai á primeira Área.

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

--group

ID de grupo opcional no mapa do sitio para colocar a páxina en. Por defecto o primeiro grupo da Área escollida.

--language-code

Código de idioma (LCID) para o título SubArea. Por defecto é 1033 (en-US).

--publish

Publica a aplicación baseada en modelos despois de engadir a(s) páxina(s).

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

--solution

Nome único do contexto da solución Dataverse para a actualización do mapa do sitio. Por defecto é 'Predeterminado'.

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

Nota

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 get-connector-schema

Obtén un esquema de columna de táboa de conectores ou esquema de operacións REST para páxinas xeradas.

Parámetros requiridos para model genpage get-connector-schema

--connection-id

ID de conexión para usar na descuberta de metadatos do conector.

--connector-id

ID da API do conector (por exemplo, /providers/Microsoft. PowerApps/APIS/shared_sharepointonline).

Parámetros opcionais para model genpage get-connector-schema

--dataset

Identificador de conxunto de datos para o descubrimento de conectores tabulares (por exemplo, unha URL de sitio de SharePoint ou un servidor/base de datos SQL). Obrigatorio con --table.

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

--operation

Identificador de operación REST para o modo esquema de operación. Non se pode usar con --dataset ou --table.

--table

Identificador de táboa para o modo esquema tabular. Requírese --conxunto de datos e non pode usarse coa operación --.

pac model genpage list

Lista páxinas xeradas — por defecto en todo o ambiente, ou para unha aplicación cando se fornece --app-id. Pasa --include-unpublished para tamén listar páxinas de borradores.

Parámetros opcionais para model genpage list

--app-id

O ID da aplicación guiada por 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.

--include-unpublished

Inclúe páxinas xerativas non publicadas na lista (por defecto: só publicadas).

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

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 list-connector-operations

Lista operacións REST do conector para páxinas xeradas.

Parámetros requiridos para model genpage list-connector-operations

--connection-id

ID de conexión para usar na descuberta de metadatos do conector.

--connector-id

ID da API do conector (por exemplo, /providers/Microsoft. PowerApps/APIS/shared_sharepointonline).

Parámetros opcionais para model genpage list-connector-operations

--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-connector-tables

Lista as táboas conectoras para páxinas xeradas.

Parámetros requiridos para model genpage list-connector-tables

--connection-id

ID de conexión para usar na descuberta de metadatos do conector.

--connector-id

ID da API do conector (por exemplo, /providers/Microsoft. PowerApps/APIS/shared_sharepointonline).

Parámetros opcionais para model genpage list-connector-tables

--dataset

Identificador de conxunto de datos para o descubrimento de conectores tabulares (por exemplo, unha URL de sitio de SharePoint ou un servidor/base de datos SQL). Obrigatorio con --table.

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

Desvincula páxina(s) existente(s) de IA xerativa do sitemap dunha aplicación baseada en modelos. A fila de páxina en Dataverse mantense (aínda pode ser referenciada desde outras aplicacións).

Parámetros requiridos para model genpage remove

--page-id

Un ou máis IDs uxagentproject para eliminar (comas separadas).

Parámetros opcionais para model genpage remove

--app-id

ID de aplicación guiado por modelo (uniqueid) para eliminar a(s) páxina(s). Excluínte mutuamente con --app-name.

--app-name

Nome único da aplicación guiada por modelos para eliminar a(s) páxina(s). Mutuamente excluínte con --app-id.

--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 baseada en modelos despois da edición do sitemap para que os cambios se publiquen inmediatamente.

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

--solution

Solución Dataverse, nome único para a actualización do mapa do sitio. Por defecto é 'Predeterminado'.

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 unha páxina xerada a Dataverse e publícaa. Crea unha nova páxina cando se omite --page-id; actualiza a páxina existente cando se fornece --page-id. Para anexar unha páxina que xa existe no entorno ao mapa do sitio doutra aplicación sen volver subir, usa 'pac model genpage add' no seu lugar.

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

--actions

Ruta cara a un ficheiro JSON con ligazóns de acción/función da API personalizada de Dataverse para persistir na config.json da páxina baixo actionBindings.

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

--connectors

Ruta cara a un ficheiro JSON con ligazóns de conector para persistir na config.jsonda páxina.

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

Suxestión

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

Parámetro Necesario Descripción
--app-id Si GUID da aplicación ou nome de visualización. Corre pac model list para atopalo.
--code-file Si 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 Só actualizacións GUID da páxina existente para substituír.
--data-sources Páxinas do Dataverse Lista separada por comas de nomes lóxicos das táboas Dataverse (por exemplo, "account,contact").
--prompt Recomendado Resumo en linguaxe natural do que fai a páxina. Gardado para contexto de rexeneración.
--model Recomendado ID de modelo usado para xerar a páxina (por exemplo, claude-sonnet-4-6).
--agent-message Recomendado 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

Saída de exemplo:

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

Ver tamén

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

  • Última actualización o