Partilhar via


createRecord (Referência da API JavaScript) para Dynamics 365 Channel Integration Framework 1.0

Cria um registro de entidade.

Sintaxe

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

Parâmetros

Nome Tipo Obrigatório Description
entityLogicalName Cordão Yes Nome lógico da entidade que você deseja criar. Por exemplo: "conta".
dados Cordão Yes String que define os atributos e valores para o novo registro de entidade.
successCallback Função Não Uma função para chamar quando um registro é criado.
errorCallback Função Não Uma função para chamar quando a operação falhar.

Valor de retorno

Quando for bem-sucedido, retorna uma promessa contendo uma cadeia de caracteres com os atributos e seus valores.

Examples

O código de exemplo demonstra como criar um registro de contato de exemplo.

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

O exemplo a seguir mostra como você pode passar um valor de pesquisa em vez de texto sem formatação na variável 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
      }
);