updateRecord (הפניה ל- API של JavaScript) עבור Dynamics 365 Channel Integration Framework 2.0

מעדכן רשומת ישות.

תחביר

microsoft-ciframework.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);

פרמטרים

שם	Type	נדרש	תיאור‬‏‫‬
entityLogicalName	String	כן	השם הלוגי של הישות של הרשומה שברצונך לעדכן. לדוגמה: "חשבון".
id	String	כן	GUID של רשומת הישות שברצונך לעדכן.
נתונים	String	כן	מחרוזת המכילה key: value זוגות, כאשר key הוא המאפיין של הישות והוא value הערך של המאפיין שברצונך לעדכן. ראה דוגמאות בהמשך נושא זה כדי לראות כיצד ניתן להגדיר את data המחרוזת עבור תרחיש העדכון.
הצלחההתקשרות חוזרת	פונקציה	לא	פונקציה שיש לקרוא לה כאשר רשומה מתעדכנת.
errorהתקשרות חוזרת	פונקציה	לא	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת.

ערך החזרה

בעת הצלחה, הפונקציה מחזירה הבטחה המכילה מחרוזת עם התכונות המעודכנות והערכים שלהן.

דוגמאות

קוד לדוגמה זה מעדכן רשומת איש קשר קיימת עם מזהה רשומה = a8a19cdd-88df-e311-b8e5-6c3be5a8b200

//// define the data to update a record
var entityLogicalName = "contact";
var data = {
    "firstname": "Updated Sample",
    "lastname": "Contact",
    "fullname": "Updated Sample Contact",
    "emailaddress1": "contact@contoso.com",
    "jobtitle": "Sr. Marketing Manager",
    "telephone1": "555-0109",
    "description": "Updated values for this record were set programmatically."
}
// update contact record
var id = "b44d31ac-5fd1-e811-8158-000d3af97055";
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.updateRecord(entityLogicalName,id,jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact updated with ID: " + res.id);
          //the record is updated
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
  );