Xrm.Page.data.entity (riferimento lato client)

Articolo
10/31/2017

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Xrm.Page.data.entity offre i metodi per recuperare informazioni specifiche del record visualizzate nella pagina, il metodo di salvataggio e una raccolta di tutti gli attributi inclusi nel modulo. I dati dell'attributo vengono limitati agli attributi rappresentati dai campi nel modulo.

Proprietà e metodi di Xrm.Page.data.entity

attributi
La raccolta di attributi per l'entità.
getDataXml
Restituisce una stringa che rappresenta il file XML che verrà inviato al server quando viene salvato il record.
getEntityName
Restituisce una stringa che rappresenta il nome logico dell'entità per il record.
getId
Restituisce una stringa che rappresenta il valore id della GUID per il record.
getIsDirty
Restituisce un valore booleano che indica se i campi del modulo sono stati modificati.
OnSave
Utilizzare i metodi di removeOnSave e addOnSave per aggiungere o rimuovere i gestori evento dall'evento di salvataggio
getPrimaryAttributeValue
Ottiene una stringa per il valore dell'attributo primario dell'entità.
Salva
Salvare il record con le opzioni per chiudere il modulo o per aprire un nuovo modulo dopo il completamento del salvataggio.

attributi

La raccolta Xrm.Page.data.entity.attributes offre i metodi per accedere ai dati per il record visualizzato nel modulo. Per ulteriori informazioni su questa raccolta, vedere Raccolte (riferimento lato client). Vedere Attributo Xrm.Page.data.entity (riferimento lato client) per le proprietà e i metodi disponibili agli oggetti nella raccolta.

getDataXml

Restituisce una stringa che rappresenta il file XML che verrà inviato al server quando viene salvato il record. Solo i dati nei campi modificati sono impostati nel server.

Nota

Questa funzione non funziona con Microsoft Dynamics 365 per tablet.

Xrm.Page.data.entity.getDataXml()

Valore restituito
Tipo: stringa.

Esempio:in questo esempio, i tre campi seguenti di un record di account sono stati aggiornati:
- nome
- accountnumber
- telephone2
```
"<account><name>Contoso</name><accountnumber>55555</accountnumber><telephone2>425 555-1234</telephone2></account>"
```

getEntityName

Restituisce una stringa che rappresenta il nome logico dell'entità per il record.

Xrm.Page.data.entity.getEntityName()

Valore restituito
Tipo: stringa. Nome dell'entità.

Esempio: in questo esempio, un record di account è stato modificato.
```
"account"
```

getId

Restituisce una stringa che rappresenta il valore id della GUID per il record.

Xrm.Page.data.entity.getId()

Valore restituito
Tipo: stringa.

Esempio: il valore ID GUID per il record.
```
"{825CB223-A651-DF11-AA8B-00155DBA3804}"
```

getIsDirty

Restituisce un valore booleano che indica se i campi del modulo sono stati modificati.

Xrm.Page.data.entity.getIsDirty()

Valore restituito
Tipo: booleano

OnSave

Utilizzare i metodi di removeOnSave e addOnSave per aggiungere o rimuovere i gestori evento dall'evento di salvataggio

addOnSave

Aggiunge una funzione da chiamare quando il record viene salvato.

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

Parametro
Tipo: riferimento a funzione.

Note: la funzione sarà aggiunta al fondo della pipeline del gestore eventi. Il contesto di esecuzione viene impostato automaticamente per essere passato come primo parametro passato ai gestori eventi impostati utilizzando questo metodo. Per ulteriori informazioni, vedere Contesto di esecuzione (riferimento sul lato client).

Esempio: in questo esempio, la libreria JavaScript contiene due funzioni. L'aggiunta della funzione addMessageToOnSave all'evento OnLoad del modulo aggiungerò la funzione displayOrgName come gestore per l'evento OnSave.
```
function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

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

removeOnSave

Elimina una funzione da chiamare quando il record viene salvato.

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

Parametro
Tipo: riferimento a funzione.

Esempio: in questo esempio, la libreria JavaScript contiene due funzioni. L'aggiunta della funzione removeMessageFromOnSave a un evento del modulo eliminerà la funzione displayOrgName come gestore per l'evento OnSave.

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

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

getPrimaryAttributeValue

Ottiene una stringa per il valore dell'attributo primario dell'entità.

Xrm.Page.data.entity.getPrimaryAttributeValue()

Ogni entità ha un attributo stringa progettato come PrimaryNameAttribute. Il valore di questo attributo viene utilizzato quando vengono visualizzati i collegamenti al record.

Valore restituito
Tipo: stringa. Il valore dell'attributo primario dell'entità.
Note
Questo metodo è disponibile solo per 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties.

Salva

Salvare il record in modo sincrono con le opzioni per chiudere il modulo o per aprire un nuovo modulo dopo il completamento del salvataggio.

Sia Xrm.Page.data.save che Xrm.Page.data.entity.save salveranno il record, ma Xrm.Page.data.save offre funzioni di richiamata dopo il completamento dell'operazione di salvataggio.

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

Argomenti
- save()
  Se non è incluso alcun parametro il record verrà semplicemente salvato. Ciò corrisponde a utilizzare il comando Salva.
- save("saveandclose")
  Ciò corrisponde a utilizzare il comando Salva e chiudi.
- save("saveandnew")
  Ciò corrisponde a utilizzare il comando Salva e nuovo.

Note
Quando si utilizzano i moduli di creazione rapida nell'applicazione Web, l'opzione saveandnew non viene applicata. Funzionerà sempre come se è stato utilizzato saveandclose. I moduli di creazione rapida Microsoft Dynamics 365 per tablet applicheranno il comportamento saveandnew.

Vedere anche

Riferimento programmazione sul lato client
Riferimento rapido dello scripting dei moduli
Attributo Xrm.Page.data.entity (riferimento lato client)
Creare il codice per moduli di Microsoft Dynamics 365
Utilizzare il modello a oggetti Xrm.Page

Microsoft Dynamics 365

Condividi tramite