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

  • Articolo

 

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

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright