retrieveMultipleRecords

אחזור אוסף של רשומות טבלה.

זמין עבור

אפליקציות ופורטלים מונחי דגמים.

תחביר

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

פרמטרים

שם	סוג	נדרש	תיאור
entityLogicalName	מחרוזת	כן	השם הלוגי של הטבלה של הרשומות שברצונך לאחזר. לדוגמה: "חשבון".
אפשרויות	מחרוזת	לא	אפשרויות שאילתה של מערכת OData או שאילתת FetchXML כדי לאחזר את הנתונים שלך. אפשרויות שאילתת המערכת הבאות נתמכות: $select, $top, $filter, $expand ו- $orderby. כדי לציין שאילתת FetchXML, השתמש בעמודה כדי fetchXml לציין את השאילתה. הערה: עליך להשתמש תמיד באפשרות שאילתת $select כדי להגביל את המאפיינים המוחזרים עבור רשומת טבלה על-ידי הכללת רשימה מופרדת באמצעות פסיקים של שמות מאפיינים. הגבלת העמודות שתחזור היא שיטות עבודה מומלצות חשובות לביצועים. אם מאפיינים לא מצוינים באמצעות $select, כל המאפיינים יוחזרו. עליך לציין את אפשרויות השאילתה המתחילות ב- ?. באפשרותך גם לציין אפשרויות מרובות של שאילתת מערכת באמצעות הפרד & בין אפשרויות השאילתה.
maxPageSize	מספר	לא	ציין מספר חיובי המציין את מספר רשומות הטבלה שיש להחזיר בכל עמוד. אם לא תציין פרמטר זה, ערך ברירת המחדל יעברו כ- 5,000. אם מספר הרשומות המאוחזרות maxPageSize גדול מהערך שצוין, nextLink העמודה באובייקט המוחזר promise תכלול קישור לאחזור קבוצת הטבלאות הבאה.
הצלחההתקשרות חוזרת	פונקציה	לא	פונקציה להתקשרות בעת אחזור רשומות טבלה. אובייקט עם העמודות הבאות מועבר לפונקציה: ישויות: מערך של אובייקטי JSON, שבו כל אובייקט מייצג את רשומת הטבלה המאוחזרת המכילה עמודות והערכים שלהן כזוגות key: value . המזהה של רשומת הטבלה מאוחזר כברירת מחדל. nextLink: String. אם מספר הרשומות המאוחזרות maxPageSize גדול מהערך שצוין בפרמטר בבקשה, עמודה זו מחזירה את כתובת ה- URL כדי להחזיר את קבוצת הרשומות הבאה.
errorהתקשרות חוזרת	פונקציה	לא	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת.

ערך החזרה

סוג: Promise<RetrieveMultipleResponse>

תיאור: RetrieveMultipleResponse הפונקציה מחזירה הבטחה המכילה מערך של אובייקטי JSON המכילים את רשומות הטבלה המאוחזרת ואת הפרמטר nextLink עם כתובת ה- URL המצביעה על קבוצת הרשומות הבאה במקרה שעמוד (maxPageSize) צוין בבקשה, וספירת הרשומות המוחזרת חורגת מערך ההחלפה. הוא כולל את הפרמטרים הבאים:

פרמטר	ערך החזרה	תיאור
ישויות	Entity[]	מערך של אובייקטי JSON, כאשר כל אובייקט מייצג את רשומת הטבלה המאוחזרת המכילה עמודות והערכים שלהם.
הקישור הבא	string	אם מספר הרשומות המאוחזרות גדול מהערך שצוין בפרמטר 'maxPageSize' בבקשה, פרמטר זה מחזיר את כתובת ה- URL כדי להחזיר את קבוצת הרשומות הבאה.

מאמרים קשורים

API של אינטרנט
חומר עזר ל- API של מסגרת רכיב Power Apps
מבט כולל על מסגרת הרכיבים של Power Apps