Hỗ trợ Microsoft Power Platform CLI cho Power Pages

Microsoft Power Platform CLI (giao diện dòng lệnh) là một giao diện dòng lệnh đơn giản, toàn diện dành cho nhà phát triển, hỗ trợ nhà phát triển và người tạo ứng dụng tạo các thành phần mã.

Công cụ Microsoft Power Platform CLI là bước đầu tiên trên hành trình quản lý vòng đời ứng dụng (ALM) toàn diện, nơi các nhà phát triển doanh nghiệp và nhà cung cấp phần mềm độc lập (ISV) có thể tạo, xây dựng, gỡ lỗi và phát hành các tiện ích và phần tùy chỉnh một cách nhanh chóng và hiệu quả. Để biết thêm thông tin, hãy truy cập Microsoft Power Platform CLI là gì?

Nhờ tính năng này, Microsoft Power Platform CLI hỗ trợ CI/CD (Tích hợp liên tục/Triển khai liên tục) của cấu hình trang web Power Pages. Giờ đây, bạn có thể đăng ký cấu hình trang web vào kiểm soát nguồn và di chuyển cấu hình trang web sang môi trường bất kỳ bằng Microsoft Power Platform CLI.

Lưu ý

• Tính năng này thường được cung cấp kể từ Power Platform CLI phiên bản 1.9.8. Để tìm hiểu về cách cài đặt phiên bản mới nhất, hãy chuyển đến Cài đặt Microsoft Power Platform CLI.
• Bắt đầu với Power Platform CLI phiên bản 1.27, lệnh pac paportal được đổi thành pac powerpages. 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ừ nay về sau. Bài viết này sẽ sớm được cập nhật để sử dụng powerpages thay thế paportal.

Tại sao nên sử dụng Microsoft Power Platform CLI để phát triển trang web?

Với Microsoft Power Platform CLI, giờ đây, bạn có thể tùy chỉnh trang web như khi không có kết nối mạng bằng cách thực hiện các thay đổi đối với nội dung trang web. Và sau khi tất cả các phần tùy chỉnh hoặc thay đổi được lưu, bạn có thể tải cấu hình trang web lên Microsoft Dataverse. Khi bạn tải nội dung trang web xuống bằng Microsoft Power Platform CLI, nội dung đó sẽ có cấu trúc ở định dạng YAML và HTML, giúp bạn dễ dàng tùy chỉnh, mang lại trải nghiệm phát triển chuyên nghiệp.

Dưới đây là danh sách các tính năng và khả năng mà cổng thông tin được hưởng lợi nhờ việc hỗ trợ cho Microsoft Power Platform CLI:

Dễ sử dụng

• Hỗ trợ tải xuống/tải lên dữ liệu cấu hình trang web đến/từ hệ thống tệp cục bộ

• Xây dựng trên công cụ Microsoft Power Platform CLI hiện có.

Quản lý vòng đời ứng dụng (ALM)

• Theo dõi các thay đổi đối với cấu hình trang web trong một tổ chức

• Di chuyển tệp cấu hình giữa các tổ chức hoặc đối tượng thuê

Hỗ trợ doanh nghiệp và nhà phát triển chuyên nghiệp

• Giúp tích hợp liền mạch với mọi công cụ kiểm soát nguồn, ví dụ như "git"

• Dễ dàng thiết lập quy trình CI/CD

Cài đặt Microsoft Power Platform CLI

Để biết hướng dẫn từng bước, hãy tham khảo bài viết Cài đặt CLI Microsoft Power Platform.

Các bảng được hỗ trợ

Hỗ trợ cổng thông tin cho Microsoft Power Platform CLI được giới hạn ở các bảng sau.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (chỉ tải xuống)

adx_websitelanguage

adx_webtemplate

chú thích

Quan trọng

• Bảng tùy chỉnh và bảng theo mẫu (chẳng hạn như blog, cộng đồng hoặc cổng thông tin ý tưởng) không được hỗ trợ để tùy chỉnh bằng Microsoft Power Platform CLI.
• Các tệp đính kèm tệp hình ảnh vào bản ghi quảng cáo (adx_ad) không được tải xuống bằng Power Platform CLI. Để giải quyết vấn đề, hãy sử dụng trường URL hình ảnh hoặc bằng cách thêm một tham chiếu HTML trong trường Sao chép vào bản ghi tệp web chứa một tệp hình ảnh.

Cài đặt và xác minh Microsoft Power Platform CLI cho cổng thông tin

Để tìm hiểu về cách cài đặt Microsoft Power Platform CLI, hãy xem phần Cài đặt Microsoft Power Platform CLI.

Sau khi cài đặt Microsoft Power Platform CLI, hãy mở dấu nhắc lệnh và chạy pac để xác minh rằng đầu ra chứa "paportal" - lệnh cho cổng thông tin Power Apps.

Các lệnh Microsoft Power Platform CLI cho cổng thông tin

Lệnh Microsoft Power Platform CLI cho cổng thông tin là "paportal".

Các phần sau đây cung cấp thêm chi tiết về các thuộc tính khác nhau của lệnh "paportal".

Tham số

Tên thuộc tính	Nội dung mô tả	Ví dụ:
danh sách	Liệt kê tất cả các trang web cổng thông tin của môi trường Dataverse hiện tại. Bạn có thể thêm tham số -v để cho biết liệu trang web đang sử dụng tiêu chuẩn hay mô hình dữ liệu nâng cao	pac paportal list
tải xuống	Tải nội dung trang web cổng thông tin xuống từ môi trường Dataverse hiện tại. Thuộc tính này có các tham số sau: - path: Đường dẫn tải nội dung trang web (bí danh: -p) - webSiteId: ID trang web cổng thông tin cần tải xuống (biệt hiệu: -id) - ghi đè: (Không bắt buộc) true – ghi đè nội dung hiện có; false - không ghi đè nếu thư mục đã có nội dung trang web (biệt hiệu: -o) - modelVersion: 1 hoặc 2 để cho biết liệu dữ liệu trang web được tải xuống có sử dụng dữ liệu tiêu chuẩn (1) hay nâng cao hay không mô hình (2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
tải lên	Tải nội dung trang web cổng thông tin lên môi trường Dataverse hiện tại. Thuộc tính này có tham số sau: - path: Đường dẫn đến vị trí nội dung trang web sẽ được lưu (biệt hiệu: -p) -deploymentProfile: Tải dữ liệu cổng thông tin lên với chi tiết môi trường được xác định thông qua biến hồ sơ trong tệp deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 hoặc 2 để cho biết liệu dữ liệu trang web được tải lên có sử dụng dữ liệu tiêu chuẩn (1) hay nâng cao hay không mô hình (2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Dùng cấu hình triển khai

Nút chuyển deploymentProfile cho phép bạn xác định tập hợp các biến cho môi trường ở định dạng YAML. Ví dụ: bạn có thể có các cấu hình triển khai khác nhau (chẳng hạn như dev, test, prod) với chi tiết lược đồ khác nhau được xác định trong cấu hình.

Nếu đang tạo cấu hình thử nghiệm, bạn có thể tạo tệp trong deployment-profiles với tên "test.deployment.yml" (tức là <profileTag>.deployment.yml). Đồng thời, bạn có thể chạy lệnh với thẻ (<profileTag>) để dùng cấu hình này:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

Trong tệp này, bạn có thể có tên bảng (thực thể) với ID bảng, danh sách các thuộc tính và các giá trị mà bạn muốn ghi đè trong khi tải lên cấu hình cổng thông tin bằng tham số deploymentProfile.

Ngoài ra, bạn có thể sử dụng biến OS để truy cập vào các biến môi trường của hệ điều hành.

Dưới đây là ví dụ về tệp YAML cấu hình "test.deployment.yml" này với chi tiết lược đồ không trùng lặp:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Lưu ý

Để tìm hiểu về tất cả các lệnh dùng trong CLI ngoài các cổng thông tin, hãy xem phần Các lệnh phổ biến trong Microsoft Power Platform CLI.

Tệp kê khai

Khi bạn tải xuống nội dung trang web bằng lệnh pac paportal download CLI, cùng với việc tải xuống nội dung trang web, nó cũng tạo ra hai tệp kê khai;

• Tệp kê khai môi trường (org-url-manifest.yml)
• Tệp kê khai theo dõi xóa (manifest.yml)

Tệp kê khai môi trường (org-url-manifest.yml)

Tệp kê khai môi trường được tạo mỗi khi lệnh pac paportal download được chạy.

Sau mỗi lần tải xuống, công cụ PAC CLI sẽ đọc tệp kê khai môi trường hiện có và cập nhật các mục đã bị xóa trong môi trường hoặc tạo tệp kê khai môi trường nếu nó không tồn tại.

Khi bạn chạy lệnh pac paportal download để tải lên nội dung trang web cổng thông tin. Lệnh đó đọc tệp kê khai môi trường và xác định các thay đổi được thực hiện kể từ lần tải xuống sau cùng và chỉ tải lên nội dung đã cập nhật. Việc này giúp tối ưu hóa quá trình tải lên vì chỉ nội dung trang web cập nhật mới được tải lên, thay vì tải lên tất cả nội dung trên mọi lệnh tải lên.

Tệp kê khai môi trường ở chế độ chỉ đọc khi kết nối với cùng một môi trường (URL môi trường khớp với tên tệp), để tránh những thay đổi vô tình.

Lưu ý

• Tệp kê khai môi trường không được thiết kế để theo dõi các thay đổi khi triển khai trang web sang các môi trường khác nhau.
• Tệp kê khai môi trường được thiết kế để các nhà phát triển sử dụng để triển khai cục bộ trong môi trường nhà phát triển của họ và phải được thêm vào danh sách bỏ qua git.

Tệp kê khai theo dõi xóa (manifest.yml)

Tệp này được sử dụng để theo dõi các bản ghi đã bị xóa khỏi môi trường.

Khi nội dung trang web được tải xuống bằng lệnh pac paportal download , thao tác này sẽ thêm các bản ghi đã xóa khỏi tệp kê khai môi trường (org-url-manifest.yml) vào tệp kê khai.yml. Vì vậy, khi bạn tải lên nội dung trang web bằng lệnh pac paportal upload thì nó sẽ xóa các tệp khỏi môi trường (thậm chí sang một môi trường khác). Tệp này không bị xóa và được sử dụng bất kể bạn kết nối với môi trường nào. Tệp này cần được xem xét khi thực hiện các thay đổi đối với kiểm soát nguồn để xem xét xóa các mục trong môi trường đích.

Lưu ý

Để xóa các bản ghi nội dung trang web trong một môi trường và cũng xóa các bản ghi nội dung tương tự trong một môi trường khác bằng cách sử dụng PAC CLI, bạn sẽ cần chạy lệnh pac paportal downloadtrước và sau khi xóa nội dung bản ghi trang web. Tệp manifest.yml sẽ theo dõi những thay đổi này và xóa các bản ghi tương ứng trong môi trường đích khi lệnh pac paportal upload được chạy.

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

Bạn cũng có thể sử dụng tiện ích VS Code Power Platform VS Code Extension để được hưởng lợi từ ngôn ngữ Liquid tích hợp sẵn từ IntelliSense, tính năng hỗ trợ hoàn thành mã, gợi ý và tương tác với Microsoft Power Platform CLI bằng Cửa sổ dòng lệnh tích hợp của VS Code. Thông tin thêm: Sử dụng tiện ích Visual Studio Code (Xem trước)

Những điểm cần cân nhắc khác

• Hệ thống sẽ báo lỗi nếu đường dẫn tệp của bạn vượt quá giới hạn độ dài tối đa của đường dẫn. Thông tin thêm: Giới hạn độ dài tối đa của đường dẫn trong Windows
• Đối với các bản ghi trùng lặp, chẳng hạn như tên trang web trùng lặp, Microsoft Power Platform CLI sẽ tạo hai thư mục khác nhau – một thư mục có tên trang web và một thư mục cùng tên có tiền tố là mã băm. Ví dụ: "My-page" và "My-page-mã-băm".

Các bước tiếp theo

Hướng dẫn: Sử dụng Microsoft Power Platform CLI với các cổng thông tin

Xem thêm

• Microsoft Power Platform CLI
• Sử dụng tiện ích Visual Studio Code (Xem trước)