Xrm.WebApi.online.executeMultiple (αναφορά API προγράμματος-πελάτη)

Εκτελέστε μια συλλογή ενεργειών, συναρτήσεων ή λειτουργιών CRUD.

Σημείωμα

Αυτή η μέθοδος υποστηρίζεται μόνο για την κατάσταση λειτουργίας online (Xrm.WebApi.online).

Εάν θέλετε να εκτελέσετε πολλές αιτήσεις σε μια συναλλαγή, πρέπει να μεταβιβάσετε μια αλλαγή που έχει οριστεί ως παράμετρος σε αυτήν τη μέθοδο. Τα σύνολα αλλαγών αντιπροσωπεύουν μια συλλογή λειτουργιών που εκτελούνται σε μια συναλλαγή. Μπορείτε επίσης να μεταβιβάσετε μεμονωμένες αιτήσεις και να αλλάξετε σύνολα ως παραμέτρους σε αυτήν τη μέθοδο.

Σημείωμα

• Δεν μπορείτε να συμπεριλάβετε λειτουργίες ανάγνωσης (ανάκτηση, ανάκτηση πολλών συναρτήσεων και web API) ως μέρος ενός συνόλου αλλαγών. Αυτό σύμφωνα με τις προδιαγραφές OData v4.
• Οι αιτήσεις μπορεί να περιέχουν έως 1.000 μεμονωμένες αιτήσεις και δεν μπορούν να περιέχουν άλλες δέσμες. Περισσότερες πληροφορίες: Εκτέλεση λειτουργιών δέσμης.

Σύνταξη

Εκτέλεση πολλαπλών αιτήσεων:

var requests = [req1, req2, req3];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Εκτελέστε πολλαπλές αιτήσεις σε μια συναλλαγή:

Σε αυτήν την περίπτωση, req1τα , req2και req3 εκτελούνται σε μια συναλλαγή.

var changeSet = [req1, req2, req3];
var requests = [changeSet];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Εκτελέστε έναν συνδυασμό μεμονωμένων αιτήσεων και πολλαπλών αιτήσεων σε μια συναλλαγή:

Σε αυτήν την περίπτωση, req1τα , req2και req3 εκτελούνται στη συναλλαγή, αλλά req4 και req5 εκτελούνται μεμονωμένα.

var changeSet = [req1, req2, req3];
var requests = [req4, req5, changeset];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Παράμετροι

Όνομα	Δακτυλογραφώ	Απαραίτητο	Περιγραφή
requests	Πίνακας αντικειμένων	Ναι	Ένας πίνακας με έναν από τους ακόλουθους τύπους: Αντικείμενα στα οποία κάθε αντικείμενο είναι μια ενέργεια, συνάρτηση ή αίτηση CRUD που θέλετε να εκτελεστεί στο τελικό σημείο του API Web. Κάθε αντικείμενο παρουσιάζει μια μέθοδο getMetadata που σας επιτρέπει να ορίσετε τα μετα-δεδομένα για την ενέργεια, τη συνάρτηση ή την αίτηση CRUD που θέλετε να εκτελέσετε. Η μέθοδος εκτέλεσης αποδέχεται αυτόν τον τύπο παραμέτρου. Αλλάξτε το σύνολο (έναν πίνακα αντικειμένων), όπου κάθε αντικείμενο στο σύνολο αλλαγών είναι όπως εξηγήθηκε προηγουμένως. Σε αυτή την περίπτωση, όλα τα αντικείμενα αίτησης που καθορίζονται στο σύνολο αλλαγών εκτελούνται σε μια συναλλαγή. Βρείτε παραδείγματα αιτήσεων στην ενότητα Σύνταξη.
successCallback	Function	όχι	Μια συνάρτηση για κλήση όταν η λειτουργία εκτελεστεί με επιτυχία. Ένας πίνακας αντικειμένων απόκρισης μεταβιβάζεται στη συνάρτηση. Ανατρέξτε στο θέμα Τιμή επιστροφής
errorCallback	Function	όχι	Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία. Διαβιβάζεται ένα αντικείμενο με τις ακόλουθες ιδιότητες: - errorCode:Αριθμός. Ο κωδικός σφάλματος ως θετικός δεκαδικός αριθμός. Για παράδειγμα, ο κωδικός σφάλματος που τεκμηριώνεται ως 0x80040333 θα επιστραφεί ως 2147746611. - message:Σειρά. Ένα μήνυμα λάθους που περιγράφει το ζήτημα.

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

Με επιτυχία, επιστρέφει μια υπόσχεση που περιέχει μια σειρά από αντικείμενα στην successCallback. Τα αντικείμενα έχουν αυτές τις ιδιότητες:

Όνομα	Δακτυλογραφώ	Απαραίτητο	Περιγραφή
json	Υπόσχεση	όχι	Σώμα απόκρισης σε μορφή JSON.
text	Υπόσχεση	όχι	Σώμα απόκρισης σε μορφή απλού κειμένου.
headers	Αντικείμενο	Ναι	Κεφαλίδες απόκρισης.
ok	Boolean	Ναι	Υποδεικνύει εάν η αίτηση ολοκληρώθηκε με επιτυχία.
status	Αριθμός	Ναι	Αριθμητική τιμή στον κωδικό κατάστασης απόκρισης. Για παράδειγμα: 200
statusText	Συμβλοσειρά	Ναι	Περιγραφή του κωδικού κατάστασης απόκρισης. Για παράδειγμα: OK
type	Συμβλοσειρά	Ναι	Τύπος απόκρισης. Οι τιμές είναι: η κενή συμβολοσειρά (προεπιλογή), arraybuffer, blob, document, jsonκαι text.
url	Συμβλοσειρά	Ναι	Αίτηση διεύθυνσης URL για την ενέργεια, συνάρτηση ή αίτηση CRUD που στάλθηκε στο τελικό σημείο Web API.

Σχετικά άρθρα

Xrm.WebApi