Saltar al contenido principal
Version: 4.5.0

Criteria

Los elementos de criterio son componentes de ventana que pueden obtener la entrada del usuario y enviarla al servidor de aplicaciones (lógica de negocio).

Criteria

Cómo funcionan

Internamente, un criterio tiene 2 atributos básicos para administrar la información que se envía al servidor y la información que se muestra al usuario:

  • seleccionado: Los valores seleccionados del criterio. Estos valores serán enviados al servidor.
  • valores: Los valores disponibles del criterio. Estos valores no __ serán enviados al servidor. Es una lista de valores y etiquetas que se mostrarán al usuario para elegir.

Prioridades

Los valores de **** seleccionados pueden ser completados de varias maneras. Esta es una lista de prioridades con estas maneras:

  1. variable - Estos son los valores enviados desde otra pantalla
  2. screen target - Los valores devueltos por el objetivo de la pantalla son la prioridad más alta de la lista
  3. initial-load="value" - Los valores recuperados de consulta siguen los valores objetivo de la pantalla
  4. sesión - Valores almacenados en sesión
  5. propiedad - Valores almacenados en la propiedad
  6. valor - Valores estáticos definidos en el atributo de valor

Esqueleto de XML

<criteria id="[identifier]" component="[component]" label="[label]" placeholder="[placeholder]" style="[classes]"
initial-load="[initial-load]" server-action="[server-action]" target-action="[target-action]"
variable="[variable]" value="[value]" session="[session]" property="[property]"
validation="[validation]" readonly="[read-only]" size="[size]" unit="[unit]" icon="[icon]"
printable="[printable]" help="[help]" help-image="[help-image]"
optional="[optional]" area-rows="[area-rows]" number-format="[number-format]" capitalize="[capitalize]"
strict="[strict]" checked="[checked]" group="[group]" show-slider="[slider]" destination="[destination]">
<dependency... />
</criteria>

Estructura de criterios

ElementoUsoVarias instanciasDescripción
criteriaObligatorioNoNodo global de los criterios. Define los atributos del criterio
dependencyOpcionalSiLista de dependencias adjuntas al criterio

Atributos generales

AtributoUsoTipoDescripciónValores
idObligatorioStringIdentificador de criterio. Con fines de referencia
componentObligatorioStringTipo de criterioVer componentes
labelOpcionalStringTexto del criterio (fuera del criterio)Nota: Puedes usar i18n archivos (locales)
marcador de posiciónOpcionalStringTexto del criterio (dentro del criterio)Nota: Puedes usar i18n archivos (locales)
styleOpcionalStringClases CSS CriterionVer posicionamiento de Bootstrap para el tamaño del criterio
carga-inicialOpcionalStringLlamada de acción al servidor para cargar los datos de criterio (se lanza al cargar la ventana)enum (para enumerado), consulta (para llamada de consulta cargando los valores parte del criterio) o valores (para llamada de consulta cargando el seleccionado parte del criterio)
server-acciónOpcionalStringLlamada de acción del servidorVer lista de acciones del servidor
acción-objetivoOpcionalStringDestino para llamar al servidor
maxOpcionalEnteroNúmero máximo de valoresNota: El valor predeterminado se establece en la propiedad var.def.rpp en el archivo base.properties
carga automáticaOpcionalBooleanIniciar acción de destino cuando la pantalla ha sido inicializadaNota: El valor predeterminado es falso
autorefrescarOpcionalEnteroEjecuta la acción del objetivo cada X segundosNota: El valor está en segundos
variableOpcionalStringParámetro para rellenar el valor del criterioIdentificador de un criterio en la pantalla anterior
valorOpcionalStringValor por defecto del criterio
sessionOpcionalStringSession variable to load the criterionSession variable identifier
propertyOpcionalStringProperty variable to load the criterionProperty variable identifier
validationOpcionalStringReglas de validaciónVer validación
sólo lecturaOpcionalBooleanEstablecer criterio como sólo lecturaEl valor predeterminado es falso
sizeOpcionalStringTamaño del criteriosm (default), md or lg.
unidadOpcionalStringTexto de unidad de criterioNota: Puedes usar i18n archivos (locales)
iconoOpcionalStringIdentificador de iconoNota: Puede comprobar todos los iconos en FontAwesome
imprimibleOpcionalStringComprobar si el criterio es imprimibletrue, false, excel, todos, pestaña
ayudaOpcionalStringHelp text for the criterionNota: Puedes usar i18n archivos (locales)
imagen de ayudaOpcionalStringHelp image for the criterionEsta debe ser una ruta de imagen
etiqueta izquierdaOpcionalEnteroPon la etiqueta a la izquierda y dale un tamaño en caracteresEl valor por defecto está vacío (la etiqueta está arriba en lugar de izquierda). Si está definido, el valor debe ser un número de caracteres para la etiqueta

Atributos específicos

AtributoCriterioTipoDescripciónValores
optionalSeleccionarBooleanPermite seleccionar un valor vacíoEl valor predeterminado es falso
filas de áreaTextareaEnteroNúmero de filas del área de textoEl valor predeterminado es 3
formato-numeroNumericStringFormato del númeroVer plugin umeric
capitalizarSeleccionar, SugerenciaBooleanPoner la primera letra de las opciones en mayúsculas y las otras en minúsculasEl valor predeterminado es falso
estrictoSugerenciaBooleanPermitir al usuario sólo seleccionar los valores de la listaEl valor predeterminado es verdadero
check-targetSugerenciaStringAcción de destino a lanzar si la etiqueta no está definida al sugerir inicializaciónEl valor predeterminado es el definido en target-action
comprobadoCaja de verificación, RadioBooleanMarcar el criterio como comprobado inicialmenteEl valor predeterminado es falso
groupCaja de verificación, RadioStringGrupo del criterio (para fines de validación y gestión)
mostrar-deslizadorNumericBooleanSe utiliza para mostrar el deslizador gráfico del componenteNota: Sólo aplicar en criterios numéricos
destinationCargadorStringCarpeta relativa de destino para subir el archivo
show-weekendsDateBooleanPara activar o desactivar los días de fin de semanaEl valor predeterminado es verdadero
fechas de futuroDateBooleanPara activar o desactivar los días futuros después del valor de fecha seleccionadoEl valor predeterminado es verdadero
date-formatDateStringPara establecer el formato de la fecha que desea mostrarEl valor predeterminado es dd/MM/aaaaa. Nota: Ver el formato en el siguiente enlace
fecha-mostrar-hoy-botónDateBooleanPara mostrar o no el botón para seleccionar la fecha de hoyEl valor predeterminado es verdadero
fecha-vista-modoDateStringSelecciona 'días', 'meses' o 'años' para establecer la magnitud mínima a mostrarEl valor predeterminado es días

Componentes

Criterios de texto

Entrada de texto básica.

textCriterion

Criterio de contraseña

Entrada de texto básica, pero los caracteres escritos no se muestran al usuario.

Password

Textarea criterion

Criterio que permite al usuario insertar un texto grande y nuevas líneas.

Textarea

Criterio oculto

Criterios ocultos. Es útil enviar valores estáticos a una consulta o como elemento de fórmula.

Criterio numérico

Criterio que permite insertar números formateados.

numericCriterion

Criterio numérico con deslizador activado

Deslizador_numérico

Atributo de formato numérico

Este atributo se utiliza para formatear el criterio numérico y el deslizador. Se especifica en el formato de objeto json.

AtributoUsoTipoDescripciónValores
minOpcionalNumberEl valor mínimo posibleEx: {min: 5}
maxOpcionalNumberEl valor máximo posibleEx: {max: 5}
aSignOpcionalStringSímbolo de moneda deseadoEx: {aSign: ' €'}
pSignOpcionalStringControla la colocación del símbolo de monedapSign: 'p' para prefijo o pSign: 's' para sufijo (predeterminado)
aPadOpcionalBooleanControla el relleno de los decimalesverdadero siempre pon el decimal con ceros o falso (por defecto) sin relleno
precisiónOpcionalNumberNumber of decimalsNota: Los mil & separadores decimales no pueden ser los mismos
pasoOpcionalNumberPaso de incremento deslizanteEx: {step: 5}
ticksOpcionalMatrizUtilizado para definir los valores de ticks en el deslizador. Las marcas de marca son indicadores que indican valores especiales en el rango. Esta opción sobrescribe las opciones min y maxEj: {ticks: [-1000, -500, 0, 500, 1000]}
etiquetas_etiquetasOpcionalMatrizDefine las etiquetas debajo de las marcas de tick. Acepta entrada HTMLEj: {ticks_labels: ['-$1000', '-$500', '$0', '$500', '$1000']}

Nota: Puedes ver todos los atributos uméricos aquí y los atributos deslizantes aquí

Ejemplos de formato numérico

number-format="{min: 0, max: 100, paso: 0. 1, precisión: 2, asign:' £', pSign:'s', aPad:true}"
---
number-format="{min: -1000, max: 1000, step: 10, precision: 2, Prensa:' $', pSign:'s', aPad:true,
ticks: [-1000, -500, 0, 500, 1000], ticks_labels: ['-$1000', '-$500', '$0', '$500', '$500', '$1000']}"

Criterio de fecha

Permite seleccionar una fecha con un calendario.

dateCriterio

Criterio de hora

Permite seleccionar una hora con un selector de tiempo.

TimeCriterion

Criterio de fecha filtrado

Permite seleccionar una fecha con un calendario de una lista de fechas filtradas.

Filtrado Date.ong

Seleccionar criterio

Muestra una lista y permite al usuario seleccionar un elemento.

Seleccionar

Criterios sugeridos

Permite al usuario buscar un valor escribiendo algunos caracteres del valor buscar.

Sugerencia

Nota: El texto escrito se envía al servidor como sugerir parámetro, pero sólo cuando la consulta se utiliza para rellenar las opciones. De lo contrario, el id de la sugerencia debería utilizarse como de costumbre.

Seleccionar sugerencia de VS

SeleccionarSugerencia
La lista de valores es "fijada"La lista puede cambiar cada vez que interactúa con el componente
La lista se carga cuando entra en la ventanaLa lista se carga cuando interactúa con el componente
Filtrado en el clienteSe puede filtrar en cliente y servidor
Tienes que usarlo cuando la lista de valores es pequeña y con un número fijo de valores.Se puede utilizar con listas grandes y pequeñas
Usar atributo "max"=0Utilice el atributo "max" para limitar los datos devueltos por el servidor.
Debe utilizar la variable "sugerir" para filtrar.
No se utiliza cuando hay interrelaciones entre criteriosUso forzoso cuando hay interrelaciones con otros criterios.

Múltiples criterios de selección

Muestra una lista y permite al usuario seleccionar algunos elementos.

Multiselección

Múltiples criterios de sugerencia

Permite al usuario buscar algunos valores escribiendo algunos caracteres de los valores buscar.

Multisugerir

Nota: El texto escrito se envía al servidor como sugerir parámetro.

Criterios de checkbox

Muestra una casilla de verificación. Envía un 1 (o el valor definido en el valor atributo) si está marcado o 0 si está desmarcado.

Casillas

Criterio del botón de radio

Muestra un botón de radio. Es una monoselección. Envía el atributo value del elemento seleccionado entre todos los botones de radio con el mismo atributo grupo.

Radios

Nota: Si queremos que un grupo de botones de radio sea requerido, todos los botones de radio que están dentro del grupo deben tener validación="requerido"

Criterio de la casilla de verificación de botón (línea)

Similar a una casilla de verificación pero tiene una apariencia de botón. Envía un 1 (o el valor definido en el valor atributo) si está marcado o 0 si está desmarcado.

ButtonCheckbox

Criterio del botón de radio (línea)

Similar a un botón de radio pero tiene una apariencia de botón. Es una monoselección. Envía el atributo value del elemento seleccionado entre todos los botones de radio con el mismo atributo grupo.

Radio Botón

Criterios de color

Criterios de color. Es útil para obtener el valor hexadecimal de color con un selector de color widget.

Selector de color

Criterio del cargador

Criterio útil para enviar archivos al servidor. Una vez subidos, los archivos pueden ser gestionados por los procesos del servidor

Criterio de subida

Criterio de vista de texto

Este criterio simplemente muestra un texto, que puede ser recuperado de una variable, un parámetro, una consulta o incluso cargado de dependencias.

TextView

Ejemplos

Múltiples sugerencias con icono

<criteria label="PARAMETER_USER" component="suggest-multiple" id="..." icon="user" initial-load="query" target-action="..."    
style="col-xs-12 col-sm-6 col-lg-3"/>
Sugerir icono

Grupo de botones de radio

<criteria component="radio" label="PARAMETER_RADIO_1" id="RadBox1" group="RadBox" variable="RadBox" 
value="Radio1" style="col-xs-6 col-sm-2 col-lg-1 no-label" validation="required" checked="true"/>
<criteria component="radio" label="PARAMETER_RADIO_2" id="RadBox2" group="RadBox" variable="RadBox"
value="Radio2" style="col-xs-6 col-sm-2 col-lg-1 no-label" readonly="true"/>
<criteria component="radio" label="PARAMETER_RADIO_3" id="RadBox3" group="RadBox" variable="RadBox"
value="Radio3" style="col-xs-6 col-sm-2 col-lg-1 no-label"/>
Radios

Texto requerido sin etiqueta, con marcador de posición y con icono

<criteria placeholder="SCREEN_TEXT_USER" component="text" icon="user" id="user" validation="required" 
style="col-xs-6 col-sm-4 col-md-2"/>
Usuario

Seleccionar múltiple con dos valores preseleccionados

<criteria component="select-multiple" id="user" label="PARAMETER_USER" icon="user" initial-load="query" 
target-action="..." style="col-xs-12 col-sm-6 col-lg-3" value="1, 2" validation="required"/>
Seleccionar múltiples preseleccionados

Ejemplo de criterio de color

<criteria label="PARAMETER_COLOR" id="Col" variable="Col" component="color" 
style="col-xs-6 col-sm-3 col-lg-2" value="#d5db89" />

Color2

Ejemplo de criterio de carga

<criteria label="PARAMETER_UPLOADER" id="Upl" component="uploader" validation="required" 
style="col-xs-12 col-sm-6 col-lg-4" destination="testModule">
Criterio del cargador2