Delen via


createRecord (JavaScript API-referentie) voor Dynamics 365 Channel Integration Framework 1.0

Hiermee maakt u een entiteitsrecord.

Syntaxis

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

Parameterwaarden

Naam Typologie Verplicht Description
entityLogicalName String Yes Logische naam van de entiteit die u wilt maken. Bijvoorbeeld: "account".
gegevens String Yes Tekenreeks die de kenmerken en waarden voor de nieuwe entiteitsrecord definieert.
succesTerugbellen Functie Nee. Een functie om aan te roepen wanneer een record wordt gemaakt.
foutCallback Functie Nee. Een functie om aan te roepen wanneer de bewerking mislukt.

Retourwaarde

Als dit lukt, wordt een belofte geretourneerd die een tekenreeks bevat met de kenmerken en hun waarden.

Voorbeelden

De voorbeeldcode laat zien hoe u een voorbeeldcontactpersoonrecord maakt.

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
      }
  ); 

In het volgende voorbeeld ziet u hoe u een opzoekwaarde kunt doorgeven in plaats van tekst zonder opmaak in de variabele 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
      }
);