Collection de contrôles (référence de l’API client)

Utilisez la controls collection pour accéder aux contrôles associés aux colonnes.

Lorsque vous effectuez des actions sur des contrôles liés à une colonne, considérez que le contrôle peut apparaître sur la page plusieurs fois. En règle générale, vous devez effectuer les mêmes actions pour chaque contrôle pour la colonne. Vous pouvez parcourir la collection de contrôles de colonne et effectuer les actions sur chaque contrôle.

Par exemple, pour ajouter une notification à chaque contrôle lié à la name colonne, utilisez le code suivant :

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

Étant donné que chaque colonne peut apparaître plusieurs fois sur la page, la collection de contrôles permet d’accéder à tous les contrôles qui représentent cette colonne. Si la colonne est représentée par un seul contrôle de la page, la longueur de cette collection est 1.

Lorsque vous utilisez la méthode getName du contrôle, le nom du premier contrôle correspond au nom de la colonne. La deuxième instance d’un contrôle pour cette colonne est <columnName>1. Le modèle <columnName>+N se poursuit pour chaque contrôle supplémentaire ajouté au formulaire pour une colonne spécifique.

Lorsqu’un formulaire affiche un contrôle de flux de processus métier dans l’en-tête, il ajoute des contrôles pour chaque colonne qui apparaît dans le flux de processus métier. Ces contrôles ont un nom unique comme suit : header_process_<column name>.

Articles associés

Colonnes (référence d’API client)