[ árbol de herencia ] [ índice general ]

ei_formulario_ml



Un formulario multilínea (ei_formulario_ml) presenta una grilla de campos repetidos una cantidad dada de filas permitiendo recrear la carga de distintos registros con la misma estructura. La definición y uso de la grilla de campos es similar al formulario simple con el agregado de lógica para manejar un número arbitrario de filas. Contiene una serie de ca campos se los denomina Elementos de Formulario (efs).
See:
Object
   |
   +--ei
         |
         +--ei_formulario
               |
               +--ei_formulario_ml

Ubicada en ei_formulario_ml.js


Clase PHP equivalente: toba_ei_formulario_ml
Métodos
void activar_boton_fila(fila, evento)
void agregar_total(<string> id_ef) Indica que un ef totalize los valores en todas sus filas colocandolo en la última fila
void bajar_seleccionada() Toma la fila actualmente seleccionada y la intercambia en orden con la fila posterior en orden
Object boton_agregar() Referencia al tag html del boton agregar
Object boton_bajar() Referencia al tag html que contiene el boton de bajar la fila actual
Object boton_deshacer() Referencia al tag html del boton deshacer
Object boton_deshacer_cant() Referencia al tag html que contiene la cantidad de eliminaciones a deshacer
Object boton_eliminar() Referencia al tag html del boton eliminar
Object boton_subir() Referencia al tag html que contiene el boton de subir la fila actual
Object cambiar_total(<string> id_ef, <string> total) Cambia el contenido de la fila destinada a contener el valor totalizado de un ef especifico
void cascadas_cambio_maestro(<string> id_ef) Esquema de Cascadas:
Un ef indica que su valor cambio y por lo tanto sus esclavos deben refrescarse
Object crear_fila() Agrega una nueva fila a la grilla.
Object debe_disparar_evento()
void desactivar_boton_fila(fila, evento)
void deseleccionar_actual() Deselecciona cualquier seleccion anterior de fila
void deshacer() Deshace la ultima eliminacion de fila
string eliminar_fila(<string> fila) Elimina una fila y retorna la fila anterior en orden
void eliminar_filas() Elimina una fila y retorna la fila anterior en orden
Object eliminar_seleccionada() Elimina del formulario la fila actualmente seleccionada El HTML solo se oculta, no se elimina, con lo cual puede ser recuperado en su estado actual
Object filas() Retorna las filas actuales del formulario Útil para hacer recorridos por todas las filas, por ejemplo
 var filas = this.filas()
 for (id_fila in filas) {
      this.ef('nombre').ir_a_fila(filas[id_fila]).set_estado('nuevo');
      this.seleccionar(filas[id_fila]);
 }
Object get_datos() Retorna el estado actual del formulario en un Arreglo que contiene un Objeto asociativo id_ef=>valor (formato RecordSet)
Object hay_cambios(<string> fila_actual, <string> ef_actual) Determina si algun ef de alguna fila cambio, o se agregar o quitaron filas Opcionalmente resalta o no un ef puntual
void intercambiar_filas(<int> pos_a, <int> pos_b) Intercambia de posicion a dos filas dadas
void mostrar_boton_fila(fila, evento)
void mostrar_columna(<string> columna, <boolean> mostrar) Muestra u oculta una columna completa
void ocultar_boton_fila(fila, evento)
void post_eliminar_fila(<string> fila) Ventana para colocar código luego de la eliminación de una fila seleccionada
void refrescar_foco() Toma la fila seleccionada y le pone foco al primer ef que lo acepte
void refrescar_todo() Refresca todos la grafica variable del formulario
void resetear_errores() Limpia el componente de errores producidos anteriormente
void seleccionar(<string> fila) Marca una fila como seleccionada, cambiando su color de fondo Se puede atrapar el evento con evt__seleccionar_fila (fila), si dicha funcion devuelve FALSE no se selecciona la fila.
void set_cabecera_visible_sin_datos(<boolean> visible) Se muestra la cabecera/pie en caso de que no tenga datos el formulario
void set_toggle(<string> id_ef) Indica que un ef tiene un estado binario
void subir_seleccionada() Toma la fila actualmente seleccionada y la intercambia en orden con la fila anterior en orden
Object submit() Inicia el proceso de submit, este proceso recorre todos los componentes validandolos y preparandolos para una comunicación con el servidor
void toggle_checkbox(<string> id_ef) Dado un id de un ef checkbox cambia el chequeo de todas las filas
Object total(<string> id_ef) Función de calculo de total por defecto, suma el valor de cada fila
Object validar() Realiza la validación de este componente Para agregar validaciones particulares globales al formulario, definir el metodo evt__validar_datos.
Para validar efs especificos, definir el método evt__idef__validar

ei_formulario_ml

  ei_formulario_ml (id, instancia, rango_tabs, input_submit, filas, proximo_id, seleccionada, en_linea, maestros, esclavos, invalidos)

activar_boton_fila

  void activar_boton_fila (fila, evento)

agregar_total

  void agregar_total (<string> id_ef)

    Indica que un ef totalize los valores en todas sus filas colocandolo en la última fila

Parámetros:
id_ef   Identificador del ef a totalizar
bajar_seleccionada

  void bajar_seleccionada ()

    Toma la fila actualmente seleccionada y la intercambia en orden con la fila posterior en orden

boton_agregar

  Object boton_agregar ()

    Referencia al tag html del boton agregar

boton_bajar

  Object boton_bajar ()

    Referencia al tag html que contiene el boton de bajar la fila actual

boton_deshacer

  Object boton_deshacer ()

    Referencia al tag html del boton deshacer

boton_deshacer_cant

  Object boton_deshacer_cant ()

    Referencia al tag html que contiene la cantidad de eliminaciones a deshacer

boton_eliminar

  Object boton_eliminar ()

    Referencia al tag html del boton eliminar

boton_subir

  Object boton_subir ()

    Referencia al tag html que contiene el boton de subir la fila actual

cambiar_total

  Object cambiar_total (<string> id_ef, <string> total)

    Cambia el contenido de la fila destinada a contener el valor totalizado de un ef especifico

Parámetros:
id_ef   Id. del ef o columna a variar
total   Nuevo total
cascadas_cambio_maestro

  void cascadas_cambio_maestro (<string> id_ef)

    Esquema de Cascadas:
    Un ef indica que su valor cambio y por lo tanto sus esclavos deben refrescarse

Parámetros:
id_ef   Identificador del ef maestro que sufrio una modificación
crear_fila

  Object crear_fila ()

    Agrega una nueva fila a la grilla. Dependiendo de la definición del componente en el editor, este método crea la fila directamente en javascript o lo hace a través de un evento 'pedido_registro_nuevo' en el servidor

debe_disparar_evento

  Object debe_disparar_evento ()

desactivar_boton_fila

  void desactivar_boton_fila (fila, evento)

deseleccionar_actual

  void deseleccionar_actual ()

    Deselecciona cualquier seleccion anterior de fila

deshacer

  void deshacer ()

    Deshace la ultima eliminacion de fila

eliminar_fila

  string eliminar_fila (<string> fila)

    Elimina una fila y retorna la fila anterior en orden

Parámetros:
fila   Id. de la fila a eliminar
eliminar_filas

  void eliminar_filas ()

    Elimina una fila y retorna la fila anterior en orden

eliminar_seleccionada

  Object eliminar_seleccionada ()

    Elimina del formulario la fila actualmente seleccionada El HTML solo se oculta, no se elimina, con lo cual puede ser recuperado en su estado actual

filas

  Object filas ()

    Retorna las filas actuales del formulario Útil para hacer recorridos por todas las filas, por ejemplo
     var filas = this.filas()
     for (id_fila in filas) {
          this.ef('nombre').ir_a_fila(filas[id_fila]).set_estado('nuevo');
          this.seleccionar(filas[id_fila]);
     }

get_datos

  Object get_datos ()

    Retorna el estado actual del formulario en un Arreglo que contiene un Objeto asociativo id_ef=>valor (formato RecordSet)

hay_cambios

  Object hay_cambios (<string> fila_actual, <string> ef_actual)

    Determina si algun ef de alguna fila cambio, o se agregar o quitaron filas Opcionalmente resalta o no un ef puntual

Parámetros:
fila_actual   Nro de fila a verificar
ef_actual   Identificador del ef a verificar
intercambiar_filas

  void intercambiar_filas (<int> pos_a, <int> pos_b)

    Intercambia de posicion a dos filas dadas

Parámetros:
pos_a   Posicion que ocupa la primer fila
pos_b   Posicion que ocupa la segunda fila
mostrar_boton_fila

  void mostrar_boton_fila (fila, evento)

mostrar_columna

  void mostrar_columna (<string> columna, <boolean> mostrar)

    Muestra u oculta una columna completa

Parámetros:
columna   Id. del ef o columna a variar
mostrar   Indica si se muestra u oculta
ocultar_boton_fila

  void ocultar_boton_fila (fila, evento)

post_eliminar_fila

  void post_eliminar_fila (<string> fila)

    Ventana para colocar código luego de la eliminación de una fila seleccionada

Parámetros:
fila   Nro de fila de la eliminacion
refrescar_foco

  void refrescar_foco ()

    Toma la fila seleccionada y le pone foco al primer ef que lo acepte

refrescar_todo

  void refrescar_todo ()

    Refresca todos la grafica variable del formulario

resetear_errores

  void resetear_errores ()

    Limpia el componente de errores producidos anteriormente

seleccionar

  void seleccionar (<string> fila)

    Marca una fila como seleccionada, cambiando su color de fondo Se puede atrapar el evento con evt__seleccionar_fila (fila), si dicha funcion devuelve FALSE no se selecciona la fila.

Parámetros:
fila   Nro de fila a seleccionar
set_cabecera_visible_sin_datos

  void set_cabecera_visible_sin_datos (<boolean> visible)

    Se muestra la cabecera/pie en caso de que no tenga datos el formulario

Parámetros:
visible   Indica si la cabecera es visible o no ante la falta de datos.
set_toggle

  void set_toggle (<string> id_ef)

    Indica que un ef tiene un estado binario

Parámetros:
id_ef   Identificador del ef
subir_seleccionada

  void subir_seleccionada ()

    Toma la fila actualmente seleccionada y la intercambia en orden con la fila anterior en orden

submit

  Object submit ()

    Inicia el proceso de submit, este proceso recorre todos los componentes validandolos y preparandolos para una comunicación con el servidor

toggle_checkbox

  void toggle_checkbox (<string> id_ef)

    Dado un id de un ef checkbox cambia el chequeo de todas las filas

Parámetros:
id_ef   Identificador del ef switchear
total

  Object total (<string> id_ef)

    Función de calculo de total por defecto, suma el valor de cada fila

Parámetros:
id_ef   Identificador del ef a totalizar
validar

  Object validar ()

    Realiza la validación de este componente Para agregar validaciones particulares globales al formulario, definir el metodo evt__validar_datos.
    Para validar efs especificos, definir el método evt__idef__validar




Desarrollado por SIU.
Documentación generada con JSDoc