Partilhar via


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

Atualiza um registro de entidade.

Sintaxe

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

Parâmetros

Nome Tipo Obrigatório Description
entityLogicalName Cordão Yes O nome lógico da entidade do registro que você deseja atualizar. Por exemplo: "conta".
id Cordão Yes GUID do registro de entidade que você deseja atualizar.
dados Cordão Yes

String contendo key: value pares, onde key é a propriedade da entidade e value é o valor da propriedade que você deseja atualizar.

Consulte exemplos mais adiante neste tópico para ver como você pode definir a data cadeia de caracteres para o cenário de atualização.

successCallback Função Não

Uma função para chamar quando um registro é atualizado.

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 atualizados e seus valores.

Examples

Este código de exemplo atualiza um registro de contato existente com ID de registro = 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
      }
  );