Condividi tramite

Oggetti e metodi della griglia modificabile (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

È possibile impostare gestori di eventi in modo che effettuino la sottoscrizione a eventi attivati da griglie modificabili quando i dati vengono selezionati, modificati o salvati in una griglia modificabile. Le griglie modificabili supportano la maggior parte dei metodi sul lato client supportati da griglie non modificabili. Per ulteriori informazioni, vedere Utilizzare le griglie modificabili in Dynamics 365

Nota

La griglia modificabile è stata introdotta inAggiornamento di dicembre 2016 per Dynamics 365 (online e locale).

In questo argomento

Eventi griglia modificabile

Metodi della griglia modificabile

Eventi griglia modificabile

La griglia modificabile supporta gli eventi seguenti utilizzabili per la registrazione e l'esecuzione degli script sul lato client. È possibile registrarsi per tali eventi tramite la scheda Eventi della pagina Microsoft Dynamics 365 utilizzata per abilitare le griglie modificabili per un'entità o una griglia di sola lettura:

  • OnRecordSelect

  • OnChange

  • OnSave

Importante

Utilizzare il metodo getFormContext di contesto di esecuzione per creare i gestori eventi comuni che possono operare su una GridCell di una griglia modificabile o sul campo di un modulo in base a dove il gestore eventi viene eseguito.Ulteriori informazioni:getFormContext

OnRecordSelect

L'evento OnRecordSelect si verifica quando una singola riga (record) è selezionata nella griglia modificabile. Questo evento non si verifica se un utente seleziona diverse celle nella stessa riga o seleziona più righe.

OnChange

L'evento OnChange si verifica quando un valore viene modificato in una cella nella griglia modificabile e la cella perde lo stato attivo. Questo evento può verificarsi anche quando un valore di attributo viene aggiornato utilizzando il metodo setValue.

OnSave

L'evento OnSave si verifica prima dell'invio delle informazioni aggiornate al server e quando si verifica una delle condizioni seguenti:

  • Esiste una modifica nella selezione di record.

  • L'utente attiva in modo esplicito un'operazione di salvataggio tramite il pulsante di salvataggio della griglia modificabile.

  • L'utente applica un'operazione di ordinamento, filtro, raggruppamento, paginazione o spostamento dalla griglia modificabile mentre ci sono modifiche in sospeso.

Alcuni aspetti importanti da tenere in considerazione per l'eventoOnSave:

  • Se un utente modifica più colonne dello stesso record in sequenza, l'evento OnSave verrà generato una sola volta per assicurare prestazioni ottimali e la compatibilità con comportamento dei moduli.

  • La griglia modificabile e il modulo padre hanno pulsanti di salvataggio distinti. Fare clic sul pulsante di salvataggio in una non salva le modifiche nell'altro.

  • La griglia modificabile non salva le modifiche in sospeso quando le operazioni di spostamento vengono eseguite all'esterno del suo contesto. Se il controllo ha dati non salvati, i dati potrebbe andare persi. Pertanto l'evento OnSave potrebbe non essere generato. Ad esempio, ciò potrebbe verificarsi nello spostamento a un altro record utilizzando un campo di tipo lookup del modulo o tramite la barra multifunzione.

  • La scelta del pulsante di aggiornamento nella griglia modificabile provoca l'eliminazione di eventuali modifiche in sospeso e l'evento OnSave non verrà generato.

  • Il controllo griglia modificabile non implementa un timer di salvayaggio automatico.

  • La griglia modificabile sopprime le regole di rilevamento duplicati.

Metodi della griglia modificabile

La griglia modificabile supporta alcuni nuovi e la maggior parte dei metodi esistenti supportati nelle griglie di sola lettura:

  • GridControl

  • Griglia

  • GridRow

  • GridRowData

  • GridEntity

  • GridAttribute

  • GridCell

GridControl

Se si conosce il nome del controllo griglia modificabile, è possibile accedervi tramite codice seguente. Ad esempio, per accedere alla griglia secondaria CONTACTS nel modulo account predefinito:

var contactsGrid = Xrm.Page.getControl("Contacts");

Suggerimento

Per individuare i nomi dei controlli griglia nel modulo senza aprire l'editor dei moduli, vedi le informazioni disponibili in Utilizzare gli strumenti per sviluppatori di browser.

La griglia modificabile supporta i seguenti metodi dei controlli di griglia di sola lettura: getEntityName e getGrid.

Griglia

La griglia modificabile supporta i seguenti metodi per Grid restituito dal metodo GridControl.getGridgetRows, getSelectedRows e getTotalRecordCount.

GridRow

La griglia modificabile supporta il metodo getData per GridRow restituito dai metodi Grid.getRows e Grid.getSelectedRows.

GridRow supporta anche la raccolta data che fornisce i modi per utilizzare una riga di griglia modificabile. Vedi Raccolte (riferimento lato client) per informazioni sui metodi disponibili per accedere ai dati in una raccolta.

GridRowData

La griglia modificabile supporta il metodo getEntity per GridRowData restituito dal metodo GridRow.getData.

GridRowData fornisce anche i metodi per recuperare informazioni specifiche di un record visualizzate in una riga della griglia modificabile, inclusa una raccolta di tutti gli attributi inclusi nella riga. I dati di attributo sono limitati alle colonne presentate dalla griglia modificabile. Vedi Raccolte (riferimento lato client) per informazioni sui metodi disponibili per accedere ai dati in una raccolta.

GridEntity

La griglia modificabile supporta i seguenti metodi per GridEntity restituito dal metodo GridRowData..getEntity:

Oltre a utilizzare il metodo GridRowData.getEntity, è possibile recuperare GridEntity direttamente accedendo all'oggetto GridRowData.entity.

GridEntity supporta anche la raccolta attributes che fornisce i metodi di utilizzo di una raccolta di attributi per un'entità nella griglia modificabile. Ogni attributo (GridAttribute) rappresenta i dati della cella di una griglia modificabile e include un riferimento a tutte le celle associate all'attributo. Vedi Raccolte (riferimento lato client) per informazioni sui metodi disponibili per accedere ai dati in una raccolta.

GridAttribute

GridAttribute supporta i seguenti metodi per gli attributi di una riga di griglia selezionata: getName, getRequiredLevel, setRequiredLevel, getValue e setValue.

Utilizzare il metodo Grid.getSelectedRows per recuperare la riga selezionata in una griglia modificabile.

GridAttribute supporta anche la raccolta controls per gli attributi di una riga di griglia selezionata, che fornisce i metodi di utilizzo di una raccolta di celle associate all'attributo. Ogni cella (GridCell) di una riga di griglia selezionata è analoga a un controllo in un modulo collegato a un attributo in una griglia modificabile. Vedi Raccolte (riferimento lato client) per informazioni sui metodi disponibili per accedere ai dati in una raccolta.

Suggerimento

Per motivi di prestazioni, una riga (record) in una griglia modificabile non è modificabile fino a che il record è selezionato. Gli utenti devono selezionare un singolo record in una griglia per modificarlo. Una volta che un record è selezionato in una griglia modificabile, Dynamics 365 valuta internamente una serie di fattori, inclusi l'accesso utente al record, se il record è attivo e le convalide del campo per assicurare il rispetto della sicurezza e della validità dei dati quando si modificano i dati. Valutare la possibilità di utilizzare l'evento OnRecordSelect con il metodo getFormContext per accedere ai record nella griglia nello stato modificabile.

GridCell

Oltre a setNotification e clearNotification, GridCell supporta i seguenti metodi per i controlli:

Nota

Le griglie modificabili non possono visualizzare più di una notifica alla volta.

getDisabled

Restituisce un valore che indica se la cella è disabilitata (sola lettura).

gridCellObj.getDisabled()
  • Valore restituito
    Tipo: booleano. True se la cella è disabilitata; in caso contrario false.

setDisabled

Imposta un valore che indica se la cella è disabilitata.

gridCellObj.setDisabled(bool)

  • Argomenti
    Tipo: booleano. True se la cella deve essere disabilitata; in caso contrario false.

  • Note
    L'abilitazione di una cella di sola lettura per la modifica può causare un errore quando il record viene salvato. Se il campo viene considerato di sola lettura dal server, un errore può verificarsi se il valore viene modificato. Questo problema può verificarsi in scenari in cui l'utente non dispone di privilegi di scrittura sul record, il record è disabilitato o l'utente non dispone dei necessari privilegi di sicurezza a livello di campo.

getLabel

Restituisce l'etichetta di colonna che contiene la cella.

gridCellObj.getLabel()
  • Valore restituito
    Tipo: stringa. Etichetta della colonna.

Vedere anche

Oggetti e metodi (sola lettura) della griglia (riferimento lato client)
Utilizzare le griglie modificabili in Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright