הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
עדכון רשומת טבלה.
תחביר
Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);
פרמטרים
| שם | Type | נדרש | תיאור |
|---|---|---|---|
entityLogicalName |
String | כן | השם הלוגי של הטבלה של הרשומה שברצונך לעדכן. לדוגמה: account. |
id |
String | כן | GUID של רשומת הטבלה שברצונך לעדכן. |
data |
חפץ | כן | אובייקט JSON המכיל זוגות key: value , כאשר key הוא המאפיין של value הטבלה והוא הערך של המאפיין שברצונך לעדכן.ראה דוגמאות כדי לראות כיצד באפשרותך להגדיר את האובייקט data עבור תרחישי עדכון שונים. |
successCallback |
פונקציה | כן | פונקציה שיש לקרוא לה כאשר רשומה מתעדכנת. ראה ערך החזרה |
errorCallback |
פונקציה | כן | פונקציה שיש לקרוא לה כאשר הפעולה נכשלת. אובייקט עם המאפיינים הבאים מועבר: - errorCode:מספר. קוד השגיאה כמספר עשרוני חיובי. לדוגמה, קוד השגיאה שתועד כפי 0x80040333 שהוא יוחזר בתור 2147746611.- message:מחרוזת. הודעת שגיאה המתארת את הבעיה. |
ערך החזרה
בעת הצלחה, החזרת אובייקט promise ל- successCallback עם המאפיינים הבאים:
| שם | Type | תיאור |
|---|---|---|
entityType |
String | השם הלוגי של הטבלה של הרשומה. |
id |
String | GUID של הרשומה. |
דוגמאות
דוגמאות אלה משתמשות בחלק מאותם אובייקטי בקשה כפי שהודגם בעדכון ומחיקה של שורות טבלה באמצעות ה- API של האינטרנט כדי להגדיר את אובייקט הנתונים לעדכון רשומת טבלה.
| דוגמה | מדגים | דוגמה ל- API של אינטרנט |
|---|---|---|
| עדכון בסיסי | כיצד לעדכן ערכי עמודות ברשומת חשבון קיימת. | עדכון בסיסי |
| עדכון שיוכים לטבלאות הקשורות | כיצד לשנות איש קשר ראשי של חשבון באמצעות @odata.bind. |
שיוך למאפיין ניווט עם ערך יחיד |
| עדכון שיוכי טבלאות קשורות מסוג 'פעילות' | כיצד לשייך משימה להזדמנות או להגדיר את בדיקת המידע שלה בחשבון. | שיוך למאפיין ניווט עם ערך יחיד |
| עדכון שיוכים עבור מאפייני ניווט עם ערך אוסף | כיצד לשייך ולבצע ביטול שיוך של רשומות קשורות באמצעות Xrm.WebApi.online.execute. |
הוספת רשומה לאוסףוהסרה של רשומה מאוסף |
דוגמה לעדכון בסיסי
עדכון רשומת חשבון קיימת עם מזהה רשומה = 5531d753-95af-e711-a94e-000d3a11e605.
// define the data to update a record
var data =
{
"name": "Updated Sample Account ",
"creditonhold": true,
"address1_latitude": 47.639583,
"description": "This is the updated description of the sample account",
"revenue": 6000000,
"accountcategorycode": 2
}
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Account updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
דוגמה לעדכון שיוכי טבלאות קשורות
כדי לעדכן שיוך לרשומות הטבלה הקשורות (בדיקות מידע), @odata.bind הגדר את הערך של מאפייני ניווט עם ערך יחיד באמצעות הביאור כדי להצביע על רשומה אחרת.
להלן דוגמה לקוד:
הדוגמה הבאה מעדכת רשומת תיק לקוח כדי לשייך רשומת איש קשר אחרת כ איש הקשר הראשי עבור החשבון:
// define the data to update a record
var data =
{
"primarycontactid@odata.bind": "/contacts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
}
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Account updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
שיטה הוצאה משימוש עבור תרחיש לא מקוון למכשירים ניידים
הערה
במקום להשתמש לביאור @odata.bind בדוגמה הקודמת, אובייקט בדיקת המידע שהוצאה משימוש עם מאפיינים תלויי רישיות ( logicalnameidו- ) עדיין נתמך בהתאמות אישיות קיימות. עם זאת, מומלץ להשתמש @odata.bind לביאור הן עבור תרחישים מקוונים והן עבור תרחישים לא מקוונים במקום להשתמש באובייקט זה שהוצאה משימוש.
הדוגמה הבאה משתמשת בשיטה שהוצאה משימוש כדי לעדכן רשומת תיק לקוח כדי לשייך רשומת איש קשר אחרת כ איש הקשר הראשי עבור החשבון מהלקוחות הניידים בעת עבודה במצב לא מקוון:
// define the data to update a record
var data =
{
"primarycontactid":
{
"logicalname": "contact",
"id": "61a0e5b9-88df-e311-b8e5-6c3be5a8b200"
}
}
// update the record
Xrm.WebApi.offline.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Account updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
עדכן שיוכים לטבלאות הקשורות מסוג 'דוגמה לפעילות'
כדי לעדכן שיוכים לטבלאות הקשורות מסוג 'פעילות' @odata.bind , הגדר את הערך של מאפייני ניווט עם ערך יחיד באמצעות הביאור כדי להצביע על רשומה אחרת.
עדכן עמודת הזדמנות קשורה בפעילות
// define the data to update a record
var data =
{
"new_relatedopportunities_task@odata.bind": "/opportunities(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
}
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Task updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
עדכון לגבי עמודה בפעילות
// define the data to update a record
var data =
{
"regardingobjectid_account_task@odata.bind": "/accounts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
}
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Task updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
דוגמה לעדכון שיוכי ניווט עם ערך אוסף
השתמש ב - API Xrm.WebApi.online.execute כדי לשייך ולבצע שיוך של מאפייני ניווט בעלי ערך אוסף. תכונה זו אינה נתמכת עבור תרחישים לא מקוונים במכשירים ניידים.