Objektin tuloste-osa

[Tämä ohjeaihe sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Tämä mallikomponentti näyttää, miten voit käyttää objektityypin tulosteominaisuuksia. Tämä komponentti luo staattisen objektin ja tulosteen ominaisuuden kautta, jota voidaan käyttää pohjaan perustuvassa sovelluksessa tai mallilomakkeen asiakassovellusten ohjelmointirajapintojen kautta.

Käytettävissä kohteelle

Mallipohjaiset sovellukset ja pohjaan perustuvat sovellukset

Edellytykset

Koodikomponenttien luonti tunteminen.

Koodi

Koko koodiesimerkki löytyy täältä: PowerApps-Samples/component-framework/ObjectOutputControl/.

Luettelo sisältää objektityypin ominaisuuden nimeltä Data ja piilotetun ominaisuuden nimeltä DataSchema . DataSchema-ominaisuutta tarvitaan vain pohjaan perustuvissa sovelluksissa, ja ympäristö käyttää sitä tulosteobjektirakenteen noutamiseen. Meidän on myös luotava ominaisuusriippuvuus näiden kahden ominaisuuden välille.

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

index.ts tiedostoon on lisättävä getOutputSchema-menetelmä , joka antaa tulosteobjektin rakenteen. Kun ohjausobjekti lisätään pohjaan perustuvaan sovellukseen, ympäristö kutsuu tätä menetelmää ennen ohjausobjektin alustamista, jotta tulosteobjektit voidaan vastaanottaa.

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

Päivitä - getOutput menetelmä ja palauta tulosteominaisuuden arvo.

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

- onLoadData menetelmää kutsutaan, kun Lataa tiedot -painiketta painetaan, jotta tietoja ladataan tulosteobjektiin ja ympäristölle ilmoitetaan tulosteen muutoksista. Tämä käynnistää onChange-toiminnan pohjasovelluksessa ohjausobjektia varten tai OnOutputChange-tapahtuman asiakkaan ohjelmointirajapinnoille.

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

onOutputChange-tapahtuma
StandardControl.getOutputSchema
ReactControl.getOutputSchema
StandardControl.getOutputs
ReactControl.getOutputs