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 add Allegare una o più pagine generative esistenti alla mappa del sito di un'app basata su modello (nessun nuovo caricamento). Usa 'pac model genpage upload' per creare o aggiornare la pagina stessa. Usa questo verbo per visualizzare una pagina già caricata in un'altra app.
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 Elencare le pagine generate: env-wide per impostazione predefinita o per un'app quando viene fornito --app-id. Pass --include-unpubblicato per elencare anche le pagine bozza.
pac model genpage remove Scollegare le pagine di intelligenza artificiale generative esistenti dalla mappa del sito di un'app basata su modello. La riga di pagina in Dataverse viene mantenuta (può comunque essere fatto riferimento da altre app).
pac model genpage transpile Traspila un file TypeScript con tipi di runtime per test e debug
pac model genpage upload Caricare una pagina generata in Dataverse e pubblicarla. Crea una nuova pagina quando --page-id viene omesso; aggiorna la pagina esistente quando viene fornito --page-id. Per allegare una pagina già esistente nell'ambiente alla mappa del sito di un'altra app senza ricaricare, usare invece "pac model genpage add".
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 è 'Default' se non specificato.

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

Suggerimento

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 add

Allegare una o più pagine generative esistenti alla mappa del sito di un'app basata su modello (nessun nuovo caricamento). Usa 'pac model genpage upload' per creare o aggiornare la pagina stessa. Usa questo verbo per visualizzare una pagina già caricata in un'altra app.

Parametri obbligatori per model genpage add

--page-id

ID pagina generativi delimitati da virgole (GUID) da aggiungere all'app.

Parametri facoltativi per model genpage add

--app-id

ID (GUID) dell'app basata su modello. Si escludono a vicenda con --app-name.

--app-name

Nome univoco dell'app basata su modello. Si escludono a vicenda con --app-id.

--area

ID area facoltativo nella mappa del sito per posizionare la pagina sotto. L'impostazione predefinita è la prima area.

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

--group

ID gruppo facoltativo nella mappa del sito per posizionare la pagina sotto. Il valore predefinito è il primo gruppo dell'area selezionata.

--language-code

Codice lingua (LCID) per il titolo SubArea. Il valore predefinito è 1033 (en-US).

--publish

Pubblicare l'app basata su modello dopo aver aggiunto le pagine.

Questo parametro non richiede alcun valore. È un cambio.

--solution

Nome univoco del contesto della soluzione Dataverse per l'aggiornamento della mappa del sito. Il valore predefinito è 'Predefinito'.

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

Elencare le pagine generate: env-wide per impostazione predefinita o per un'app quando viene fornito --app-id. Pass --include-unpubblicato per elencare anche le pagine bozza.

Parametri facoltativi per model genpage list

--app-id

ID dell'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.

--include-unpublished

Includere pagine generative non pubblicate nell'elenco (impostazione predefinita: solo pubblicata).

Questo parametro non richiede alcun valore. È un cambio.

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 remove

Scollegare le pagine di intelligenza artificiale generative esistenti dalla mappa del sito web di un'app basata su modello. La riga di pagina in Dataverse viene mantenuta (può comunque essere fatto riferimento da altre app).

Parametri obbligatori per model genpage remove

--page-id

Uno o più ID uxagentproject da rimuovere (delimitati da virgole).

Parametri facoltativi per model genpage remove

--app-id

ID app basato su modello (uniqueid) da cui rimuovere le pagine. Si escludono a vicenda con --app-name.

--app-name

Nome univoco dell'app basata su modello da cui rimuovere le pagine. Si escludono a vicenda con --app-id.

--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 basata su modello dopo la modifica della mappa del sito in modo che le modifiche vengano pubblicate immediatamente.

Questo parametro non richiede alcun valore. È un cambio.

--solution

Nome univoco della soluzione Dataverse per l'aggiornamento della mappa del sito. Il valore predefinito è 'Predefinito'.

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

Caricare una pagina generata in Dataverse e pubblicarla. Crea una nuova pagina quando --page-id viene omesso; aggiorna la pagina esistente quando viene fornito --page-id. Per allegare una pagina già esistente nell'ambiente alla mappa del sito di un'altra app senza ricaricare, usare invece "pac model genpage add".

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

Suggerimento

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

Parametro Obbligatorio 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 Solo aggiornamenti GUID della pagina esistente da sostituire.
--data-sources Pagine di dataverse 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

Output di esempio:

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

Vedere anche

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