Freigeben über


Xrm.Page.data.entity (clientseitige Referenz)

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Xrm.Page.data.entity enthält Methoden zum Abrufen von Informationen, die für den auf der Seite angezeigten Datensatz spezifisch sind, die Speichermethode und eine Sammlung aller im Formular enthaltenen Attribute. Attribute werden durch Felder beschränkt, die im Formular angezeigt werden.

Xrm.Page.data.entity-Eigenschaften und -Methoden

  • Attribute
    Die Sammlung von Attributen für die Entität.

  • getDataXml
    Gibt eine Zeichenfolge zurück, die die xml darstellt, die zum Server gesendet wirdn, wenn der Datensatz gespeichert wird.

  • getEntityName
    Gibt eine Zeichenfolge zurück, die den logische Namen des Entitätsdatensatz darstellt.

  • getId
    Gibt eine Zeichenfolge zurück, die de GUID-ID-Wert für den Datensatz darstellt.

  • getIsDirty
    Gibt einen Booleschen Wert an, der angibt, ob eines der Felder im Formular geändert wurde.

  • OnSave
    Verwenden Sie die addOnSave- und removeOnSave-Methoden, um Ereignishandler im Speichern-Ereignis hinzufügen und zu entfernen.

  • getPrimaryAttributeValue
    Ruft eine Zeichenfolge für den Wert des primären Attributs der Entität ab.

  • Speichern
    Speichert den Datensatz mit Optionen zum Schließen des Formulars oder Öffnen eines neuen Formulars, nachdem das Speichern abgeschlossen ist.

Attribute

Die Xrm.Page.data.entity.attributes-Sammlung bietet Methoden, auf Daten für einen Datensatz zuzugreifen, die im Formular angezeigt werdenl. Weitere Informationen zu dieser Sammlung finden Sie unter Sammlungen (clíentseitige Referenz). Siehe Xrm.Page.data.entity-Attribut (clientseitige Referenz) für die Eigenschaften und Methoden, die für Objekte in dieser Sammlung verfügbar sind.

getDataXml

Gibt eine Zeichenfolge zurück, die die XML darstellt, die zum Server gesendet wird, wenn der Datensatz gespeichert wird. Nur Daten in den Feldern, die geändert wurden, werden auf den Server festgelegt.

Hinweis

Diese Funktion kann nicht mit Microsoft Dynamics 365 für Tablets verwendet werden.

Xrm.Page.data.entity.getDataXml()
  • Rückgabewert
    Typ: Zeichenfolge

    Beispiel: In diesem Beispiel wurden die folgenden drei Felder für einen Firmendatensatz aktualisiert:

    • Name

    • AccountNumber

    • telephone2

    "<account><name>Contoso</name><accountnumber>55555</accountnumber><telephone2>425 555-1234</telephone2></account>"
    

getEntityName

Gibt eine Zeichenfolge zurück, die den logische Namen des Entitätsdatensatz darstellt.

Xrm.Page.data.entity.getEntityName()
  • Rückgabewert
    Typ: Zeichenfolge. Der Name der Entität.

    Beispiel: In diesem Beispiel wurde ein Firmendatensatz bearbeitet.

    "account"
    

getId

Gibt eine Zeichenfolge zurück, die de GUID-ID-Wert für den Datensatz darstellt.

Xrm.Page.data.entity.getId()
  • Rückgabewert
    Typ: Zeichenfolge

    Beispiel: Der GUID-Wert für den Datensatz.

    "{825CB223-A651-DF11-AA8B-00155DBA3804}"
    

getIsDirty

Gibt einen Booleschen Wert an, der angibt, ob eines der Felder im Formular geändert wurde.

Xrm.Page.data.entity.getIsDirty()
  • Rückgabewert
    Typ: Boolesch.

OnSave

Verwenden Sie die addOnSave- und removeOnSave-Methoden, um Ereignishandler im Speichern-Ereignis hinzufügen und zu entfernen.

addOnSave

Fügt eine Funktion hinzu, die aufgerufen wird, wenn der Datensatz gespeichert wird.

Xrm.Page.data.entity.addOnSave([function reference])
  • Parameter
    Typ:-Funktionsverweis

    Anmerkungen: Die Funktion wird unten auf der Ereignishandlerpipeline hinzugefügt. Der Ausführungskontext wird automatisch darauf festgelegt, als der erste Parameter, der an die Ereignishandler übegeben wird, die diese Methode verwenden. Weitere Informationen finden Sie unter Ausführungskontext (clientseitige Referenz).

    Beispiel: In diesem Beispiel enthält die JavaScript-Bibliothek zwei Funktionen. Durch Hinzufügen der addMessageToOnSave-Funktion zum Formular-OnLoad-Ereignis wird die displayOrgName-Funktion als Handler für das OnSave-Ereignis hinzugegfügt.

    function displayOrgName(execContext)
    {
        try {
            alert(execContext.getContext().getOrgUniqueName());
        }
        catch (e) {
            alert(e.message);
        }
    }
    
    function addMessageToOnSave() {
        Xrm.Page.data.entity.addOnSave(displayOrgName);
    }
    

removeOnSave

Entfernt eine Funktion, die aufgerufen werden soll, wenn der Datensatz gespeichert wird.

Xrm.Page.data.entity.removeOnSave([function reference])
  • Parameter
    Typ:-Funktionsverweis

    Beispiel: In diesem Beispiel enthält die JavaScript-Bibliothek zwei Funktionen. Durch Hinzufügen der removeMessageFromOnSave-Funktion zum Formular-displayOrgName-Funktion als Handler für das OnSave-Ereignis hinzugegfügt

    function displayOrgName(execContext)
    {
        try {
            alert(execContext.getContext().getOrgUniqueName());
        }
        catch (e) {
            alert(e.message);
        }
    }
    
    function removeMessageFromOnSave() {
        Xrm.Page.data.entity.removeOnSave(displayOrgName);
    }
    

getPrimaryAttributeValue

Ruft eine Zeichenfolge für den Wert des primären Attributs der Entität ab.

Xrm.Page.data.entity.getPrimaryAttributeValue()

Jede Entität besitzt ein String-Attribut, das als PrimaryNameAttribute festgelegt ist. Der Wert für das Attribut wird verwendet, wenn Links zum Datensatz angezeigt werden.

  • Rückgabewert
    Typ: Zeichenfolge. Der Wert des Attributs und der primären Entität.

  • Anmerkungen
    Diese Methode ist nur für 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties verfügbar.

Speichern

Speichert den Datensatz synchron mit den Optionen zum Schließen des Formulars oder Öffnen eines neuen Formular, nachdem das Speichern ausgeführt wurde.

Xrm.Page.data.save und Xrm.Page.data.entity.save speichern den Datensatz, aber Xrm.Page.data.save bietet Rückruffunktionen, nachdem der Speichervorgang abgeschlossen ist.

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

    • save()
      Wenn keine Parameter enthalten sind, wird der Datensatz einfach gespeichert. Dies entspricht der Verwendung des Speichern-befehls.

    • save("saveandclose")
      Dies entspricht der Verwendung des Speichern und Schließen-Befehls.

    • save("saveandnew")
      Dies entspricht der Verwendung des Speichern und Erneuern-Befehls.

  • Anmerkungen
    Beim Verwenden von Schnellerfassungsformularen in der Webanwendung wird die Option saveandnew nicht angewendet. Es funktioniert immer, als wenn saveandclose verwendet würde. Schnellerfassungsformulare in Microsoft Dynamics 365 für Tablets wenden iimmer das saveandnew-Verhalten an.

Siehe auch

Cclientseitige Programmierreferenz
Kurzübersicht zum Formularskripting
Xrm.Page.data.entity-Attribut (clientseitige Referenz)
Schreiben von Code für Microsoft Dynamics 365-Formulare
Verwenden des Xrm.Page-Objektmodells

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright