Col·lecció de controls (referència de l'API del client)

Utilitza la controls col·lecció per accedir als controls associats a les columnes.

Quan realitzes accions en controls vinculats a una columna, tingues en compte que el control pot aparèixer a la pàgina més d'una vegada. En general, hauries de fer les mateixes accions per a cada control de la columna. Pots recórrer la col·lecció de controls de columna i fer les accions de cada control.

Per exemple, per afegir una notificació a cada control vinculat a la name columna, utilitza el següent codi:

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

Com que cada columna pot aparèixer més d'una vegada a la pàgina, la col·lecció de controls proporciona accés a tots els controls que representen aquesta columna. Si la columna està representada per un sol control a la pàgina, la longitud d'aquesta col·lecció és 1.

Quan utilitzes el mètode control getName , el nom del primer control coincideix amb el nom de la columna. La segona instància d'un control per a aquesta columna és <columnName>1. El patró <columnName>+N continua per a cada control addicional afegit al formulari per a una columna específica.

Quan un formulari mostra un control de flux de processos de negoci a l'encapçalament, afegeix controls per a cada columna que apareix en el flux de processos de negoci. Aquests controls tenen un nom únic com el següent: header_process_<column name>.

Articles relacionats

Columnes (referència de l'API del client)