Megosztás:

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 Táblasor létrehozása a Webes API használatával a táblarekord létrehozásához használt adatobjektum definiálásához.

Alapszintű létrehozás

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épek csak online módban hozhatók létre. Más képoszlopok nem állíthatók be létrehozással. 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ágok értékeiként definiálja őket. Ezt a mintát mély beszúrásnak nevezzük. Ebben a példában létrehozunk egy mintafiókrekordot 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ásához

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

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ó: Webes API-navigáció tulajdonságai

Í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:

@odata.bind A korábban bemutatott széljegyzet-példa helyett a kis- és nagybetűk megkülönböztetésévellogicalname (és id) rendelkező elavult keresési objektum továbbra is támogatott a meglévő testreszabások esetében. Javasoljuk azonban, hogy az elavult objektum használata helyett az online és offline forgatókönyvben is használjon @odata.bind széljegyzetet.

Az alábbi példa az elavult módszerrel 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

  • Last updated on