pac model

Comandi per lavorare con app guidate da modello.

Commands

Command Description
pac model create Crea una nuova app guidata dal modello.
pac model genpage download Estrai le pagine generate da un'app guidata dal modello.
pac model genpage generate-types Genera definizioni di schema TypeScript per le sorgenti di dati
pac model genpage list Elenca tutte le pagine generate nell'app guidata dal modello specificata.
pac model genpage transpile Traspila un file TypeScript con tipi di runtime per test e debug
pac model genpage upload Carica e pubblica una pagina generata su un'app guidata da modelli.
pac model list Elenca tutte le app guidate dal modello nell'ambiente.
pac model list-languages Liste abilitate dei linguaggi nell'ambiente Dataverse.
pac model list-tables Elenca le tabelle Dataverse nell'ambiente connesso.

pac model create

Crea una nuova app guidata dal modello.

Parametri obbligatori per model create

--name -n

Nome visualizzato per la nuova app basata su modello.

Parametri facoltativi per model create

--description -d

Descrizione per la nuova app basata su modello.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--publish

Pubblicare l'app dopo la creazione.

Questo parametro non richiede alcun valore. È un cambio.

--solution

Nome univoco della soluzione a cui aggiungere l'app. Il valore predefinito è la soluzione attiva.

pac model create esempi

Gli esempi seguenti illustrano i modi comuni per usare il pac model create comando .

Creare una nuova app basata su modello nell'ambiente attivo

pac model create --name "Contoso Sales Hub"

Creare un'app con una descrizione e aggiungerla a una soluzione, quindi pubblicarla immediatamente

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

Creare un'app in un ambiente specifico specifica fornendo l'URL dell'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

Usare pac model list per verificare che l'app sia stata creata e recuperare il relativo ID app da usare con altri comandi, pac model genpage uploadad esempio .

pac model genpage download

Estrai le pagine generate da un'app guidata dal modello.

Parametri obbligatori per model genpage download

--app-id

ID dell'app basata su modello.

Parametri facoltativi per model genpage download

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--output-directory -o

Directory per salvare le pagine estratte. Il valore predefinito è la directory corrente.

--page-id

Elenco delimitato da virgole di ID di pagina da estrarre.

pac model genpage download esempi

Gli esempi seguenti illustrano i modi comuni per usare il pac model genpage download comando .

Scaricare una singola pagina generativa in base all'ID pagina in una cartella locale per la modifica

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

Scaricare tutte le pagine generative in un'app contemporaneamente

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

Creare una sottodirectory denominata dopo l'ID pagina e scrivere i file seguenti

./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 definizioni di schema TypeScript per le sorgenti di dati

Parametri obbligatori per model genpage generate-types

--data-sources

Elenco delimitato da virgole delle origini dati usate ,ad esempio 'account,lead,contatto'.

Parametri facoltativi per model genpage generate-types

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--output-file -o

Percorso per salvare il file di schema TypeScript generato (impostazione predefinita per RuntimeTypes.ts)

pac model genpage generate-types esempi

Gli esempi seguenti illustrano i modi comuni per usare il pac model genpage generate-types comando .

Generare tipi TypeScript

Generare tipi TypeScript per le account tabelle e contact e scriverli in ./src/RuntimeTypes.ts:

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

Generare tipi per una singola tabella in una directory di output specifica

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

Note

Eseguire generate-types sempre prima di scrivere codice di pagina che esegue query sulle tabelle Dataverse. Il file generato contiene nomi di colonna fortemente tipizzati, campi chiave esterna ed enumerazione per ogni tabella. La relying on the generated types impedisce errori di runtime causati da nomi di colonna non digitati o inesistenti.

pac model genpage list

Elenca tutte le pagine generate nell'app guidata dal modello specificata.

Parametri obbligatori per model genpage list

--app-id

ID dell'app basata su modello.

Parametri facoltativi per model genpage list

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac model genpage list esempi

Gli esempi seguenti illustrano i modi comuni per usare il pac model genpage list comando .

Elencare le pagine con l'ID app

Elencare tutte le pagine generative nell'app Contoso Sales Hub usando il relativo ID app:

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

Elencare le pagine con il nome dell'app

Elencare le pagine generative in base al nome dell'app (l'interfaccia della riga di comando cerca automaticamente l'ID app):

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

pac model Output di esempio di 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

Traspila un file TypeScript con tipi di runtime per test e debug

Parametri obbligatori per model genpage transpile

--code-file

Percorso del file contenente il codice della pagina.

Parametri facoltativi per model genpage transpile

--data-sources

Elenco delimitato da virgole delle origini dati usate ,ad esempio 'account,lead,contatto'.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--output-file

Percorso per salvare l'output JavaScript transpiled (il valore predefinito è [code-file].compiled.js)

pac model genpage upload

Carica e pubblica una pagina generata su un'app guidata da modelli.

Parametri obbligatori per model genpage upload

--app-id

ID dell'app basata su modello.

--code-file

Percorso del file contenente il codice della pagina.

Parametri facoltativi per model genpage upload

--add-to-sitemap

Aggiungere la pagina alla navigazione della mappa della mappa dell'app.

Questo parametro non richiede alcun valore. È un cambio.

--agent-message

Messaggio di risposta dell'agente.

--agent-message-file

Percorso di un file contenente il messaggio di risposta dell'agente.

--compiled-code-file

Percorso del file contenente il codice JavaScript compilato. Se non specificato, TypeScript verrà automaticamente traspilato in JavaScript.

--data-sources

Elenco delimitato da virgole delle origini dati usate ,ad esempio 'account,lead,contatto'.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--model

Modello di intelligenza artificiale usato per generare la pagina ,ad esempio 'claude-3-5-sonnet-20241022'.

--name -n

Nome della pagina.

--page-id

ID della pagina da aggiornare. Se non specificato, verrà creata una nuova pagina.

--prompt

Richiesta dell'utente che ha generato questa pagina.

--prompt-file

Percorso di un file contenente il prompt dell'utente che ha generato questa pagina.

pac model genpage upload esempi

Gli esempi seguenti illustrano i modi comuni per usare il pac model genpage upload comando .

Pubblicare una nuova pagina generativa

Pubblicare una nuova pagina generativa nell'app Contoso Sales Hub e aggiungerla alla mappa dell'app:

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

Aggiornare una pagina generativa esistente

Aggiornare una pagina generativa esistente specificando il relativo ID pagina (omettere --add-to-sitemap per evitare di creare una voce della mappa duplicata):

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

Pubblicare una pagina che usa dati fittizi

Pubblicare una pagina che usa dati fittizi (nessuna tabella dataverse - omettere --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

Il --app-id parametro accetta il GUID dell'app o il relativo nome visualizzato. Se più app condividono lo stesso nome visualizzato, usare il GUID per evitare ambiguità. Eseguire pac model list per cercare gli ID app.

pac model genpage upload riferimento rapido ai parametri

Parameter Required Description
--app-id Yes GUID dell'app o nome visualizzato. Esegui pac model list per trovarlo.
--code-file Yes Percorso del .tsx file di origine da distribuire.
--name Solo nuove pagine Nome visualizzato visualizzato nella mappa dell'app.
--page-id Updates only GUID della pagina esistente da sostituire.
--data-sources Dataverse pages Elenco delimitato da virgole di nomi logici di tabella di Dataverse (ad esempio, "account,contact").
--prompt Recommended Riepilogo del linguaggio naturale delle operazioni della pagina. Archiviato per il contesto di rigenerazione.
--model Recommended ID modello usato per generare la pagina , ad esempio claude-sonnet-4-6.
--agent-message Recommended Descrizione di ciò che è stato creato o modificato. Archiviato come cronologia delle modifiche.
--add-to-sitemap Solo nuove pagine Aggiunge automaticamente la pagina allo spostamento dell'app. Omettere durante l'aggiornamento.

pac model list

Elenca tutte le app guidate dal modello nell'ambiente.

Parametri facoltativi per model list

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

Esempio pac model list

Elencare tutte le app basate su modello nell'ambiente attualmente attivo:

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

Liste abilitate dei linguaggi nell'ambiente Dataverse.

Parametri facoltativi per model list-languages

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

pac model list-tables

Elenca le tabelle Dataverse nell'ambiente connesso.

Parametri facoltativi per model list-tables

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--search -s

Elenco di nomi da cercare con virgole (corrisponde al nome logico, al nome dello schema o al nome di visualizzazione).

--type -t

Filtra per tipo di tabella: 'personalizzato', 'standard' o 'tutti' (predefinito: tutti).

See also

Microsoft Power Platform gruppi di comandi dell'interfaccia della riga di comando
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform

  • Last updated on