pac model

Model odaklı uygulamalarla çalışmak için komutlar.

Commands

Command Description
pac model create Yeni model odaklı bir uygulama oluşturuyor.
pac model genpage download Model odaklı bir uygulamadan oluşturulan sayfaları çekin.
pac model genpage generate-types Veri kaynakları için TypeScript şema tanımları oluşturur
pac model genpage list Belirlenen model odaklı uygulamada oluşturulan tüm sayfaları listeler.
pac model genpage transpile Test ve hata ayıklama için çalışma zamanı tipleriyle bir TypeScript dosyası aktarır
pac model genpage upload Oluşturulmuş bir sayfayı model odaklı bir uygulamaya yükleyip yayınlayın.
pac model list Ortamdaki tüm model tabanlı uygulamaları listeler.
pac model list-languages Listler, Dataverse ortamında dilleri etkinleştirdi.
pac model list-tables Bağlı ortamda Dataverse tablolarını listeleyin.

pac model create

Yeni model odaklı bir uygulama oluşturuyor.

Için Gerekli Parametreler model create

--name -n

Yeni model temelli uygulamanın görünen adı.

için İsteğe Bağlı Parametreler model create

--description -d

Yeni model temelli uygulamanın açıklaması.

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--publish

Oluşturma işleminden sonra uygulamayı yayımlayın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--solution

Uygulamayı eklemek için çözüm benzersiz adı. Varsayılan olarak etkin çözümü kullanır.

pac model create örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model create .

Etkin ortamda model temelli yeni bir uygulama oluşturma

pac model create --name "Contoso Sales Hub"

Açıklama içeren bir uygulama oluşturun ve bir çözüme ekleyin, ardından hemen yayımlayın

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

Ortam URL'sini sağlayarak belirli bir ortamda uygulama oluşturma

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

Uygulamanın oluşturulduğunu doğrulamak ve gibi pac model listdiğer komutlarla kullanmak üzere uygulama kimliğini almak için kullanınpac model genpage upload.

pac model genpage download

Model odaklı bir uygulamadan oluşturulan sayfaları çekin.

Için Gerekli Parametreler model genpage download

--app-id

Model temelli uygulamanın kimliği.

için İsteğe Bağlı Parametreler model genpage download

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--output-directory -o

Çekilen sayfaları kaydetmek için dizin. Varsayılan olarak geçerli dizine geçer.

--page-id

Çekecek sayfa kimliklerinin virgülle ayrılmış listesi.

pac model genpage download örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage download .

Sayfa kimliğine göre tek bir üretken sayfayı düzenlemek üzere yerel bir klasöre indirme

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

Bir uygulamadaki tüm üretken sayfaları aynı anda indirme

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

Sayfa kimliğinden sonra adlı bir alt dizin oluşturun ve aşağıdaki dosyaları yazar

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

Veri kaynakları için TypeScript şema tanımları oluşturur

Için Gerekli Parametreler model genpage generate-types

--data-sources

Kullanılan veri kaynaklarının virgülle ayrılmış listesi (örneğin, 'hesap,müşteri adayı,ilgili kişi').

için İsteğe Bağlı Parametreler model genpage generate-types

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--output-file -o

Oluşturulan TypeScript şema dosyasını kaydetme yolu (varsayılan olarak RuntimeTypes.ts)

pac model genpage generate-types örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage generate-types .

TypeScript türleri oluşturma

ve account tabloları için contact TypeScript türleri oluşturup yazın./src/RuntimeTypes.ts:

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

Belirli bir çıkış dizininde tek bir tablo için türler oluşturma

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

Note

Dataverse tablolarını sorgulayan sayfa kodu yazmadan önce her zaman çalıştırın generate-types . Oluşturulan dosya, her tablo için kesin olarak yazılmış sütun adları, yabancı anahtar alanları ve sabit listesi değerleri içerir. Oluşturulan türlere güvenmek, yanlış yazılmış veya varolmayan sütun adlarının neden olduğu çalışma zamanı hatalarını önler.

pac model genpage list

Belirlenen model odaklı uygulamada oluşturulan tüm sayfaları listeler.

Için Gerekli Parametreler model genpage list

--app-id

Model temelli uygulamanın kimliği.

için İsteğe Bağlı Parametreler model genpage list

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac model genpage list örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage list .

Uygulama kimliğini kullanarak sayfaları listeleme

Contoso Sales Hub uygulamasındaki tüm üretken sayfaları uygulama kimliğini kullanarak listeleyin:

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

Uygulama adını kullanarak sayfaları listeleme

Oluşturan sayfaları uygulama adına göre listeleyin (CLI, uygulama kimliğini otomatik olarak arar):

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

pac model genpage örnek çıktısı

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

Test ve hata ayıklama için çalışma zamanı tipleriyle bir TypeScript dosyası aktarır

Için Gerekli Parametreler model genpage transpile

--code-file

Sayfa kodunu içeren dosyanın yolu.

için İsteğe Bağlı Parametreler model genpage transpile

--data-sources

Kullanılan veri kaynaklarının virgülle ayrılmış listesi (örneğin, 'hesap,müşteri adayı,ilgili kişi').

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--output-file

Çevrilmiş JavaScript çıkışını kaydetme yolu (varsayılan olarak [code-file].compiled.js)

pac model genpage upload

Oluşturulmuş bir sayfayı model odaklı bir uygulamaya yükleyip yayınlayın.

Için Gerekli Parametreler model genpage upload

--app-id

Model temelli uygulamanın kimliği.

--code-file

Sayfa kodunu içeren dosyanın yolu.

için İsteğe Bağlı Parametreler model genpage upload

--add-to-sitemap

Sayfayı uygulamanın site haritası gezintisine ekleyin.

Bu parametre için değer gerekmez. Bu bir anahtar.

--agent-message

Aracının yanıt iletisi.

--agent-message-file

Aracının yanıt iletisini içeren dosyanın yolu.

--compiled-code-file

Derlenmiş JavaScript kodunu içeren dosyanın yolu. Sağlanmazsa, TypeScript otomatik olarak JavaScript'e çevrilir.

--data-sources

Kullanılan veri kaynaklarının virgülle ayrılmış listesi (örneğin, 'hesap,müşteri adayı,ilgili kişi').

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--model

Sayfayı oluşturmak için kullanılan yapay zeka modeli (örneğin, 'claude-3-5-sonnet-20241022').

--name -n

Sayfanın adı.

--page-id

Güncelleştirilecek sayfanın kimliği. Sağlanmazsa yeni bir sayfa oluşturulur.

--prompt

Bu sayfayı oluşturan kullanıcı istemi.

--prompt-file

Bu sayfayı oluşturan kullanıcı istemini içeren dosyanın yolu.

pac model genpage upload örnekleri

Aşağıdaki örneklerde komutunu kullanmanın yaygın yolları gösterilmektedir pac model genpage upload .

Yeni bir üretken sayfa yayımlama

Contoso Sales Hub uygulamasında yeni bir üretken sayfa yayımlayın ve bunu uygulama site haritasına ekleyin:

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

Var olan bir üretken sayfayı güncelleştirme

Var olan bir üretken sayfayı, sayfa kimliğini sağlayarak güncelleştirin (yinelenen site haritası girdisi oluşturmaktan kaçınmak için atla --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."

Sahte veri kullanan bir sayfa yayımlama

Sahte veri kullanan bir sayfa yayımlama (Dataverse tablosu yok — atlayın --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 parametresi, uygulamanın GUID'sini veya görünen adını kabul eder. Birden çok uygulama aynı görünen adı paylaşıyorsa, belirsizliği önlemek için GUID'yi kullanın. Uygulama kimliklerini aramak için komutunu çalıştırın pac model list .

pac model genpage upload parametre hızlı başvurusu

Parameter Required Description
--app-id Yes Uygulama GUID'i veya görünen ad. Bulmak için çalıştırın pac model list .
--code-file Yes Dağıtılacak .tsx kaynak dosyanın yolu.
--name Yalnızca yeni sayfalar Uygulama site haritasında gösterilen görünen ad.
--page-id Updates only Değiştirilmek üzere var olan sayfanın GUID'i.
--data-sources Dataverse pages Dataverse tablosu mantıksal adlarının virgülle ayrılmış listesi (örneğin, "account,contact").
--prompt Recommended Sayfanın ne yaptığının doğal dil özeti. Yeniden oluşturma bağlamı için depolanır.
--model Recommended Sayfayı oluşturmak için kullanılan model kimliği (örneğin, claude-sonnet-4-6).
--agent-message Recommended Oluşturulan veya değiştirilenlerin açıklaması. Değişiklik geçmişi olarak depolanır.
--add-to-sitemap Yalnızca yeni sayfalar Sayfayı uygulama gezintisine otomatik olarak ekler. Güncelleştirme sırasında atla.

pac model list

Ortamdaki tüm model tabanlı uygulamaları listeler.

için İsteğe Bağlı Parametreler model list

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac model list örneği

Şu anda etkin olan ortamdaki tüm model temelli uygulamaları listeleyin:

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

Listler, Dataverse ortamında dilleri etkinleştirdi.

için İsteğe Bağlı Parametreler model list-languages

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

pac model list-tables

Bağlı ortamda Dataverse tablolarını listeleyin.

için İsteğe Bağlı Parametreler model list-tables

--environment -env

Hedef Dataverse'i belirtir. Değer guid veya mutlak https URL'si olabilir. Belirtilmediğinde, geçerli kimlik doğrulama profili için seçilen etkin kuruluş kullanılır.

--search -s

Virgülle ayrılmış aranan isim listesi (mantıksal isim, şema adı veya gösterim adı ile eşleşir).

--type -t

Tablo tipine göre filtreleyin: 'custom', 'standard' veya 'all' (varsayılan: all).

See also

Microsoft Power Platform CLI Komut Grupları
Microsoft Power Platform CLI'ya genel bakış