Kolekcia ovládacích prvkov (odkaz na klientske rozhranie API)

Kolekciu controls môžete použiť na prístup k ovládacím prvkom priradeným k stĺpcom.

Keď vykonávate akcie v ovládacích prvkoch, ktoré sú naviazané na stĺpec, zvážte, že ovládací prvok sa môže na strane zobraziť viackrát. Vo všeobecnosti by ste mali vykonávať rovnaké akcie pre každý ovládací prvok v stĺpci. Môžete cyklicky prechádzať kolekciou ovládacích prvkov stĺpcov a vykonávať akcie na každom ovládacom prvku.

Ak chcete napríklad pridať oznámenie každému ovládaciemu prvku name , ktorý je naviazaný na stĺpec, použite nasledujúci kód:

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

Keďže každý stĺpec sa môže na stránke zobraziť viackrát, kolekcia ovládacích prvkov poskytuje prístup ku všetkým ovládacím prvkom, ktoré daný stĺpec predstavujú. Ak je stĺpec zastúpený iba jedným ovládacím prvkom na strane, dĺžka tejto kolekcie je 1.

Keď použijete metódu getName ovládacieho prvku, názov prvého ovládacieho prvku sa zhoduje s názvom stĺpca. Druhá inštancia ovládacieho prvku pre tento stĺpec je <columnName>1. <columnName>+N Vzor pokračuje pre každý ďalší ovládací prvok pridaný do formulára pre konkrétny stĺpec.

Keď formulár zobrazí v hlavičke ovládací prvok postupu obchodného procesu, pridá ovládacie prvky pre každý stĺpec, ktorý sa zobrazí v postupe obchodného procesu. Tieto ovládacie prvky majú jedinečný názov, ako je tento: header_process_<column name>.

Stĺpce (odkaz na klientske rozhranie API)