pac model

Komandos, skirtos darbui su modeliu pagrįstomis programomis.

Commands

Command Description
pac model create Sukuria naują modeliu pagrįstą programą.
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 Išvardijami visi sugeneruoti puslapiai nurodytoje modeliu pagrįstoje programoje.
pac model genpage transpile Transpiliuoja TypeScript failą su vykdymo laiko tipais testavimui ir derinimui
pac model genpage upload Nusiųskite ir publikuokite sugeneruotą puslapį modeliu pagrįstoje programoje.
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ą. Pagal numatytuosius nustatymus taikomas aktyvus sprendimas.

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

Tip

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

Note

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

Išvardijami visi sugeneruoti puslapiai nurodytoje modeliu pagrįstoje programoje.

Būtini parametrai model genpage list

--app-id

Modeliu pagrįstos programėlės ID.

Pasirinktiniai parametrai, skirti model genpage 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.

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

Nusiųskite ir publikuokite sugeneruotą puslapį modeliu pagrįstoje programoje.

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

Tip

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

Parameter Required Description
--app-id Yes Taikomosios programos GUID arba rodomas pavadinimas. Paleiskite pac model list , kad ją rastumėte.
--code-file Yes Kelias į diegiamą .tsx šaltinio failą.
--name Tik nauji puslapiai Rodomas pavadinimas rodomas taikomosios programos svetainės strukte.
--page-id Updates only Esamo puslapio, kurį norite pakeisti, GUID.
--data-sources Dataverse pages Kableliais atskirtų dataverse lentelės loginių pavadinimų sąrašas (pvz., "account,contact").
--prompt Recommended Puslapio natūralios kalbos suvestinė. Saugoma regeneracijos kontekstui.
--model Recommended Modelio ID, naudojamas puslapiui generuoti (pvz., claude-sonnet-4-6).
--agent-message Recommended 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

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

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

See also

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

  • Last updated on