retrieveRecord

Ανακτά μια εγγραφή πίνακα.

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

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

Σύνταξη

context.webAPI.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

Παράμετροι

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

Επιλογές ερωτήματος συστήματος OData, $select και $expand, για να ανακτήσετε τα δεδομένα σας.

  • Χρησιμοποιήστε την επιλογή $select ερωτήματος συστήματος για να περιορίσετε τις ιδιότητες που επιστρέφονται, συμπεριλαμβάνοντας μια λίστα ονομάτων ιδιοτήτων διαχωρισμένων με κόμματα. Ο περιορισμός των στηλών που ανακτάτε είναι μια σημαντική βέλτιστη πρακτική για τις επιδόσεις. Εάν δεν έχουν καθοριστεί ιδιότητες με χρήση $select, θα επιστραφούν όλες οι ιδιότητες.
  • Χρησιμοποιήστε την επιλογή ερωτήματος συστήματος $expand για να ελέγξετε ποια δεδομένα από σχετικούς πίνακες επιστρέφονται. Εάν συμπεριλάβετε μόνο το όνομα της ιδιότητας περιήγησης, θα λάβετε όλες τις ιδιότητες για σχετικές εγγραφές. Μπορείτε να περιορίσετε τις ιδιότητες που επιστρέφονται για σχετικές εγγραφές χρησιμοποιώντας την επιλογή ερωτήματος συστήματος $select σε παρένθεση μετά το όνομα της ιδιότητας περιήγησης. Χρησιμοποιήστε αυτήν την επιλογή τόσο για τις ιδιότητες περιήγησης μίας τιμής όσο και για τις ιδιότητες περιήγησης με αξία συλλογής .

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

?$select=name&$expand=primarycontactid($select=contactid,fullname)
επιτυχίαΕπανάκληση Function όχι

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

errorCallback Function όχι Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

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

Τύπος: Οντότητα Promise<>

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