Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
(Anteprima) Comandi per l'uso di app basate su modello.
Commands
| Command | Description |
|---|---|
| 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 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.
Examples
Scaricare una singola pagina generativa in base al relativo 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
Il comando crea una sottodirectory denominata dopo l'ID pagina e scrive 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)
Examples
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.
Examples
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 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"
Output di esempio:
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.
Examples
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 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 (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.
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 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.
Examples
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