Controls-samling (klient-API-referens)

Använd samlingen controls för att komma åt kontroller som är associerade med kolumner.

När du utför åtgärder för kontroller som är knutna till en kolumn bör du tänka på att kontrollen kan visas på sidan mer än en gång. I allmänhet bör du utföra samma åtgärder för varje kontroll för kolumnen. Du kan loopa igenom samlingen med kolumnkontroller och utföra åtgärderna på varje kontroll.

Om du till exempel vill lägga till ett meddelande till varje kontroll som är bunden till name kolumnen använder du följande kod:

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

Eftersom varje kolumn kan visas mer än en gång på sidan ger kontrollsamlingen åtkomst till alla kontroller som representerar kolumnen. Om kolumnen endast representeras av en kontroll på sidan är längden på den här samlingen 1.

När du använder metoden control getName matchar namnet på den första kontrollen namnet på kolumnen. Den andra instansen av en kontroll för kolumnen är <columnName>1. Mönstret <columnName>+N fortsätter för varje ytterligare kontroll som läggs till i formuläret för en specifik kolumn.

När ett formulär visar en affärsprocessflödeskontroll i rubriken lägger det till kontroller för varje kolumn som visas i affärsprocessflödet. Dessa kontroller har ett unikt namn som följande: header_process_<column name>.

Kolumner (klient-API-referens)