Piezīmes
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt pierakstīties vai mainīt direktorijus.
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt mainīt direktorijus.
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ē
- Izveidojiet programmu ar aprakstu un pievienojiet to risinājumam, pēc tam nekavējoties publicējiet
- Programmas izveide noteiktā vidē, norādot vides URL
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
- Lejupielādējiet visas ģeneratīvās lapas lietotnē uzreiz
- Izveidojiet apakšdirektoriju, kas nosaukta pēc lapas ID, un ieraksta šādus failus
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
- Esošas ģeneratīvās lapas atjaunināšana
- Publicēt lapu, kurā tiek izmantoti fiktīvi dati
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