pac model

Модельдік қосымшалармен жұмыс істеуге арналған командалар.

Commands

Command Description
pac model create Жаңа модельге негізделген қосымша жасайды.
pac model genpage download Модельге негізделген қосымшадан генерацияланған беттерді алыңыз.
pac model genpage generate-types Деректер көздері үшін TypeScript схемасының анықтамаларын жасайды
pac model genpage list Көрсетілген модельге негізделген қосымшадағы барлық генерацияланған беттерді тізімдейді.
pac model genpage transpile TypeScript файлын тестілеу және жөндеу үшін орындау кезеңінің типтерімен транспилейді
pac model genpage upload Генерацияланған бетті модельге негізделген қосымшаға жүктеп, жариялаңыз.
pac model list Қоршаған ортадағы барлық модельге негізделген қосымшаларды тізімдейді.
pac model list-languages Dataverse ортасында қосылған тілдерді тізімдейді.
pac model list-tables Dataverse кестелерін қосылған ортада тізімдеңіз.

pac model create

Жаңа модельге негізделген қосымша жасайды.

Қажетті параметрлер model create

--name -n

Жаңа модельге негізделген қосымшаның атауы.

Қосымша параметрлер model create

--description -d

Жаңа модельге негізделген қосымшаның сипаттамасы.

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--publish

Қосымшаны жасалғаннан кейін жариялаңыз.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--solution

Қосымшаны қосуға арналған бірегей атау. Әдепкі түрде белсенді шешімге көшеді.

pac model create Мысалдар

Төмендегі мысалдар команданы pac model create қолданудың кең таралған тәсілдерін көрсетеді.

Белсенді ортада жаңа модельге негізделген қосымшаны жасау

pac model create --name "Contoso Sales Hub"

Сипаттамасы бар қосымшаны жасап, шешімге қосып, бірден жариялаңыз

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

Арнайы ортада ортаның 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

Қосымшаның pac model list жасалғанын тексеру және басқа командалармен pac model genpage uploadқолдану үшін оның қосымша идентификаторын алу үшін пайдалану үшін пайдалану қажет.

pac model genpage download

Модельге негізделген қосымшадан генерацияланған беттерді алыңыз.

Қажетті параметрлер model genpage download

--app-id

Модельге негізделген қосымшаның ID-і.

Қосымша параметрлер model genpage download

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--output-directory -o

Өшірілген беттерді сақтау үшін директория. Әдепкі бойынша ағымдағы каталогқа орнатылады.

--page-id

Бет ID-лерін алу үшін үтірмен бөлінген тізім.

pac model genpage download Мысалдар

Төмендегі мысалдар команданы pac model genpage download қолданудың кең таралған тәсілдерін көрсетеді.

Бір генеративті бетті оның бет идентификаторы бойынша жергілікті қалтаға жүктеп, өңдеу үшін

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

Барлық генеративті беттерді қосымшадан бірден жүктеңіз

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

Бет идентификаторының атымен аталатын ішкі каталог жасап, келесі файлдарды жазыңыз

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

Деректер көздері үшін TypeScript схемасының анықтамаларын жасайды

Қажетті параметрлер model genpage generate-types

--data-sources

Қолданылатын деректер көздерінің үтірмен бөлінген тізімі (мысалы, 'аккаунт, lead, contact').

Қосымша параметрлер model genpage generate-types

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--output-file -o

Генерацияланған TypeScript схема файлын сақтау жолы (әдепкі RuntimeTypes.ts)

pac model genpage generate-types Мысалдар

Төмендегі мысалдар команданы pac model genpage generate-types қолданудың кең таралған тәсілдерін көрсетеді.

TypeScript түрлерін генерациялау

және кестелері accountcontact үшін TypeScript түрлерін жасап, оларды келесі түрге ./src/RuntimeTypes.tsжазыңыз:

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

Бір кестеге арналған типтерді нақты шығыс каталогына генерациялау

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

Note

Dataverse кестелерін сұрайтын бет кодын жазбас бұрын әрдайым іске қосыңыз generate-types . Жасалған файлда әр кестеге арналған қатты типтелген бағана атаулары, шетелдік кілт өрістері және enum мәндері бар. Генерацияланған типтерге сүйену қате жазылған немесе жоқ бағана атаулары туындайтын орындау кезінде қателіктердің алдын алады.

pac model genpage list

Көрсетілген модельге негізделген қосымшадағы барлық генерацияланған беттерді тізімдейді.

Қажетті параметрлер model genpage list

--app-id

Модельге негізделген қосымшаның ID-і.

Қосымша параметрлер model genpage list

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac model genpage list Мысалдар

Төмендегі мысалдар команданы pac model genpage list қолданудың кең таралған тәсілдерін көрсетеді.

Қосымша ID арқылы тізім беттері

Contoso Sales Hub қосымшасындағы барлық генеративті беттерді оның қосымша идентификаторы арқылы тізімдеңіз:

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

Қосымша атауын пайдаланатын тізім беттері

Генеративті беттерді қосымша атауы бойынша тізімдеңіз (CLI қосымша идентификаторын автоматты түрде анықтайды):

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

pac model genpage үлгілерінің шығуы

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

TypeScript файлын тестілеу және жөндеу үшін орындау кезеңінің типтерімен транспилейді

Қажетті параметрлер model genpage transpile

--code-file

Бет кодын қамтитын файлға жол.

Қосымша параметрлер model genpage transpile

--data-sources

Қолданылатын деректер көздерінің үтірмен бөлінген тізімі (мысалы, 'аккаунт, lead, contact').

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--output-file

Транспилленген JavaScript шығысын сақтау жолы (әдепкі [код-файл].compiled.js)

pac model genpage upload

Генерацияланған бетті модельге негізделген қосымшаға жүктеп, жариялаңыз.

Қажетті параметрлер model genpage upload

--app-id

Модельге негізделген қосымшаның ID-і.

--code-file

Бет кодын қамтитын файлға жол.

Қосымша параметрлер model genpage upload

--add-to-sitemap

Бұл бетті қосымшаның сайт картасына қосыңыз.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--agent-message

Агенттің жауап хабарламасы.

--agent-message-file

Агенттің жауап хабарламасы бар файлға жол.

--compiled-code-file

Компиляцияланған JavaScript кодын қамтитын файлға жол. Егер ол берілмесе, TypeScript автоматты түрде JavaScript-ке ауыстырылады.

--data-sources

Қолданылатын деректер көздерінің үтірмен бөлінген тізімі (мысалы, 'аккаунт, lead, contact').

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--model

Бетті генерациялау үшін қолданылатын AI моделі (мысалы, 'claude-3-5-sonnet-20241022').

--name -n

Беттің аты.

--page-id

Беттің ID-ін жаңартуға болады. Егер көрсетілмесе, жаңа бет ашылады.

--prompt

Бұл бетті жасаған пайдаланушы сұраны.

--prompt-file

Бұл бетті жасаған пайдаланушы сұрауын қамтитын файлға жол.

pac model genpage upload Мысалдар

Төмендегі мысалдар команданы pac model genpage upload қолданудың кең таралған тәсілдерін көрсетеді.

Жаңа генеративті бет жариялаңыз

Contoso Sales Hub қосымшасына жаңа генеративті бет жариялап, оны қосымшаның сайт картасына қосыңыз:

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

Бар генеративті бетті жаңарту

Бар генеративті бетті бет идентификаторын көрсету арқылы жаңартыңыз (сайт картасының қайталанатын жазбасын жасамау үшін алып тастаңыз --add-to-sitemap ):

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

Жалған деректерді пайдаланатын бетті жариялаңыз

Жалған деректерді қолданатын бетті жариялаңыз (Dataverse кестелері жоқ — алып тастаңыз --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 Параметр қосымшаның GUID-ін немесе оның көрсетілетін атауын қабылдайды. Егер бірнеше қосымша бірдей дисплей атауын бөліссе, түсініксіздікті болдырмау үшін GUID-ті қолданыңыз. Қосымша ID-лерін іздеуге жүгіріңіз pac model list .

pac model genpage upload Параметрлерге жылдам сілтеме

Parameter Required Description
--app-id Yes Қосымшаның GUID немесе көрсетілетін атауы. Оны іздеп жүгір pac model list .
--code-file Yes Бастапқы файлға .tsx жеткізу жолын орналастыру керек.
--name Тек жаңа беттер Қосымшадағы сайт картасында көрсетілген атау көрсетіледі.
--page-id Updates only Қолданыстағы беттің GUID-ін ауыстыру керек.
--data-sources Dataverse pages Dataverse кестесінің логикалық атауларының үтірмен бөлінген тізімі (мысалы, "account,contact").
--prompt Recommended Беттің табиғи тілдегі қысқаша мазмұны. Қалпына келтіру контексті үшін сақталған.
--model Recommended Бетті генерациялау үшін қолданылатын модель идентификаторы (мысалы, claude-sonnet-4-6).
--agent-message Recommended Не салынған немесе өзгертілгенінің сипаттамасы. Өзгеріс тарихы ретінде сақталған.
--add-to-sitemap Тек жаңа беттер Бұл бетті қосымша навигациясына автоматты түрде қосады. Жаңартқанда оны алып тастаңыз.

pac model list

Қоршаған ортадағы барлық модельге негізделген қосымшаларды тізімдейді.

Қосымша параметрлер model list

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac model list Мысал

Қазіргі белсенді ортадағы барлық модельдік қосымшаларды тізімдеңіз:

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

Dataverse ортасында қосылған тілдерді тізімдейді.

Қосымша параметрлер model list-languages

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac model list-tables

Dataverse кестелерін қосылған ортада тізімдеңіз.

Қосымша параметрлер model list-tables

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--search -s

Іздеу үшін үтірмен бөлінген есімдер тізімі (логикалық атау, схема аты немесе көрсетілім атауы сәйкес келеді).

--type -t

Кесте түрі бойынша сүзгіден өткізіңіз: 'custom', 'standard' немесе 'all' (әдепкі: бәрі).

See also

Microsoft Power Platform CLI командалық топтары
Microsoft Power Platform CLI шолуы