Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
(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ä
- Luo sovellus, jossa on kuvaus ja lisää se ratkaisuun, ja julkaise heti
- Luo sovellus tietyssä ympäristössä antamalla ympäristön URL-osoite
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
- Lataa kaikki sovelluksen sivut kerralla
- Luo alihakemisto, joka on nimetty sivutunnuksen mukaan, ja kirjoita seuraavat tiedostot
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
- Päivitä olemassa oleva luotu sivu
- Mallitietoja käyttävän sivun julkaiseminen
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