Chia sẻ qua

Cấu phần Đầu ra Đối tượng

[Chủ đề này là tài liệu hướng dẫn trước khi phát hành và có thể thay đổi.]

Cấu phần mẫu này cho thấy cách sử dụng thuộc tính đầu ra loại đối tượng. Cấu phần này tạo ra một đối tượng tĩnh và đầu ra thông qua một thuộc tính mà sau đó có thể được truy cập trong ứng dụng canvas hoặc thông qua API máy khách trong một biểu mẫu mô hình.

Sẵn dùng cho

Ứng dụng dựa trên mô hình và ứng dụng Canvas

Điều kiện tiên quyết

Sự quen thuộc khi tạo các cấu phần mã.

Mã

Bạn có thể tìm thấy mẫu mã đầy đủ tại đây: PowerApps-Samples/component-framework/ObjectOutputControl/.

Bản kê khai bao gồm một thuộc tính kiểu đối tượng được gọi Data và một thuộc tính ẩn có tên là DataSchema . Chỉ cần thuộc tính DataSchema cho các ứng dụng Canvas và được nền tảng sử dụng để có được lược đồ đối tượng đầu ra. Chúng tôi cũng cần tạo ra một phụ thuộc thuộc tính giữa hai thuộc tính này.

<!-- A hidden property used by Canvas to get the output object schema -->
<property name="DataSchema"
   display-name-key="DataSchema"
   description-key="DataSchema"
   of-type="SingleLine.Text"
   usage="input"
   hidden="true" />
<!-- The object type output property -->
<property name="Data"
   display-name-key="Data"
   description-key="Data"
   of-type="Object"
   usage="output"
   hidden="false"
   default-value="" />
<property-dependencies>
   <!-- Define the dependency between schema and the object type property -->
   <property-dependency input="DataSchema"
      output="Data"
      required-for="schema" />
</property-dependencies>

Trong tệp index.ts, chúng ta cần thêm phương pháp getOutputSchema để cung cấp sơ đồ đối tượng đầu ra. Khi điều khiển được thêm vào Ứng dụng Canvas, nền tảng sẽ gọi đến phương pháp này trước khi khởi tạo điều khiển để nhận (các) sơ đồ đối tượng đầu ra.

public async getOutputSchema(context: ComponentFramework.Context<IInputs>): Promise<Record<string, unknown>> {
   return Promise.resolve({
      Data: StaticDataSchema
   });
}

Cập nhật phương getOutput pháp để trả về giá trị cho thuộc tính đầu ra.

public getOutputs(): IOutputs {
   return {
      Data: this._staticData
   };
}

Phương onLoadData pháp này được gọi khi nhấn nút Tải Dữ liệu để tải dữ liệu vào đối tượng đầu ra và thông báo cho nền tảng về những thay đổi đầu ra. Thao tác này sẽ kích hoạt hành vi onChange trong Ứng dụng Bảng tùy biến cho điều khiển hoặc sự kiện OnOutputChange cho API máy khách.

private onLoadData = async () => {
   this._staticData = StaticData;
   this._staticData.loadCounter = (this._staticData.loadCounter || 0) + 1;
   this.notifyOutputChanged();
}

Sự kiện onOutputChange
StandardControl.getOutputSchema
ReactControl.getOutputSchema
StandardControl.getOutputs
ReactControl.getOutputs

  • Last updated on