updateRecord (חומר עזר עבור API של לקוח)

עדכון רשומת טבלה.

תחביר

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 של האינטרנט כדי להגדיר את אובייקט הנתונים לעדכון רשומת טבלה.

עדכון בסיסי

עדכון רשומת חשבון קיימת עם מזהה רשומה = 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 כדי לשייך ולבצע שיוך של מאפייני ניווט בעלי ערך אוסף. פעולה זו אינה נתמכת עבור תרחישים לא מקוונים של מכשירים ניידים.

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

Xrm.WebApi