dataApi reference for generative pages

בעת יצירת דף באמצעות שפה טבעית, הבינה המלאכותית יוצרת דף React ב- TypeScript. הדף שנוצר מכסה הן את חוויית המשתמש החזיתית על-ידי בחירת הרכיבים המתאימים והן קביעה של הפריסה הטובה ביותר והלוגיקה העסקית המתאימה.

באפשרותך להציג ולערוך את הקוד שנוצר כדי למקד את הפלט. פעולות נתונים משתמשות dataApi באובייקט החושפת שיטות ציבוריות המחוברת לקטגוריות הבאות:

קטגוריה תיאור
פעולות שירות של טבלה Dataverse צור, אחזר, עדכן ומחק שורות טבלה Dataverse ועמודות בחירה של שאילתה.
שיטות מחבר עבוד עם נתונים שנחשפו על-ידי מחבר Power Platform המאוגד לדף.
פעולות שירות של פעולה Dataverse הפעל ממשקי API מותאמים אישית מסוג Dataverse המאוגדים לדף כפעולות או כפונקציות.
שיטות דף שלוט בדף הג'יניטיבי עצמו, כגון החזרת ערך כאשר העמוד משמש כתיבת דו-שיח.

שיטות המחבר ושיטות הפעולה והפונקציה הם חברים אופציונליים בחוזה dataApi . מארחים מסוימים אינם מיישמים אותם, לכן עליך לוודא תמיד ששיטה קיימת (לדוגמה, if (dataApi.executeAction) { ... }) לפני שהיא מתקשרת אליה. שיטה קיימת אינה מתכוונת שלדף יש מחבר או API מותאם אישית של Dataverse המאוגדים בו, או שה- API המותאם אישית זמין או מורשה עבור המשתמש הנוכחי. טפל בפונקציונליות לא זמינה ובכשלים מותאמים אישית של API באופן מפורש במקום להניח הצלחה.

פעולות שירות של טבלה Dataverse

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

פעולת שירות תיאור
createRow יצירת שורה חדשה בטבלה שצוינה.
deleteRow מחיקת שורה מהטבלה שצוינה.
getChoices מאחזר את האפשרויות עבור שם עמודת הבחירה שצוין.
queryTable שאילתה על טבלה עם האפשרויות שצוינו.
retrieveRow אחזור שורה מהטבלה שצוינה עם האפשרויות שצוינו.
updateRow עדכון שורה קיימת בטבלה שצוינה.

שיטות מחבר

השתמש בשיטות המחבר של האובייקט dataApi כדי לעבוד עם נתונים החשופים על-ידי מחבר Power Platform המאוגד לדף.

פעולת שירות תיאור
createConnectorRow יצירת שורה חדשה בטבלת המחברים שצוינה.
deleteConnectorRow מחיקת שורה מטבלת המחברים שצוינה.
executeConnectorOperation הפעלת פעולה בעלת שם שנחשפו על-ידי מחבר REST (המקש פעולה), כגון משתמשי Office 365.
getConnectorSwagger מאחזר את הגדרת Swagger (OpenAPI) עבור המחבר.
getConnectorTableSchema אחזור הסכימה עבור טבלה (הנקראת גם ישות או רשימה) החשופה על-ידי המחבר.
listConnectorDatasets פירוט ערכות הנתונים הזמינות עבור המחבר.
listConnectorOperations פירוט הפעולות שנחשפו על-ידי מחבר REST (המקש פעולה).
listConnectorTables פירוט הטבלאות הזמינות בערכת הנתונים של המחבר שצוין.
queryConnectorTable ביצוע שאילתה בטבלה שנחשפו על-ידי המחבר עם האפשרויות שצוינו.
retrieveConnectorRow אחזור שורה בודדת מטבלת המחברים שצוינה.
updateConnectorRow עדכון שורה קיימת בטבלת המחברים שצוינה.

פעולות ופעולות שירות של Dataverse

השתמש בשיטות הפעולה והפונקציה של dataApi האובייקט כדי להפעיל ממשקי API מותאמים אישית של Dataverse המאוגדים לדף.

פעולת שירות תיאור
executeAction הפעלת API מותאם אישית של Dataverse המאוגד לדף כפעולה.
executeFunction הפעלת API מותאם אישית של Dataverse המאוגד לדף כפונקציה.
listBoundActions פירוט ממשקי ה- API המותאמים אישית של Dataverse (פעולות ופונקציות) המאוגדים לדף.

שיטות דף

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

פעולת שירות תיאור
setPageOutput הגדרת הערך המוחזר לקובץ ה- Script של השיחות כאשר תיבת דו-שיח של דף generative נסגרת.