Apéndice B. Pluggins, que son y como usarlos en mi aplicación

Tabla de contenidos

B.1. Documentación Plugins gvHidra
B.1.1. CWArbol
B.1.2. CWAreaTexto
B.1.3. CWBarra
B.1.4. CWBarraInfPanel
B.1.5. CWBarraSupPanel
B.1.6. CWBoton
B.1.7. CWBotonTooltip
B.1.8. CWCampoTexto
B.1.9. CWContendorPestanyas
B.1.10. CWContenedor
B.1.11. CWCheckBox
B.1.12. CWFicha
B.1.13. CWFichaEdicion
B.1.14. CWFila
B.1.15. CWImagen
B.1.16. CWInfoContenedor
B.1.17. CWLista
B.1.18. CWMarcoPanel
B.1.19. CWMenuLayer
B.1.20. CWPaginador
B.1.21. CWPanel
B.1.22. CWPantallaEntrada
B.1.23. CWPestanyas
B.1.24. CWSelector
B.1.25. CWSolapa
B.1.26. CWTabla
B.1.27. CWUpLoad
B.1.28. CWVentana

B.1. Documentación Plugins gvHidra

Lista de Pluggins

B.1.1. CWArbol

Crea paneles vinculados a una estructura jerárquica.

En la parte izquierda dibuja el árbol, y el panel de la derecha corresponde al nodo seleccionado.

  • Plugins que pueden contener a CWArbol

    • Padres

      • CWMarcoPanel

  • Plugins que puede contener CWArbol

    • Hijos

      • CWPanel

Tabla de argumentos de CWArbol

Nombre Tipo ¿Opcional? Descripción Valores
estado alfanumérico false Indica el estado del panel (activo o desactivado) cuando se carga la pantalla. Normalmente es una variable smarty ($estado_edi) que será sustituida por el php correspondiente del views. Puede tomar los siguientes valores:
  • on: visible y activo

  • off: visible e inactivo

  • inactivo: no visible e inactivo

arbol alfanumérico false Estructura definida para el árbol (fichero xml). Será una variable smarty ($smty_objArbol) que es sustituida por IgepPanel.  
titulo alfanumérico true Dará el título al panel que contiene el árbol.  
ancho numerico true Define el ancho del panel árbol en porcentaje, por defecto es un 25%.  

Ejemplos de uso del plugin CWArbol:

Árbol con dos paneles diferentes. La variable $smty_panelVisible es sustituida por IgepPanelArbol, que le asignará el valor del tipo de nodo que se ha seleccionado, coincidrá con el nombre que se le pase como primer parámetro a la función setNodoPanel().

{CWArbol estado=$estado_edi arbol=$smty_objArbol}
 {if $smty_panelVisible == "ANYO" || $smty_panelVisible == "FACTURA"}
   {CWPanel 
                     ..............
                {/CWPanel}
 {else}
                {CWPanel 
                     ..............
                {/CWPanel}
 {/if}
{/CWArbol}

Lista de plugins

B.1.2. CWAreaTexto

Equivalente al TEXTAREA de HTML.

  • Plugins que pueden contener a CWAreaTexto

    • Padres

      • CWContenedor

      • CWFila

      • CWFicha

      • CWSelector

      • CWSolapa

  • Plugins que puede contener CWAreaTexto

    • Hijos

      • El plugin CWAreaTexto es una hoja (no contiene otros plugins)

Tabla de argumentos de CWAreaTexto

Nombre Tipo ¿Opcional? Descripción
nombre alfanumérico false Nombre para identificar la instancia del componente. Si los datos que maneja son persistentes (acceso a BD), es necesario que este parámetro coincida con el definido por el programador en el atributo matching de la clase correspondiente en la lógica de negocio.
longitudMinima entero true Indica el número de carácteres mínimos que debe introducirse en el campo. Si no se alcanza el número mínimo de caracteres a introducir, se muestra un mensaje de ALERTA.
longitudMaxima entero true Indica el número de carácteres máximos que pueden introducirse en el campo. Si se sobrepasa dicho valor, se muestra un mensaje de ALERTA.
value alfanumérico true Valor por defecto que aparecera en el campo.
editable alfanumérico true Especifica el comportamiento del campo: si su valor es true, es editable por el usuario. Si el valor es false, no es editable y si su valor es nuevo, será editable solo en la inserción cuando el plugin CWAreaTexto sea hijo de CWFila o CWFicha. Si no se especifica el atributo, el campo es editable.
cols entero true Especifica el número de columnas que tendrá el textarea. En el caso de que nos encontremos en un panel tabular se utilizará este valor como referencia para fijar el ancho de la columna.
rows entero true Especifica el número de filas que tendrá el textarea.
tabIndex entero true Especifica el orden de tabulación.
textoAsociado alfanumérico false Fija el texto descriptivo que acompaña a un campo (etiqueta). Si además aparece el argumento/parámetro "obligatorio" a true, se le añade un * que indicará que el campo es obligatorio de rellenar. El texto que se incorpora como etiqueta, será también el que se utilice en los mensajes de comprobación de cmapos obligatorios, etc...
mostrarTextoAsociado booleano false No siempre queremos que se muestre la etiqueta o texto asociado a un campo, aunque puede interesarnos que dicho texto exista en realidad para utilizarlo en mensajes con el usuario. La solución en utilizar el parámetro y fijar su valor a false, así, evitaremos que se muestre el texto asociado.
actualizaA alfanumérico true Nombre de otro componente que su valor depende del valor que tenga nuestro componte texto.
visible booleano true Con "true/false" indicaremos que queremos forzar si queremos que el botón sea visible/invisible desde el principio. En lugar de obedecer el comportamiento prefijado por gvHigra.

Ejemplos de uso del plugin CWAreaTexto:

Ejemplo: Declaración de CWAreaTexto.

{CWAreaTexto nombre="comentario" textoAsociado="Expedientes" cols="20" rows="10"} 

Lista de plugins

B.1.3. CWBarra

Dibuja la barra superior común a todas las ventanas, comprende el menú de la aplicación, una descripción de la pantalla o formulario donde nos encontramos (la entrada de menú correspondiente). El usuario que se ha validado en la aplicación, y por último la hora y fecha local del PC desde el que se ejecuta el navegador Web.

  • Plugins que pueden contener a CWBarra

    • Padres

      • CWVentana

  • Plugins que puede contener CWBarra

    • Hijos

      • CWMenuLayer

Tabla de argumentos de CWBarra

Nombre Tipo ¿Opcional? Descripción
usuario alfanumérico true Fija el nombre de usuario en la Barra. Variable smarty ($smty_usuario) asignada internamente.
codigo alfanumérico true Fija el nombre de la aplicacion en la barra Variable smarty ($smty_codigo) asignada internamente.
customTitle alfanumérico true En la barra superior de color azul, a la izquierda de la fecha y hora, se ha reservado un pequeño espacio para poder incluir un texto personalizado. La asiganción se realiza a través de la variable smarty ($smty_customTitle) asignada internamente por gvHidra en IgepPantalla

Ejemplos de uso del plugin CWBarra:

Ejemplo: Una barra con Menú (plugin CWMenuLayer).

{CWBarra usuario="$smty_usuario" codigo="$smty_codigo" customTitle=$smty_customTitle}
  {CWMenuLayer name="$smty_nombre" fichero="$smty_fichero"}
{/CWBarra}

Lista de plugins

B.1.4. CWBarraInfPanel

Dibuja la barra inferior de un panel. Contiene los botones que realizan acciones sobre la capa de persistencia (botones inferiores según la guía de estilo).

  • Plugins que pueden contener a CWBarraInfPanel

    • Padres

      • CWPanel

  • Plugins que puede contener CWBarraInfPanel

    • Hijos

      • CWBoton

Tabla de argumentos de CWBarraInfPanel

El plugin CWBarraInfPanel no tiene argumentos

Ejemplos de uso del plugin CWBarraInfPanel:

Ejemplo: Declaración de CWBarraInfPanel.

{CWBarraInfPanel}
  {CWBoton imagen="41" texto="Guardar" class="boton" funcion="guardar"}
{/CWBarraInfPanel}

Lista de plugins

B.1.5. CWBarraSupPanel

Dibuja lo que en un panel será la cabecera de la ventana donde irá el título de esa ventana.

  • Plugins que pueden contener a CWBarraSupPanel

    • Padres

      • CWPanel

  • Plugins que puede contener CWBarraSupPanel

    • Hijos

      • CWBotonTooltip

Tabla de argumentos de CWBarraSupPanel

Nombre Tipo ¿Opcional? Descripción
titulo alfanumérico true Establece la descripción de la acción del panel.

Ejemplos de uso del plugin CWBarraSupPanel:

Ejemplo: Declaración de CWBarraSupPanel.

{CWBarraSupPanel titulo="BUSCAR ESTADOS"}
  {CWBotonTooltip imagen="04" titulo="Limpiar campos" funcion="limpiar"}
{/CWBarraSupPanel}

Lista de plugins

B.1.6. CWBoton

Equivalente al BUTTON de HTML. Generalmente, el uso de estos botones será para acceso a la capa de persistencia.

  • Plugins que pueden contener a CWBoton

    • Padres

      • CWBarraInfPanel

  • Plugins que puede contener CWBoton

    • Hijos

      • El plugin CWBoton es una hoja (no contiene otros plugins)

Tabla de argumentos de CWBoton

Nombre Tipo ¿Opcional? Descripción Valores
name alfanumérico true Nombre para identificar la instancia del componente, y se utilizara como texto del botón.  
class alfanumérico true Indica el estilo css del botón que se genera. Por defecto tiene el marcado por la guía de estilo ('boton'). En caso de querer cambiarlo se debería incluir en la css.  
imagen alfanumérico true Nombre del fichero que contiene la imagen que queremos que aparezca en el botón, junto al texto, pero sin añadirle la extensión. Actualmente, estas imágenes deben estar siempre en formato "gif"  
mostrarEspera boolean true Su valor por defecto es false. Si la accion que desencadena el boton requiere un tiempo de proceso considerable, es conveniente utilizar este parámetro fijándolo a 'true'. Con ello conseguimos que durante el procesado de la acción que desencadena el botón, la interfaz permanezca bloqueda y se muestre al usuario un mensaje que indica que espere.  
funcion alfanumérico true Este parametro se utiliza por si queremos añadirle funcionalidad extra al botón. En caso de utilizarse no debe añadirse la palabra reservada "javascript:".  
accion alfanumérico true Especifica la acción que realiza el botón Puede tomar los siguientes valores:
  • guardar: Ejecuta la acción del panel.

  • cancelar:Cancela la acción del panel.

  • saltar: La acción es un salto.

  • volver: Se retorna de un salto.

  • listar: La accion invoca a un listado.

  • cancelarvs: Para un botón Cancelar de una ventana emergente.

  • aceptarvs: Sólo para el botón Aceptar de la ventana de selección.

  • particular: El botón realiza una función que no es genérica. En este caso son obligatorios los parámetros "id" y "action".

    "action": acción particular que se ejecutará en la clase manejadora (método accionesParticulares).

    "id": identificador del botón. Si queremos que el botón funcione en cuanto a visibilidad como los guardar/cancelar pondremos el parámetro visible = "false".

visible boolean true Con "true/false" indicaremos que queremos forzar si queremos que el botón sea visible/invisible desde el principio, y tratar su visibilidad posteriormente desde negocio.  
id alfanumérico true Identificador para el botón, sólo en el caso de que la acción sea "particular".  
openWindow boolean true Indica si queremos que la acción del botón la ejecute en una ventana diferente.  
action alfanumérico true Acción que queremos que se ejecute al pulsar el botón y que sea diferente a la de por defecto del panel.  
texto alfanumérico true Este parametro se utiliza para visualizar la ayuda en linea al situar el puntero del ratón sobre el componente.  
confirm boolean true Con este parámetro aparecerá una ventana emergente de confirmación para ejecutar la acción del panel.  
filaActual entero true Nos indica la fila seleccionada, SÓLO se utiliza en la VENTANA DE SELECCIÓN donde es OBLIGATORIO.  
formActua alfanumérico true Parámetro OBLIGATORIO SÓLO cuando es un botón de la VENTANA DE SELECCIÓN. Indica el nombre del formulario en el que se devolverán los valores elegidos en la ventana de selección.  
panelActua alfanumérico true Parámetro OBLIGATORIO SÓLO cuando es un botón de la VENTANA DE SELECCIÓN. Indica el nombre del panel en el que se devolverán los valores elegidos en la ventana de selección.  
actuaSobre alfanumérico true Parámetro OBLIGATORIO SÓLO cuando es un botón de la VENTANA DE SELECCIÓN. Indica los campos donde se volcarán los valores elegidos en la ventana de selección.  

Ejemplos de uso del plugin CWBoton:

Ejemplo: Declaración de CWBoton.

{CWBoton imagen="41" texto="Guardar" class="boton" accion="guardar"}

Lista de plugins

B.1.7. CWBotonTooltip

Estos componentes se utlizan para comunicar la capa de presentación con la capa de la lógica de negocio. Las acciones realizadas a través de ellos no persisten hasta que se confirman con los botones inferiores.

  • Plugins que pueden contener a CWBotonTooltip

    • Padres

      • CWBarraSupPanel

      • CWFicha

      • CWFila

      • CWSelector

      • CWSolapa

  • Plugins que puede contener CWBotonTooltip

    • Hijos

      • El plugin CWBotonTooltip es una hoja (no contiene otros plugins)

Tabla de argumentos de CWBotonTooltip

Nombre Tipo ¿Opcional? Descripción Valores
titulo alfanumérico false Nombre para identificar la instancia del componente. Este debe coincidir con la acción que se quiera realizar.  
id alfanumérico true Nombre que identificar el botón. Debe coincidir con la acción que se quiera realizar.  
actuaSobre alfanumérico false En el caso de la actualización de campos aqui se indicará el array de los campos a actualizar. En el resto de casos, indica sobre que panel se va a mostrar el resultado. Indicará el destino de la acción del botón:
  • tabla: si los datos se muestran sobre una tabla y las operaciones se realizan sobre ella

  • ficha: si los datos se muestran sobre una ficha y las operaciones se realizan sobre ella

imagen alfanumérico false Nombre del fichero que contiene la imagen que queremos que aparezca en el botón, pero sin añadirle la extensión.  
action alfanumérico true Se utiliza para redireccionar en el mapping, la lógica de negocio. IMPORTANTE: Botón insertar en panel de búsqueda action siempre valdrá "nuevo".  
funcion enumerado true Indica la función que va a tener asociada ese BotonTooltip (es decir, el tipo de botón que es) Acción que realizará el botón:
  • insertar: Un botonTooltip de inserción o nuevo

  • modificar: BotonTooltip de edición o modificación

  • eliminar: BotonToltip de marcado para borrar

  • limpiar: BotonToltip de restablecimiento de valores

  • abrirVS: Botón que abre una Ventana de selección

  • buscarVS: Botón que ejecuta la búsqueda dentro de la ventana de selección

  • actualizaCampos: Botón que actualizará una serie de campos

  • print: lanza una ventana emergente imprimible con el contenido del panel con una CSS de impresión.

  • exportCSV: exporta a CSV el contenido del panel

  • ayuda: Botón que nos abrirá el manual de ayuda en una ventana emergente.

filaActual alfanumérico true Parámetro SÓLO para el botón buscar de la VENTANA DE SELECCIÓN que será una variable smarty de gestión interna.  
claseManejadora alfanumérico true Nombre de la clase php que maneje el panel.  
rutaManual alfanumérico false Indicaremos la ruta relativa a partir del directorio doc, a la página del manual que queremos que se muestre. Obligatorio si el botón es un enlace al manual.  

Ejemplos de uso del plugin CWBotonTooltip:

Ejemplo: Botón de eliminar que se encuentra en un panel tabular e insertará en él mismo.

{CWBotonTooltip imagen="01" titulo="Eliminar registros" funcion="eliminar" actuaSobre="tabla"}

Ejemplo: Botón para inserción en un patrón Tabular-Registro, la inserción se efectuará en el panel registro (ficha) y hay que indicarle un action, con "nuevo" que será la redirección indicada en el mappings.php.

{CWBotonTooltip imagen="01" titulo="Insertar registros" funcion="insertar" actuaSobre="ficha" action="nuevo"}
$this->_AddMapping('claseManejadora__nuevo', 'claseManejadora');
$this->_AddForward('claseManejadora__nuevo', 'gvHidraSuccess', 'index.php?view=views/patronesSimples/p_tabularRegistro.php&panel=editar');
$this->_AddForward('claseManejadora__nuevo', 'gvHidraError', 'index.php?view=views/patronesSimples/p_tabularRegistro.php&panel=listar');

Ejemplo: Botón asociado a una ventana de selección.

{CWBotonTooltip imagen="13" titulo="solucionar" actuaSobre='autor,fsolucion,l_estado' funcion="actualizaCampos"}

Lista de plugins

B.1.8. CWCampoTexto

Equivalente al INPUT de HTML.

  • Plugins que pueden contener a CWCampoTexto

    • Padres

      • CWContenedor

      • CWFila

      • CWFicha

      • CWSelector

      • CWSolapa

  • Plugins que puede contener CWCampoTexto

    • Hijos

      • El plugin CWCampoTexto es una hoja (no contiene otros plugins)

Tabla de argumentos de CWCampoTexto

Nombre Tipo ¿Opcional? Descripción
nombre alfanumérico false Nombre para identificar la instancia del componente. Si los datos que maneja son persistentes (acceso a BD), es necesario que este parámetro coincida con el definido por el programador en el atributo matching de la clase correspondiente en la lógica de negocio.
datatype matriz false Matriz con una estructura definida en la clase del panel, que definirá el tipo de dato a mostrar en el campo (cadena, número, fecha...) y sus propiedades como: longitud, obligatorio, máscara, calendario... Será una variable smarty en la tpl, definida de la siguiente forma: dataType = $dataType_ClaseManejadora.NombreCampo
longitudMinima entero true Indica el número de carácteres mínimos que debe introducirse en el campo. Si no se alcanza el número mínimo de caracteres a introducir, se muestra un mensaje de ALERTA.
longitudMaxima entero true Indica el número de carácteres máximos que pueden introducirse en el campo. Si se sobrepasa dicho valor, se muestra un mensaje de ALERTA.
editable enumerado true Especifica el comportamiento del campo: si su valor es true, es editable por el usuario. Si el valor es false, no es editable y si su valor es nuevo, será editable solo en la inserción cuando el plugin CWCampoTexto sea hijo de CWFila o CWFicha. Si no se especifica el atributo, el campo es editable.
oculto boolean true Añadido a partir de la versión 1.20. Se utiliza para crear CWCampoTextos no visibles, pero que pueden ser útiles para campos calculados, etc... Su comportamiento es similar al de un CWCampoTexto, a escepcion de la parte visual (CSSs) y el javascript de control.
size alfanumérico true Permite indicar el tamaño del campo en caracteres a la hora de visualizarlo en pantalla. En el caso de que nos encontremos en un panel tabular se utilizará este valor como referencia para fijar el ancho de la columna.
conUrl boolean true Si aparece y su valor es true, al lado de la caja de texto, aparece un botón, que al pulsarse abrirá una nueva ventana del navegador, cargando la URL que tenga como valor el CampoTexto. Deberá ser una URL válida y completa.
value alfanumérico true Valor que queremos que tenga el campo cuando estamos en una inserción.
actualizaA alfanumérico true Nombre de otro componente que su valor depende del valor que tenga nuestro componte texto.
tabIndex entero true Especifica el orden de tabulación.
textoAsociado alfanumérico false Fija el texto descriptivo que acompaña a un campo (etiqueta). Si además aparece el argumento/parámetro "obligatorio" a true, se le añade un * que indicará que el campo es obligatorio de rellenar. El texto que se incorpora como etiqueta, será también el que se utilice en los mensajes de comprobación de cmapos obligatorios, etc...
mostrarTextoAsociado boolean false No siempre queremos que se muestre la etiqueta o texto asociado a un campo, aunque puede interesarnos que dicho texto exista en realidad para utilizarlo en mensajes con el usuario. La solución en utilizar el parámetro y fijar su valor a false, así, evitaremos que se muestre el texto asociado.
funcion alfanumérico false Llamada a distintas funciones con sus <COMPLETAR>
visible boolean true Con "true/false" indicaremos que queremos forzar si queremos que el botón sea visible/invisible desde el principio. En lugar de obedecer el comportamiento prefijado por gvHigra.

Ejemplos de uso del plugin CWCampoTexto:

Ejemplo de uso del atributo máscara:

{CWCampoTexto nombre="ediCif" size="9" editable="true" textoAsociado="CIF" dataType=$smty_dataType_Personas.ediCif}

Lista de plugins

B.1.9. CWContendorPestanyas

Plugin que alberga dentro las pestañas asociadas a un panel.

  • Plugins que pueden contener a CWContendorPestanyas

    • Padres

      • CWMarcoPanel

  • Plugins que puede contener CWContendorPestanyas

    • Hijos

      • CWPestanya

Tabla de argumentos de CWContendorPestanyas

Nombre Tipo ¿Opcional? Descripción
id alfanumérico false Establece el identificador del CWContenedorPestanyas, y el nombre del objeto JS que controla las pestañas

Ejemplos de uso del plugin CWContendorPestanyas:

Ejemplo: Declaración de un CWContenedorPestanya con dos pestanyas dentro.

{CWContenedorPestanyas id="Maestro"}
  {CWPestanya tipo="fil" estado=$estado_fil}
  {CWPestanya tipo="lis" estado=$estado_lis}
{/CWContenedorPestanyas}

Lista de plugins

B.1.10. CWContenedor

Componente sin funcionalidad visual, se utiliza para albergar tanto tablas de HTML como plugins, desde componentes básicos hasta plugins fichas y/o tablas.

  • Plugins que pueden contener a CWContenedor

    • Padres

      • CWPanel

  • Plugins que puede contener CWContenedor

    • Hijos

      • CWTabla

      • CWFichaEdicion

      • CWFicha (sólo en dos casos: Una búsqueda o un campo external en un tabular)

Tabla de argumentos de CWContenedor

El plugin CWContenedor No tiene argumentos

Ejemplos de uso del plugin CWContenedor:

Ejemplo: Contenedor con el componente CWTabla.

{CWContenedor}
  {CWTabla ...}
   ...
  {/CWTabla}
{/CWContenedor}

Ejemplo: Contenedor con el componente CWFichaEdicion.

{CWContenedor}
  {CWFichaEdicion ...}
   ...
  {/CWFichaEdicion}
{/CWContenedor}

Ejemplo: Contenedor para panel de búsqueda.

{CWContenedor}
  {CWFicha}
    <br/>Busqueda por fechas<br/>
    {CWCampoTexto nombre="filFechaIni" size="10" editable="true" textoAsociado="Fecha recepcion inicial:"}
    {CWCampoTexto nombre="filFechaFin" size="10" editable="true" textoAsociado="Fecha recepcion final:"}
  {/CWFicha}
{/CWContenedor}

Lista de plugins

B.1.11. CWCheckBox

Equivalente al CHECKBOX de HTML.

  • Plugins que pueden contener a CWCheckBox

    • Padres

      • CWContenedor

      • CWFila

      • CWFicha

      • CWSolapa

      • CWSelector

  • Plugins que puede contener CWCheckBox

    • Hijos

      • El plugin CWCheckBox es una hoja (no contiene otros plugins)

Tabla de argumentos de CWCheckBox

Nombre Tipo ¿Opcional? Descripción
nombre alfanumérico false Nombre para identificar la instancia del componente. Si los datos que maneja son persistentes (acceso a BD), es necesario que este parámetro coincida con el definido por el programador en el atributo matching de la clase correspondiente en la lógica de negocio.
editable enumerado true Especifica el comportamiento del campo: si su valor es true, es editable por el usuario. Si el valor es false, no es editable y si su valor es nuevo, será editable solo en la inserción cuando el plugin CWCheckBox sea hijo de CWFila o CWFicha. Si no se especifica el atributo, el campo es editable.
valor alfanumérico true Valor que se le pasa a la capa de negocio cuando el componente este en un panel de búsqueda. Será obligatorio siempre que forme parte de un panel de búsqueda.
datatype matriz false Matriz con una estructura definida en la clase del panel, que definirá las propiedades del campo: obligatorio, valor chequeado, valor no chequeado. Será una variable smarty en la tpl, definida de la siguiente forma: dataType = $dataType_ClaseManejadora.NombreCampo
tabIndex entero true Especifica el orden de tabulación.
textoAsociado alfanumérico false Fija el texto descriptivo que acompaña a un campo (etiqueta). Si además aparece el argumento/parámetro "obligatorio" a true, se le añade un * que indicará que el campo es obligatorio de rellenar. El texto que se incorpora como etiqueta, será también el que se utilice en los mensajes de comprobación de cmapos obligatorios, etc...
mostrarTextoAsociado booleano false No siempre queremos que se muestre la etiqueta o texto asociado a un campo, aunque puede interesarnos que dicho texto exista en realidad para utilizarlo en mensajes con el usuario. La solución en utilizar el parámetro y fijar su valor a false, así, evitaremos que se muestre el texto asociado.
visible boolean true Con "true/false" indicaremos que queremos forzar si queremos que el botón sea visible/invisible desde el principio. En lugar de obedecer el comportamiento prefijado por gvHigra.
size alfanumérico true En el caso de que nos encontremos en un panel tabular se utilizará este valor como referencia para fijar el ancho de la columna.

Ejemplos de uso del plugin CWCheckBox:

Declaración de CWCheckBox como campo de una tabla.

{CWCheckBox nombre="descEstado" editable="true" dataType=$dataType_claseManejadora.descEstado}

SUBIR

B.1.12. CWFicha

El plugin ficha, se encarga de dibujar las capas HTML y el campo oculto que indica en que estado se encuentra la ficha (modificación, inserción o borrado). En el caso de los paneles de búsqueda, como en el uso de campos "external" (campos comunes a todas las tuplas de un panel tabular) este plugin tendrá como padre al CWContenedor directamente.

  • Plugins que pueden contener a CWFicha

    • Padres

      • CWFichaEdicion

      • CWContenedor

  • Plugins que puede contener CWFicha

    • Hijos

      • CWCampoTexto

      • CWAreaTexto

      • CWLista

      • CWCheckBox

      • CWSelector

      • CWSolapa

Tabla de argumentos de CWFicha

El plugin CWFicha no tiene argumentos

Ejemplos de uso del plugin CWFicha:

Uso del plugin CWFicha en un panel de edición.

{CWFichaEdicion id="FichaEdicion" datos=$smty_datosTablaM}
  {CWFicha}
    {CWCampoTexto nombre="anyo" editable="true" size="4" value=$smty_anyoNuevo textoAsociado="A&ntilde;o"}
    &nbsp;&nbsp;
    {CWCampoTexto nombre="nfactura" editable="false" size="6" value="0" textoAsociado="N&uacute;mero Factura"}
    <br><br>
    {CWLista nombre="procedencia" radio="true" editable="true" datos=$smty_datosPreInsertadosTinvEntradas2.procedencia textoAsociado="Procedencia"}
  {/CWFicha}
  {CWPaginador enlacesVisibles="3"}
{/CWFichaEdicion}

Lista de plugins

B.1.13. CWFichaEdicion

Plugin que alberga dentro un CWFicha, a partir de los datos que le lleguen como parámetros y de su contenido, representa esos datos como fichas, si se desea poder moverse entre ellas, debe incluirse un CWPaginador.

  • Plugins que pueden contener a CWFichaEdicion

    • Padres

      • CWContenedor

  • Plugins que puede contener CWFichaEdicion

    • Hijos

      • CWFicha

      • CWPaginador

Tabla de argumentos de CWFichaEdicion

Nombre Tipo ¿Opcional? Descripción
id alfanumérico false Establace el identificador del CWFichaEdicion
datos array asociativo false Array asociativo con los datos que queremos mostrar en la tabla. Los componentes que representen los datos de este array deben llamarse igual que las claves del array. Será una variable smarty ($smty_datos) que la sustituye IgepPanel.

Ejemplos de uso del plugin CWFichaEdicion:

{CWFichaEdicion id="FichaEdicion" datos=$smty_datosFicha}
  {CWFicha}
   ...
  {/CWFicha}
{/CWFichaEdicion

Lista de plugins

B.1.14. CWFila

Este plugin representa la fila de una tabla. Se utiliza como molde para manejar la información en modo browse.

  • Plugins que pueden contener a CWFila

    • Padres

      • CWTabla

  • Plugins que puede contener CWFila

    • Hijos

      • CWCampoTexto

      • CWAreaTexto

      • CWLista

      • CWCheckBox

Tabla de argumentos de CWFila

Nombre Tipo ¿Opcional? Descripción
tipoListado booleano true Se utiliza para las tablas que queramos que unicamente muestre la informacion en plan listado, no utilizaremos componentes básicos para representar los datos.

Ejemplos de uso del plugin CWFila:

{CWFila tipoListado="false"}
  {CWCampoTexto nombre="lisCif" size="13" textoAsociado="CIF" dataType=$dataType_Registro.lisCif}
  {CWCampoTexto nombre="lisOrden" size="2" textoAsociado="Orden" dataType=$dataType_Registro.lisOrden}
  {CWLista nombre="lisDepartamento" textoAsociado="Departamento" datos=$defaultData_Registro.lisDepartamento dataType=$dataType_Registro.lisOrden}
{/CWFila}

Lista de plugins

B.1.15. CWImagen

Equivalente al FILE de HTML.

  • Plugins que pueden contener a CWImagen

    • Padres

      • CWFicha

  • Plugins que puede contener CWImagen

    • Hijos

      • El plugin CWImagen es una hoja (no contiene otros plugins)

Tabla de argumentos de CWImagen

Nombre Tipo ¿Opcional? Descripción
nombre alfanumérico false Nombre para identificar la instancia del componente. Si los datos que maneja son persistentes (acceso a BD), es necesario que este parámetro coincida con el definido por el programador en el atributo matching de la clase correspondiente en la lógica de negocio.
width entero true Indica el ancho de la imagen.
height entero true Indica el alto de la imagen.
alt enumerado true Texto alternativo que se representa cuando la imagen no puede ser mostrada.
src entero true Ruta a la imagen. Cuando se ha de mostrar una imagen de la bd no es obligatorio poner este parámetro.
rutaAbs booleano true Ruta absoluta. Indica que debe buscar la imagen en la ruta absoluta del servidor.
textoAsociado alfanumérico false Texto que acompañará a la imagen.
mostrarTextoAsociado booleano false No siempre queremos que se muestre la etiqueta o texto asociado a un campo, aunque puede interesarnos que dicho texto exista en realidad para utilizarlo en mensajes con el usuario. La solución en utilizar el parámetro y fijar su valor a false, así, evitaremos que se muestre el texto asociado.
visible booleano true Con "true/false" indicaremos que queremos forzar si queremos que el botón sea visible/invisible desde el principio. En lugar de obedecer el comportamiento prefijado por gvHigra.

Ejemplos de uso del plugin CWImagen:

{CWImagen nombre="fichero" src="imagenes/imagen0.gif" rutaAbs="true"}

Lista de plugins

B.1.16. CWInfoContenedor

Plugin que nos permitirá introducir un texto de ayuda y que aparecerá bajo la barra superior,

  • Plugins que pueden contener a CWImagen

    • Padres

      • CWContenedor

Tabla de argumentos de CWImagen

El plugin CWContenedor No tiene argumentos.

Ejemplos de uso del plugin CWImagen:

{CWInfoContenedor}

... texto ...

{/CWInfoContenedor}

Lista de plugins

B.1.17. CWLista

Es un componente de seleccion, simple y/o multiple, se corresponde con los elementos de selección HTML, es decir, las etiquetas SELECT (select-one y select-multiple) y RADIOBUTTON. A través de los argumentos del plugin pueden expresarse selecciones condicionales, por ejemplo, listas dependientes unas de otras (Ej. Provincia - Municipio).

  • Plugins que pueden contener a CWLista

    • Padres

      • CWFila

      • CWFicha

  • Plugins que puede contener CWLista

    • Hijos

      • El plugin CWLista es una hoja (no contiene otros plugins)

Tabla de argumentos de CWLista

Nombre Tipo ¿Opcional? Descripción
nombre alfanumérico false Nombre para identificar la instancia del componente. Si los datos que maneja son persistentes (acceso a BD), es necesario que este parámetro coincida con el definido por el programador en el atributo matching de la clase correspondiente en la lógica de negocio.
editable enumerado true Especifica el comportamiento del selector: si su valor es "true", es editable por el usuario. Si el valor es "false", no es editable y si su valor es "nuevo", será editable solo en la inserción. Si no se especifica el atributo el campo es editable.
datatype matriz false Matriz con una estructura definida en la clase del panel, que definirá las propiedades de la lista, tales como obligatoriedad, tamaño (size), si es una lista múltiple o no, y si queremos que aparezca como un elemento tipo RadioButton o tipo Select. Será una variable smarty en la tpl, definida de la siguiente forma: dataType = $dataType_ClaseManejadora.NombreCampo
numCaracteres entero true Indica el número de caracteres que se mostrarán en la lista desplegable (ancho). En el caso de que nos encontremos en un panel tabular se utilizará este valor como referencia para fijar el ancho de la columna.
obligatorio booleano true Especifica el comportamiento del componente: si el su valor es 'true', es necesario que el campo tenga valor, o mostrará un mensaje de ALERTA. Si su valor es 'false', no es necesario rellenarlo. cuando el plugin CWLista sea hijo de CWFila o CWFicha. Si no se especifica el atributo, la introducción de valores en el campo no es obligatoria.
multiple booleano true Si se especifica la lista de selección se convierte en una lista de selección multiple.
size entero true Numero máximo de opciones del desplegable sin que aparezca el scroll.
radio booleano true Si aparece este parámetro, el plugin CWLista, genera un grupo de radio Buttoms con las opciones indicadas. No es compatible con el argumento "multiple".
datos matriz false Matriz con una estrutura definida, que se le pasa al CWLista para indicar cuales son las opciones posibles, el valor de cada una y cual es la seleccionada. Por lo tanto es una variable smarty ($smty_datosPreinsertados[claseManejadora]) que será sustituida por IgepPanel. Si el componente se encuentra dentro de un CWTabla o CWFicha, recogerá esos datos del padre (es decir, del CWTabla o del CWFicha). En ese caso éste argumento se utiliza para indicar cuales son los valores que deben mostrarse cuando se inserta un nuevo registro.
actualizaA alfanumérico true Se utiliza este campo en el caso de listas dependientes. Se pondra el nombre del campo que actualizas cuando este toma un valor.
tabIndex entero true Especifica el orden de tabulación.
textoAsociado alfanumérico false Texto que acompaña a un campo. Si además aparece el argumento obligatorio a true, se le añade un * que indicará que el campo es obligatorio de rellenar.
mostrarTextoAsociado booleano false No siempre queremos que se muestre la etiqueta o texto asociado a un campo, aunque puede interesarnos que dicho texto exista en realidad para utilizarlo en mensajes con el usuario. La solución en utilizar el parámetro y fijar su valor a false, así, evitaremos que se muestre el texto asociado.
visible booleano true Con "true/false" indicaremos que queremos forzar si queremos que el botón sea visible/invisible desde el principio. En lugar de obedecer el comportamiento prefijado por gvHigra.

Ejemplos de uso del plugin CWLista:

Ejemplo: Dos listas dependientes.

{CWLista nombre="ediCodProv" radio="true" size="3" actualizaA="ediCodMun" editable="true" datos=$defaultData_Registro.ediCodProv dataType=$dataType_Registro.ediCodProv}
{CWLista nombre="ediCodMun" size="3" editable="true" dataType=$dataType_Registro.ediCodMun datos=$defaultData_Registro.ediCodMun}

Lista de plugins

B.1.18. CWMarcoPanel

Se utiliza para agrupar paneles, cada panel representa un modo de trabajo (busqueda, ficha, browse...) sobre un mismo conjunto de datos o un subconjunto de los mismos. Sus hijos serán siempre uno o más paneles y por último, un CWContenedorPestanyas si es que estas deben aparecer.

  • Plugins que pueden contener a CWMarcoPanel

    • Padres

      • CWVentana

  • Plugins que puede contener CWMarcoPanel

    • Hijos

      • CWPanel

      • CWContenedorPestanyas

Tabla de argumentos de CWMarcoPanel

Nombre Tipo ¿Opcional? Descripción
conPestanyas booleano true Debe utilizarse en cuanto aparezcan los modos de comportamiento. Cuando su valor es true, introduce los elementos Javascript necesarios para el manejo de las pestañas.

Ejemplos de uso del plugin campo:

Ejemplo: Uso del componente CWMarcoPanel en un Maestro-Detalle.

{CWVentana ...}
...
 {CWMarcoPanel conPestanyas="true"}

<!--*********** PANEL fil ******************-->
   {CWPanel id="fil" action="buscar" method="post" estado="$estado_fil" claseManejadora="Registro"}
   ...
   {/CWPanel}
<!--*********** PANEL lis ******************-->
   {CWPanel id="edi" tipoComprobacion="envio" action="operarBD" method="post" estado="$estado_edi" claseManejadora="Registro"}
   ...
   {/CWPanel}
<!-- ****************** PESTANYAS ************************-->
   {CWContenedorPestanyas}
     {CWPestanya tipo="fil" estado=$estado_fil}
     {CWPestanya tipo="edi" estado=$estado_edi}
   {/CWContenedorPestanyas}
 {/CWMarcoPanel}
{/CWVentana}

Lista de plugins

B.1.19. CWMenuLayer

Adaptación simplificada del menu dinámico generado en PHP y JavaScript del proyecto GPL PHPLM (PHP Layers Menu) de Marco Pratesi

  • Plugins que pueden contener a CWMenuLayer

    • Padres

      • CWBarra

  • Plugins que puede contener CWMenuLayer

    • Hijos

      • El plugin CWMenuLayer es una hoja (no contiene otros plugins)

Tabla de argumentos de CWMenuLayer

Nombre Tipo ¿Opcional? Descripción
name alfanumérico false Especifica el nombre del componente. Si no se indica, se genera uno automáticamente. Es una variable smarty ($smty_nombre) que se sustituirá en IgepPanel.
usarImagenesAplicacion booleano false Parámetro opcional, cuyo valor por defecto es "false", indica si debe buscar las imágenes del menu en la aplicación, o en caso de ser falso, utilizará las imágenes de gvHidra.
imgDescenso alfanumérico true Indica el nombre de la imagen (soporta gif, jpg o png) que despliega el menu de forma descedente. La imagen por defecto es down-arrow.png
imgDespliega alfanumérico true Indica el nombre de la imagen (soporta gif, jpg o png) que despliega el menu de forma lateral. La imagen por defecto es forward-arrow.png
fichero alfanumérico true Parámetro opcional con el que se indica el fichero (extensión .str) que contiene la estructura del menu el formato del mismo es: ". | opcion | url | texto ayuda emergente | imagen" Si se utiliza esta forma de establecer el menú no ha de existir el próximo parámetro 'cadenaMenu'.
cadenaMenu alfanumérico true Cadena de texto con la estructura del menú. Al ser una cadena de texto, podemos generar menús dinámicos (será un fichero xml), es decir, cuyas opciones varíen en función de algún parámetro, por ejemplo en función del ROL del usuario etc... Será una variable smarty $smty_cadenaMenu que se sustituirá en IgepPantalla.

Ejemplos de uso del plugin CWMenuLayer:

Ejemplo de la estuctura del menú

.|Menu|
..|Entrada Opción 1||
...|Inserción|?view=views/insercion.php| Opción para Nuevo Registro | insertar.png
...|Mantenimiento|?view=views/mantenimiento.php| Opción para Mantenimiento
..|Entrada Opción 2||
...|Prueba con frame oculto|?view=views/inicio.php| Aplicación
...|Prueba Maestro-Detalle|?view=views/MD.php| Home en flaco

Ejemplo: Dentro de CWVentana.

{CWVentana tipoAviso=$smty_tipoAviso codAviso=$smty_codError descBreve=$smty_descBreve textoAviso=$smty_textoAviso onLoad=$smty_jsOnLoad}
  {CWBarra usuario=$smty_usuario codigo=$smty_codigo customTitle=$smty_customTitle}
    {CWMenuLayer name="$smty_nombre" cadenaMenu="$smty_cadenaMenu"}
  {/CWBarra}
  {CWMarcoPanel conPestanyas="true"}
   ···
  {/CWMarcoPanel}
{/CWVentana}

Lista de plugins

B.1.20. CWPaginador

Integra una línea de enlaces para paginar cuando se presentan múltiples regitros a través de los plugins CWTabla y CWFicha.

  • Plugins que pueden contener a CWPaginador

    • Padres

      • CWTabla

      • CWFichaEdicion

  • Plugins que puede contener CWPaginador

    • Hijos

      • El plugin CWPaginador es una hoja (no contiene otros plugins)

Tabla de argumentos de CWPaginador

Nombre Tipo ¿Opcional? Descripción
pagInicial entero true Indica la página que aparecerá visible cuando se cargue la pantalla, por defecto siempre vale 0.
enlacesVisibles entero true Indica el número de enlaces que apareceran para realizar la navegación además de los fijos (siguiente, ultimo, anterior y primero)

Ejemplos de uso del plugin CWPaginador:

Ejemplo: Utilizacion de un CWPaginador en una tabla.

{CWTabla conCheck="true" seleccionUnica="true" id="Tabla1" datos=$smty_datosTabla}
  {CWFila tipoListado="false"}
    {CWCampoTexto nombre="lisCif" size="9" editable="true" textoAsociado="CIF" dataType=$smty_dataType_Personas.lisCif}
    {CWCampoTexto nombre="lisNombre" editable="true" size="30" textoAsociado="Nombre" dataType=$smty_dataType_Personas.lisNombre}
  {/CWFila}
  {CWPaginador enlacesVisibles="3"}
{/CWTabla}

Lista de plugins

B.1.21. CWPanel

Este componente es un contenedor, aporta javascript, una tabla HTML para incluir otros plugins, y un elemento FORM de HTML, por lo que es el plugin que realiza los envios de información hacia la lógica. Cada panel es un formulario HTML y se corresponde con una de las pestañas de los modos de trabajo indicados en la guía de estilo (búsqueda, ficha, tabular).

El orden de los hijos en un panel si que es importante y debe respetarse.

  • Plugins que pueden contener a CWPanel

    • Padres

      • CWMarcoPanel

  • Plugins que puede contener CWPanel

    • Hijos (hay que respetar este orden a la hora de crear los hijos)

      • CWBarraSupPanel

      • CWContenedor

      • CWBarraInfPanel

Tabla de argumentos de CWPanel

Nombre Tipo ¿Opcional? Descripción Valores
id enumerado false Fija el identificador del componete y del formulario HTML que incluye por debajo. Es necesario que dicho nombre sea único para evitar comportamientos no previstos en la interfaz. Puede tomar los siguientes valores:
  • fil: panel de búsqueda.

  • edi: panel registro.

  • lis: panel tabulares.

  • ediMaestro / ediDetalle: panel registro maestro o detalle, respectivamente.

  • lisMaestro / lisDetalle: panel tabular maestro o detalle, respectivamente.

action alfanumérico true Tipo de acción que debe coincidir con la correspondiente en el mappings.  
accion alfanumérico true Estado en el que se quiere encontrar el panel al cargarlo (modo inserción, modificación, borrado) Puede tomar los siguientes valores:
  • insertar

  • modificar

  • borrar

tipoComprobacion alfanumérico false Indica la comprobación que queremos que se realice a los campos que tengan el argumento comprobacion igual true. Por defecto hará una comprobación "envio" Puede tomar los siguientes valores:
  • envio

  • foco

  • todo

method alfanumérico false Indica la manera en que debe realizarse el submit del FORM HTML (get/post).  
estado alfanumérico true Indica el estado del panel (activo o desactivado) cuando se carga la pantalla. Las opciones son, si no viene dado desde la capa de negocio con variables smarty: Puede tomar los siguientes valores:
  • on: visible y activo

  • off: visible e inactivo

  • inactivo: no visible e inactivo

claseManejadora alfanumérico true Indica la clase que va a ocuparse de la lógica de esta pantalla.  

Ejemplos de uso del plugin CWPanel:

Ejemplo de uso del action:

-> Parámetro del plugin
{CWPanel id="edi" action="operarBD" estado="$estado_edi" claseManejadora="TinvEntradas2" ...}

-> Correspondencia en el mappings.php
$this->_AddMapping('TinvEntradas2__operarBD', 'TinvEntradas2', '', 'IgepForm', 0);

Ejemplo: Uso del componente CWPanel en un panel de búsqueda.

{CWPanel id="fil" action="buscar" method="post" estado="$estado_fil" claseManejadora="TinvDonantes"}
  {CWBarraSupPanel titulo="Donantes"}
    {CWBotonTooltip imagen="01" titulo="Insertar registro" funcion="insertar" actuaSobre="ficha" action="nuevo"}
    {CWBotonTooltip imagen="04" titulo="Limpiar campos" funcion="limpiar" actuaSobre="ficha"}
  {/CWBarraSupPanel}
  {CWContenedor}
    {CWFicha}
      <br>&nbsp;&nbsp;
      {CWCampoTexto nombre="filCif" editable="true" size="13" textoAsociado="CIF/NIF" dataType=$dataType_TinvDonantes.filCif}
      <br><br>
    {/CWFicha}
   {/CWContenedor}
   {CWBarraInfPanel}
     {CWBoton imagen="50" texto="Buscar" class="boton" accion="buscar"}
   {/CWBarraInfPanel}
{/CWPanel}

Lista de plugins

B.1.22. CWPantallaEntrada

Con este plugin creamos la pantalla inicial de cualquier aplicación según la guía de estilo. Todos sus parámetros son variables smarty que se sustituyen internamente.

  • Plugins que pueden contener a CWPantallaEntrada

    • Padres

      • CWVentana

  • Plugins que puede contener CWPantallaEntrada

    • Hijos

      • El plugin CWPantallaEntrada es una hoja (no contiene otros plugins)

Tabla de argumentos de CWPantallaEntrada

Nombre Tipo ¿Opcional? Descripción
usuario alfanumérico false Se utiliza para mostrar en pantalla el usuario que está conectado a la aplicación.
nomApl alfanumérico false Se utiliza para mostrar el nombre de la aplicación que se va a utilizar.
codApl alfanumérico false Se utiliza para mostrar en pantalla el código de la aplicación. (Abreviatura que suele corresponderse con el nombre del directorio del servidor Web donde se ubica)

Ejemplos de uso del plugin CWPantallaEntrada:

Ejemplo: Declaración de una Pantalla de inicio. Sólo aparece en aplicación.tpl, plantilla exlclusiva de igep.

{CWVentana tipoAviso=$smty_tipoAviso titulo=$smty_tituloApl codAviso=$smty_codError descBreve=$smty_descBreve textoAviso=$smty_textoAviso onLoad=$smty_jsOnLoad onUnload=$smty_jsOnUnload}
  {CWPantallaEntrada usuario=$smty_usuario rolApl=$smty_rolApl nomApl=$smty_aplicacion codApl=$smty_codaplic}
{/CWVentana}

Lista de plugins

B.1.23. CWPestanyas

Plugin que dibujará la pestaña lateral correspondiente.

  • Plugins que pueden contener a CWPestanyas

    • Padres

      • CWContenedorPestanyas

  • Plugins que puede contener CWPestanyas

    • Hijos

      • El plugin CWPestanyas es una hoja (no contiene otros plugins)

Tabla de argumentos de CWPestanyas

Nombre Tipo ¿Opcional? Descripción Valores
tipo enumerado false Indicará el tipo de pestaña El valor a tomar dependerá del panel al que va asociado:
  • fil: Panel filtro

  • edi: Panel registro

  • lis: Panel tabular

estado alfanumérico false Valor que corresponderá con el estado que queramos que aparezaca en un principio. Puede ser establecida por defecto en la tpl o ser una variable de smarty sustituida internamente.  
panelAsociado alfanumérico false Nombre del panel al que está asociada dicha pestaña.  
ocultar alfanumérico false Se utiliza en los mantenimientos mestro detalle, nos permite ocultar el panel de detalle cuano se se selecciona la pestaña en el que está definido el parámetro (el valor es "Detalle")  
mostrar alfanumérico false Similar a ocultar, pero en este caso se utiliza para activar el detalle ('Detalle' como argumento) al seleccionar la pestaña que tiene dicho parámetro  

Ejemplos de uso del plugin CWPestanyas:

Ejemplo: Definición de dos pestañas.

{CWContenedorPestanyas}
  {CWPestanya tipo="fil" estado=$estado_fil}
  {CWPestanya tipo="lis" estado=$estado_lis}
{/CWContenedorPestanyas}

Lista de plugins

B.1.24. CWSelector

Define un patrón tipo lista que nos permita simular el maestro-detalle-subdetalle. Por un lado tenemos una lista múltiple donde se irán acumulando los valores procedentes de los campos que se hayan incluido en el selector. Estos campos pueden ser un conjunto de elementos básicos (CWCampoTexto, CWLista (NO multiple), CWCheckBox, CWBotonToolTip) o una única lista multiple. No se podrá combinar una lista múltiple con otros elementos de formulario (campos de texto, listas simples...), ya que las opciones elegidas de la lista múltiple se copiarán a la lista destino como opciones diferentes y no una combinación como la que se hace con varios campos.

  • Plugins que pueden contener a CWSelector

    • Padres

      • CWFicha

  • Plugins que puede contener CWSelector

    • Hijos

      • CWCampoTexto

      • CWAreaTexto

      • CWLista

      • CWCheckBox

      • CWBotonToolTip

Tabla de argumentos de CWSelector

Nombre Tipo ¿Opcional? Descripción
titulo alfanumérico false Título que identifica el elemento.
botones matriz false Estructura recibida de la capa de negocio para indicar que botones ('insertar','modificar','eliminar') aparecerán visibles.
nombre alfanumérico false Nombre para el campo destino donde se irán acumulando los valores.
editable alfanumérico true Especifica el comportamiento del campo destino: si su valor es true, es editable por el usuario. Si el valor es false, no es editable y si su valor es nuevo, será editable solo en la inserción cuando el plugin CWAreaTexto sea hijo de CWFila o CWFicha. Si no se especifica el atributo, el campo es editable.
separador alfanumérico true Carácter que utilizaremos para separar los distintos datos que formen parte de un mismo registro, por defecto será el carácter "|".
datos matriz true Matriz con una estrutura definida, que se le pasa al CWSelector para mostrar los datos existentes a los que podremos añadir o eliminar otros. Será una variable smarty $smty_datos que se encargará IgepPanel de sustituir.
rows entero true Especifica el número de filas que tendrá el textarea.

Ejemplos de uso del plugin CWSelector:

Ejemplo: Selector con varios campos de texto.

{CWSelector titulo="*Formato:" botones=$smty_botones nombre="listaBienes" editable="nuevo" separador=","}
    {CWCampoTexto nombre="ediCcentro" editable="nuevo" size="2" textoAsociado="Centro" actualizaA="ediDcentro" dataType=$dataType_MiClase.ediCcentro}
    &nbsp;&nbsp;
    {CWCampoTexto nombre="ediDcentro" editable="false" size="50" dataType=$dataType_MiClase.ediDcentro}
    {CWBotonTooltip imagen="13" titulo="Ventana de seleccion" funcion="abrirVS" actuaSobre="ccentro" formActua="ediDetalle" panelActua="FichaDetalle" claseManejadora="TinvLineas2"}
    <br><br>
    {CWCampoTexto nombre="ediUds" editable="true" size="5" textoAsociado="Uds" dataType=$dataType_MiClase.ediUds}
    <br><br>
{/CWSelector}

Ejemplo: Selector con una lista con datos de la BD.

{CWSelector titulo="*Formato:" botones=$smty_botones nombre="listaBienes" editable="nuevo" datos=$defaultData_Registro.listaBienes}
    {CWLista multiple=true nombre="categorias" editable="nuevo" textoAsociado="Categorias" datos=$defaultData_Registro.categorias}
{/CWSelector}

Lista de plugins

B.1.25. CWSolapa

Plugin que alberga dentro las solapas asociadas a un panel. Genera la lógica JavaScript necesaria para manejarlas. Es necesario que las solapas estén dentro de una FichaEdicion, que tiene como parámetros 'numSolapas' y 'titulosSolapas' (ver plugin CWFichaEdicion).

  • Plugins que pueden contener a CWSolapa

    • Padres

      • CWFicha

  • Plugins que puede contener CWSolapa

    • Hijos

      • CWCampoTexto

      • CWAreaTexto

      • CWLista

      • CWCheckBox

Tabla de argumentos de CWSolapa

Nombre Tipo ¿Opcional? Descripción
titulo alfanumérico false Establace el texto que aparecerá en la solapa.
poscionSolapa entero false Es un atributo obligatorio, que indica la posicion que tendra esa solapa. Debe ser consecutivo y empezar por 0.

Ejemplos de uso del plugin CWSolapa:

Ejemplo: Declaración de un CWContenedorPestanya con dos pestanyas dentro.

{CWFichaEdicion id="FichaEdicion" datos=$smty_datosFicha}
  {CWFicha}
    {CWSolapa titulo=" Datos 1" posicionSolapa=0}
      {CWCampoTexto nombre="ediCif" editable="true" size="13" textoAsociado="CIF" dataType=$dataType_Registro.ediCif}
      {CWCampoTexto nombre="ediOrden" editable="true" size="2" textoAsociado="Orden" dataType=$dataType_Registro.ediOrden}
    {/CWSolapa}
    {CWSolapa titulo="Datos personales" posicionSolapa="1"}
       ...
    {/CWSolapa}
{/CWFicha}
{/CWFichaEdicion}

Lista de plugins

B.1.26. CWTabla

Equivalente al TABLE del HTML

  • Plugins que pueden contener a CWTabla

    • Padres

      • CWContenedor

  • Plugins que puede contener CWTabla

    • Hijos

      • CWFila

Tabla de argumentos de CWTabla

Nombre Tipo ¿Opcional? Descripción
id alfanumérico false Atributo utilizado por plugins herederos o descendientes. Lo utiliza el plugin CWFila para generar los elementos TR con un id.
datos array asociativo false Vector asociativo que el programador pasa a la tabla con los datos que queremos que se muestre en esta. Variable smarty ($smty_datos) que se sustituye internamente.
conCheck boleano true Si aparece y su valor es true, al principio de cada fila que compone la tabla aparecera un checkbox que utilizaremos para seleccionar la fila o filas sobre las que realizaremos las diferentes acciones.
seleccionUnica boleano true Permite un único elemento seleccionado en la tabla.
conCheckTodos boleano true Si aparece y su valor es true, aparecera un checkbox en la cabecera de la tabla que nos permitira seleccionar y deseleccionar todos los registros.
numFilasPantalla entero true Fija el número de filas de datos que queremos que aparezca por pantalla. En caso de no aparecer por defecto apareceran 6 filas de datos.

Ejemplos de uso del plugin CWTabla:

{CWTabla conCheck="true" seleccionUnica="true" id="Tabla1" datos=$smty_datosTabla}
  {CWFila tipoListado="false"}
     {CWCampoTexto nombre="lisCif" size="9" editable="true" textoAsociado="CIF" dataType=$dataType_MiClase.lisCif}
     {CWCampoTexto nombre="lisNombre" editable="true" size="30" textoAsociado="Nombre" dataType=$dataType_MiClase.lisNombre}
     {CWCampoTexto nombre="lisMoto" editable="true" size="30" textoAsociado="Moto" dataType=$dataType_MiClase.lisMoto}
  {/CWFila}
  {CWPaginador enlacesVisibles="3"}
{/CWTabla}

Lista de plugins

B.1.27. CWUpLoad

Equivale al FILE de HTML

  • Plugins que pueden contener a CWUpLoad

    • Padres

      • El plugin CWUpLoad es raiz (no lo contiene ningún otro plugin)

  • Plugins que puede contener CWUpLoad

    • Hijos

      • CWFicha

      • CWConenedor

Tabla de argumentos de CWUpLoad

Nombre Tipo ¿Opcional? Descripción
nombre alfanumérico false Nombre para identificar la instancia del componente. Si los datos que maneja son persistentes (acceso a BD), es necesario que este parámetro coincida con el definido por el programador en el atributo matching de la clase correspondiente en la lógica de negocio.
obligatorio booleano true Especifica el comportamiento del campo: Si el su valor es true, es necesario que el campo tenga valor, o mostrará un mensaje de ALERTA. Si su valor es false, no es necesario rellenarlo. Cuando el plugin CWCampoTexto sea hijo de CWFila o CWFicha, si no se especifica el atributo, la introducción de valores en el campo no es obligatoria.
size entero true Tamaño de la caja de texto en pantalla.
tabIndex entero true Especifica el orden de tabulación.
textoAsociado alfanumérico false Texto que acompaña a un campo. Si además aparece el argumento obligatorio a true, se le añade un * que indicará que el campo es obligatorio de rellenar.

Ejemplos de uso del plugin CWUpLoad:

{CWUpLoad nombre="ficheroUpload" size="10" textoAsociado="Si quieres cambiar la imagen..."}

Lista de plugins

B.1.28. CWVentana

Este componente se basa en la ventana HTML. Es el plugin raíz, con el se incluye la base javascript necesaria para el comportamiento de la interfaz (manejo de capas, errores...). Todos sus parámetros serán fijados internamente mediante variables smarty.

  • Plugins que pueden contener a CWVentana

    • Padres

      • El plugin CWVentana es raiz (no lo contiene ningún otro plugin)

  • Plugins que puede contener CWVentana

    • Hijos

      • CWBarra

      • CWMarcoPanel

      • CWPantallaEntrada

      • CWEjecutarScripts

Tabla de argumentos de CWVentana

Nombre Tipo ¿Opcional? Descripción Valores
titulo alfanumérico true Fija el título de la Ventana HTML. Variable smarty $smty_tituloApl.  
tipoAviso alfanumérico false Indica el tipo de aviso según la guia de estilo. Variable smarty $smty_tipoAviso. Los tipos de aviso pueden ser:
  • aviso

  • alerta

  • notificación

  • sugerencia

codAviso alfanumérico false Fija el código de aviso. Variable smarty $smty_codError.  
descBreve alfanumérico false Descripción breve del mensaje del aviso. Variable smarty $smty_descBreve.  
textoAviso alfanumérico false Descripción detallada del aviso. Variable smarty $smty_textoAviso.  
onload alfanumérico false En este parámetro podremos introducir una llamada a una funcion javascript que debe ejecutarse en el evento onLoad de la página  
onUnload alfanumérico false En este parámetro podremos introducir una llamada a una funcion javascript que debe ejecutarse en el evento onUnLoad de la página  

Ejemplos de uso del plugin CWVentana:

{CWVentana tipoAviso=$smty_tipoAviso  codAviso=$smty_codError  descBreve = $smty_descBreve  textoAviso=$smty_textoAviso onLoad=$smty_jsOnLoad}
···
{/CWVentana}

Lista de plugins