Scrivere script per le griglie secondarie

 

Data di pubblicazione: gennaio 2017

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

Puoi impostare dei gestori eventi per eseguire gli script quando i dati vengono caricati in griglie secondarie. In questo modo, puoi modificare la visualizzazione selezionata per recuperare i riferimenti ai dati visualizzati nella griglia.

Importante

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

In questo argomento

Evento OnLoad della griglia secondaria

Modello a oggetti griglia secondaria

Evento OnLoad della griglia secondaria

Le griglie secondarie vengono caricate in modalità asincrona dal modulo per permetterti di accedere in modo affidabile ai dati della griglia secondaria nell'evento OnLoad del modulo. Tuttavia puoi impostare un gestore eventi per l'evento OnLoad della griglia secondaria. Questo evento si verifica ogni volta che i dati nella griglia vengono aggiornati, incluso quando gli utenti ordinano le colonne della griglia.

Non è disponibile un'interfaccia utente per aggiungere i nuovi gestori eventi per questo evento, quindi se desideri eseguire questa operazione, devi utilizzare il codice in un altro evento, in genere l'evento OnLoad del modulo per utilizzare il metodo GridControl.addOnLoad. Per rimuovere i gestori eventi per questo evento, utilizza il metodo GridControl.removeOnLoad.

Modello a oggetti griglia secondaria

Nel diagramma seguente vengono illustrati gli oggetti a cui puoi accedere da una griglia secondaria di un modulo.

Il controllo della griglia secondaria è denominato GridControl in questo contesto. Come per un controllo Xrm.Page.ui, la griglia secondaria ha tutti i metodi disponibili per tutti i controlli oltre al metodo refresh.

GridControl è lo stesso oggetto passato a una barra dei comandi o alle azioni della barra multifunzione o alle regole utilizzando <CrmParameter> (RibbonDiffXml) se disponibile, quando viene selezionato il parametro SelectedControl.

Modificare le visualizzazioni con ViewSelector

Quando una griglia secondaria è configurata per visualizzare il selettore di visualizzazione, puoi ottenere o impostare la visualizzazione corrente. Utilizza il metodo GridControl.getViewSelector per accedere al selettore di visualizzazione e i metodi ViewSelector.getCurrentViewgetCurrentView e ViewSelector.setCurrentView per ottenere o impostare la visualizzazione corrente con un oggetto di ricerca.

Ottenere i dati della griglia

Utilizza il metodo GridControl.getGrid per accedere alla griglia. Utilizza il metodo Grid.getRows o il metodo Grid.getSelectedRows per ottenere una raccolta di oggetti GridRow. Puoi quindi accedere a un riferimento per ogni record della riga, concatenando insieme i metodi GridRow.getData, GridRowData.getEntity e GridEntity.getEntityReference.

Vedere anche

Oggetti e metodi (sola lettura) della griglia (riferimento lato client)
Raccolte (riferimento lato client)
Creare il codice per moduli di Microsoft Dynamics 365
Estendere Microsoft Dynamics 365 nel client

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright