pac model

Các lệnh để làm việc với các ứng dụng dựa trên mô hình.

Commands

Command	Description
pac model create	Tạo một ứng dụng dựa trên mô hình mới.
pac model genpage download	Lấy các trang được tạo từ ứng dụng dựa trên mô hình.
pac model genpage generate-types	Tạo định nghĩa lược đồ TypeScript cho nguồn dữ liệu
pac model genpage list	Liệt kê tất cả các trang được tạo trong ứng dụng dựa trên mô hình được chỉ định.
pac model genpage transpile	Chuyển tệp TypeScript với các loại thời gian chạy để kiểm tra và gỡ lỗi
pac model genpage upload	Tải lên và xuất bản trang đã tạo lên ứng dụng dựa trên mô hình.
pac model list	Liệt kê tất cả các ứng dụng dựa trên mô hình trong môi trường.
pac model list-languages	Liệt kê các ngôn ngữ được bật trong môi trường Dataverse.
pac model list-tables	Liệt kê các bảng Dataverse trong môi trường được kết nối.

pac model create

Tạo một ứng dụng dựa trên mô hình mới.

Tham số Bắt buộc cho model create

--name -n

Tên hiển thị cho ứng dụng dựa trên mô hình mới.

Tham số Tùy chọn cho model create

--description -d

Mô tả cho ứng dụng dựa trên mô hình mới.

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--publish

Phát hành ứng dụng sau khi tạo.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--solution

Giải pháp tên duy nhất để thêm ứng dụng vào. Mặc định cho giải pháp hiện hoạt.

pac model create Ví dụ

Các ví dụ sau đây cho thấy các cách sử dụng lệnh phổ pac model create biến.

• Tạo ứng dụng dựa trên mô hình mới trong môi trường hiện hoạt
• Tạo ứng dụng có mô tả và thêm ứng dụng đó vào giải pháp, sau đó phát hành ngay lập tức
• Tạo ứng dụng trong một môi trường cụ thể bằng cách cung cấp URL môi trường

Tạo ứng dụng dựa trên mô hình mới trong môi trường hiện hoạt

pac model create --name "Contoso Sales Hub"

Tạo ứng dụng có mô tả và thêm ứng dụng đó vào giải pháp, sau đó phát hành ngay lập tức

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

Tạo ứng dụng trong một môi trường cụ thể bằng cách cung cấp URL môi trường

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

Sử dụng pac model list để xác minh ứng dụng đã được tạo và truy xuất ID ứng dụng để sử dụng với các lệnh khác như pac model genpage upload.

pac model genpage download

Lấy các trang được tạo từ ứng dụng dựa trên mô hình.

Tham số Bắt buộc cho model genpage download

--app-id

ID của ứng dụng dựa trên mô hình.

Tham số Tùy chọn cho model genpage download

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--output-directory -o

Thư mục để lưu các trang đã kéo. Mặc định cho thư mục hiện tại.

--page-id

Để kéo danh sách ID trang được phân tách bằng dấu phẩy.

pac model genpage download Ví dụ

Các ví dụ sau đây cho thấy các cách sử dụng lệnh phổ pac model genpage download biến.

• Tải xuống một trang tạo bằng ID trang vào thư mục cục bộ để chỉnh sửa
• Tải xuống tất cả các trang đang tạo trong một ứng dụng cùng một lúc
• Tạo thư mục con có tên theo ID trang và ghi các tệp sau

Tải xuống một trang tạo bằng ID trang vào thư mục cục bộ để chỉnh sửa

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

Tải xuống tất cả các trang đang tạo trong một ứng dụng cùng một lúc

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

Tạo thư mục con có tên theo ID trang và ghi các tệp sau

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

Tạo định nghĩa lược đồ TypeScript cho nguồn dữ liệu

Tham số Bắt buộc cho model genpage generate-types

--data-sources

Danh sách nguồn dữ liệu được phân tách bằng dấu phẩy được sử dụng (ví dụ: 'tài khoản,đầu mối,liên hệ').

Tham số Tùy chọn cho model genpage generate-types

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--output-file -o

Đường dẫn để lưu tệp sơ đồ TypeScript đã tạo (mặc định là RuntimeTypes.ts)

pac model genpage generate-types Ví dụ

Các ví dụ sau đây cho thấy các cách sử dụng lệnh phổ pac model genpage generate-types biến.

• Tạo loại TypeScript
• Tạo các loại cho một bảng đơn vào một thư mục đầu ra cụ thể

Tạo loại TypeScript

Tạo loại TypeScript cho các account bảng contact và ghi chúng vào ./src/RuntimeTypes.ts:

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

Tạo các loại cho một bảng đơn vào một thư mục đầu ra cụ thể

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

Note

Luôn chạy trước generate-types khi viết mã trang truy vấn bảng Dataverse. Tệp được tạo có chứa tên cột kiểu mạnh, trường khóa ngoại và giá trị liệt kê cho mỗi bảng. Dựa vào các kiểu đã tạo sẽ ngăn lỗi thời gian chạy do tên cột viết sai chính tả hoặc không tồn tại gây ra.

pac model genpage list

Liệt kê tất cả các trang được tạo trong ứng dụng dựa trên mô hình được chỉ định.

Tham số Bắt buộc cho model genpage list

--app-id

ID của ứng dụng dựa trên mô hình.

Tham số Tùy chọn cho model genpage list

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac model genpage list Ví dụ

Các ví dụ sau đây cho thấy các cách sử dụng lệnh phổ pac model genpage list biến.

• Trang danh sách sử dụng ID ứng dụng
• Liệt kê các trang bằng tên ứng dụng

Trang danh sách sử dụng ID ứng dụng

Liệt kê tất cả các trang đang tạo trong ứng dụng Hub Bán hàng Contoso bằng ID ứng dụng:

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

Liệt kê các trang bằng tên ứng dụng

Liệt kê các trang tạo theo tên ứng dụng (CLI tự động tra cứu ID ứng dụng):

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

pac model đầu ra mẫu 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

Chuyển tệp TypeScript với các loại thời gian chạy để kiểm tra và gỡ lỗi

Tham số Bắt buộc cho model genpage transpile

--code-file

Đường dẫn đến tệp chứa mã trang.

Tham số Tùy chọn cho model genpage transpile

--data-sources

Danh sách nguồn dữ liệu được phân tách bằng dấu phẩy được sử dụng (ví dụ: 'tài khoản,đầu mối,liên hệ').

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--output-file

Đường dẫn để lưu đầu ra JavaScript được hoán đổi (mặc định thành [code-file].compiled.js)

pac model genpage upload

Tải lên và xuất bản trang đã tạo lên ứng dụng dựa trên mô hình.

Tham số Bắt buộc cho model genpage upload

--app-id

ID của ứng dụng dựa trên mô hình.

--code-file

Đường dẫn đến tệp chứa mã trang.

Tham số Tùy chọn cho model genpage upload

--add-to-sitemap

Thêm trang vào dẫn hướng sơ đồ trang của ứng dụng.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--agent-message

Tin nhắn trả lời của nhân viên hỗ trợ.

--agent-message-file

Đường dẫn đến tệp chứa thư phản hồi của đại diện.

--compiled-code-file

Đường dẫn đến tệp chứa mã JavaScript đã biên dịch. Nếu không được cung cấp, TypeScript sẽ được tự động chuyển đổi sang JavaScript.

--data-sources

Danh sách nguồn dữ liệu được phân tách bằng dấu phẩy được sử dụng (ví dụ: 'tài khoản,đầu mối,liên hệ').

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--model

Mô hình AI được sử dụng để tạo trang (ví dụ: 'claude-3-5-sonnet-20241022').

--name -n

Tên của trang.

--page-id

ID của trang cần cập nhật. Nếu không được cung cấp, một trang mới sẽ được tạo.

--prompt

Lời nhắc người dùng đã tạo trang này.

--prompt-file

Đường dẫn đến tệp chứa lời nhắc người dùng đã tạo trang này.

pac model genpage upload Ví dụ

Các ví dụ sau đây cho thấy các cách sử dụng lệnh phổ pac model genpage upload biến.

• Phát hành trang tạo mới
• Cập nhật trang tạo hiện có
• Phát hành trang sử dụng dữ liệu giả

Phát hành trang tạo mới

Phát hành trang tạo mới vào ứng dụng Hub Bán hàng Contoso và thêm trang đó vào sơ đồ trang web ứng dụng:

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

Cập nhật trang tạo hiện có

Cập nhật trang tạo hiện có bằng cách cung cấp ID trang của nó (bỏ --add-to-sitemap qua để tránh tạo mục nhập sơ đồ trang trùng lặp):

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

Phát hành trang sử dụng dữ liệu giả

Phát hành trang sử dụng dữ liệu giả (không có bảng Dataverse — bỏ qua --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

Tham --app-id số chấp nhận GUID của ứng dụng hoặc tên hiển thị của nó. Nếu nhiều ứng dụng có cùng tên hiển thị, hãy sử dụng GUID để tránh sự mơ hồ. Chạy pac model list để tra cứu ID ứng dụng.

pac model genpage upload tham chiếu nhanh tham số

Parameter	Required	Description
--app-id	Yes	GUID ứng dụng hoặc tên hiển thị. Chạy pac model list để tìm nó.
--code-file	Yes	Đường dẫn đến tệp .tsx nguồn cần triển khai.
--name	Chỉ trang mới	Tên hiển thị được hiển thị trong sơ đồ trang ứng dụng.
--page-id	Updates only	GUID của trang hiện có cần thay thế.
--data-sources	Dataverse pages	Danh sách các tên lô-gic bảng Dataverse được phân tách bằng dấu phẩy (ví dụ: "account,contact").
--prompt	Recommended	Tóm tắt ngôn ngữ tự nhiên về chức năng của trang. Được lưu trữ cho ngữ cảnh tái sinh.
--model	Recommended	ID mô hình được sử dụng để tạo trang (ví dụ: claude-sonnet-4-6).
--agent-message	Recommended	Mô tả về những gì đã được xây dựng hoặc thay đổi. Được lưu trữ dưới dạng lịch sử thay đổi.
--add-to-sitemap	Chỉ trang mới	Tự động thêm trang vào dẫn hướng ứng dụng. Bỏ qua khi cập nhật.

pac model list

Liệt kê tất cả các ứng dụng dựa trên mô hình trong môi trường.

Tham số Tùy chọn cho model list

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac model list Ví dụ

Liệt kê tất cả các ứng dụng dựa trên mô hình trong môi trường hiện hoạt:

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

Liệt kê các ngôn ngữ được bật trong môi trường Dataverse.

Tham số Tùy chọn cho model list-languages

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac model list-tables

Liệt kê các bảng Dataverse trong môi trường được kết nối.

Tham số Tùy chọn cho model list-tables

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--search -s

Danh sách tên được phân tách bằng dấu phẩy để tìm kiếm (khớp với tên logic, tên lược đồ hoặc tên hiển thị).

--type -t

Lọc theo loại bảng: "tùy chỉnh", "chuẩn" hoặc "tất cả" (mặc định: tất cả).

See also

Microsoft Power Platform lệnh CLI
Microsoft Power Platform tổng quan về CLI