pac model

Comandos para trabalhar com aplicações orientadas a modelos.

Commands

Command Description
pac model create Cria uma nova aplicação orientada a modelos.
pac model genpage download Extrai páginas geradas de uma aplicação orientada a modelos.
pac model genpage generate-types Gera definições de esquema TypeScript para fontes de dados
pac model genpage list Lista todas as páginas geradas na aplicação orientada a modelos especificada.
pac model genpage transpile Transpila um ficheiro TypeScript com tipos de runtime para testes e depuração
pac model genpage upload Carregue e publique uma página gerada numa aplicação orientada a modelos.
pac model list Lista todas as aplicações orientadas a modelos no ambiente.
pac model list-languages Listas ativadas linguagens no ambiente Dataverse.
pac model list-tables Liste as tabelas Dataverse no ambiente conectado.

pac model create

Cria uma nova aplicação orientada a modelos.

Parâmetros Obrigatórios para model create

--name -n

O nome de exibição da nova aplicação orientada ao modelo.

Parâmetros Opcionais para model create

--description -d

Descrição da nova aplicação orientada a modelos.

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--publish

Publique a aplicação depois de criar.

Este parâmetro não requer valor. É uma mudança.

--solution

Solução nome único para adicionar a aplicação. Por defeito, a solução ativa.

pac model create exemplos

Os exemplos seguintes mostram formas comuns de usar o pac model create comando.

Criar uma nova aplicação orientada por modelos no ambiente ativo

pac model create --name "Contoso Sales Hub"

Cria uma aplicação com uma descrição e adiciona-a a uma solução, depois publica imediatamente

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

Crie uma aplicação num ambiente específico fornecendo a URL do ambiente

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

Use pac model list para verificar se a aplicação foi criada e recuperar o ID da aplicação para usar com outros comandos, como pac model genpage upload.

pac model genpage download

Extrai páginas geradas de uma aplicação orientada a modelos.

Parâmetros Obrigatórios para model genpage download

--app-id

O ID da aplicação orientada ao modelo.

Parâmetros Opcionais para model genpage download

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--output-directory -o

Diretório para guardar páginas extraídas. Por defeito, o diretório atual.

--page-id

Lista separada por vírgulas de IDs de página para puxar.

pac model genpage download exemplos

Os exemplos seguintes mostram formas comuns de usar o pac model genpage download comando.

Descarregue uma única página gerativa pelo seu ID de página para uma pasta local para edição

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

Descarregue todas as páginas generativas numa aplicação de uma só vez

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

Crie um subdiretório com o nome do ID da página e escreve 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

Gera definições de esquema TypeScript para fontes de dados

Parâmetros Obrigatórios para model genpage generate-types

--data-sources

Lista separada por vírgulas das fontes de dados utilizadas (por exemplo, 'conta, lead, contacto').

Parâmetros Opcionais para model genpage generate-types

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--output-file -o

Caminho para guardar o ficheiro de esquema TypeScript gerado (por defeito para RuntimeTypes.ts)

pac model genpage generate-types exemplos

Os exemplos seguintes mostram formas comuns de usar o pac model genpage generate-types comando.

Gerar tipos TypeScript

Gerar tipos TypeScript para as account tabelas e contact escrevê-los para ./src/RuntimeTypes.ts:

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

Gerar tipos para uma única tabela num diretório de saída específico

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

Note

Executa generate-types sempre antes de escrever código de página que consulta tabelas do Dataverse. O ficheiro gerado contém nomes de colunas fortemente tipados, campos de chave estrangeira e valores enum para cada tabela. Confiar nos tipos gerados previne erros de execução causados por nomes de colunas mal escritos ou inexistentes.

pac model genpage list

Lista todas as páginas geradas na aplicação orientada a modelos especificada.

Parâmetros Obrigatórios para model genpage list

--app-id

O ID da aplicação orientada ao modelo.

Parâmetros Opcionais para model genpage list

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac model genpage list exemplos

Os exemplos seguintes mostram formas comuns de usar o pac model genpage list comando.

Páginas de lista usando o ID da aplicação

Liste todas as páginas generativas na aplicação Contoso Sales Hub usando o seu ID de aplicação:

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

Páginas da lista usando o nome da aplicação

Liste páginas generativas por nome da aplicação (a CLI procura 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 um ficheiro TypeScript com tipos de runtime para testes e depuração

Parâmetros Obrigatórios para model genpage transpile

--code-file

Caminho para o ficheiro que contém o código da página.

Parâmetros Opcionais para model genpage transpile

--data-sources

Lista separada por vírgulas das fontes de dados utilizadas (por exemplo, 'conta, lead, contacto').

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--output-file

Caminho para guardar a saída JavaScript transpilada (por defeito para [ficheiro de código].compiled.js)

pac model genpage upload

Carregue e publique uma página gerada numa aplicação orientada a modelos.

Parâmetros Obrigatórios para model genpage upload

--app-id

O ID da aplicação orientada ao modelo.

--code-file

Caminho para o ficheiro que contém o código da página.

Parâmetros Opcionais para model genpage upload

--add-to-sitemap

Adicione a página à navegação do sitemap da aplicação.

Este parâmetro não requer valor. É uma mudança.

--agent-message

A mensagem de resposta do agente.

--agent-message-file

Caminho para um ficheiro que contém a mensagem de resposta do agente.

--compiled-code-file

Caminho para o ficheiro que contém o código JavaScript compilado. Se não for fornecido, o TypeScript será automaticamente transpilado para JavaScript.

--data-sources

Lista separada por vírgulas das fontes de dados utilizadas (por exemplo, 'conta, lead, contacto').

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--model

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

--name -n

O nome da página.

--page-id

O ID da página para atualizar. Se não for fornecida, será criada uma nova página.

--prompt

O prompt do utilizador que gerou esta página.

--prompt-file

Caminho para um ficheiro que contém o prompt do utilizador que gerou esta página.

pac model genpage upload exemplos

Os exemplos seguintes mostram formas comuns de usar o pac model genpage upload comando.

Publique uma nova página generativa

Publique uma nova página generativa na aplicação Contoso Sales Hub e adicione-a ao sitemap da aplicação:

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

Atualizar uma página generativa existente

Atualize uma página generativa existente fornecendo o seu ID de página (omitir --add-to-sitemap para evitar criar uma entrada duplicada no sitemap):

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

Publique uma página que utilize dados simulados

Publique uma página que utilize dados simulados (sem tabelas 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 aceita ou o GUID da aplicação ou o seu nome de visualização. Se várias aplicações partilharem o mesmo nome de visualização, use o GUID para evitar ambiguidades. Corre pac model list para procurar os IDs das aplicações.

pac model genpage upload Referência rápida do parâmetro

Parameter Required Description
--app-id Yes GUID da aplicação ou nome de visualização. Corre pac model list para o encontrar.
--code-file Yes Caminho para o .tsx ficheiro de origem a implementar.
--name Apenas páginas novas Nome de exibição mostrado no sitemap da aplicação.
--page-id Updates only GUID da página existente para substituir.
--data-sources Dataverse pages Lista separada por vírgulas dos nomes lógicos das tabelas Dataverse (por exemplo, "account,contact").
--prompt Recommended Resumo em linguagem natural do que a página faz. Armazenado para contexto de regeneração.
--model Recommended ID de modelo usado para gerar a página (por exemplo, claude-sonnet-4-6).
--agent-message Recommended Descrição do que foi construído ou alterado. Guardado como histórico de mudanças.
--add-to-sitemap Apenas páginas novas Adiciona automaticamente a página à navegação da aplicação. Omita ao atualizar.

pac model list

Lista todas as aplicações orientadas a modelos no ambiente.

Parâmetros Opcionais para model list

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

Exemplo do pac model list

Liste todas as aplicações orientadas por modelos no ambiente atualmente ativo:

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

Listas ativadas linguagens no ambiente Dataverse.

Parâmetros Opcionais para model list-languages

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac model list-tables

Liste as tabelas Dataverse no ambiente conectado.

Parâmetros Opcionais para model list-tables

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--search -s

Lista de nomes separados por vírgulas a procurar (corresponde ao nome lógico, nome do esquema ou nome de visualização).

--type -t

Filtre por tipo de tabela: 'personalizado', 'standard' ou 'todos' (por defeito: todos).

See also

Microsoft Power Platform Grupos de Comando CLI
Microsoft Power Platform Visão geral da CLI

  • Last updated on