createRecord (Referencia de API JavaScript) para Marco de integración de canal de Dynamics 365 1.0

Crea un registro de entidad.

Sintaxis

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

Parámetros

Name	Type	Obligatorio	Descripción
entityLogicalName	Cadena	Sí	Nombre lógico de la entidad que quiere crear. Por ejemplo: "cuenta".
datos	String	Sí	Cadena que define los atributos y valores del registro de entidad nuevo.
successCallback	Función	No	Una función para llamar cuando se crea un registro.
errorCallback	Función	No	Una función para llamar cuando la operación tiene error.

Valor de retorno

En caso de resultar correcto, devuelve una promesa que contiene una cadena con los atributos y sus valores.

Ejemplos

El siguiente código de ejemplo demuestra cómo crear un registro de contacto de ejemplo.

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

El siguiente ejemplo muestra cómo puede pasar un valor de búsqueda en lugar de texto sin formato en la variable 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
      }
);