Raccolta controls (informazioni di riferimento sulle API client)

Utilizzare la controls raccolta per accedere ai controlli associati alle colonne.

Quando si eseguono azioni sui controlli associati a una colonna, tenere presente che il controllo potrebbe essere visualizzato più volte nella pagina. In genere, è consigliabile eseguire le stesse azioni per ogni controllo per la colonna. È possibile scorrere la raccolta di controlli di colonna ed eseguire le azioni su ogni controllo.

Ad esempio, per aggiungere una notifica a ogni controllo associato alla name colonna, usare il codice seguente:

const notification = {
    messages: ['Sample Notification on Name Controls'],
    notificationLevel: 'RECOMMENDATION',
    uniqueId: 'my_unique_id'
 };
 
formContext.getAttribute("name").controls.forEach(control =>
    control.addNotification(notification)
 );

Poiché ogni colonna può essere visualizzata più volte nella pagina, l'insieme controls fornisce l'accesso a tutti i controlli che rappresentano tale colonna. Se la colonna è rappresentata da un solo controllo nella pagina, la lunghezza dell'insieme è 1.

Quando si utilizza il metodo getName del controllo, il nome del primo controllo corrisponde al nome della colonna. La seconda istanza di un controllo per tale colonna è <columnName>1. Il criterio <columnName>+N continua per ogni controllo aggiuntivo aggiunto al form per una colonna specifica.

Quando un modulo visualizza un controllo del flusso di processo aziendale nell'intestazione, aggiunge controlli per ogni colonna visualizzata nel flusso del processo aziendale. Questi controlli hanno un nome univoco simile al seguente: header_process_<column name>.

Articoli correlati

Colonne (informazioni di riferimento sulle API client)