pac model

Komandos, skirtos darbui su modeliu pagrįstomis programomis.

Komandos

Komanda Aprašas
pac model create Sukuria naują modeliu pagrįstą programą.
pac model genpage add Prie modeliu pagrįstos taikomosios programos svetainės struktūros pridėkite vieną ar daugiau esamų generuojamų puslapių (iš naujo nenusiųskite). Naudokite norėdamipac model genpage upload sukurti arba atnaujinti patį puslapį; naudokite šį veiksmažodį, kad jau nusiųstas puslapis būtų rodomas kitoje programoje.
pac model genpage download Ištraukite sugeneruotus puslapius iš modeliu pagrįstos programos.
pac model genpage generate-types Generuoja duomenų šaltinių TypeScript schemos apibrėžimus
pac model genpage list Sąrašo sugeneruoti puslapiai – iš viso pagal numatytuosius nustatymus arba vienai programėlei, kai pateikiama --app-id. Pass – include-unpublished to also list draft pages.
pac model genpage remove Atjunkite esamą (-us) generuojamą (-us) DI puslapį (-us) nuo modeliu pagrįstos taikomosios programos svetainės struktūros. "Dataverse" puslapio eilutė išsaugoma (ją vis tiek galima nurodyti iš kitų programų).
pac model genpage transpile Transpiliuoja TypeScript failą su vykdymo laiko tipais testavimui ir derinimui
pac model genpage upload Įkelkite sugeneruotą puslapį į "Dataverse" ir publikuokite jį. Sukuria naują puslapį, kai --page-id praleidžiamas; atnaujina esamą puslapį, kai pateikiamas --page-id. Norėdami pridėti puslapį, kuris jau yra aplinkoje, prie kitos taikomosios programos svetainės struktūros nenusiuntę iš naujo, vietoj to naudokite .pac model genpage add
pac model list Išvardijamos visos modeliu pagrįstos programos aplinkoje.
pac model list-languages Išvardijamos įgalintos kalbos "Dataverse" aplinkoje.
pac model list-tables Išvardinkite "Dataverse" lenteles prijungtoje aplinkoje.

pac model create

Sukuria naują modeliu pagrįstą programą.

Būtini parametrai model create

--name -n

Naujos modeliu pagrįstos programėlės rodomas pavadinimas.

Pasirinktiniai parametrai, skirti model create

--description -d

Naujos modeliu pagrįstos programėlės aprašas.

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--publish

Publikuoti taikomąją programą po sukūrimo.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

--solution

Sprendimo unikalus pavadinimas, į kurį norite įtraukti taikomąją programą. Jei nenurodyta, numatytoji reikšmė yra Numatytoji.

pac model create Pavyzdžiai

Tolesniuose pavyzdžiuose pateikiami įprasti komandos naudojimo pac model create būdai.

Naujos modeliu pagrįstos programos kūrimas aktyvioje aplinkoje

pac model create --name "Contoso Sales Hub"

Sukurkite taikomąją programą su aprašu ir įtraukite ją į sprendimą, tada iš karto publikuokite

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

Taikomosios programos kūrimas konkrečioje aplinkoje pateikiant aplinkos 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

Patarimas

Naudokite pac model list norėdami patikrinti, ar programa sukurta, ir gauti jos taikomosios programos ID, kad ją būtų galima naudoti su kitomis komandomis, pvz., pac model genpage upload.

pac model genpage add

Prie modeliu pagrįstos taikomosios programos svetainės struktūros pridėkite vieną ar daugiau esamų generuojamų puslapių (iš naujo nenusiųskite). Naudokite norėdamipac model genpage upload sukurti arba atnaujinti patį puslapį; naudokite šį veiksmažodį, kad jau nusiųstas puslapis būtų rodomas kitoje programoje.

Būtini parametrai model genpage add

--page-id

Kableliais atskirtų generavimo puslapių ID (GUID), kurie bus įtraukti į programą.

Pasirinktiniai parametrai, skirti model genpage add

--app-id

Modeliu pagrįstos programėlės ID (GUID). Tarpusavyje nesuderinami su --app-name.

--app-name

Modeliu pagrįstas programos unikalus pavadinimas. Tarpusavyje nesuderinami su "-app-id".

--area

Svetainės struktūros pasirinktinis srities ID, kad būtų galima padėti puslapį. Numatytoji reikšmė yra pirmoji sritis.

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--group

Svetainės struktūros pasirinktinis grupės ID, kad būtų galima įterpti puslapį. Numatytoji reikšmė yra pirma pasirinktos srities grupė.

--language-code

Antrinės srities pavadinimo kalbos kodas (LCID). Numatytoji reikšmė yra 1033 (en-US).

--publish

Įtraukę puslapį (-us) publikuokite modeliu pagrįstą programą.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

--solution

Svetainės struktūros naujinimo "Dataverse" sprendimo konteksto unikalus pavadinimas. Numatytoji reikšmė yra Numatytoji.

pac model genpage download

Ištraukite sugeneruotus puslapius iš modeliu pagrįstos programos.

Būtini parametrai model genpage download

--app-id

Modeliu pagrįstos programėlės ID.

Pasirinktiniai parametrai, skirti model genpage download

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--output-directory -o

Katalogas, kuriame galima įrašyti ištrauktus puslapius. Pagal numatytuosius nustatymus dabartinis katalogas.

--page-id

Kableliais atskirtų puslapių, iš kurių reikia traukti, ID sąrašas.

pac model genpage download Pavyzdžiai

Tolesniuose pavyzdžiuose pateikiami įprasti komandos naudojimo pac model genpage download būdai.

Vieno generuojančio puslapio atsisiuntimas pagal jo puslapio ID į vietinį aplanką redagavimui

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

Atsisiųskite visus generuojančius puslapius programėlėje vienu metu

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

Kurti pakatalogį, pavadintą po puslapio ID, ir rašyti šiuos 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

Generuoja duomenų šaltinių TypeScript schemos apibrėžimus

Būtini parametrai model genpage generate-types

--data-sources

Kableliais atskirtų naudojamų duomenų šaltinių sąrašas (pvz., paskyra, galimas klientas, kontaktas).

Pasirinktiniai parametrai, skirti model genpage generate-types

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--output-file -o

Sugeneruoto TypeScript schemos failo įrašymo kelias (numatytasis RuntimeTypes.ts)

pac model genpage generate-types Pavyzdžiai

Tolesniuose pavyzdžiuose pateikiami įprasti komandos naudojimo pac model genpage generate-types būdai.

Generuoti TypeScript tipus

Generuoti TypeScript tipus lentelėms ir account lentelėms contact ir rašyti juos į ./src/RuntimeTypes.ts:

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

Generuoti vienos lentelės tipus į konkretų išvesties katalogą

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

Pastaba

Visada vykdyti generate-types prieš rašydami puslapio kodą, kuris pateikia užklausas "Dataverse" lentelėms. Sugeneruotame faile yra labai įvesti kiekvienos lentelės stulpelių pavadinimai, išorinio rakto laukai ir išvardijimas. Pasikliaudami sugeneruotais tipais, išvengsite vykdymo klaidų, atsiradusių dėl klaidingai parašytų arba nesamų stulpelių pavadinimų.

pac model genpage list

Sąrašo sugeneruoti puslapiai – iš viso pagal numatytuosius nustatymus arba vienai programėlei, kai pateikiama --app-id. Pass – include-unpublished to also list draft pages.

Pasirinktiniai parametrai, skirti model genpage list

--app-id

Modeliu pagrįstos programėlės ID.

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--include-unpublished

Į sąrašą įtraukite nepublikuotus generuojančius puslapius (numatytasis parametras: tik publikuoti).

Šiam parametrui nereikia reikšmės. Tai jungiklis.

pac model genpage list Pavyzdžiai

Tolesniuose pavyzdžiuose pateikiami įprasti komandos naudojimo pac model genpage list būdai.

Puslapių sąrašas naudojant taikomosios programos ID

Nurodykite visus generuojančius puslapius "Contoso" pardavimo telkinio taikomojoje programoje naudodami programos ID:

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

Puslapių sąrašas naudojant taikomosios programos pavadinimą

Pateikti generuojamų puslapių sąrašą pagal programėlės pavadinimą (CLI automatiškai ieško taikomosios programos 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 remove

Atjunkite esamą (-us) generuojamą (-us) DI puslapį (-us) nuo modeliu pagrįstos taikomosios programos svetainės struktūros. "Dataverse" puslapio eilutė išsaugoma (ją vis tiek galima nurodyti iš kitų programų).

Būtini parametrai model genpage remove

--page-id

Vienas ar daugiau uxagentproject ID, kurie bus pašalinti (kableliais atskirti).

Pasirinktiniai parametrai, skirti model genpage remove

--app-id

Modeliu pagrįstas programėlės ID (uniqueid), iš kurio (-ių) norite pašalinti puslapį (-us). Tarpusavyje nesuderinami su --app-name.

--app-name

Modeliu pagrįstas programos unikalus pavadinimas, iš kurios pašalinamas (-i) puslapis (-iai). Tarpusavyje nesuderinami su "-app-id".

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--publish

Publikuokite modeliu pagrįstą taikomąją programą po svetainės struktūros redagavimo, kad pakeitimai būtų nedelsiant atlikti.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

--solution

"Dataverse" sprendimo unikalus svetainės struktūros naujinimo pavadinimas. Numatytoji reikšmė yra Numatytoji.

pac model genpage transpile

Transpiliuoja TypeScript failą su vykdymo laiko tipais testavimui ir derinimui

Būtini parametrai model genpage transpile

--code-file

Failo, kuriame yra puslapio kodas, kelias.

Pasirinktiniai parametrai, skirti model genpage transpile

--data-sources

Kableliais atskirtų naudojamų duomenų šaltinių sąrašas (pvz., paskyra, galimas klientas, kontaktas).

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--output-file

Transpiled JavaScript išvesties įrašymo kelias (numatytoji reikšmė yra [kodo failas].compiled.js)

pac model genpage upload

Įkelkite sugeneruotą puslapį į "Dataverse" ir publikuokite jį. Sukuria naują puslapį, kai --page-id praleidžiamas; atnaujina esamą puslapį, kai pateikiamas --page-id. Norėdami pridėti puslapį, kuris jau yra aplinkoje, prie kitos taikomosios programos svetainės struktūros nenusiuntę iš naujo, vietoj to naudokite .pac model genpage add

Būtini parametrai model genpage upload

--app-id

Modeliu pagrįstos programėlės ID.

--code-file

Failo, kuriame yra puslapio kodas, kelias.

Pasirinktiniai parametrai, skirti model genpage upload

--add-to-sitemap

Įtraukite puslapį į taikomosios programos svetainės struktūros naršymą.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

--agent-message

Agento atsakymo pranešimas.

--agent-message-file

Failo, kuriame yra agento atsakymo pranešimas, kelias.

--compiled-code-file

Failo, kuriame yra sukompiliuotas "JavaScript" kodas, kelias. Jei nepateikta, TypeScript bus automatiškai transpiliuojamas į "JavaScript".

--data-sources

Kableliais atskirtų naudojamų duomenų šaltinių sąrašas (pvz., paskyra, galimas klientas, kontaktas).

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--model

DI modelis, naudojamas puslapiui sugeneruoti (pvz., "claude-3-5-sonnet-20241022").

--name -n

Puslapio pavadinimas.

--page-id

Naujinto puslapio ID. Jei nepateiktas, bus sukurtas naujas puslapis.

--prompt

Vartotojo raginimas, kuris sugeneravo šį puslapį.

--prompt-file

Failo, kuriame yra vartotojo raginimas, sugeneravęs šį puslapį, kelias.

pac model genpage upload Pavyzdžiai

Tolesniuose pavyzdžiuose pateikiami įprasti komandos naudojimo pac model genpage upload būdai.

Publikuoti naują generuojamą puslapį

Publikuokite naują generuojamą puslapį "Contoso" pardavimo telkinio taikomojoje programoje ir įtraukite jį į taikomosios programos svetainės struktūrą:

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

Esamo generuojančio puslapio naujinimas

Atnaujinkite esamą generuojamą puslapį pateikdami jo puslapio ID (kad --add-to-sitemap nebūtų kuriamas pasikartojantis svetainės struktūros įrašas):

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

Puslapio, kuriame naudojami maketo duomenys, publikavimas

Publikuoti puslapį, kuriame naudojami maketo duomenys (nėra "Dataverse" lentelių – praleisti --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

Patarimas

Parametras --app-id priima taikomosios programos GUID arba rodomą pavadinimą. Jei kelios programėlės naudoja tą patį rodomą pavadinimą, naudokite GUID, kad išvengtumėte dviprasmiškumo. Paleiskite pac model list norėdami ieškoti programėlių IDENTIFIKATORIUS.

pac model genpage upload parametro sparčioji nuoroda

Parametras Būtina Aprašas
--app-id Taip Taikomosios programos GUID arba rodomas pavadinimas. Paleiskite pac model list , kad ją rastumėte.
--code-file Taip Kelias į diegiamą .tsx šaltinio failą.
--name Tik nauji puslapiai Rodomas pavadinimas rodomas taikomosios programos svetainės strukte.
--page-id Tik naujinimai Esamo puslapio, kurį norite pakeisti, GUID.
--data-sources "Dataverse" puslapiai Kableliais atskirtų dataverse lentelės loginių pavadinimų sąrašas (pvz., "account,contact").
--prompt Rekomenduojama Puslapio natūralios kalbos suvestinė. Saugoma regeneracijos kontekstui.
--model Rekomenduojama Modelio ID, naudojamas puslapiui generuoti (pvz., claude-sonnet-4-6).
--agent-message Rekomenduojama Aprašą, kas buvo sukurta arba pakeista. Saugoma kaip keitimų retrospektyva.
--add-to-sitemap Tik nauji puslapiai Automatiškai įtraukia puslapį į taikomosios programos naršymą. Naujinant praleisti.

pac model list

Išvardijamos visos modeliu pagrįstos programos aplinkoje.

Pasirinktiniai parametrai, skirti model list

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

Pavyzdys: „pac model list“

Išvardyti visas modeliu pagrįstas programėles šiuo metu aktyvioje aplinkoje:

pac model list

Pavyzdžio išvestis:

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

Išvardijamos įgalintos kalbos "Dataverse" aplinkoje.

Pasirinktiniai parametrai, skirti model list-languages

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

pac model list-tables

Išvardinkite "Dataverse" lenteles prijungtoje aplinkoje.

Pasirinktiniai parametrai, skirti model list-tables

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--search -s

Kableliais atskirtas ieškotinų pavadinimų sąrašas (atitinka loginį pavadinimą, schemos pavadinimą arba rodomą pavadinimą).

--type -t

Filtruoti pagal lentelės tipą: "tinkintas", "standartinis" arba "visi" (numatytasis: visi).

Taip pat žr.

Microsoft Power Platform CLI komandų grupės
Microsoft Power Platform CLI apžvalga

  • Last updated on