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

יוצר רשומת ישות.

תחביר

Microsoft.CIFramework.createRecord(entityLogicalName, data).then(successCallback, errorCallback);

פרמטרים

שם	Type	חובה	תיאור
entityLogicalName	String	כן	השם הלוגי של הישות שברצונך ליצור. לדוגמה: "חשבון".
נתונים	String	כן	מחרוזת המגדירה את התכונות והערכים עבור רשומת הישות החדשה.
הצלחההתקשרות חוזרת	פונקציה	לא	פונקציה שיש לקרוא לה בעת יצירת רשומה.
errorהתקשרות חוזרת	פונקציה	לא	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת.

ערך החזרה

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

דוגמאות

הקוד לדוגמה מדגים כיצד ליצור רשומת איש קשר לדוגמה.

var entityLogicalName = "contact";
var data = {
    "firstname": "Sample",
    "lastname": "Contact",
    "fullname": "Sample Contact",
    "emailaddress1": "contact@contoso.com",
    "jobtitle": "Sr. Marketing Manager",
    "telephone1": "555-0109",
    "description": "Default values for this record were set programmatically."
}
// create contact record
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.createRecord(entityLogicalName,jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact created with ID: " + res.id);
          //perform operations on record creation
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
  ); 

הדוגמה הבאה מראה כיצד ניתן להעביר ערך בדיקת מידע במקום טקסט רגיל במשתנה data.

var data =
    {
        "name": "Sample Account",
        "primarycontactid@odata.bind": "/contacts(3518ddae-2f46-e911-8190-000d3a6ce16d)"
    }
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.createRecord("account",jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact created with ID: " + res.id);
          //perform operations on record creation
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
);