pac model

Komennot mallipohjaisten sovellusten kanssa työskentelyyn.

Komennot

Komento Description
pac model create Luo uuden mallipohjaisen sovelluksen.
pac model genpage add Liitä vähintään yksi olemassa oleva luotu sivu mallipohjaisen sovelluksen sivustokarttaan (ei lataa uudelleen). Käytä merkkiä "pac model genpage upload" itse sivun luomiseen tai päivittämiseen. Käytä tätä verbiä, jotta jo ladattu sivu näkyy toisessa sovelluksessa.
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 Luetteloi luodut sivut – oletusarvoisesti env-wide tai yksi sovellus, kun --app-id on annettu. Välitä – sisällytä julkaisematon – myös luonnossivujen luetteloon.
pac model genpage remove Irrota olemassa olevat luodut tekoälysivut mallipohjaisen sovelluksen sivustokartasta. Dataversen sivurivi säilytetään (siihen voidaan edelleen viitata muista sovelluksista).
pac model genpage transpile Transpiloi TypeScript-tiedoston, jossa on ajonaikaiset tyypit testaukseen ja virheenkorjaukseen
pac model genpage upload Lataa luotu sivu Dataverseen ja julkaise se. Luo uuden sivun, kun --page-id jätetään pois päivittää olemassa olevan sivun, kun --page-id on annettu. Jos haluat liittää ympäristössä jo olevan sivun toisen sovelluksen sivustokarttaan lataamatta sitä uudelleen, käytä sen sijaan -arvoapac model genpage add.
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. Oletusarvona on "Oletus", jos sitä ei ole määritetty.

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 add

Liitä vähintään yksi olemassa oleva luotu sivu mallipohjaisen sovelluksen sivustokarttaan (ei lataa uudelleen). Käytä merkkiä "pac model genpage upload" itse sivun luomiseen tai päivittämiseen. Käytä tätä verbiä, jotta jo ladattu sivu näkyy toisessa sovelluksessa.

Pakolliset parametrit parametrille model genpage add

--page-id

Pilkuin eroteltuja sivutunnuksia (GUID), jotka lisätään sovellukseen.

Valinnaiset parametrit parametrille model genpage add

--app-id

Mallipohjaisen sovelluksen TUNNUS (GUID). Toisensa poissulkeva --app-name kanssa.

--app-name

Mallipohjaisen sovelluksen yksilöivä nimi. Toisensa poissulkeva --app-id:n kanssa.

--area

Valinnainen aluetunnus sivustokartassa, johon sivu sijoitat. Oletusarvo on ensimmäinen alue.

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

--group

Valinnainen ryhmätunnus sivustokartassa, johon sivu sijoitat. Oletusarvona on valitun alueen ensimmäinen ryhmä.

--language-code

Alialueen otsikon kielikoodi (LCID). Oletusarvo on 1033 (en-US).

--publish

Julkaise mallipohjainen sovellus sivun tai sivujen lisäämisen jälkeen.

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

--solution

Sivustokartan päivityksen Dataverse-ratkaisukontekstin yksilöivä nimi. Oletusarvo on "Oletus".

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

Luetteloi luodut sivut – oletusarvoisesti env-wide tai yksi sovellus, kun --app-id on annettu. Välitä – sisällytä julkaisematon – myös luonnossivujen luetteloon.

Valinnaiset parametrit parametrille model genpage list

--app-id

Mallipohjaisen sovelluksen tunnus.

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

--include-unpublished

Sisällytä julkaisemattomat luodut sivut luetteloon (oletusarvo: vain julkaistu).

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

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 remove

Irrota olemassa olevat luodut tekoälysivut mallipohjaisen sovelluksen sivustokartasta. Dataversen sivurivi säilytetään (siihen voidaan edelleen viitata muista sovelluksista).

Pakolliset parametrit parametrille model genpage remove

--page-id

Vähintään yksi poistettava uxagentproject-tunnus (pilkuin eroteltuna).

Valinnaiset parametrit parametrille model genpage remove

--app-id

Mallipohjaisen sovelluksen tunnus (uniqueid), josta sivut poistetaan. Toisensa poissulkeva --app-name kanssa.

--app-name

Mallipohjaisen sovelluksen yksilöivä nimi, josta sivut poistetaan. Toisensa poissulkeva --app-id:n kanssa.

--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 mallipohjainen sovellus sivustokartan muokkaamisen jälkeen, jotta muutokset julkaistaan heti.

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

--solution

Dataverse-ratkaisun sivustokartan päivityksen yksilöivä nimi. Oletusarvo on "Oletus".

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 luotu sivu Dataverseen ja julkaise se. Luo uuden sivun, kun --page-id jätetään pois päivittää olemassa olevan sivun, kun --page-id on annettu. Jos haluat liittää ympäristössä jo olevan sivun toisen sovelluksen sivustokarttaan lataamatta sitä uudelleen, käytä sen sijaan nimeä 'pac model genpage add.

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

Parametri Pakollinen 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 Vain päivitykset Korvattavan sivun GUID-tunnus.
--data-sources Dataverse-sivut Pilkuin eroteltu Dataverse-taulukoiden loogisten nimien luettelo (esimerkiksi "account,contact").
--prompt Suositellut Yhteenveto sivun käytöstä luonnollisella kielellä. Tallennetaan uudistamiskontekstia varten.
--model Suositellut Sivun luonnissa käytettävä mallitunnus (esimerkiksi claude-sonnet-4-6).
--agent-message Suositellut 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

Mallitulos:

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

Katso myös

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

  • Last updated on