updateRecord (αναφορά API JavaScript) για το Dynamics 365 Channel Integration Framework 1.0

Ενημερώνει μια καρτέλα οντότητας.

Syntax

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

Parameters

Πλήρες όνομα Type Απαραίτητο Περιγραφή
entityΛογικό_όνομα String Όχι Το λογικό όνομα οντότητας της καρτέλας που θέλετε να ενημερώσετε. Για παράδειγμα: "λογαριασμός".
αναγνωριστικό String Όχι GUID της καρτέλας οντότητας που θέλετε να ενημερώσετε.
δεδομένα String Όχι

Συμβολοσειρά που περιέχει key: value ζεύγη, όπου key είναι η ιδιότητα της οντότητας και value είναι η τιμή της ιδιότητας που θέλετε να ενημερώσετε.

Δείτε παραδείγματα παρακάτω σε αυτό το θέμα για να δείτε πώς μπορείτε να ορίσετε τη data συμβολοσειρά για το σενάριο ενημέρωσης.

επιτυχίαΕπανάκληση Function όχι

Μια συνάρτηση που καλείται όταν ενημερώνεται μια εγγραφή.

errorCallback Function όχι Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

Τιμή επιστροφής

Κατά την επιτυχία, επιστρέφει μια υπόσχεση που περιέχει μια συμβολοσειρά με τα ενημερωμένα χαρακτηριστικά και τις τιμές τους.

Παραδείγματα

Αυτό το δείγμα κώδικα ενημερώνει μια υπάρχουσα εγγραφή επαφής με αναγνωριστικό εγγραφής = 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
      }
  );