Komponen Output Objek

[Topik ini ialah dokumentasi prapelancaran dan tertakluk pada perubahan.]

Komponen sampel ini menunjukkan cara menggunakan sifat output jenis objek. Komponen ini menjana objek statik dan output melalui sifat yang kemudiannya boleh diakses dalam apl kanvas atau melalui API klien dalam bentuk model.

Tersedia untuk

Apl dipau model dan apl Kanvas

Prasyarat

Kebiasaan mencipta komponen kod.

Kod

Anda boleh mendapatkan sampel kod lengkap di sini: PowerApps-Samples/component-framework/ObjectOutputControl/.

Manifes termasuk sifat jenis objek yang dipanggil Data dan sifat tersembunyi yang dipanggil DataSchema . Sifat DataSchema hanya diperlukan untuk aplikasi Kanvas dan digunakan oleh platform untuk mendapatkan skema objek output. Kita juga perlu mewujudkan kebergantungan harta antara kedua-dua sifat ini.

<!-- 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>

Dalam fail index.ts, kita perlu menambah kaedah getOutputSchema untuk menyediakan skema objek output. Apabila kawalan ditambah pada Apl Kanvas, platform memanggil kaedah ini sebelum permulaan kawalan untuk menerima skema objek output.

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

Kemas kini getOutput kaedah untuk mengembalikan nilai bagi sifat output.

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

Kaedah ini onLoadData dipanggil apabila butang Muatkan Data ditekan untuk memuatkan data ke objek output dan memberitahu platform tentang perubahan output. Ini mencetuskan tingkah laku onChange dalam Apl Kanvas untuk kawalan atau peristiwa OnOutputChange untuk API klien.

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

Artikel berkaitan

Acara onOutputChange
StandardControl.getOutputSchema
ReactControl.getOutputSchema
StandardControl.getOutputs
ReactControl.getOutputs