pac model

Comenzi pentru lucrul cu aplicații bazate pe modele.

Commands

Command Description
pac model create Creează o nouă aplicație bazată pe model.
pac model genpage download Extrage pagini generate dintr-o aplicație bazată pe modele.
pac model genpage generate-types Generează definiții de scheme TypeScript pentru sursele de date
pac model genpage list Listează toate paginile generate în aplicația model-driven specificată.
pac model genpage transpile Transpile un fișier TypeScript cu tipuri de runtime pentru testare și depanare
pac model genpage upload Încarcă și publică o pagină generată într-o aplicație bazată pe model.
pac model list Listează toate aplicațiile bazate pe modele din mediu.
pac model list-languages Listele au activat limbaje în mediul Dataverse.
pac model list-tables Listează tabelele Dataverse din mediul conectat.

pac model create

Creează o nouă aplicație bazată pe model.

Parametri obligatorii pentru model create

--name -n

Numele afișat pentru noua aplicație bazată pe modele.

Parametri opționali pentru model create

--description -d

Descriere pentru noua aplicație bazată pe modele.

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--publish

Publicați aplicația după creare.

Acest parametru nu necesită nicio valoare. Este un comutator.

--solution

Nume unic soluție la care să adăugați aplicația. Se aplică implicit soluției active.

pac model create Exemple

Următoarele exemple arată modalități comune de pac model create a utiliza comanda.

Crearea unei aplicații noi bazate pe modele în mediul activ

pac model create --name "Contoso Sales Hub"

Creați o aplicație cu o descriere și adăugați-o la o soluție, apoi publicați imediat

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

Creați o aplicație într-un anumit mediu, furnizând URL-ul de mediu

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

Se utilizează pac model list pentru a verifica dacă aplicația a fost creată și a regăsi ID-ul său de aplicație pentru utilizare cu alte comenzi, cum pac model genpage uploadar fi .

pac model genpage download

Extrage pagini generate dintr-o aplicație bazată pe modele.

Parametri obligatorii pentru model genpage download

--app-id

ID-ul aplicației bazate pe model.

Parametri opționali pentru model genpage download

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--output-directory -o

Director pentru a salva paginile extrase. Implicit la directorul curent.

--page-id

Listă de ID-uri de pagină separate prin virgulă.

pac model genpage download Exemple

Următoarele exemple arată modalități comune de pac model genpage download a utiliza comanda.

Descărcați o singură pagină generată de ID-ul paginii sale într-un folder local pentru editare

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

Descărcați simultan toate paginile generativă dintr-o aplicație

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

Creați un subdirector denumit după ID-ul paginii și scrieți următoarele fișiere

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

Generează definiții de scheme TypeScript pentru sursele de date

Parametri obligatorii pentru model genpage generate-types

--data-sources

Listă separată prin virgulă de surse de date utilizate (de exemplu, 'account,lead,contact').

Parametri opționali pentru model genpage generate-types

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--output-file -o

Cale pentru a salva fișierul schemă TypeScript generat (implicit la RuntimeTypes.ts)

pac model genpage generate-types Exemple

Următoarele exemple arată modalități comune de pac model genpage generate-types a utiliza comanda.

Generare tipuri TypeScript

Generați tipuri TypeScript pentru account tabele și contact le scrieți în ./src/RuntimeTypes.ts:

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

Generarea tipurilor pentru un singur tabel într-un director de ieșire specific

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

Note

Rulați generate-types întotdeauna înainte de a scrie cod de pagină care interoghează tabeleLe Dataverse. Fișierul generat conține nume de coloane tastate puternic, câmpuri cheie străină și valori de enumerare pentru fiecare tabel. Dacă vă bazați pe tipurile generate, erorile de rulare sunt cauzate de nume de coloane ortografiate greșit sau inexistente.

pac model genpage list

Listează toate paginile generate în aplicația model-driven specificată.

Parametri obligatorii pentru model genpage list

--app-id

ID-ul aplicației bazate pe model.

Parametri opționali pentru model genpage list

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac model genpage list Exemple

Următoarele exemple arată modalități comune de pac model genpage list a utiliza comanda.

Listarea paginilor utilizând ID-ul de aplicație

Listați toate paginile generative din aplicația Hub de vânzări Contoso utilizând ID-ul său de aplicație:

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

Listarea paginilor utilizând numele aplicației

Listați paginile generoase după numele aplicației (CLI caută automat ID-ul aplicației):

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

pac model ieșire eșantion 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

Transpile un fișier TypeScript cu tipuri de runtime pentru testare și depanare

Parametri obligatorii pentru model genpage transpile

--code-file

Calea către fișierul care conține codul de pagină.

Parametri opționali pentru model genpage transpile

--data-sources

Listă separată prin virgulă de surse de date utilizate (de exemplu, 'account,lead,contact').

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--output-file

Cale pentru a salva rezultatul JavaScript transpilat (implicit la [cod-file].compiled.js)

pac model genpage upload

Încarcă și publică o pagină generată într-o aplicație bazată pe model.

Parametri obligatorii pentru model genpage upload

--app-id

ID-ul aplicației bazate pe model.

--code-file

Calea către fișierul care conține codul de pagină.

Parametri opționali pentru model genpage upload

--add-to-sitemap

Adăugați pagina la navigarea hartă site a aplicației.

Acest parametru nu necesită nicio valoare. Este un comutator.

--agent-message

Mesajul de răspuns al agentului.

--agent-message-file

Calea către un fișier care conține mesajul de răspuns al agentului.

--compiled-code-file

Calea către fișierul care conține codul JavaScript compilat. Dacă nu este furnizat, TypeScript va fi transpilat automat în JavaScript.

--data-sources

Listă separată prin virgulă de surse de date utilizate (de exemplu, 'account,lead,contact').

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--model

Modelul AI utilizat pentru a genera pagina (de exemplu, "claude-3-5-sonnet-20241022").

--name -n

Numele paginii.

--page-id

ID-ul paginii de actualizat. Dacă nu se furnizează, se va crea o pagină nouă.

--prompt

Utilizatorul a determinat această pagină.

--prompt-file

Calea către un fișier care conține solicitarea de utilizator care a generat această pagină.

pac model genpage upload Exemple

Următoarele exemple arată modalități comune de pac model genpage upload a utiliza comanda.

Publicarea unei pagini generativă noi

Publicați o pagină nouă degenerativă în aplicația Hub de vânzări Contoso și adăugați-o la harta site-ului de aplicație:

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

Actualizarea unei pagini generativă existente

Actualizați o pagină genertivă existentă, furnizând ID-ul său de pagină (omiteți --add-to-sitemap pentru a evita crearea unei intrări de hartă site dublată):

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

Publicarea unei pagini care utilizează date despre machete

Publicați o pagină care utilizează date de tip machetă (fără tabele Dataverse - omite --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

Parametrul --app-id acceptă GUID-ul aplicației sau numele său afișat. Dacă mai multe aplicații partajează același nume afișat, utilizați GUID pentru a evita ambiguitatea. Rulați pac model list pentru a căuta ID-uri de aplicație.

pac model genpage upload parametru quick-reference

Parameter Required Description
--app-id Yes GUID-ul aplicației sau numele afișat. Rulați pac model list pentru a o găsi.
--code-file Yes Calea către fișierul sursă de .tsx implementat.
--name Numai pagini noi Numele afișat afișat în harta site-ului de aplicație.
--page-id Updates only GUID-ul paginii existente de înlocuit.
--data-sources Dataverse pages Listă logică separate prin virgulă de nume logice de tabel Dataverse (de exemplu, "account,contact").
--prompt Recommended Rezumatul limbajului natural cu ceea ce face pagina. Stocat pentru contextul de regenerare.
--model Recommended ID model utilizat pentru a genera pagina (de exemplu, claude-sonnet-4-6).
--agent-message Recommended Descrierea a ceea ce a fost construit sau modificat. Stocat ca istoric al modificărilor.
--add-to-sitemap Numai pagini noi Adaugă automat pagina la navigarea în aplicație. Omiteți la actualizare.

pac model list

Listează toate aplicațiile bazate pe modele din mediu.

Parametri opționali pentru model list

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac model list Exemplu

Listați toate aplicațiile bazate pe modele în mediul activ în prezent:

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

Listele au activat limbaje în mediul Dataverse.

Parametri opționali pentru model list-languages

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac model list-tables

Listează tabelele Dataverse din mediul conectat.

Parametri opționali pentru model list-tables

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--search -s

Lista de nume de căutare separată prin virgule (corespunde cu numele logic, numele schemei sau numele afișat).

--type -t

Filtrează după tipul tabelului: 'custom', 'standard' sau 'toate' (implicit: toate).

See also

Microsoft Power Platform grupuri de comenzi CLI
Microsoft Power Platform prezentare generală CLI

  • Last updated on