Jaa


pac model

(esikatselu) Komentoja mallipohjaisten sovellusten kanssa työskentelyä varten.

Komennot

Komento Description
pac model create (esikatselu) Luo uuden mallipohjaisen sovelluksen.
pac model genpage download (esikatselu) Hae luodut sivut mallipohjaisesta sovelluksesta.
pac model genpage generate-types (esikatselu) Luo TypeScript-rakennemääritykset tietolähteille
pac model genpage list (esikatselu) Näyttää luettelon kaikista määritetyn mallipohjaisen sovelluksen luoduista sivuista.
pac model genpage transpile (esikatselu) Transpiloa TypeScript-tiedoston runtime-tyypeillä testausta ja virheenkorjausta varten
pac model genpage upload (esikatselu) Lataa ja julkaise luotu sivu mallipohjaiseen sovellukseen.
pac model list (esikatselu) Näyttää luettelon kaikista ympäristön mallipohjaista sovelluksista.
pac model list-languages (esikatselu) Näyttää luettelon käytössä olevista kielistä Dataverse-ympäristössä.

pac model create

(esikatselu) 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

Vinkki

: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

(esikatselu) Hae 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

(esikatselu) Luo TypeScript-rakennemääritykset 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

Muistio

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

(esikatselu) Näyttää luettelon kaikista määritetyn mallipohjaisen sovelluksen luoduista sivuista.

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

(esikatselu) Transpiloa TypeScript-tiedoston runtime-tyypeillä testausta ja virheenkorjausta varten

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

(esikatselu) 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

Vinkki

--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 Kyllä Sovelluksen GUID-tunnus tai näyttönimi. Etsi se suorittamalla pac model list .
--code-file Kyllä 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

(esikatselu) Näyttää luettelon kaikista ympäristön mallipohjaista sovelluksista.

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

(esikatselu) Näyttää luettelon käytössä olevista kielistä 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.

Katso myös

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