Xrm.Page.data.entity (client-side reference)

Artikel
11/28/2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Xrm.Page.data.entity provides methods to retrieve information specific to the record displayed on the page, the save method, and a collection of all the attributes included in the form. Attribute data is limited to attributes represented by fields on the form.

Xrm.Page.data.entity Properties and Methods

attributes
The collection of attributes for the entity.
getDataXml
Returns a string representing the xml that will be sent to the server when the record is saved.
getEntityName
Returns a string representing the logical name of the entity for the record.
getId
Returns a string representing the GUID id value for the record.
getIsDirty
Returns a Boolean value that indicates if any fields in the form have been modified.
OnSave
Use the addOnSave and removeOnSave methods to add or remove event handlers to the save event
getPrimaryAttributeValue
Gets a string for the value of the primary attribute of the entity.
save
Saves the record with the options to close the form or open a new form after the save is completed.

attributes

The Xrm.Page.data.entity.attributes collection provides methods to access the data for a record displayed on the form. For more information about this collection, see Collections (client-side reference). See Xrm.Page.data.entity attribute (client-side reference) for properties and methods available to objects in this collection.

getDataXml

Returns a string representing the XML that will be sent to the server when the record is saved. Only data in fields that have changed are set to the server.

Note

This function does not work with Microsoft Dynamics 365 for tablets.

Xrm.Page.data.entity.getDataXml()

Return Value
Type: String

Example:In this example, the following three fields for an account record were updated:
- name
- accountnumber
- telephone2
```
"<account><name>Contoso</name><accountnumber>55555</accountnumber><telephone2>425 555-1234</telephone2></account>"
```

getEntityName

Returns a string representing the logical name of the entity for the record.

Xrm.Page.data.entity.getEntityName()

Return Value
Type: String. The name of the entity.

Example: In this example, an account record was being edited.
```
"account"
```

getId

Returns a string representing the GUID id value for the record.

Xrm.Page.data.entity.getId()

Return Value
Type: String

Example: The GUID Id value for the record.
```
"{825CB223-A651-DF11-AA8B-00155DBA3804}"
```

getIsDirty

Returns a Boolean value that indicates if any fields in the form have been modified.

Xrm.Page.data.entity.getIsDirty()

Return Value
Type: Boolean

OnSave

Use the addOnSave and removeOnSave methods to add or remove event handlers to the save event

addOnSave

Adds a function to be called when the record is saved.

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

Parameter
Type: function reference

Remarks: The function will be added to the bottom of the event handler pipeline. The execution context is automatically set to be passed as the first parameter passed to event handlers set using this method. See Execution context (client-side reference) for more information.

Example: In this example, the JavaScript library contains two functions. Adding the addMessageToOnSave function to the form OnLoad event will add the displayOrgName function as a handler for the OnSave event.
```
function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

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

removeOnSave

Removes a function to be called when the record is saved.

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

Parameter
Type: function reference

Example: In this example, the JavaScript library contains two functions. Adding the removeMessageFromOnSave function to a form event will remove the displayOrgName function as a handler for the OnSave event.

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

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

getPrimaryAttributeValue

Gets a string for the value of the primary attribute of the entity.

Xrm.Page.data.entity.getPrimaryAttributeValue()

Each entity has one string attribute that is designated as the PrimaryNameAttribute. The value for this attribute is used when links to the record are displayed.

Return Value
Type: String. The value of the primary attribute of the entity.
Remarks
This method is only available for Updated entities.

save

Saves the record synchronously with the options to close the form or open a new form after the save is completed.

Both Xrm.Page.data.save and Xrm.Page.data.entity.save will save the record, but Xrm.Page.data.save provides callback functions after the save operation completes.

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

Arguments
- save()
  If no parameter is included the record will simply be saved. This is the equivalent of using the Save command.
- save("saveandclose")
  This is the equivalent of using the Save and Close command.
- save("saveandnew")
  This is the equivalent of the using the Save and New command.

Remarks
When using quick create forms in the web application the saveandnew option is not applied. It will always work as if saveandclose were used. Quick create forms in Microsoft Dynamics 365 for tablets will apply the saveandnew behavior.

Dela via