Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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
Kapcsolódó táblarekordok létrehozása az elsődleges rekord példájával együtt
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
}
);
Kapcsolódó cikkek
Táblázatsor létrehozása a Webes API használatával
Xrm.WebApi