Xrm.Page.data.entity (clientreferentie)

Artikel
07/06/2017

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Xrm.Page.data.entity biedt methoden om informatie op te halen die specifiek is voor de weergegeven record op de pagina, de opslagmethode en een verzameling van alle kenmerken die in het formulier zijn opgenomen. De kenmerkgegevens zijn beperkt tot kenmerken die worden vertegenwoordigd door velden op het formulier.

Eigenschappen en methoden van Xrm.Page.data.entity

kenmerken
De verzameling van kenmerken voor de entiteit.
getDataXml
Retourneert een tekenreeks die de xml voorstelt die naar de server wordt gestuurd wanneer de record wordt opgeslagen.
getEntityName
Retourneert een tekenreeks met de logische naam van de entiteit voor de record.
getId
Retourneert een tekst die de GUID-id-waarde van de record vertegenwoordigt.
getIsDirty
Retourneert een Booleaanse waarde die aangeeft of velden in het formulier zijn gewijzigd.
OnSave
Gebruik de methoden addOnSave en removeOnSave om gebeurtenishandlers toe te voegen of te verwijderen voor de opslaggebeurtenis
getPrimaryAttributeValue
Haalt een tekenreeks voor de waarde van het primaire kenmerk van de entiteit.
Opslaan
Slaat de record op met de opties om het formulier te sluiten of een nieuw formulier te openen nadat de opslag is voltooid.

kenmerken

De verzameling Xrm.Page.data.entity.attributes bevat methoden om toegang te krijgen tot de gegevens voor een record die in het formulier wordt weergegeven. Zie voor meer informatie over deze verzameling Verzamelingen (clientreferentie). Zie Xrm.Page.data.entity attribute (clientreferentie) voor eigenschappen en methoden die beschikbaar zijn voor objecten in deze verzameling.

getDataXml

Retourneert een tekenreeks die de XML voorstelt die naar de server wordt gestuurd wanneer de record wordt opgeslagen. Alleen gegevens in velden die zijn gewijzigd, worden ingesteld op de server.

Notitie

Deze functie werkt niet met Microsoft Dynamics CRM voor tablets.

Xrm.Page.data.entity.getDataXml()

Retourwaarde
Type: Tekenreeks

Voorbeeld:: in dit voorbeeld zijn de volgende drie velden voor een accounttype bijgewerkt:
- naam
- accountnumber
- telephone2
```
"<account><name>Contoso</name><accountnumber>55555</accountnumber><telephone2>425 555-1234</telephone2></account>"
```

getEntityName

Retourneert een tekenreeks met de logische naam van de entiteit voor de record.

Xrm.Page.data.entity.getEntityName()

Retourwaarde
Type: Tekenreeks. De naam van de entiteit.

Voorbeeld: in dit voorbeeld is een accountrecord bewerkt.
```
"account"
```

getId

Retourneert een tekst die de GUID-id-waarde van de record vertegenwoordigt.

Xrm.Page.data.entity.getId()

Retourwaarde
Type: Tekenreeks

Voorbeeld: de GUID-id-waarde voor de record.
```
"{825CB223-A651-DF11-AA8B-00155DBA3804}"
```

getIsDirty

Retourneert een Booleaanse waarde die aangeeft of velden in het formulier zijn gewijzigd.

Xrm.Page.data.entity.getIsDirty()

Retourwaarde
Type: Boole-waarde.

OnSave

Gebruik de methoden addOnSave en removeOnSave om gebeurtenishandlers toe te voegen of te verwijderen voor de opslaggebeurtenis

addOnSave

Voegt een functie toe die moet worden aangeroepen als de record wordt opgeslagen.

Xrm.Page.data.entity.addOnSave([function reference])

Parameter
Type: functiereferentie

Opmerkingen: De functie wordt aan de onderkant van de pipeline van de gebeurtenishandler toegevoegd. De uitvoeringscontext wordt automatisch ingesteld als eerste parameter die aan de gebeurtenishandler wordt doorgegeven met deze methode. Zie Uitvoeringscontext (clientreferentie) voor meer informatie.

Voorbeeld: in dit voorbeeld bevat de JavaScript-bibliotheek twee functies. Als de functie addMessageToOnSave wordt toegevoegd aan de gebeurtenis OnLoad van het formulier, wordt de functie displayOrgName toegevoegd als handler voor de gebeurtenis OnSave.
```
function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

function addMessageToOnSave() {
    Xrm.Page.data.entity.addOnSave(displayOrgName);
}
```

removeOnSave

Verwijdert een functie die moet worden aangeroepen als de record wordt opgeslagen.

Xrm.Page.data.entity.removeOnSave([function reference])

Parameter
Type: functiereferentie

Voorbeeld: in dit voorbeeld bevat de JavaScript-bibliotheek twee functies. Als de functie removeMessageFromOnSave wordt toegevoegd aan een formuliergebeurtenis, wordt de functie displayOrgName verwijderd als handler voor de gebeurtenis OnSave.
```
function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

function removeMessageFromOnSave() {
    Xrm.Page.data.entity.removeOnSave(displayOrgName);
}
```

getPrimaryAttributeValue

Haalt een tekenreeks voor de waarde van het primaire kenmerk van de entiteit.

Xrm.Page.data.entity.getPrimaryAttributeValue()

Elke entiteit heeft één tekenreekskenmerk dat is aangeduid als de PrimaryNameAttribute. De waarde voor dit kenmerk wordt gebruikt als koppelingen naar de record worden weergegeven.

Retourwaarde
Type: Tekenreeks. De waarde van het primaire kenmerk van de entiteit.
Opmerkingen
Deze methode is alleen beschikbaar voor Bijgewerkte entiteiten.

Opslaan

Slaat de record synchroon op met de opties om het formulier te sluiten of een nieuw formulier te openen nadat de opslag is voltooid.

Zowel Xrm.Page.data.save als Xrm.Page.data.entity.save slaan de record op, maar Xrm.Page.data.save biedt terugbeloproepfuncties nadat de opslag is voltooid.

Xrm.Page.data.entity.save( null | "saveandclose" |"saveandnew" )

Argumenten
- save()
  Als geen parameter wordt opgenomen, wordt de record gewoon opgeslagen. Dit is het equivalent van de opdracht Opslaan.
- save("saveandclose")
  Dit is het equivalent van de opdracht Opslaan en sluiten.
- save("saveandnew")
  Dit is het equivalent van de opdracht Opslaan en nieuw.

Opmerkingen
Als de functie snel formulieren maken in de webtoepassing wordt gebruikt, wordt de optie saveandnew niet toegepast. Het werkt altijd alsof saveandclose is gebruikt. Snel formulieren maken in Microsoft Dynamics CRM voor tablets past het gedrag saveandnew toe.

Zie ook

Programmeerreferentie op de client
Beknopte naslag voor het opstellen van formulierscripts
Xrm.Page.data.entity attribute (clientreferentie)
Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
Het objectmodel Xrm.Page gebruiken

Delen via