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

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

Xrm.WebApi