Kolekcja kontrolek (dokumentacja interfejsu API klienta)

Użyj kolekcji controls , aby uzyskać dostęp do kontroli dostępu skojarzonych z kolumnami.

Podczas wykonywania akcji dotyczących kontrolek powiązanych z kolumną należy wziąć pod uwagę, że kontrolka może pojawić się na stronie więcej niż raz. Ogólnie rzecz biorąc, należy wykonać te same akcje dla każdej kontrolki dla kolumny. Możesz przeprowadzić pętlę przez kolekcję kontrolek kolumn i wykonać akcje dla każdej kontrolki.

Aby na przykład dodać powiadomienie do każdej kontrolki powiązanej z kolumną name , użyj następującego kodu:

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

Ponieważ każda kolumna może pojawiać się więcej niż raz na stronie, kolekcja kontrolek zapewnia dostęp do wszystkich kontrolek reprezentujących te kolumny. Jeśli kolumna jest reprezentowana przez tylko jedną kontrolkę na stronie, długość tej kolekcji wynosi 1.

Gdy używasz metody getName kontrolki, nazwa pierwszej kontrolki jest zgodna z nazwą kolumny. Drugim wystąpieniem kontrolki dla tej kolumny jest <columnName>1. Wzorzec <columnName>+N jest kontynuowany dla każdej dodatkowej kontrolki dodanej do formularza dla określonej kolumny.

Gdy formularz wyświetla kontrolkę przepływu procesów biznesowych w nagłówku, dodaje kontrolki dla każdej kolumny wyświetlanej w przepływie procesów biznesowych. Te kontrolki mają unikatową nazwę podobną do następującej: header_process_<column name>.

Powiązane artykuły

Kolumny (dokumentacja interfejsu API klienta)