Objectuitvoeronderdeel

[Dit onderwerp maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Dit voorbeeldonderdeel laat zien hoe u uitvoereigenschappen van objecttypen gebruikt. Dit onderdeel genereert een statisch object en uitvoer via een eigenschap die vervolgens kan worden geopend in een canvas-app of via client-API's in een modelformulier.

Beschikbaar voor

Modelgestuurde apps en Canvas-apps

Vereiste voorwaarden

Bekendheid met het maken van codeonderdelen.

Code

U vindt het volledige codevoorbeeld hier: PowerApps-Samples/component-framework/ObjectOutputControl/.

Het manifest bevat een eigenschap van het objecttype aangeroepen Data en een verborgen eigenschap met de naam DataSchema . De eigenschap DataSchema is alleen nodig voor Canvas-apps en wordt door het platform gebruikt om het uitvoerobjectschema op te halen. We moeten ook een eigenschapsafhankelijkheid tussen deze twee eigenschappen maken.

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

In het bestand index.ts moeten we de methode getOutputSchema toevoegen om het uitvoerobjectschema op te geven. Wanneer het besturingselement wordt toegevoegd aan een canvas-app, roept het platform deze methode aan voordat u de initialisatie bepaalt om de schema's van het uitvoerobject(en) te ontvangen.

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

Werk de getOutput methode bij om de waarde voor de uitvoereigenschap te retourneren.

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

De onLoadData methode wordt aangeroepen wanneer de knop Gegevens laden wordt ingedrukt om de gegevens naar het uitvoerobject te laden en het platform op de hoogte te stellen van de uitvoerwijzigingen. Dit activeert onChange-gedrag in de Canvas-app voor het besturingselement of de gebeurtenis OnOutputChange voor client-API's .

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

Verwante artikelen

onOutputChange-gebeurtenis
StandardControl.getOutputSchema
ReactControl.getOutputSchema
StandardControl.getOutputs
ReactControl.getOutputs