createRecord (Référence API JavaScript) pour l’environnement d’intégration du canal de Dynamics 365 1.0

  • Article

Crée un enregistrement d’entité.

Syntaxe

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

Paramètres

Nom  Type Requise Description
entityLogicalName Chaîne Oui Nom logique de l’entité à créer. Par exemple : « compte ».
Données String Oui Chaîne définissant les attributs et valeurs du nouvel enregistrement d’entité.
successCallback Fonction Non Fonction à appeler lorsqu’un enregistrement est créé.
errorCallback Fonction Non Fonction à appeler lorsque l’opération échoue.

Valeur renvoyée

En cas de réussite, retourne une promesse contenant la chaîne avec les attributs et leurs valeurs.

Exemples

L’exemple de code montre comment créer un exemple d’enregistrement de contact.

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

L’exemple suivant montre comment vous pouvez transmettre une valeur de recherche au lieu de texte brut dans 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
      }
);