pac model

Käsud mudelipõhiste rakendustega töötamiseks.

Commands

Command Description
pac model create Loob uue mudelipõhise rakenduse.
pac model genpage download Tõmba genereeritud lehed mudelipõhisest rakendusest.
pac model genpage generate-types Genereerib andmeallikate jaoks TypeScripti skeemi definitsioonid
pac model genpage list Loetleb kõik genereeritud lehed määratud mudelipõhises rakenduses.
pac model genpage transpile Transpileerib TypeScript-faili käitusaegsete tüüpidega testimiseks ja silumiseks
pac model genpage upload Laadi üles ja avalda genereeritud leht mudelipõhisesse rakendusse.
pac model list Loetleb kõik mudelipõhised rakendused keskkonnas.
pac model list-languages Loendid lubasid keeled Dataverse'i keskkonnas.
pac model list-tables Loetle Dataverse'i tabelid ühendatud keskkonnas.

pac model create

Loob uue mudelipõhise rakenduse.

Nõutavad parameetrid: model create

--name -n

Uue mudelipõhise rakenduse kuvatav nimi.

Valikulised parameetrid: model create

--description -d

Uue mudelipõhise rakenduse kirjeldus.

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--publish

Avaldage rakendus pärast loomist.

See parameeter ei vaja väärtust. See on lüliti.

--solution

Rakenduse lisamiseks lahenduse kordumatu nimi. Vaikimisi on tegu aktiivse lahendusega.

pac model create Näited

Järgmistes näidetes on toodud käsu kasutamise pac model create levinumad viisid.

Uue mudelipõhise rakenduse loomine aktiivses keskkonnas

pac model create --name "Contoso Sales Hub"

Looge kirjeldusega rakendus ja lisage see lahendusele, seejärel avaldage kohe

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

Rakenduse loomine kindlas keskkonnas, esitades keskkonna URL-i

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

Selle abil saate pac model list kontrollida, kas rakendus on loodud ja tuua selle rakenduse ID kasutamiseks muude käskudega (nt pac model genpage upload.

pac model genpage download

Tõmba genereeritud lehed mudelipõhisest rakendusest.

Nõutavad parameetrid: model genpage download

--app-id

Mudelipõhise rakenduse ID.

Valikulised parameetrid: model genpage download

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--output-directory -o

Kataloog tõmmatud lehtede salvestamiseks. Vaikimisi on valitud praegune kaust.

--page-id

Tõmmatavate lehe ID-de komaeraldusega loend.

pac model genpage download Näited

Järgmistes näidetes on toodud käsu kasutamise pac model genpage download levinumad viisid.

Lehe ID järgi ühe lehe allalaadimine redigeerimiseks kohalikku kausta

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

Rakenduse kõigi generatiivsete lehtede korraga allalaadimine

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

Looge alamkataloog, mille nimi on lehe ID järgi, ja kirjutab järgmised failid

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

Genereerib andmeallikate jaoks TypeScripti skeemi definitsioonid

Nõutavad parameetrid: model genpage generate-types

--data-sources

Komaeraldusega loend kasutatud andmeallikatest (nt konto, müügivihje, kontakt).

Valikulised parameetrid: model genpage generate-types

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--output-file -o

Loodud TypeScripti skeemifaili salvestamise tee (vaikimisi RuntimeTypes.ts)

pac model genpage generate-types Näited

Järgmistes näidetes on toodud käsu kasutamise pac model genpage generate-types levinumad viisid.

TypeScripti tüüpide loomine

Genereerige tabelite account jaoks TypeScripti tüübid ja contact kirjutage need asukohta ./src/RuntimeTypes.ts:

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

Ühe tabeli tüüpide loomine kindlasse väljundkausta

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

Note

Käita alati generate-types enne andmetabelite päringut lehekoodi kirjutamist. Loodud fail sisaldab tugevalt tipitud veerunimesid, välisvõtmevälju ja loendiväärtusi iga tabeli kohta. Genereeritud tüüpidele toetumine takistab käitusajatõrkeid, mis on tingitud valesti kirjutatud või olematutest veerunimedest.

pac model genpage list

Loetleb kõik genereeritud lehed määratud mudelipõhises rakenduses.

Nõutavad parameetrid: model genpage list

--app-id

Mudelipõhise rakenduse ID.

Valikulised parameetrid: model genpage list

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac model genpage list Näited

Järgmistes näidetes on toodud käsu kasutamise pac model genpage list levinumad viisid.

Rakenduse ID-ga loendilehed

Loetlege kõik Contoso müügikeskuse rakenduse generatiivsed lehed, kasutades selle rakenduse ID-t:

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

Loendilehed rakenduse nime abil

Loetlege generatiivsed lehed rakenduse nime järgi (CLI otsib automaatselt rakenduse ID):

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

pac model genpage sample output

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

Transpileerib TypeScript-faili käitusaegsete tüüpidega testimiseks ja silumiseks

Nõutavad parameetrid: model genpage transpile

--code-file

Lehekoodi sisaldava faili tee.

Valikulised parameetrid: model genpage transpile

--data-sources

Komaeraldusega loend kasutatud andmeallikatest (nt konto, müügivihje, kontakt).

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--output-file

Transpileeritud JavaScripti väljundi salvestamise tee (vaikimisi [koodifail].compiled.js)

pac model genpage upload

Laadi üles ja avalda genereeritud leht mudelipõhisesse rakendusse.

Nõutavad parameetrid: model genpage upload

--app-id

Mudelipõhise rakenduse ID.

--code-file

Lehekoodi sisaldava faili tee.

Valikulised parameetrid: model genpage upload

--add-to-sitemap

Saate lehe lisada rakenduse saidikaardi navigeerimispaanile.

See parameeter ei vaja väärtust. See on lüliti.

--agent-message

Agendi vastusteade.

--agent-message-file

Agendi vastusesõnumit sisaldava faili tee.

--compiled-code-file

Kompileeritud JavaScripti koodi sisaldava faili tee. Kui seda ei esitata, transpileeritakse TypeScript automaatselt JavaScripti.

--data-sources

Komaeraldusega loend kasutatud andmeallikatest (nt konto, müügivihje, kontakt).

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--model

Lehe genereerimiseks kasutatav TEI mudel (nt claude-3-5-sonnet-20241022).

--name -n

Lehe nimi.

--page-id

Värskendatava lehe ID. Kui seda pole esitatud, luuakse uus leht.

--prompt

Selle lehe genereerinud kasutajaviip.

--prompt-file

Selle lehe genereerinud kasutajaviipa sisaldava faili tee.

pac model genpage upload Näited

Järgmistes näidetes on toodud käsu kasutamise pac model genpage upload levinumad viisid.

Uue lehe avaldamine

Avaldage Contoso müügikeskuse rakenduses uus generatiivne leht ja lisage see rakenduse saidikaardile.

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

Olemasoleva generatiivse lehe värskendamine

Olemasoleva generatiivse lehe värskendamiseks sisestage selle lehe ID (saidikaardi duplikaadikirje loomise vältimiseks ärge --add-to-sitemap looge järgmist).

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

Mocki andmeid kasutava lehe avaldamine

Saate avaldada lehe, mis kasutab mock-andmeid (tabeleid Dataverse pole – ära jäetud --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

Parameeter --app-id aktsepteerib rakenduse GUID-i või selle kuvatavat nime. Kui mitmel rakendusel on sama kuvatav nimi, kasutage mitmetähenduslikkuse vältimiseks GUID-i. Saate käivitada pac model list rakenduse ID-sid otsimiseks.

pac model genpage upload parameetri kiirülevaade

Parameter Required Description
--app-id Yes Rakenduse GUID või kuvatav nimi. Selle otsimiseks käivitage pac model list see.
--code-file Yes Juurutatava .tsx lähtefaili tee.
--name Ainult uued lehed Rakenduse saidikaardil kuvatav kuvatav nimi.
--page-id Updates only Asendatava olemasoleva lehe GUID.
--data-sources Dataverse pages Komaeraldusega loend tabeli Dataverse loogikanimedest (nt "account,contact").
--prompt Recommended Loomuliku keele kokkuvõte lehe tegevusest. Talletatakse regenereerimise konteksti jaoks.
--model Recommended Lehe loomiseks kasutatav mudeli ID (nt claude-sonnet-4-6).
--agent-message Recommended Valmis- või muutmiskorra kirjeldus. Talletatakse muutuste ajaloona.
--add-to-sitemap Ainult uued lehed Lisab lehe automaatselt rakenduse navigeerimispaanile. Ära lisa värskendamisel.

pac model list

Loetleb kõik mudelipõhised rakendused keskkonnas.

Valikulised parameetrid: model list

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac model list näide

Loetlege kõik mudelipõhised rakendused praegu aktiivses keskkonnas.

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

Loendid lubasid keeled Dataverse'i keskkonnas.

Valikulised parameetrid: model list-languages

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac model list-tables

Loetle Dataverse'i tabelid ühendatud keskkonnas.

Valikulised parameetrid: model list-tables

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--search -s

Komadega eraldatud nimede nimekiri, mida otsida (vastab loogilisele nimele, skeeminimele või kuvanimele).

--type -t

Filtreeri tabelitüübi järgi: 'custom', 'standard' või 'all' (vaikimisi: kõik).

See also

Microsoft Power Platform CLI käsurühmad
Microsoft Power Platform CLI ülevaade