createRecord (αναφορά API προγράμματος-πελάτη)

Δημιουργεί μια εγγραφή πίνακα.

Σύνταξη

Xrm.WebApi.createRecord(entityLogicalName, data).then(successCallback, errorCallback);

Παράμετροι

Name Δακτυλογραφώ Απαραίτητο Περιγραφή
entityLogicalName Συμβλοσειρά Ναι Λογικό όνομα του πίνακα που θέλετε να δημιουργήσετε. Για παράδειγμα: account.
data Αντικείμενο Ναι Ένα αντικείμενο JSON που ορίζει τις στήλες και τις τιμές για τη νέα εγγραφή πίνακα. Δείτε παραδείγματα
successCallback Function Όχι Μια συνάρτηση για κλήση κατά τη δημιουργία μιας εγγραφής. Ανατρέξτε στο θέμα Τιμή επιστροφής
errorCallback Function Όχι Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία. Διαβιβάζεται ένα αντικείμενο με τις ακόλουθες ιδιότητες:
- errorCode:Αριθμός. Ο κωδικός σφάλματος ως θετικός δεκαδικός αριθμός. Για παράδειγμα, ο κωδικός σφάλματος που τεκμηριώνεται ως 0x80040333 θα επιστραφεί ως 2147746611.
- message:Σειρά. Ένα μήνυμα λάθους που περιγράφει το ζήτημα.

Επιστρεφόμενη αξία

Με επιτυχία, επιστρέφει ένα αντικείμενο υπόσχεσης στο successCallback με τις ακόλουθες ιδιότητες:

Name Δακτυλογραφώ Περιγραφή
entityType Συμβλοσειρά Το λογικό όνομα πίνακα της νέας εγγραφής.
id Συμβλοσειρά GUID της νέας εγγραφής.

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

Αυτά τα παραδείγματα χρησιμοποιούν τα ίδια αντικείμενα αίτησης με το ακόλουθο άρθρο: Δημιουργία γραμμής πίνακα με χρήση του API Web. Το άρθρο περιγράφει τον τρόπο ορισμού του αντικειμένου δεδομένων για τη δημιουργία μιας εγγραφής πίνακα.

Παράδειγμα Αποδεικνύει Παράδειγμα Web API
Βασική δημιουργία Πώς μπορείτε να δημιουργήσετε μια εγγραφή λογαριασμού με τιμές στήλης. Βασική δημιουργία
Δημιουργία σχετικών εγγραφών πίνακα μαζί με την κύρια εγγραφή Πώς μπορείτε να δημιουργήσετε ένα λογαριασμό και σχετικές εγγραφές επαφής, ευκαιρίας και εργασίας σε μία μόνο λειτουργία. Δημιουργία σχετικών γραμμών πίνακα σε μία λειτουργία
Συσχέτιση πινάκων κατά τη δημιουργία νέων εγγραφών Πώς μπορείτε να συσχετίσετε έναν νέο λογαριασμό με μια υπάρχουσα επαφή χρησιμοποιώντας τη συνάρτηση @odata.bind. Συσχέτιση γραμμών πίνακα κατά τη δημιουργία

Παράδειγμα βασικής δημιουργίας

Δημιουργεί ένα δείγμα εγγραφής λογαριασμού.

// define the data to create new account
var data =
    {
        "name": "Sample Account",
        "creditonhold": false,
        "address1_latitude": 47.639583,
        "description": "This is the description of the sample account",
        "revenue": 5000000,
        "accountcategorycode": 1,
        "opendeals_date": new Date("2024-02-03T00:00:00Z")
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Σημείωμα

Η δημιουργία εγγραφών με μια κύρια εικόνα δεν υποστηρίζεται για τη λειτουργία εκτός σύνδεσης. Μπορείτε να ορίσετε κύριες εικόνες μόνο χρησιμοποιώντας τη δυνατότητα Δημιουργία σε λειτουργία online. Δεν μπορείτε να ορίσετε άλλες στήλες εικόνας χρησιμοποιώντας τη δημιουργία. Μάθετε περισσότερα σχετικά με τις κύριες εικόνες

Μπορείτε να δημιουργήσετε πίνακες που σχετίζονται μεταξύ τους, ορίζοντας τους ως τιμές ιδιοτήτων περιήγησης. Αυτό το μοτίβο είναι γνωστό ως εισαγωγή σε βάθος. Σε αυτό το παράδειγμα, δημιουργείτε ένα δείγμα εγγραφής λογαριασμού μαζί με την κύρια εγγραφή επαφής και μια συσχετισμένη εγγραφή ευκαιρίας.

Σημείωμα

Η δημιουργία σχετικών εγγραφών πίνακα σε μία μόνο λειτουργία δημιουργίας δεν υποστηρίζεται για λειτουργία εκτός σύνδεσης.

// define data to create primary and related table records
var data =
    {
        "name": "Sample Account",
        "primarycontactid":
        {
            "firstname": "John",
            "lastname": "Smith"
        },
        "opportunity_customer_accounts":
        [
            {
                "name": "Opportunity associated to Sample Account",
                "Opportunity_Tasks":
                [
                    { "subject": "Task associated to opportunity" }
                ]
            }
        ]
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Παράδειγμα συσχέτισης πινάκων κατά τη δημιουργία νέων εγγραφών

Για να συσχετίσετε νέες εγγραφές πίνακα με υπάρχουσες εγγραφές πίνακα, ορίστε την τιμή των ιδιοτήτων περιήγησης μίας τιμής χρησιμοποιώντας το @odata.bind σχόλιο.

Σημείωμα

Τα ονόματα των ιδιοτήτων περιήγησης μίας τιμής δεν είναι πάντα τα ίδια με τα ονόματα για το LogicalName χαρακτηριστικό αναζήτησης. Βεβαιωθείτε ότι χρησιμοποιείτε την Name τιμή χαρακτηριστικού του NavigationProperty στοιχείου στο έγγραφο υπηρεσίας Web API $metadata. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Ιδιότητες περιήγησης API Web.

Ακολουθεί ένα παράδειγμα κώδικα:

Το παρακάτω παράδειγμα δημιουργεί μια εγγραφή λογαριασμού και την συσχετίζει με μια υπάρχουσα εγγραφή επαφής για να ορίσει τη δεύτερη ως την κύρια επαφή για τη νέα εγγραφή λογαριασμού:

var data =
    {
        "name": "Sample Account",
        "primarycontactid@odata.bind": "/contacts(465b158c-541c-e511-80d3-3863bb347ba8)"
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Υπό απόσυρση μέθοδος για σενάριο για κινητές συσκευές εκτός σύνδεσης

Σημείωμα

Αντί να χρησιμοποιήσετε το @odata.bind παράδειγμα σχολιασμού που εμφανίσατε προηγουμένως, το υπό απόσυρση αντικείμενο αναζήτησης με ιδιότητες με διάκριση πεζών-κεφαλαίων (logicalname και id) εξακολουθεί να υποστηρίζεται για υπάρχουσες προσαρμογές. Ωστόσο, χρησιμοποιήστε το @odata.bind σχόλιο για σενάρια σύνδεσης και εκτός σύνδεσης αντί να χρησιμοποιήσετε αυτό το υπό απόσυρση αντικείμενο.

Το παρακάτω παράδειγμα χρησιμοποιεί τη μέθοδο υπό απόσυρση για να δημιουργήσει μια εγγραφή λογαριασμού και να τη συσχετίσει με μια υπάρχουσα εγγραφή επαφής για να ορίσει τη δεύτερη ως την κύρια επαφή για τη νέα εγγραφή λογαριασμού από προγράμματα-πελάτες κινητής τηλεφωνίας όταν εργάζονται σε λειτουργία χωρίς σύνδεση:

var data =
    {
        "name": "Sample Account",
        "primarycontactid":
        {
            "logicalname": "contact",
            "id": "465b158c-541c-e511-80d3-3863bb347ba8"
        } 
    }

// create account record
Xrm.WebApi.offline.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Δημιουργία γραμμής πίνακα με χρήση του API Web
Xrm.WebApi

  • Τελευταία ενημέρωση στις