Komponent for objektutdata

[Dette emnet er forhåndsversjonsdokumentasjon og kan endres.]

Denne eksempelkomponenten viser hvordan du bruker utdataegenskaper for objekttype. Denne komponenten genererer et statisk objekt og utdata via en egenskap som deretter kan åpnes i en lerretsapp eller via klient-API-er i et modellskjema.

Tilgjengelig for

Modelldrevne apper og Lerret-apper

Forutsetning

Kjennskap til oppretting av kodekomponenter.

Kode

Du finner det fullstendige kodeeksempelet her: PowerApps-Samples/component-framework/ObjectOutputControl/.

Manifestet inneholder en objekttypeegenskap kalt Data og en skjult egenskap kalt DataSchema . Egenskapen DataSchema er bare nødvendig for Lerret-apper og brukes av plattform for å hente utdataobjektskjemaet. Vi må også opprette en egenskapsavhengighet mellom disse to egenskapene.

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

I index.ts-filen må vi legge til getOutputSchema-metoden for å angi utdataobjektskjemaet. Når kontrollen legges til i en lerretsapp, kaller plattformen til denne metoden før kontroll initialisering for å motta utdataobjektenes skjema(er).

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

getOutput Oppdater metoden for å returnere verdi for utdataegenskapen.

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

Metoden onLoadData kalles når Last inn data-knappen trykkes for å laste inn dataene til utdataobjektet og varsle plattformen om utdataendringene. Dette utløser virkemåten for OnChange i Lerretsappen for kontrollen eller OnOutputChange-hendelsen for klient-API-er.

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

Relaterte artikler

onOutputChange-hendelse
StandardControl.getOutputSchema
ReactControl.getOutputSchema
StandardControl.getOutputs
ReactControl.getOutputs