モデル駆動型アプリを扱うためのコマンド。
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
ターゲット Dataverse を指定します。 値は、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などの他のコマンドで使用するアプリ ID を取得します。
pac model genpage download
モデル駆動型アプリから生成されたページを引き出します。
に必要なパラメーター model genpage download
--app-id
モデル駆動型アプリの ID。
の省略可能なパラメーター model genpage download
--environment
-env
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
--output-directory
-o
プルされたページを保存するディレクトリ。 既定値は現在のディレクトリです。
--page-id
プルするページ ID のコンマ区切りの一覧。
pac model genpage download の例
次の例は、 pac model genpage download コマンドを使用する一般的な方法を示しています。
- ページ ID で 1 つの生成ページを編集用のローカル フォルダーにダウンロードする
- アプリ内のすべての生成ページを一度にダウンロードする
- ページ ID にちなんだサブディレクトリを作成し、次のファイルを書き込みます。
ページ ID で 1 つの生成ページを編集用のローカル フォルダーにダウンロードする
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
ページ ID にちなんだサブディレクトリを作成し、次のファイルを書き込みます。
./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
使用されるデータ ソースのコンマ区切りの一覧 (例: "アカウント、潜在顧客、連絡先")。
の省略可能なパラメーター model genpage generate-types
--environment
-env
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
--output-file
-o
生成された TypeScript スキーマ ファイルを保存するパス (既定値は RuntimeTypes.ts)
pac model genpage generate-types の例
次の例は、 pac model genpage generate-types コマンドを使用する一般的な方法を示しています。
TypeScript 型を生成する
accountテーブルとcontact テーブルの TypeScript 型を生成し、./src/RuntimeTypes.tsに書き込みます。
pac model genpage generate-types \
--data-sources "account,contact" \
--output-file ./src/RuntimeTypes.ts
1 つのテーブルの型を特定の出力ディレクトリに生成する
pac model genpage generate-types \
--data-sources "opportunity" \
--output-file ./pages/opportunity/RuntimeTypes.ts
Note
Dataverse テーブルにクエリを実行するページ コードを記述する前に、常に generate-types 実行してください。
生成されたファイルには、厳密に型指定された列名、外部キー フィールド、および各テーブルの列挙値が含まれています。 生成された型に依存すると、スペルミスまたは存在しない列名が原因で発生するランタイム エラーを防ぐことができます。
pac model genpage list
指定されたモデル駆動アプリで生成されたすべてのページを一覧にします。
に必要なパラメーター model genpage list
--app-id
モデル駆動型アプリの ID。
の省略可能なパラメーター model genpage list
--environment
-env
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
pac model genpage list の例
次の例は、 pac model genpage list コマンドを使用する一般的な方法を示しています。
アプリ ID を使用してページを一覧表示する
Contoso Sales Hub アプリ内のすべての生成ページを、そのアプリ ID を使用して一覧表示します。
pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"
アプリ名を使用してページを一覧表示する
生成ページをアプリ名で一覧表示します (CLI はアプリ ID を自動的に検索します)。
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
使用されるデータ ソースのコンマ区切りの一覧 (例: "アカウント、潜在顧客、連絡先")。
--environment
-env
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
--output-file
トランスパイルされた JavaScript 出力を保存するパス (既定値は [code-file].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
使用されるデータ ソースのコンマ区切りの一覧 (例: "アカウント、潜在顧客、連絡先")。
--environment
-env
ターゲット Dataverse を指定します。 値は、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
既存の生成ページを更新する
ページ ID を指定して既存の生成ページを更新します (サイトマップ エントリが重複しないように --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 を使用します。
pac model listを実行してアプリ ID を検索します。
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 | ページの生成に使用されるモデル ID (たとえば、 claude-sonnet-4-6)。 |
--agent-message |
Recommended | ビルドまたは変更された内容の説明。 変更履歴として格納されます。 |
--add-to-sitemap |
新しいページのみ | ページをアプリのナビゲーションに自動的に追加します。 更新時に省略します。 |
pac model list
環境内のすべてのモデル駆動アプリを一覧にしています。
の省略可能なパラメーター model list
--environment
-env
ターゲット Dataverse を指定します。 値は、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
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
pac model list-tables
接続環境にDataverseテーブルをリストします。
の省略可能なパラメーター model list-tables
--environment
-env
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
--search
-s
検索名のカンマ区切りリスト(論理名、スキーマ名、表示名と一致するもの)。
--type
-t
テーブルタイプ別フィルター:『custom』『standard』『all』(デフォルト:all)。
See also
Microsoft Power Platform CLI コマンド グループ
Microsoft Power Platform CLIの概要