Xrm.WebApi.online.executeMultiple (חומר עזר עבור API של לקוח)

ביצוע אוסף של פעולות פעולה, פונקציה או CRUD.

הערה

שיטה זו נתמכת רק עבור המצב המקוון (Xrm.WebApi.online).

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

הערה

• לא ניתן לכלול פעולות קריאה (אחזור, אחזור פונקציות מרובות ופונקציות 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);

Parameters

שם	Type	נדרש	Description
requests	מערך אובייקטים	כן	מערך של אחד הסוגים הבאים: אובייקטים שבהם כל אובייקט הוא פעולה, פונקציה או בקשת CRUD שברצונך לבצע מול נקודת הקצה של ה- API של האינטרנט. כל אובייקט חושף פעולת שירות getMetadata המאפשרת לך להגדיר את המטה-נתונים עבור הפעולה, הפונקציה או בקשת CRUD שברצונך לבצע. פעולת השירות execute מקבלת סוג זה של פרמטר. ערכת שינויים (מערך של אובייקטים), כאשר כל אובייקט בערכת שינויים הוא כפי שהוסבר קודם לכן. במקרה זה, כל אובייקטי הבקשה שצוינו בערכת השינויים מבוצעים בטרנזקציה. חפש דוגמאות לבקשות במקטע תחביר.
successCallback	פונקציה	לא	פונקציה להתקשרות כאשר הפעולה מבוצעת בהצלחה. מערך של אובייקטי תגובה מועבר לפונקציה. ראה ערך החזרה
errorCallback	פונקציה	לא	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת. אובייקט עם המאפיינים הבאים מועבר: - errorCode:מספר. קוד השגיאה כמספר עשרוני חיובי. לדוגמה, קוד השגיאה שתועד כפי 0x80040333 שהוא יוחזר בתור 2147746611. - message:מחרוזת. הודעת שגיאה המתארת את הבעיה.

ערך החזרה

בעת ההצלחה, החזרת הבטחה המכילה מערך של אובייקטים ל- successCallback. האובייקטים כוללים מאפיינים אלה:

שם	Type	נדרש	Description
json	הבטחה	לא	גוף התגובה בתבנית JSON.
text	הבטחה	לא	גוף התגובה בתבנית טקסט רגיל.
headers	Object	כן	כותרות תגובה.
ok	בוליאני	כן	מציין אם הבקשה הצליחה.
status	מספר	כן	ערך מספרי בקוד מצב התגובה. לדוגמה: 200
statusText	String	כן	תיאור של קוד מצב התגובה. לדוגמה: OK
type	String	כן	סוג תגובה. הערכים הם: המחרוזת הריקה (ברירת מחדל), arraybuffer, blob, document, json, ו- text.
url	String	כן	כתובת URL של בקשה עבור הפעולה, הפונקציה או בקשת CRUD שנשלחה אל נקודת הקצה של ה- API של האינטרנט.

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

Xrm.WebApi