quickForms Xrm.Page.ui (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

La raccolta Xrm.Page.ui.quickForms contiene i metodi per accedere a tutti i controlli di visualizzazione rapida e ai comandi costituenti nei moduli Microsoft Dynamics 365 durante l'utilizzo del motore di rendering del nuovo modulo (detto anche "turbo moduli"). Un controllo di visualizzazione rapida è un modulo di visualizzazione rapida aggiunto a un modulo principale di Microsoft Dynamics 365 che consente di visualizzare le informazioni relative a un record di entità correlato all'interno del modulo principale. I dati nei comandi costituenti in un controllo di visualizzazione rapida non sono modificabili. Per ulteriori informazioni sui controlli di visualizzazione rapida e i moduli di visualizzazione rapida, vedi Technet: Creare e modificare moduli di visualizzazione rapida

Nota

Questa funzionalità è stata introdotta nell'Aggiornamento 1 di CRM Online 2016 e in CRM 2016 Service Pack 1 (locale).

Questo argomento è applicabile solo se stai utilizzando il nuovo motore per il rendering di moduli in Dynamics 365. Se stai utilizzando il rendering dei moduli legacy (chiamato anche "aggiorna i moduli") in Dynamics 365, puoi accedere al controllo di visualizzazione rapida e ai controlli costituenti mediante l'oggetto di controllo standard; vedi Controllo Xrm.Page.ui (riferimento lato client).

Importante

All'annuncio della deprecazione dei moduli legacy in Dynamics 365, devi pianificare subito l'utilizzo del nuovo motore per il rendering di moduli se stai utilizzando il rendering dei moduli legacy. Dal momento che esiste una differenza tra come accedi ai controlli di visualizzazione rapida nel legacy e il nuovo rendering di moduli, devi aggiornare e testare il codice esistente che punta ai controlli di visualizzazione rapida per utilizzare i metodi descritti in questo argomento quando passi al nuovo motore per il rendering dei moduli. Per ulteriori informazioni sulla deprecazione del rendering dei moduli legacy, vedi Rimozione dell'opzione rendering dei moduli legacy

In questo argomento

Metodi di raccolta dei quickForms

Metodi degli oggetti di quickForms

Metodi di raccolta dei quickForms

La raccolta dei quickForms consente di accedere a tutti i controlli di visualizzazione rapida su un modulo. La raccolta di quickForms supporta tutti i metodi standard delle raccolte in Dynamics 365. Vedere Raccolte (riferimento lato client)

Nell'esempio seguente viene illustrato come recuperare l'istanza di un controllo di visualizzazione rapida nella raccolta di quickForms mediante il metodo 9b85e46f-ca6e-4313-af04-4290e3c6ab8b#BKMK_get specificando il valore di indice (integer) o nome (stringa) dell'istanza del controllo di visualizzazione rapida come argomento.

quickViewControl = Xrm.Page.ui.quickForms.get(arg)

Metodi degli oggetti di quickForms

Un oggetto quickForms rappresenta un'istanza del controllo di visualizzazione rapida. I seguenti metodi sono supportati per le istanze del controllo di visualizzazione rapida su un modulo.

  • getControl

  • getControlType

  • getName

  • getParent

  • getVisible

  • Metodi delle etichette

  • isLoaded

  • aggiorna

getControl

Recupera i controlli costituenti in un controllo di visualizzazione rapida.

quickViewControl.getControl()

Puoi accedere a un singolo controllo nella raccolta dei controlli costituenti passando un argomento come nome o valore dell'indice del controllo costituente in un controllo rapido di visualizzazione. Ad esempio: quickViewControl.getControl("firstname") o quickViewControl.getControl(0)

  • Valore restituito
    Tipo: raccolta oggetto se utilizzi il metodo senza alcun argomento; oggetto se utilizzi il metodo con un argomento.

  • Note
    Dopo aver recuperato un controllo costituente in un controllo di visualizzazione rapida, puoi usare uno qualsiasi dei metodi supportati per un controllo di Dynamics 365 sul controllo costituente che non altera i dati del controllo costituente. Questo perché i controlli costituenti in un controllo di visualizzazione rapida sono in sola lettura. Ad esempio, puoi utilizzare: quickViewControl.getControl(0).getAttribute(). Per ulteriori informazioni sui metodi supportati per un controllo Dynamics 365 , vedi Controllo Xrm.Page.ui (riferimento lato client)

    Importante

    Il metodo 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute o qualsiasi altro metodo correlato ai dati su un controllo costituente potrebbe non funzionare sul modulo principale f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent in quanto il modulo di visualizzazione rapida potrebbe non essere stato caricato completamente quando è stato caricato il modulo principale. Devi usare il metodo isLoaded per fare in modo che l'istanza del controllo di visualizzazione rapida ti consenta di determinare se il modulo di visualizzazione rapida associato è stato caricato completamente. Per ulteriori informazioni, vedere isLoaded

    Inoltre, la modalità di recupero dei controlli costituenti in un controllo di visualizzazione rapida sui moduli utilizzando il nuovo motore di rendering dei moduli è diversa dalla modalità usata con i moduli legacy. Pertanto, se stai utilizzando i moduli legacy ed è disponibile il codice che punta ai controlli costituenti in un controllo di visualizzazione rapida, devi aggiornare il codice se decidi di utilizzare il nuovo motore per il rendering dei moduli in Dynamics 365.

getControlType

Restituisce un valore stringa che suddivide in categorie i controlli di visualizzazione rapida.

quickViewControl.getControlType()

Per un controllo di visualizzazione rapida, il metodo restituisce quickform.

Per un controllo costituente in un controllo di visualizzazione rapida, il metodo restituisce la categoria effettiva del controllo. Per ulteriori informazioni su possibili valori restituiti, vedi 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getControlType.

getName

Restituisce il nome assegnato al controllo di visualizzazione rapida.

quickViewControl.getName()
  • Valore restituito
    Tipo: stringa. Il nome del controllo di visualizzazione rapida.

getParent

Restituisce un riferimento all'oggetto sezione che contiene il controllo.

Tipi di controllo: tutti.

quickViewControl.getParent()

getVisible

Restituisce un valore che indica se il controllo di visualizzazione rapida è visibile al momento.

Nota

Se la sezione o la scheda contenente del controllo non è visibile, questo metodo restituisce comunque true. Per accertarsi che il controllo sia effettivamente visibile; è inoltre necessario controllare la visibilità degli elementi contenenti.

quickViewControl.getVisible()
  • Valore restituito
    Tipo: booleano.True se il controllo di visualizzazione rapida è visibile; in caso contrario, false.

Metodi delle etichette

Ottieni o modifica l'etichetta per un controllo di visualizzazione rapida utilizzando i metodi setLabel e getLabel.

getLabel

Restituisce l'etichetta per il controllo di visualizzazione rapida.

quickViewControl.getLabel()
  • Valore restituito
    Tipo: stringa. L'etichetta del controllo di visualizzazione rapida.

setLabel

Imposta l'etichetta per il controllo di visualizzazione rapida.

quickViewControl.setLabel("label")
  • Argomenti
    Tipo: stringa. La nuova etichetta del controllo di visualizzazione rapida.

isLoaded

Restituisce un valore che indica se l'associazione dei dati per i controlli costituenti in un controllo di visualizzazione rapida è stata completata.

quickViewControl.isLoaded()

  • Valore restituito
    Tipo: booleano. True indica che l'associazione dei dati per un controllo costituente è stata completate, in caso contrario il valore è false.

  • Note
    L'associazione dei dati per i controlli costituenti in un controllo di visualizzazione rapida potrebbe non essere completata durante l'f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent del modulo principale in quando il modulo di visualizzazione al quale è associato il controllo potrebbe non essere stato caricato completamente. Come conseguenza, l'uso di 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute o di qualsiasi metodo correlato ai dati su un controllo costituente potrebbe non funzionare. Il metodo isLoaded per il controllo di visualizzazione rapida consente di determinare lo stato dell'associazione dei dati per i controlli costituenti nel controllo di visualizzazione rapida.

Il codice seguente di esempio illustra in che modo utilizzare il metodo isLoaded per verificare lo stato dell'associazione e quindi recuperare il valore dell'attributo a cui è associato il controllo costituente in un controllo di visualizzazione rapida.

function getAttributeValue() {
    var quickViewControl = Xrm.Page.ui.quickForms.get("<QuickViewControlName>");
    if (quickViewControl != undefined)
    {
        if (quickViewControl.isLoaded())
        {
            // Access the value of the attribute bound to the constituent control
            var myValue = quickViewControl.getControl(0).getAttribute().getValue();
            console.log(myValue);
            return;
        }
        else
        {
            // Wait for some time and check again
            setTimeout(getAttributeValue, 10);
        }
    }
    else
    {
        console.log("No data to display in the quick view control.");
        return;
    }    
}

aggiorna

Aggiorna i dati visualizzati in un controllo di visualizzazione rapida.

quickViewControl.refresh()

Vedere anche

Riferimento programmazione sul lato client
Riferimento rapido dello scripting dei moduli
Xrm.Page.ui (riferimento lato client)
Controllo Xrm.Page.ui (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