Condividi tramite

pac model

(Anteprima) Comandi per l'uso di app basate su modello.

Commands

Command Description
pac model create (Anteprima) Crea una nuova app basata su modello.
pac model genpage download (Anteprima) Eseguire il pull delle pagine generate da un'app basata su modello.
pac model genpage generate-types (Anteprima) Genera definizioni dello schema TypeScript per le origini dati
pac model genpage list (Anteprima) Elenca tutte le pagine generate nell'app basata su modello specificata.
pac model genpage transpile (Anteprima) Transpila un file TypeScript con tipi di runtime per il test e il debug
pac model genpage upload (Anteprima) Caricare e pubblicare una pagina generata in un'app basata su modello.
pac model list (Anteprima) Elenca tutte le app basate su modello nell'ambiente.
pac model list-languages (Anteprima) Elenca le lingue abilitate nell'ambiente Dataverse.

pac model create

(Anteprima) Crea una nuova app basata su 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

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 download

(Anteprima) Eseguire il pull delle pagine generate da un'app basata su 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

(Anteprima) Genera definizioni dello schema TypeScript per le origini 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

Annotazioni

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

(Anteprima) Elenca tutte le pagine generate nell'app basata su 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

(Anteprima) Transpila un file TypeScript con tipi di runtime per il test e il 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

(Anteprima) Caricare e pubblicare una pagina generata in un'app basata su modello.

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 Sì GUID dell'app o nome visualizzato. Esegui pac model list per trovarlo.
--code-file Sì 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 Raccomandato Riepilogo del linguaggio naturale delle operazioni della pagina. Archiviato per il contesto di rigenerazione.
--model Raccomandato ID modello usato per generare la pagina , ad esempio claude-sonnet-4-6.
--agent-message Raccomandato 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

(Anteprima) Elenca tutte le app basate su 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.

pac model list esempio

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

(Anteprima) Elenca le lingue abilitate 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.

Vedere anche

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

  • Last updated on