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

ヒント

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 つの生成ページを編集用のローカル フォルダーにダウンロードする

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

注

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

ヒント

--app-id パラメーターは、アプリの GUID またはその表示名を受け取ります。 複数のアプリが同じ表示名を共有する場合は、あいまいさを避けるために GUID を使用します。 pac model listを実行してアプリ ID を検索します。

pac model genpage upload パラメーターのクイック リファレンス

パラメーター 必須 Description
--app-id はい アプリ GUID または表示名。 pac model listを実行して検索します。
--code-file はい デプロイする .tsx ソース ファイルへのパス。
--name 新しいページのみ アプリサイトマップに表示される表示名。
--page-id 更新のみ 置き換える既存のページの GUID。
--data-sources Dataverse ページ Dataverse テーブルの論理名のコンマ区切りのリスト (たとえば、 "account,contact")。
--prompt 推奨 ページの動作の自然言語の概要。 再生成コンテキスト用に格納されます。
--model 推奨 ページの生成に使用されるモデル ID (たとえば、 claude-sonnet-4-6)。
--agent-message 推奨 ビルドまたは変更された内容の説明。 変更履歴として格納されます。
--add-to-sitemap 新しいページのみ ページをアプリのナビゲーションに自動的に追加します。 更新時に省略します。

pac model list

(プレビュー)環境内のすべてのモデル駆動型アプリを一覧表示します。

の省略可能なパラメーター model list

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

pac model list の例

現在アクティブな環境内のすべてのモデル駆動型アプリを一覧表示します。

pac model list

サンプル出力:

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 にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

こちらも参照ください

Microsoft Power Platform CLI コマンド グループ
Microsoft Power PlatformCLI 概要

  • Last updated on