Delen via

createRecord (client-API-verwijzing)

Hiermee maakt u een tabelrecord.

Syntaxis

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

Parameterwaarden

Naam Typologie Verplicht Description
entityLogicalName Snaar / Touwtje Yes Logische naam van de tabel die u wilt maken. Voorbeeld: account.
data Object Yes Een JSON-object waarmee de kolommen en waarden voor de nieuwe tabelrecord worden gedefinieerd. Voorbeelden bekijken
successCallback Functie Nee. Een functie om aan te roepen wanneer een record wordt gemaakt. Zie Retourwaarde
errorCallback Functie Nee. Een functie om aan te roepen wanneer de bewerking mislukt. Er wordt een object met de volgende eigenschappen doorgegeven:
- errorCode:Getal. De foutcode als een positief decimaal getal. De foutcode die wordt beschreven zoals 0x80040333 wordt geretourneerd als 2147746611.
- message:Snaar. Een foutmelding die het probleem beschrijft.

Retourwaarde

Retourneert bij succes een promise-object aan de successCallback hand van de volgende eigenschappen:

Naam Typologie Description
entityType Snaar / Touwtje De logische tabelnaam van de nieuwe record.
id Snaar / Touwtje GUID van de nieuwe record.

Voorbeelden

In deze voorbeelden worden dezelfde aanvraagobjecten gebruikt als in Een tabelrij maken met behulp van de Web-API om het gegevensobject te definiëren voor het maken van een tabelrecord.

Basis maken

Hiermee maakt u een voorbeeldaccountrecord.

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

Opmerking

Het maken van records met een primaire installatiekopie wordt niet ondersteund voor de offlinemodus. Primaire installatiekopieën kunnen alleen worden ingesteld met maken in de onlinemodus. Andere afbeeldingskolommen kunnen niet worden ingesteld met maken. Meer informatie over primaire installatiekopieën

U kunt tabellen met elkaar maken door ze te definiëren als waarden voor navigatie-eigenschappen. Dit patroon wordt deep insert genoemd. In dit voorbeeld maken we een voorbeeldaccountrecord samen met de primaire contactpersoonrecord en een bijbehorende verkoopkansrecord.

Opmerking

Het maken van gerelateerde tabelrecords in één maakbewerking wordt niet ondersteund voor de offlinemodus.

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

Tabellen koppelen voor het maken van nieuwe records

Als u nieuwe tabelrecords wilt koppelen aan bestaande tabelrecords, stelt u de waarde van navigatie-eigenschappen met één waarde in met behulp van de @odata.bind aantekening.

Opmerking

De namen van navigatie-eigenschappen met één waarde zijn niet altijd hetzelfde als voor LogicalName het opzoekkenmerk. Zorg ervoor dat u de Name kenmerkwaarde van het element in het NavigationProperty web-API-$metadata servicedocument gebruikt. Meer informatie: Eigenschappen van web-API-navigatie

Hier volgt een codevoorbeeld:

In het volgende voorbeeld wordt een accountrecord gemaakt en gekoppeld aan een bestaande record voor contactpersonen om deze record in te stellen als de primaire contactpersoon voor de nieuwe accountrecord:

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

Afgeschafte methode voor mobiel offlinescenario

Opmerking

In plaats van een eerder weergegeven voorbeeld van aantekeningen te gebruiken @odata.bind , wordt het afgeschafte opzoekobject met hoofdlettergevoelige eigenschappen (logicalname en id) nog steeds ondersteund voor bestaande aanpassingen. Het wordt echter aanbevolen om aantekeningen te gebruiken @odata.bind voor zowel online- als offlinescenario's in plaats van dit afgeschafte object te gebruiken.

In het volgende voorbeeld wordt de afgeschafte methode gebruikt om een accountrecord te maken en deze te koppelen aan een bestaande contactpersoonrecord om de laatste als primaire contactpersoon voor de nieuwe accountrecord van mobiele clients in te stellen bij het werken in de offlinemodus:

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

Een tabelrij maken met behulp van de web-API
Xrm.WebApi

  • Last updated on