Κοινοποίηση μέσω

retrieveMultipleRecords

Ανακτά μια συλλογή εγγραφών πίνακα.

Διαθέσιμο για

Εφαρμογές και πύλες βάσει μοντέλου.

Σύνταξη

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

Παράμετροι

Ονομασία Type Απαραίτητο Περιγραφή
entityΛογικό_όνομα Συμβλοσειρά Όχι Το λογικό όνομα πίνακα των εγγραφών που θέλετε να ανακτήσετε. Για παράδειγμα: "λογαριασμός".
επιλογές Συμβλοσειρά όχι

Επιλογές ερωτήματος συστήματος OData ή ερώτημα FetchXML για την ανάκτηση των δεδομένων σας.

  • Υποστηρίζονται οι ακόλουθες επιλογές ερωτημάτων συστήματος: $select, $top, $filter, $expand και $orderby.
  • Για να καθορίσετε ένα ερώτημα FetchXML, χρησιμοποιήστε τη fetchXml στήλη για να καθορίσετε το ερώτημα.

ΣΗΜΕΊΩΣΗ: Πρέπει πάντα να χρησιμοποιείτε την επιλογή ερωτήματος συστήματος $select για να περιορίσετε τις ιδιότητες που επιστρέφονται για μια εγγραφή πίνακα, συμπεριλαμβάνοντας μια λίστα ονομάτων ιδιοτήτων διαχωρισμένων με κόμματα. Ο περιορισμός των στηλών που ανακτάτε είναι μια σημαντική βέλτιστη πρακτική για τις επιδόσεις. Εάν δεν έχουν καθοριστεί ιδιότητες με χρήση $select, θα επιστραφούν όλες οι ιδιότητες.

Καθορίζετε τις επιλογές ερωτήματος που αρχίζουν με ?. Μπορείτε επίσης να καθορίσετε πολλές επιλογές ερωτήματος συστήματος, χρησιμοποιώντας & το για να διαχωρίσετε τις επιλογές ερωτήματος.

maxPageSize Αριθμός όχι

Καθορίστε έναν θετικό αριθμό που υποδεικνύει τον αριθμό εγγραφών πίνακα που θα επιστραφούν ανά σελίδα. Εάν δεν καθορίσετε αυτή την παράμετρο, η προεπιλεγμένη τιμή μεταβιβάζεται ως 5.000.

Εάν ο αριθμός εγγραφών που ανακτώνται είναι μεγαλύτερος από την καθορισμένη maxPageSize τιμή, nextLink η στήλη στο αντικείμενο υπόσχεσης που επιστρέφεται θα περιέχει μια σύνδεση για την ανάκτηση του επόμενου συνόλου πινάκων.

επιτυχίαΕπανάκληση Function όχι

Μια συνάρτηση για κλήση κατά την ανάκτηση εγγραφών πίνακα. Ένα αντικείμενο με τις ακόλουθες στήλες μεταβιβάζεται στη συνάρτηση:

  • οντότητες: Ένας πίνακας αντικειμένων JSON, όπου κάθε αντικείμενο αντιπροσωπεύει την εγγραφή πίνακα που ανακτήστηκε που περιέχει στήλες και τις τιμές τους ως key: value ζεύγη. Το αναγνωριστικό της εγγραφής πίνακα ανακτώνται από προεπιλογή.
  • nextLink: Συμβολοσειρά. Εάν ο αριθμός εγγραφών που ανακτώνται είναι μεγαλύτερος από την τιμή που καθορίζεται στην maxPageSize παράμετρο στην αίτηση, αυτή η στήλη επιστρέφει τη διεύθυνση URL για να επιστρέψει το επόμενο σύνολο εγγραφών.
errorCallback Function όχι Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

Τιμή επιστροφής

Τύπος: Promise<RetrieveMultipleResponse>

Περιγραφή: Η RetrieveMultipleResponse επιστρέφει μια υπόσχεση που περιέχει έναν πίνακα αντικειμένων JSON που περιέχει τις εγγραφές πίνακα που ανακτώνται και την παράμετρο nextLink με τη διεύθυνση URL να δείχνει στο επόμενο σύνολο εγγραφών σε περίπτωση που καθοριστεί σελιδοποίηση (maxPageSize) στην αίτηση και το πλήθος εγγραφών που επιστρέφεται υπερβαίνει την τιμή σελιδοποίησης. Έχει τις ακόλουθες παραμέτρους:

παράμετρος Τιμή επιστροφής Περιγραφή
Οντότητες Entity[] Ένας πίνακας αντικειμένων JSON, όπου κάθε αντικείμενο αντιπροσωπεύει την εγγραφή πίνακα που ανακτήστηκε που περιέχει στήλες και τις τιμές τους.
nextLink string Εάν ο αριθμός εγγραφών που ανακτώνται είναι μεγαλύτερος από την τιμή που καθορίζεται στην παράμετρο "maxPageSize" στην αίτηση, αυτή η παράμετρος επιστρέφει τη διεύθυνση URL για να επιστρέψει το επόμενο σύνολο εγγραφών.

Web API
Αναφορά API για το πλαίσιο εργασίας στοιχείων του Power Apps
Επισκόπηση πλαισίου εργασίας στοιχείων του Power Apps

  • Last updated on