أساليب الصفحة للصفحات التوليدية

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

طريقة setPageOutput

تعيين القيمة التي تم إرجاعها إلى البرنامج النصي للاتصال عند فتح صفحة إنشاء أثناء إغلاق مربع حوار. يتوفر هذا الأسلوب فقط في المضيفين الذين يدعمون إرجاع القيم من مربعات حوار الصفحة التوليدية. إنه ليس جزءا من العقد المشترك dataApi ، لذا تحقق من وجوده قبل الاتصال به.

Parameters

Name	النوع	Description
value	غير معروف	القيمة التي يجب إرجاعها إلى البرنامج النصي الذي فتح مربع الحوار. يمكن أن تكون القيمة بدائية أو كائنا أو صفيفا.

إرجاع

لا توجد قيمة.

مثال setPageOutput

dataApi.setPageOutput?.({
    action: "selected",
    recordId: selectedRecordId
});

const xrm = (window as any).Xrm;
await xrm.Navigation.navigateBack();

لا يؤدي الاتصال setPageOutput إلى إغلاق مربع الحوار أو تحديث صفحة الاتصال. أغلق مربع الحوار باستخدام Xrm.Navigation.navigateBack(). يتم حل الوعد الذي تم إرجاعه بواسطة Xrm.Navigation.navigateTo كائن يحتوي الخاصية الخاصة به returnValue على أحدث قيمة مخزنة. يجب أن يطبق البرنامج النصي الاستدعاء القيمة التي تم إرجاعها بشكل صريح على النموذج أو الشبكة أو الحالة الأخرى.

ينطبق هذا الأسلوب على الصفحات التوليدية المفتوحة كمربعات حوار. لا ترجع الصفحات التوليدية المفتوحة المضمنة أو في جزء جانب التطبيق قيمة إلى البرنامج النصي للاتصال.