Ohjausobjektien kokoelma (asiakasohjelman ohjelmointirajapintaviittaus)

Kokoelman controls avulla voit käyttää sarakkeisiin liittyviä ohjausobjekteja.

Kun suoritat toimintoja ohjausobjekteille, jotka on sidottu sarakkeeseen, ota huomioon, että ohjausobjekti saattaa näkyä sivulla useammin kuin kerran. Yleensä samat toiminnot kannattaa suorittaa jokaiselle sarakkeen ohjausobjektille. Voit silmukoi sarakeohjausobjektien kokoelman läpi ja suorittaa toiminnot kullekin ohjausobjektille.

Jos haluat esimerkiksi lisätä ilmoituksen jokaiseen sarakkeeseen sidottuun ohjausobjektiin name , käytä seuraavaa koodia:

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

Koska jokainen sarake voi näkyä sivulla useammin kuin kerran, ohjausobjektikokoelma mahdollistaa pääsyn kaikkiin kyseistä saraketta edustaviin ohjausobjekteihin. Jos saraketta edustaa vain yksi sivulla oleva ohjausobjekti, tämän kokoelman pituus on 1.

Kun käytät ohjausobjektin getName-menetelmää , ensimmäisen ohjausobjektin nimi vastaa sarakkeen nimeä. Tämän sarakkeen ohjausobjektin toinen esiintymä on <columnName>1. Malli <columnName>+N jatkuu jokaisen tietyn sarakkeen lomakkeeseen lisäohjausobjektin kohdalla.

Kun lomake näyttää liiketoimintaprosessin ohjausobjektin otsikossa, se lisää ohjausobjekteja kullekin liiketoimintaprosessissa näkyvälle sarakkeelle. Näillä ohjausobjekteilla on seuraavankaltainen yksilöivä nimi: header_process_<column name>.

Sarakkeet (asiakasohjelman ohjelmointirajapinnan viittaus)