Xrm.Page.data.entity (klientsidereference)

Artikel
07/06/2017

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Xrm.Page.data.entity indeholder metoder til at hente specifikke oplysninger om den post, der vises på siden, metoden til at gemme og en samling af alle de attributter, der er medtaget i formularen. Attributdata er begrænset til attributter, der er repræsenteret af felterne i formularen.

Egenskaber og metoder for Xrm.Page.data.entity

attributter
Samlingen af attributter for objektet.
getDataXml
Returnerer en streng, som repræsenterer den xml, der bliver sendt til serveren, når posten gemmes.
getEntityName
Returnerer en streng, som repræsenterer det logiske navn på objektet for posten.
getId
Returnerer en streng, der repræsenterer GUID-id-værdien for posten.
getIsDirty
Returnerer en boolesk værdi, der angiver, om alle felter i formularen er blevet ændret.
OnSave
Brug metoderne addOnSave og removeOnSave til at tilføje eller fjerne hændelseshandlere til/fra lagringshændelsen
getPrimaryAttributeValue
Henter en streng til værdien af den primære attribut for objektet.
Gem
Gemmer posten med mulighed for at lukke formularen eller åbne en ny formular, når dokumentet er fuldført.

attributter

Samlingen Xrm.Page.data.entity.attributes indeholder metoder til at få adgang til data for en post, der vises i formularen. Du kan finde flere oplysninger om denne samling i Grupper (klientsidereference). Se Attributten Xrm.Page.data.entity (klientsidereference) for egenskaber og metoder, der er tilgængelige for objekter i denne samlingen.

getDataXml

Returnerer en streng, som repræsenterer den XML, der bliver sendt til serveren, når posten gemmes. Kun data i felter, der er blevet ændret, sendes til serveren.

Bemærk

Denne funktion fungerer ikke sammen med Microsoft Dynamics CRM til tablets.

Xrm.Page.data.entity.getDataXml()

Returværdi
Type: streng

**Eksempel:**I dette eksempel blev de følgende tre felter for en firmapost opdateret:
- navn
- accountnumber
- telephone2
```
"<account><name>Contoso</name><accountnumber>55555</accountnumber><telephone2>425 555-1234</telephone2></account>"
```

getEntityName

Returnerer en streng, som repræsenterer det logiske navn på objektet for posten.

Xrm.Page.data.entity.getEntityName()

Returværdi
Type: streng. Navnet på objektet.

Eksempel: I dette eksempel blev en firmapost redigeret.
```
"account"
```

getId

Returnerer en streng, der repræsenterer GUID-id-værdien for posten.

Xrm.Page.data.entity.getId()

Returværdi
Type: streng

Eksempel: GUID-id-værdien for posten.
```
"{825CB223-A651-DF11-AA8B-00155DBA3804}"
```

getIsDirty

Returnerer en boolesk værdi, der angiver, om alle felter i formularen er blevet ændret.

Xrm.Page.data.entity.getIsDirty()

Returværdi
Type: Boolesk

OnSave

Brug metoderne addOnSave og removeOnSave til at tilføje eller fjerne hændelseshandlere til/fra lagringshændelsen

addOnSave

Tilføjer en funktion der skal kaldes, når posten gemmes.

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

Parameter
Type: funktionsreference

Bemærkninger: Funktionen føjes til bunden af hændelseshandlerens pipeline. Kørselskonteksten angives automatisk til at være den første parameter, der overføres til hændelseshandlere, som angives ved hjælp af denne metode. Du kan finde flere oplysninger under Kontekst for udførelse (klientsidereference).

Eksempel: I dette eksempel indeholder JavaScript-biblioteket to funktioner. Når funktionen addMessageToOnSave tilføjes til formularhændelsen OnLoad, tilføjes funktionen displayOrgName som en handler til hændelsen OnSave.
```
function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

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

removeOnSave

Fjerner en funktion der skal kaldes, når posten gemmes.

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

Parameter
Type: funktionsreference

Eksempel: I dette eksempel indeholder JavaScript-biblioteket to funktioner. Når funktionen removeMessageFromOnSave tilføjes til en formularhændelse, fjernes funktionen displayOrgName som en handler for hændelsen OnSave.

function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

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

getPrimaryAttributeValue

Henter en streng til værdien af den primære attribut for objektet.

Xrm.Page.data.entity.getPrimaryAttributeValue()

Hvert objekt har en strengattribut, der er udpeget som PrimaryNameAttribute. Værdien for denne attributten bruges, når der vises links til posten.

Returværdi
Type: streng. Værdien af den primære attribut for objektet.
Bemærkninger
Denne metode er kun tilgængelig for Opdaterede objekter.

Gem

Gemmer posten synkront med mulighed for at lukke formularen eller åbne en ny formular, når dokumentet er fuldført.

Både Xrm.Page.data.save og Xrm.Page.data.entity.save gemmer posten, men Xrm.Page.data.save indeholder tilbagekaldsfunktioner, efter at lagringshandlingen er fuldført.

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

Argumenter
- save()
  Hvis ingen parameter er inkluderet, gemmes posten blot. Dette svarer til at bruge kommandoen Gem.
- save("saveandclose")
  Dette svarer til at bruge kommandoen Gem og luk.
- save("saveandnew")
  Dette svarer til at bruge kommandoen Gem og ny(t).

Bemærkninger
Ved brug af formularer til hurtig oprettelse i webprogrammet anvendes indstillingen saveandnew ikke. Det fungerer altid, som om saveandclose blev brugt. Formularer til hurtig oprettelse i Microsoft Dynamics CRM til tablets anvender funktionsmåden saveandnew.

Se også

Programmeringsreference på klientsiden
Formularscripter - hurtig henvisning
Attributten Xrm.Page.data.entity (klientsidereference)
Skrive kode til Microsoft Dynamics CRM 2015-formularer
Bruge Xrm.Page-objektmodel