Chia sẻ qua

pac canvas

Hoạt động với tệp .msapp Power Apps

[Bài viết này là tài liệu trước khi phát hành và có thể thay đổi.]

Quan trọng

  • Các pack lệnh unpack và bị phản đối.
  • Để kiểm soát nguồn ứng dụng bảng tùy biến của bạn, hãy sử dụng Tích hợp Power Platform Git.
  • Lệnh create này thường sẵn dùng.

Lệnh

Lệnh Sự miêu tả
pac canvas create Tạo ứng dụng bức vẽ từ trình kết nối tùy chỉnh
pac canvas download Tải xuống ứng dụng bảng tùy biến dưới dạng tệp .msapp
pac canvas list Liệt kê ứng dụng bức vẽ
pac canvas pack (Xem trước) Đóng gói các nguồn vào một tệp msapp
pac canvas unpack (Xem trước) Trích xuất tệp msapp vào các nguồn
pac canvas validate (Xem trước) Xác thực nguồn .pa.yaml cho tệp msapp được giải nén

pac canvas create

Tạo ứng dụng bức vẽ từ trình kết nối tùy chỉnh

Lệnh này sẽ tạo ứng dụng .msapp bảng tùy biến dựa trên định nghĩa OpenAPI của trình kết nối tùy chỉnh hiện có. Ứng dụng sẽ chứa các màn hình, bố cục điều khiển và mã Power Fx được tạo ra dựa trên cách xác định các hành động của trình kết nối tùy chỉnh, với giao diện được xác định trước. Ứng dụng có thể được sử dụng để thực hiện trực tiếp các hành động được xác định trong trình kết nối tùy chỉnh.

Các nhà sản xuất có thể nhập các .msapp tệp được tạo vào Power Apps Studio để phát ứng dụng hoặc thực hiện các chỉnh sửa và thực hiện thêm các tùy chỉnh khác. Nhập ứng dụng được tạo vào Power Apps Studio bằng cách dẫn hướng đến Duyệt>Mở>Tệp trong Studio.

Ví dụ

Các ví dụ sau đây cho thấy cách sử dụng pac canvas create lệnh.

Tạo ứng dụng bảng tùy biến dựa trên Định nghĩa API Mở theo tên hiển thị

Ví dụ này tạo một ứng dụng bảng tùy biến (dưới dạng tệp *.msapp) dựa trên Định nghĩa API Mở bằng cách sử dụng tên hiển thị của bộ kết nối.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Tạo ứng dụng bảng tùy biến dựa trên Định nghĩa API Mở theo id

Ví dụ này tạo một ứng dụng bảng tùy biến (dưới dạng tệp *.msapp) dựa trên Định nghĩa API Mở bằng cách sử dụng ID của bộ kết nối.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

Hoặc là connector-display-name bắt connector-id buộc.

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

--msapp

Đường dẫn đến tệp .msapp sẽ được tạo

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

--connector-display-name

Tên hiển thị của Trình kết nối để tạo Power App từ đó.

--connector-id

ID của Trình kết nối để tạo Power App từ đó.

--environment

URL hoặc ID Môi trường đích. Giá trị mặc định là môi trường của Hồ sơ Xác thực Dữ liệu hiện đang hoạt động của bạn.

Ghi chú

Những điều cần cân nhắc và hạn chế:

  • Bộ nối tùy chỉnh được tham chiếu với tham connector-display-name số connector-id hoặc tham số phải là một phần của Giải pháp.
  • Sau khi nhập ứng dụng vào Studio, sẽ không có liên kết nào với trình kết nối tùy chỉnh. Trình tạo phải thêm thủ công tham chiếu đến trình kết nối tùy chỉnh mà từ đó ứng dụng được tạo trước khi có thể phát ứng dụng. Xem Thêm kết nối dữ liệu vào ứng dụng bảng tùy biến để biết các bước. Cho đến khi thực hiện xong, bạn có thể thấy các lỗi công thức trong ứng dụng sẽ giải quyết sau khi thêm tham chiếu bộ kết nối. Tên của bộ nối tùy chỉnh mà bạn thêm vào ứng dụng phải khớp với tên hiển thị của bộ nối tùy chỉnh được tham chiếu trong canvas create lệnh.
  • Ứng dụng sẽ chứa một màn hình cho mỗi màn hình POST và hành GET động mà trình kết nối xác định.
    • Các động từ khác sẵn dùng trong đường kết nối tùy chỉnh không được hỗ trợ.
  • Các điều khiển được kết xuất trên màn hình của mỗi hành động được tạo tự động dựa trên cách xác định loại đầu vào và đầu ra của mỗi hành động. Một số kiểu đầu vào và đầu ra nhất định được xác định trong bộ nối tùy chỉnh không được hỗ trợ bởi canvas create. Lệnh này sẽ tạo ra cảnh báo trong bảng điều khiển khi gặp phải những cảnh báo này. Trường hợp cụ thể:
    • Mảng đối tượng và mảng mảng không được hỗ trợ làm đầu vào
    • Không tạo điều khiển cho các đối tượng hoặc mảng lồng nhau vượt quá độ sâu 20
    • Kiểu "Tệp" và "định dạng nhị phân" không được hỗ trợ cho đầu vào hoặc đầu ra.

pac canvas download

Tải xuống ứng dụng bảng tùy biến dưới dạng tệp .msapp

Tham số Bắt buộc cho canvas download

--name -n

Chính xác, tên một phần hoặc ID ứng dụng của ứng dụng Canvas

Tham số Tùy chọn cho canvas 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.

--extract-to-directory -d

Tên thư mục để trích xuất ứng dụng bức vẽ vào

--file-name -f

Tên tệp (thường có phần mở rộng .msapp). Nếu tệp không được cung cấp được lưu trong thư mục hiện tại với 'appname'.msapp

--overwrite -o

Cho phép ghi đè tệp

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

pac canvas list

Liệt kê ứng dụng bức vẽ

Tham số Tùy chọn cho canvas 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 canvas pack

(Xem trước) Đóng gói các nguồn vào một tệp msapp

Ví dụ:

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Tham số Bắt buộc cho canvas pack

--msapp

Đường dẫn đến tệp .msapp

--sources

Thư mục cho các nguồn cần đóng gói

Ghi chú

Tạo tệp từ .msapp các tệp nguồn đã được giải nén trước đó. Có thể mở kết quả trong Power Apps Studio bằng cách dẫn hướng đến Duyệt>Mở>Tệp.

Sau khi được giải nén, các tệp nguồn có thể được chỉnh sửa và quản lý bằng các công cụ bên ngoài như Visual Studio Code và GitHub.

pac canvas unpack

(Xem trước) Trích xuất tệp msapp vào các nguồn

Ví dụ:

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Giải nén vào thư mục mặc HelloWorld_src định.

Tham số Bắt buộc cho canvas unpack

--msapp

Đường dẫn đến tệp .msapp

Tham số Tùy chọn cho canvas unpack

--sources

Thư mục đến các nguồn được giải nén

Ghi chú

Giải nén tệp .msapp nguồn.

Tải xuống .msapp tệp từ Power Apps Studio bằng cách dẫn hướng đến Lưu Tệp>dưới dạng Máy>tính này.

Nếu tham số nguồn không được xác định, một thư mục có cùng tên và vị trí như .msapp tệp được sử dụng với _src hậu tố.

Cấu trúc thư mục

Giải nén và đóng gói thuộc tính sử dụng cấu trúc thư mục sau:

  • \src - Điều khiển và tệp cấu phần. Điều này chứa các nguồn.
    • *.fx.yaml - Các công thức được trích xuất từ control.json tệp.

      Lưu ý

      Đây là nơi để sửa công thức của bạn.

    • CanvasManifest.json - Tệp kê khai chứa thông tin thường có trong tiêu đề, thuộc tính và publishInfo.
    • *.json - Tệp control.json thô.
    • \EditorState*.editorstate.json - Thông tin được lưu vào bộ đệm ẩn cho Power Apps Studio để sử dụng.
  • \DataSources - Tất cả các nguồn dữ liệu được ứng dụng sử dụng.
  • \Connections - Phiên bản kết nối được lưu với ứng dụng và được sử dụng khi tải lại vào Power Apps Studio.
  • \Assets - Tệp phương tiện được nhúng trong ứng dụng.
  • \pkgs - Bản sao tham chiếu bên ngoài đã tải xuống, chẳng hạn như mẫu, tệp định nghĩa API và thư viện cấu phần. Các tham chiếu này tương tự như tham chiếu NuGet/NPM.
  • \other - Tất cả các tệp khác cần thiết để tạo lại .msapp.
    • entropy.json - Các yếu tố biến đổi (như dấu thời gian) được trích xuất vào tệp này. Điều này giúp giảm sự khác biệt ồn ào trong các tệp khác trong khi vẫn đảm bảo rằng chúng tôi vẫn có thể thực hiện chuyến đi khứ hồi.
    • Giữ các tệp khác từ msapp, chẳng hạn như nội dung trong \rcủa bạn.

Định dạng tệp

Các .fx.yaml tệp sử dụng một tập hợp con YAML. Tương tự như Excel, tất cả các biểu thức phải bắt đầu bằng dấu bằng =. Thông tin thêm: Power Fx YAML Formula Grammar

Phối các thay đổi với Power Apps Studio

Khi phối các thay đổi được thực hiện trong hai phiên Power Apps Studio khác nhau:

  • Đảm bảo rằng tất cả các tên điều khiển là duy nhất. Ví dụ: việc chèn nút trong hai phiên khác nhau có thể dẫn đến hai điều Button1 khiển. Chúng tôi khuyên bạn nên đặt tên cho các điều khiển ngay sau khi tạo chúng. Công cụ không chấp nhận hai điều khiển có cùng tên.
  • Đối với các tệp này, hãy phối chúng như bạn vẫn thường làm:
    • \src*.fx.yaml
  • Nếu có xung đột hoặc lỗi, bạn có thể xóa các tệp này:
    • \src\editorstate*.json - Các tệp này chứa thông tin tùy chọn trong Power Apps Studio.
    • \other\entropy.jsbật
  • Đối với bất kỳ xung đột nào trong các tệp này, bạn có thể chấp nhận phiên bản mới nhất:
    • \checksum.jsbật
  • Nếu có bất kỳ xung đột phối nào dưới những đường dẫn này, việc phối sẽ không an toàn. Hãy cho chúng tôi biết nếu điều này xảy ra thường xuyên; chúng tôi sẽ làm việc để cơ cấu lại định dạng tệp để tránh xung đột.
    • \Kết nối*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Mở nguồn

Các lệnh bảng tùy biến trong MICROSOFT Power Platform CLI là mã nguồn mở. Thảo luận về các cải tiến, nêu vấn đề và truy nhập mã từ kho công cụ ngôn ngữ Power Apps.

pac canvas validate

(Xem trước) Xác thực nguồn .pa.yaml cho tệp msapp được giải nén

Tham số Bắt buộc cho canvas validate

--directory -d

Đường dẫn đến thư mục msapp được trích xuất chứa các tệp .pa.yaml để xác thực

Xem thêm

Microsoft Power Platform CLI Command Groups
Tổng quan về MICROSOFT Power Platform CLI

  • Last updated on