Colección de controles (referencia de la API de cliente)

Use la controls colección para acceder a los controles asociados a las columnas.

Al realizar acciones en controles vinculados a una columna, tenga en cuenta que el control puede aparecer en la página más de una vez. Por lo general, debe realizar las mismas acciones para cada control de la columna. Puede recorrer la colección de controles de columna y realizar las acciones en cada control.

Por ejemplo, para agregar una notificación a cada control enlazado a la name columna, use el código siguiente:

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

Dado que cada columna puede aparecer más de una vez en la página, la colección de controles proporciona acceso a todos los controles que representan esa columna. Si la columna está representada solo por un control de la página, la longitud de esta colección es 1.

Cuando se usa el método getName del control, el nombre del primer control coincide con el nombre de la columna. La segunda instancia de un control para esa columna es <columnName>1. El patrón <columnName>+N continúa para cada control adicional agregado al formulario para una columna específica.

Cuando un formulario muestra un control de flujo de proceso de negocio en el encabezado, agrega controles para cada columna que aparece en el flujo de proceso de negocio. Estos controles tienen un nombre único como el siguiente: header_process_<column name>.

Columnas (referencia de la API de cliente)

  • Se actualizó por última vez el