Del via


Xrm.Page.data.entity (klientsidereference)

 

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

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret