createRecord (Référence API JavaScript) pour l’environnement d’intégration du canal de Dynamics 365 1.0
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
}
);