pac model

Komandas darbam ar modeļa vadītām programmām.

Commands

Command Description
pac model create Izveido jaunu modeļa vadītu programmu.
pac model genpage download Izvelciet ģenerētas lapas no modeļa vadītas programmas.
pac model genpage generate-types Ģenerē TypeScript shēmas definīcijas datu avotiem
pac model genpage list Uzskaita visas ģenerētās lapas norādītajā modeļa vadītajā programmā.
pac model genpage transpile Pārveido TypeScript failu ar izpildlaika tipiem testēšanai un atkļūdošanai
pac model genpage upload Augšupielādējiet un publicējiet ģenerētu lapu modeļa vadītā programmā.
pac model list Uzskaita visas modeļa vadītās programmas vidē.
pac model list-languages Uzskaita iespējotās valodas Dataverse vidē.
pac model list-tables Uzskaitiet Dataverse tabulas savienotajā vidē.

pac model create

Izveido jaunu modeļa vadītu programmu.

Nepieciešamie parametri model create

--name -n

Jaunās modeļa vadītās programmas parādāmais nosaukums.

Neobligātie parametri model create

--description -d

Jaunās modeļa vadītās programmas apraksts.

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--publish

Publicējiet lietotni pēc izveides.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--solution

Risinājuma unikālais nosaukums, kuram pievienot programmu. Noklusējums ir aktīvais risinājums.

pac model create Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model create veidi.

Jaunas modeļa vadītas programmas izveide aktīvajā vidē

pac model create --name "Contoso Sales Hub"

Izveidojiet programmu ar aprakstu un pievienojiet to risinājumam, pēc tam nekavējoties publicējiet

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

Programmas izveide noteiktā vidē, norādot vides URL

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

Izmantojiet pac model list , lai pārbaudītu, vai programma ir izveidota, un izgūtu tās programmas ID, lai to izmantotu ar citām komandām, piemēram, pac model genpage upload.

pac model genpage download

Izvelciet ģenerētas lapas no modeļa vadītas programmas.

Nepieciešamie parametri model genpage download

--app-id

Modeļa vadītās programmas ID.

Neobligātie parametri model genpage download

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--output-directory -o

Direktorijs, lai saglabātu izvilktās lapas. Noklusējums ir pašreizējais direktorijs.

--page-id

Ar komatiem atdalīts lapu ID saraksts, kas jāizvelk.

pac model genpage download Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage download veidi.

Lejupielādējiet vienu ģeneratīvo lapu pēc tās lapas ID lokālajā mapē rediģēšanai

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

Lejupielādējiet visas ģeneratīvās lapas lietotnē uzreiz

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

Izveidojiet apakšdirektoriju, kas nosaukta pēc lapas ID, un ieraksta šādus failus

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

Ģenerē TypeScript shēmas definīcijas datu avotiem

Nepieciešamie parametri model genpage generate-types

--data-sources

Ar komatiem atdalīts izmantoto datu avotu saraksts (piemēram, "konts,interesents,kontaktpersona").

Neobligātie parametri model genpage generate-types

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--output-file -o

Ģenerētā TypeScript shēmas faila saglabāšanas ceļš (noklusējuma vērtība ir RuntimeTypes.ts)

pac model genpage generate-types Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage generate-types veidi.

TypeScript tipu ģenerēšana

Ģenerējiet TypeScript tipus un tabulām account un ierakstiet tos uzcontact:./src/RuntimeTypes.ts

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

Ģenerējiet tipus vienai tabulai noteiktā izvades direktorijā

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

Note

Vienmēr palaidiet generate-types pirms lapas koda rakstīšanas, kas vaicā Dataverse tabulās. Ģenerētajā failā ir izteikti ierakstīti kolonnu nosaukumi, ārējās atslēgas lauki un uzskaitījuma vērtības katrai tabulai. Paļaušanās uz ģenerētajiem tipiem novērš izpildlaika kļūdas, ko izraisa nepareizi uzrakstīti vai neesoši kolonnu nosaukumi.

pac model genpage list

Uzskaita visas ģenerētās lapas norādītajā modeļa vadītajā programmā.

Nepieciešamie parametri model genpage list

--app-id

Modeļa vadītās programmas ID.

Neobligātie parametri model genpage list

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac model genpage list Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage list veidi.

Lapu saraksts, izmantojot lietotnes ID

Uzskaitiet visas ģeneratīvās lapas programmā Contoso pārdošanas centrmezgls , izmantojot tās programmas ID:

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

Lapu saraksts, izmantojot programmas nosaukumu

Uzskaitiet ģeneratīvās lapas pēc programmas nosaukuma (CLI automātiski uzmeklē programmas ID):

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

pac model GenPage parauga izvade

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

Pārveido TypeScript failu ar izpildlaika tipiem testēšanai un atkļūdošanai

Nepieciešamie parametri model genpage transpile

--code-file

Ceļš uz failu, kurā ir lappuses kods.

Neobligātie parametri model genpage transpile

--data-sources

Ar komatiem atdalīts izmantoto datu avotu saraksts (piemēram, "konts,interesents,kontaktpersona").

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--output-file

Ceļš, lai saglabātu transpilēto JavaScript izvadi (noklusējuma vērtība ir [koda fails].compiled.js)

pac model genpage upload

Augšupielādējiet un publicējiet ģenerētu lapu modeļa vadītā programmā.

Nepieciešamie parametri model genpage upload

--app-id

Modeļa vadītās programmas ID.

--code-file

Ceļš uz failu, kurā ir lappuses kods.

Neobligātie parametri model genpage upload

--add-to-sitemap

Pievienojiet lapu lietotnes vietnes kartes navigācijai.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--agent-message

Aģenta atbildes ziņojums.

--agent-message-file

Ceļš uz failu, kurā ir aģenta atbildes ziņojums.

--compiled-code-file

Ceļš uz failu, kas satur kompilēto JavaScript kodu. Ja tas nav norādīts, TypeScript tiks automātiski pārveidots uz JavaScript.

--data-sources

Ar komatiem atdalīts izmantoto datu avotu saraksts (piemēram, "konts,interesents,kontaktpersona").

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--model

Lapas ģenerēšanai izmantotais AI modelis (piemēram, "claude-3-5-sonnet-20241022").

--name -n

Lapas nosaukums.

--page-id

Atjaunināmās lapas ID. Ja tas netiek sniegts, tiks izveidota jauna lapa.

--prompt

Lietotāja uzvedne, kas ģenerēja šo lapu.

--prompt-file

Ceļš uz failu, kurā ir lietotāja uzvedne, kas ģenerēja šo lapu.

pac model genpage upload Piemēri

Tālāk sniegtajos piemēros ir parādīti izplatītākie komandas lietošanas pac model genpage upload veidi.

Jaunas ģeneratīvās lapas publicēšana

Publicējiet jaunu ģeneratīvo lapu programmā Contoso pārdošanas centrmezgls un pievienojiet to programmas vietnes kartei:

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

Esošas ģeneratīvās lapas atjaunināšana

Atjauniniet esošu ģeneratīvo lapu, norādot tās lapas ID (izlaidiet --add-to-sitemap , lai izvairītos no vietnes kartes ieraksta dublikāta izveides):

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

Publicēt lapu, kurā tiek izmantoti fiktīvi dati

Publicējiet lapu, kurā tiek izmantoti fiktīvi dati (bez Dataverse tabulām — izlaidiet --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

Parametrs --app-id akceptē programmas GUID vai parādāmo nosaukumu. Ja vairākām programmām ir vienāds parādāmais vārds, izmantojiet GUID, lai izvairītos no neskaidrībām. Skrieniet pac model list , lai meklētu programmu ID.

pac model genpage upload Parametru ātrā uzziņa

Parameter Required Description
--app-id Yes Programmas GUID vai parādāmais vārds. Skrieniet pac model list , lai to atrastu.
--code-file Yes Ceļš uz izvietojamo avota .tsx failu.
--name Tikai jaunas lapas Parādāmais nosaukums, kas redzams programmas vietnes kartē.
--page-id Updates only Esošās lapas GUID, kas jāaizstāj.
--data-sources Dataverse pages Ar komatiem atdalīts Dataverse tabulas loģisko nosaukumu saraksts (piemēram, "account,contact").
--prompt Recommended Kopsavilkums par lapas darbību dabiskā valodā. Saglabāts reģenerācijas kontekstam.
--model Recommended Modeļa ID, kas izmantots lapas ģenerēšanai (piemēram, claude-sonnet-4-6).
--agent-message Recommended Uzbūvētā vai mainītā apraksts. Tiek saglabāta kā izmaiņu vēsture.
--add-to-sitemap Tikai jaunas lapas Automātiski pievieno lapu lietotnes navigācijai. Izlaist, atjauninot.

pac model list

Uzskaita visas modeļa vadītās programmas vidē.

Neobligātie parametri model list

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac model list piemērs

Uzskaitiet visas modeļa vadītās programmas pašlaik aktīvajā vidē:

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

Uzskaita iespējotās valodas Dataverse vidē.

Neobligātie parametri model list-languages

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac model list-tables

Uzskaitiet Dataverse tabulas savienotajā vidē.

Neobligātie parametri model list-tables

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--search -s

Ar komatiem atdalīts meklējamo nosaukumu saraksts (atbilst loģiskajam nosaukumam, shēmas nosaukumam vai parādāmajam nosaukumam).

--type -t

Filtrējiet pēc tabulas veida: "pielāgots", "standarta" vai "viss" (noklusējums: visi).

See also

Microsoft Power Platform CLI komandgrupas
Microsoft Power Platform CLI pārskats