pac model

Komennot mallipohjaisten sovellusten kanssa työskentelyyn.

Commands

Command Description
pac model create Luo uuden mallipohjaisen sovelluksen.
pac model genpage download Vedä luodut sivut mallipohjaisesta sovelluksesta.
pac model genpage generate-types Generoi TypeScript-skeeman määritelmät tietolähteille
pac model genpage list Listaa kaikki luodut sivut määritellyn mallipohjaisen sovelluksen sisällä.
pac model genpage transpile Transpiloi TypeScript-tiedoston, jossa on ajonaikaiset tyypit testaukseen ja virheenkorjaukseen
pac model genpage upload Lataa ja julkaise luotu sivu mallipohjaiseen sovellukseen.
pac model list Listaa kaikki mallipohjaiset sovellukset ympäristössä.
pac model list-languages Listat sallivat kielet Dataverse-ympäristössä.
pac model list-tables Listaa Dataverse-taulukot yhdistetyssä ympäristössä.

pac model create

Luo uuden mallipohjaisen sovelluksen.

Pakolliset parametrit parametrille model create

--name -n

Uuden mallipohjaisen sovelluksen näyttönimi.

Valinnaiset parametrit parametrille model create

--description -d

Uuden mallipohjaisen sovelluksen kuvaus.

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--publish

Julkaise sovellus luomisen jälkeen.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--solution

Ratkaisun yksilöivä nimi, jota käytetään sovelluksen lisäämiseen. Oletusarvo on aktiivinen ratkaisu.

pac model create Esimerkkejä

Seuraavissa esimerkeissä näytetään yleisiä -komennon pac model create käyttötapoja.

Luo uusi mallipohjainen sovellus aktiivisessa ympäristössä

pac model create --name "Contoso Sales Hub"

Luo sovellus, jossa on kuvaus ja lisää se ratkaisuun, ja julkaise heti

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

Luo sovellus tietyssä ympäristössä antamalla ympäristön URL-osoite

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

:n avulla pac model list voit varmistaa, että sovellus on luotu, ja noutaa sen sovellustunnuksen käytettäväksi muiden komentojen, kuten pac model genpage upload.

pac model genpage download

Vedä luodut sivut mallipohjaisesta sovelluksesta.

Pakolliset parametrit parametrille model genpage download

--app-id

Mallipohjaisen sovelluksen tunnus.

Valinnaiset parametrit parametrille model genpage download

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--output-directory -o

Hakemisto, tallentaaksesi haetut sivut. Oletusarvo on nykyinen hakemisto.

--page-id

Pilkuin eroteltu luettelo nostettavasta sivutunnuksista.

pac model genpage download Esimerkkejä

Seuraavissa esimerkeissä näytetään yleisiä -komennon pac model genpage download käyttötapoja.

Lataa yksittäinen sivu sivutunnuksella paikalliseen kansioon muokkaamista varten

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

Lataa kaikki sovelluksen sivut kerralla

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

Luo alihakemisto, joka on nimetty sivutunnuksen mukaan, ja kirjoita seuraavat tiedostot

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

Generoi TypeScript-skeeman määritelmät tietolähteille

Pakolliset parametrit parametrille model genpage generate-types

--data-sources

Pilkuin eroteltu luettelo käytettävistä tietolähteistä (esim. 'tili,liidi,yhteyshenkilö').

Valinnaiset parametrit parametrille model genpage generate-types

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--output-file -o

Luodun TypeScript-rakennetiedoston tallentamisen polku (oletusarvo on RuntimeTypes.ts)

pac model genpage generate-types Esimerkkejä

Seuraavissa esimerkeissä näytetään yleisiä -komennon pac model genpage generate-types käyttötapoja.

TypeScript-tyyppien luominen

Luo TypeScript-tyypit -taulukoille account ja contact kirjoita ne kohteeseen ./src/RuntimeTypes.ts:

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

Luo tyyppejä yksittäiselle taulukolle tiettyyn tuloskansioon

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

Note

Suorita generate-types aina ennen kuin kirjoitat sivukoodia, joka tekee kyselyn Dataverse-taulukoihin. Luotu tiedosto sisältää vahvasti kirjoitetut sarakkeiden nimet, viiteavainkentät ja luettelointiarvot kullekin taulukolle. Luotujen tyyppien luottaminen estää suorituksenaikaiset virheet, jotka johtuvat virheellisistä tai olemattomista sarakkeiden nimistä.

pac model genpage list

Listaa kaikki luodut sivut määritellyn mallipohjaisen sovelluksen sisällä.

Pakolliset parametrit parametrille model genpage list

--app-id

Mallipohjaisen sovelluksen tunnus.

Valinnaiset parametrit parametrille model genpage list

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac model genpage list Esimerkkejä

Seuraavissa esimerkeissä näytetään yleisiä -komennon pac model genpage list käyttötapoja.

Luetteloi sivut sovellustunnuksella

Luettele kaikki luodut sivut Contoso Sales Hub - sovelluksessa sen sovellustunnuksella:

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

Luetteloi sivut sovelluksen nimen avulla

Luetteloi luodut sivut sovelluksen nimen mukaan (CLI hakee sovellustunnuksen automaattisesti):

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

pac model genpage-mallin tulos

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

Transpiloi TypeScript-tiedoston, jossa on ajonaikaiset tyypit testaukseen ja virheenkorjaukseen

Pakolliset parametrit parametrille model genpage transpile

--code-file

Sivukoodin sisältävän tiedoston polku.

Valinnaiset parametrit parametrille model genpage transpile

--data-sources

Pilkuin eroteltu luettelo käytettävistä tietolähteistä (esim. 'tili,liidi,yhteyshenkilö').

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--output-file

Polku, joka tallentaa muunnon JavaScript-tulosteen (oletusarvo on [code-file].compiled.js)

pac model genpage upload

Lataa ja julkaise luotu sivu mallipohjaiseen sovellukseen.

Pakolliset parametrit parametrille model genpage upload

--app-id

Mallipohjaisen sovelluksen tunnus.

--code-file

Sivukoodin sisältävän tiedoston polku.

Valinnaiset parametrit parametrille model genpage upload

--add-to-sitemap

Lisää sivu sovelluksen sivustokarttaan.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--agent-message

Agentin vastausviesti.

--agent-message-file

Polku tiedostoon, joka sisältää agentin vastausviestin.

--compiled-code-file

Polku tiedostoon, joka sisältää käännetyn JavaScript-koodin. Jos sitä ei anneta, TypeScript siirretään automaattisesti JavaScriptiin.

--data-sources

Pilkuin eroteltu luettelo käytettävistä tietolähteistä (esim. 'tili,liidi,yhteyshenkilö').

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--model

Sivun luomiseen käytetty tekoälymalli (esim. "claude-3-5-sonnet-20241022").

--name -n

Sivun nimi.

--page-id

Päivitettävän sivun tunnus. Jos sitä ei anneta, uusi sivu luodaan.

--prompt

Käyttäjäkehote, joka loi tämän sivun.

--prompt-file

Polku tiedostoon, joka sisältää tämän sivun luoneen käyttäjäkehotteen.

pac model genpage upload Esimerkkejä

Seuraavissa esimerkeissä näytetään yleisiä -komennon pac model genpage upload käyttötapoja.

Uuden muodostavan sivun julkaiseminen

Julkaise uusi sivu Contoson myyntikeskussovellukseen ja lisää se sovelluksen sivustokartteluun:

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

Päivitä olemassa oleva luotu sivu

Päivitä olemassa oleva muodostettu sivu antamalla sen sivutunnus (pois jätetty --add-to-sitemap , jotta vältyt luomasta sivustokartan päällekkäistä merkintää):

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

Mallitietoja käyttävän sivun julkaiseminen

Julkaise sivu, joka käyttää mallitietoja (ei Dataverse-taulukoita – jättää pois --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

--app-id Parametri hyväksyy joko sovelluksen GUID-tunnuksen tai näyttönimen. Jos useilla sovelluksilla on sama näyttönimi, vältä moniselitteisyyttä GUID-tunnuksen avulla. Etsi sovellustunnuksia suorittamalla pac model list .

pac model genpage upload parametrin pikaviittaus

Parameter Required Description
--app-id Yes Sovelluksen GUID-tunnus tai näyttönimi. Etsi se suorittamalla pac model list .
--code-file Yes Lähdetiedoston .tsx käyttöönottopolku.
--name Vain uudet sivut Sovelluksen sivustokartassa näkyvä näyttönimi.
--page-id Updates only Korvattavan sivun GUID-tunnus.
--data-sources Dataverse pages Pilkuin eroteltu Dataverse-taulukoiden loogisten nimien luettelo (esimerkiksi "account,contact").
--prompt Recommended Yhteenveto sivun käytöstä luonnollisella kielellä. Tallennetaan uudistamiskontekstia varten.
--model Recommended Sivun luonnissa käytettävä mallitunnus (esimerkiksi claude-sonnet-4-6).
--agent-message Recommended Kuvaus siitä, mitä on luotu tai muutettu. Tallennetaan muutoshistoriana.
--add-to-sitemap Vain uudet sivut Lisää sivun sovelluksen siirtymisruutuun automaattisesti. Poista päivitys.

pac model list

Listaa kaikki mallipohjaiset sovellukset ympäristössä.

Valinnaiset parametrit parametrille model list

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac model list -esimerkki

Luettele kaikki mallipohjaiset sovellukset aktiivisessa ympäristössä:

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

Listat sallivat kielet Dataverse-ympäristössä.

Valinnaiset parametrit parametrille model list-languages

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

pac model list-tables

Listaa Dataverse-taulukot yhdistetyssä ympäristössä.

Valinnaiset parametrit parametrille model list-tables

--environment -env

Määrittää Dataverse-kohdetaulukon. Arvo voi olla GUID-tunnus tai absoluuttinen https-URL-osoite. Kun tätä ei määritetä, käytetään aktiiviseen organisaatioon, joka on valittu nykyiseen todennusprofiiliin.

--search -s

Pilkkuilla erotettu lista etsittävistä nimistä (vastaa loogista nimeä, skeeman nimeä tai näyttönimeä).

--type -t

Suodata taulukkotyypin mukaan: 'custom', 'standard' tai 'all' (oletus: all).

See also

Microsoft Power Platform CLI-komentoryhmät
Microsoft Power Platform-komentorivikäyttöliittymän yleiskatsaus

  • Last updated on