مكون إخراج الكائن

[هذا الموضوع هو وثائق ما قبل الإصدار وهو عرضة للتغيير.]

يوضح هذا المكون النموذجي كيفية استخدام خصائص إخراج نوع العنصر. ينشئ هذا المكون كائنا ثابتا وإخراجا عبر خاصية يمكن الوصول إليها بعد ذلك في تطبيق اللوحة أو عبر واجهات برمجة تطبيقات العميل في نموذج نموذج.

متوفر ل

التطبيقات المستندة إلى النموذج وتطبيقات Canvas

المتطلبات

الإلمام بإنشاء مكونات التعليمات البرمجية.

الرمز

يمكنك العثور على نموذج التعليمات البرمجية الكامل هنا: PowerApps-Samples/component-framework/ObjectOutputControl/.

يتضمن البيان خاصية نوع كائن تسمى Data وخاصية مخفية تسمى DataSchema . خاصية DataSchema مطلوبة فقط لتطبيقات Canvas وتستخدمها النظام الأساسي للحصول على مخطط كائن الإخراج. نحتاج أيضا إلى إنشاء تبعية خاصية بين هاتين الخاصيتين.

<!-- 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، نحتاج إلى إضافة أسلوب getOutputSchema لتوفير مخطط كائن الإخراج. عند إضافة عنصر التحكم إلى تطبيق Canvas، يستدعي النظام الأساسي هذا الأسلوب قبل تهيئة عنصر التحكم لتلقي مخطط (كائنات) الإخراج.

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

getOutput تحديث الأسلوب لإرجاع القيمة لخاصية الإخراج.

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

onLoadData يتم استدعاء الأسلوب عند الضغط على الزر Load Data لتحميل البيانات إلى كائن الإخراج وإعلام النظام الأساسي بتغييرات الإخراج. يؤدي هذا إلى تشغيل سلوك onChange في تطبيق Canvas لعنصر التحكم أو حدث OnOutputChange لواجهات برمجة تطبيقات العميل.

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

المقالات ذات الصلة

حدث onOutputChange
StandardControl.getOutputSchema
ReactControl.getOutputSchema
StandardControl.getOutputs
ReactControl.getOutputs