createRecord (ügyfél API-referencia)

Táblarekordot hoz létre.

Szemantika

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

Paraméterek

Név Típus Kötelező Description
entityLogicalName Lánc Igen A létrehozni kívánt tábla logikai neve. Például: account.
data Objektum Igen Az új táblarekord oszlopait és értékeit meghatározó JSON-objektum. Példák megtekintése
successCallback Funkció Nem Egy függvény, amelyet egy rekord létrehozásakor hívnak meg. Lásd : Visszatérési érték
errorCallback Funkció Nem A művelet sikertelensége esetén meghívandó függvény. A következő tulajdonságokkal rendelkező objektumok átadása történik:
- errorCode:Szám. A hibakód pozitív decimális számként. Például a dokumentált 0x80040333 hibakód a következőként 2147746611lesz visszaadva: .
- message:Húr. A problémát leíró hibaüzenet.

Visszaadott érték

Siker esetén egy ígéretobjektumot ad vissza a successCallback következő tulajdonságokkal:

Név Típus Description
entityType Lánc Az új rekord tábla logikai neve.
id Lánc Az új rekord GUID azonosítója.

Példák

Ezek a példák ugyanazokat a kérésobjektumokat használják, mint a következő cikk: Táblasor létrehozása a Webes API használatával. A cikk bemutatja, hogyan definiálhatja az adatobjektumot táblarekord létrehozásához.

Example Megmutatja Példa webes API-ra
Alapszintű létrehozás Fiókrekord létrehozása oszlopértékekkel. Alapszintű létrehozás
Kapcsolódó táblarekordok és az elsődleges rekord létrehozása Fiók- és kapcsolódó partner-, lehetőség- és tevékenységrekordok létrehozása egyetlen műveletben. Kapcsolódó táblázatsorok létrehozása egyetlen műveletben
Táblák társítása új rekordok létrehozásakor Új fiók társítása meglévő partnerrel a következő használatával @odata.bind: . Táblasorok társítása létrehozáshoz

Egyszerű létrehozási példa

Létrehoz egy mintafiókrekordot.

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

Megjegyzés:

Az elsődleges képpel rendelkező rekordok létrehozása offline módban nem támogatott. Az elsődleges képeket csak online módban történő létrehozással állíthatja be. A létrehozással nem állíthat be más képoszlopokat. További információ az elsődleges rendszerképekről

Az egymáshoz kapcsolódó táblákat úgy hozhatja létre, hogy navigációs tulajdonságértékekként definiálja őket. Ezt a mintát mély beszúrásnak nevezzük. Ebben a példában egy mintafiókrekordot hoz létre az elsődleges kapcsolattartó rekorddal és egy kapcsolódó lehetőségrekorddal együtt.

Megjegyzés:

A kapcsolódó táblarekordok egyetlen létrehozási műveletben való létrehozása offline módban nem támogatott.

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

Táblák társítása új rekordok létrehozásakor – példa

Ha új táblarekordokat szeretne társítani a meglévő táblarekordokkal, a széljegyzet használatával állítsa be az @odata.bind egyértékű navigációs tulajdonságok értékét.

Megjegyzés:

Az egyértékű navigációs tulajdonságok neve nem mindig egyezik meg a LogicalName keresési attribútum nevével. Győződjön meg arról, hogy a Name Web API $metadata szolgáltatásdokumentumban az elem attribútumértékét NavigationProperty használja. További információt a Webes API navigációs tulajdonságai című témakörben talál.

Íme egy példa kódra:

Az alábbi példa létrehoz egy fiókrekordot, és egy meglévő partnerrekordhoz társítja, hogy az utóbbi legyen az új fiókrekord elsődleges kapcsolattartója:

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

Elavult módszer mobil offline forgatókönyv esetén

Megjegyzés:

A korábban bemutatott jegyzetes példa helyett @odata.bind a kis- és idnagybetűket megkülönböztető tulajdonsággallogicalname rendelkező elavult keresési objektum továbbra is támogatott a meglévő testreszabások esetében. A széljegyzetet azonban online és offline forgatókönyvekhez is használhatja @odata.bind az elavult objektum használata helyett.

Az alábbi példa az elavult metódus használatával hoz létre egy fiókrekordot, és társítja egy meglévő partnerrekordhoz, hogy az utóbbi legyen az új fiókrekord elsődleges kapcsolattartója a mobil ügyfelektől, amikor offline módban dolgozik:

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

Táblázatsor létrehozása a Webes API használatával
Xrm.WebApi