Hướng dẫn: Sử dụng Microsoft Power Platform CLI với Power Pages

Trong hướng dẫn này, bạn sẽ học cách bắt đầu sử dụng Microsoft Power Platform CLI để cập nhật cấu hình của một trang web mẫu.

Lưu ý

• Hướng dẫn này tập trung vào các lệnh Microsoft Power Platform CLI cần thiết để sử dụng Power Pages. Để biết thêm thông tin về các lệnh dùng trong Power Platform CLI, hãy đọc phần Các lệnh phổ biến.
• Bắt đầu từ phiên bản CLI 1.27, lệnh được thay đổi thành Power Platform . pac paportalpac pages paportal vẫn tiếp tục hoạt động, nhưng chúng tôi khuyên bạn nên sử dụng powerpages từ bây giờ.

Tải xuống và cài đặt Visual Studio Code

Để kết nối với cổng thông tin Power Apps và sử dụng các lệnh Microsoft Power Platform CLI, hãy dùng Visual Studio Code và cửa sổ dòng lệnh tích hợp. Thiết bị đầu cuối tích hợp giúp dễ dàng kết nối với môi trường Dataverse và để tải xuống, thay đổi và tải lên cấu hình cổng thông tin. Bạn cũng có thể sử dụng Windows PowerShell.

Bước 1. Xác thực

Trước khi kết nối, liệt kê, tải xuống hoặc tải lên bất kỳ thay đổi nào cho cổng thông tin Power Apps, bạn phải xác thực với môi trường Dataverse trước tiên. Để biết thêm thông tin về cách xác thực bằng Microsoft Power Platform CLI, hãy đi tới phần pac auth.

Để xác thực, hãy mở Windows PowerShell và chạy lệnh pac auth create bằng URL môi trường Dataverse của bạn:

pac auth create -u [Dataverse URL]

Ví dụ

pac auth create -u https://contoso-org.crm.dynamics.com

Làm theo lời nhắc xác thực để đăng nhập vào môi trường.

Bước 2. Liệt kê các website có sẵn

Sử dụng lệnh danh sách trang pac để liệt kê các website Power Pages có trong môi trường Dataverse mà bạn đã kết nối ở bước trước đó.

pac pages list

Bước 3. Tải xuống nội dung trang web

Tải xuống nội dung trang web từ môi trường Dataverse được kết nối bằng cách sử dụng lệnh tải xuống trang pac .

pac pages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Ví dụ

pac pages download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141 --modelVersion 2

Đối với tham số id, hãy sử dụng WebSiteId được trả về từ kết quả của bước trước.

Lưu ý

• Sử dụng modelVersion1 hoặc 2 để chỉ ra liệu dữ liệu trang web được tải lên sẽ sử dụng mô hình dữ liệu chuẩn (1) hay mô hình dữ liệu nâng cao (2).
• Chạy pac pages list -v lệnh để xem mô hình dữ liệu nào được dùng cho site của bạn. Để biết thêm chi tiết, hãy xem mô hình dữ liệu nâng cao.

Bước 4. Thay đổi nội dung website

Thay đổi cấu hình bằng cách sử dụng Visual Studio Code và lưu các thay đổi.

Lưu ý

Đảm bảo rằng bạn chỉ cập nhật các bảng được hỗ trợ để sử dụng với Power Platform CLI. Để biết thêm thông tin, hãy xem phần Các bảng được hỗ trợ.

Ví dụ: trang cổng thông tin mặc định hiển thị văn bản như sau:

Văn bản này có thể nhìn thấy từ html của trang web:

Bạn có thể thay đổi văn bản này và lưu các thay đổi:

Tiền bo

Bạn có thể thay đổi vị trí của đường dẫn thư mục trong PowerShell/cửa sổ dòng lệnh tích hợp thành vị trí đã tải xuống rồi nhập "code ." để mở thư mục ngay trong Visual Studio Code.

Bước 5. Tải lên các thay đổi

Lưu ý

• Nếu bạn đang tải lên nhiều môi trường, hãy xem tải lên các thay đổi bằng hồ sơ triển khai để tìm hiểu cách tải lên các thay đổi bằng hồ sơ triển khai.
• Đảm bảo rằng kích cỡ tệp đính kèm tối đa của môi trường đích được đặt thành kích thước tương tự hoặc lớn hơn với môi trường nguồn của bạn.
• Kích thước tối đa của tệp được xác định theo cài đặt Kích thước tệp tối đa trong tab email cài đặt hệ thống trong hộp thoại cài đặt hệ thống môi trường.

Sau khi thực hiện các thay đổi bắt buộc, hãy tải chúng lên bằng lệnh tải lên các trang pac :

pac pages upload --path [Folder-location] --modelVersion [ModelVersion]

Ví dụ

pac pages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Lưu ý

Đảm bảo đường dẫn cho nội dung cổng thông tin bạn đã nhập là chính xác. Theo mặc định, hệ thống sẽ tạo một thư mục được đặt tên theo cổng thông tin (tên dễ nhớ) với nội dung cổng thông tin đã tải xuống. Ví dụ: nếu tên dễ nhớ của cổng thông tin là custom-portal thì đường dẫn cho lệnh trên (--path) phải là C:\pac-portals\downloads\custom-portal.

Việc tải lên chỉ thực hiện đối với nội dung được thay đổi. Trong ví dụ này, vì thay đổi được thực hiện đối với một trang web, nên nội dung chỉ được tải lên cho bảng adx_webpage.

Tải lên các thay đổi bằng hồ sơ triển khai

Khi làm việc với nhiều môi trường khác nhau, bạn có thể cân nhắc sử dụng hồ sơ triển khai để đảm bảo các thay đổi được tải lên đúng môi trường bằng hồ sơ triển khai.

1. Tạo một thư mục có tên deployment-profiles bên trong thư mục chứa nội dung cổng thông tin. Ví dụ: nếu nội dung cổng đã tải xuống nằm bên trong "starter-portal" thì thư mục hồ sơ triển khai phải nằm bên trong thư mục này.

   

2. Bên trong thư mục hồ sơ triển khai, hãy tạo tệp YAML triển khai có chứa các thay đổi dành riêng cho môi trường. Ví dụ: môi trường phát triển có thể được gọi là "dev.deployment.yml".

   

3. Chỉnh sửa tệp YAML triển khai bằng Visual Studio Code có định dạng sau đây:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Ví dụ: mã YAML mẫu sau đây cập nhật giá trị cho "Hậu tố tiêu đề trình duyệt" từ "Cổng tùy chỉnh" mặc định thành "Cổng tùy chỉnh (Dev)".

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Để tải các thay đổi lên một môi trường khác bằng cách sử dụng tệp YAML hồ sơ triển khai, hãy xác thực đến tổ chức đích trước tiên.

5. Sau khi xác thực và kết nối với môi trường chính xác, hãy sử dụng lệnh tải lên trang pac để tải lên nội dung:

   pac pages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

   Lưu ý

   Trong ví dụ trên, tên hồ sơ triển khai được sử dụng là "dev" sau khi làm theo các bước trước đó để tạo hồ sơ triển khai dev. Thay đổi tên từ "dev" thành bất kỳ tên nào khác (chẳng hạn như QA cho "qa.deployment.yml" hoặc Test cho "test.deployment.yml") nếu bạn đã sử dụng tên tệp khác cho tệp YAML triển khai của mình.

Bước 6. Xác nhận các thay đổi

Cách xác nhận các thay đổi đã thực hiện đối với trang web:

1. Chọn Đồng bộ trong studio thiết kế Power Pages.

2. Để xem sự thay đổi, hãy duyệt đến trang web.

   

3. Nếu bạn đã sử dụng ví dụ về hồ sơ triển khai đã giải thích trước đó, đoạn mã YAML sẽ cập nhật giá trị như hiển thị trong ảnh chụp màn hình sau.

   

   Hậu tố tiêu đề trình duyệt được cập nhật thông qua thay đổi trên cho thấy sự thay đổi khi bạn mở cổng trong trình duyệt:

   

Hướng dẫn đến đây là kết thúc. Bạn có thể lặp lại các bước trên và thay đổi nội dung cổng thông tin cho các bảng được hỗ trợ khác.

Các bước tiếp theo

Sử dụng phần mở rộng Visual Studio Mã

Xem thêm

• Microsoft Power Platform CLI
• Sử dụng phần mở rộng Visual Studio Mã