Κοινοποίηση μέσω

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 της νέας εγγραφής.

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

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

Βασική δημιουργία

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

// 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

  • Last updated on