שיטות דף עבור דפים generative

השתמש בשיטות העמוד של האובייקט dataApi כדי לשלוט בעמוד הגנדרטיבי עצמו, כגון החזרת ערך כאשר העמוד משמש כתיבת דו-שיח. בשלב זה, קיימת רק שיטת עמוד אחת.

setPageOutput שיטת

הגדרת הערך המוחזר לקובץ ה- Script של השיחות כאשר דף Generative נפתח כתיבת דו-שיח נסגרת. שיטה זו זמינה רק במארחים התומכים בהחזרת ערכים מתיבות דו-שיח של עמודים גניטיביים. הוא אינו מהווה חלק מהחוזה המשותף dataApi , לכן ודא שהוא קיים לפני שהוא מתקשר אליו.

פרמטרים

שם סוג תיאור
value ידוע הערך שיש לחזור ל- Script שפתחת את תיבת הדו-שיח. הערך יכול להיות פרימיטיבי, אובייקט או מערך.

החזרות

אין ערך.

דוגמה ל- 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 שהמאפיין שלו מכיל את הערך המאוחסן העדכני ביותר. קובץ ה- Script של השיחות חייב להחיל באופן מפורש את הערך המוחזר על הטופס, הרשת או מצב אחר שלו.

שיטה זו חלה על דפים generative שנפתחים כתיבות דו-שיח. עמודים Generative שנפתחים בתוך השורה או בחלונית צדדית של אפליקציה אינם מחזירים ערך ל- Script הקריאה.