Sección Consulta

La sección "Consulta" está basado en el tipo de sección 'Tabla'. Su funcionalidad y opciones son prácticamente idénticas, salvo que la definición de la consulta a la base de datos se puede realizar de dos formas distintas:
• Conversión de sección Tabla a Consulta.
• Como origen una consulta predefinida en el modelo de datos

Consulta convertida desde Tabla

Si hemos realizado una conversión de una sección Tabla a una de tipo Consulta, descubriremos al entrar en esta pestaña, que nos aparece la consulta ya realizada.

1521
Podrás encontrar lo siguiente:
Valor Desde aquí podemos introducir valores a los campos para probar la consulta.
Estos valores se utilizan exclusivamente para visualizar datos en la vista previa, no se utilizan para la funcionalidad de la sección. Si no se introduce un valor, no se podrá guardar la consulta.
Estos botones nos permiten insertar o eliminar pares de valores.

Servidor de datos Selección del servidor de datos, de los disponibles en el proyecto, donde realizaremos la consulta.
Consulta Introducción de la consulta SQL.
Para comprobar la validez de la consulta, podemos utilizar los valores de pruebas que mostrará el resultado en la 'Vista Previa'; una vez validada se deben substituir esos valores por los datos correctos que introduzcan valores (funciones internas, variables globales,...).
Consulta total Esta se utiliza para saber el número total de registros para poder ser usada en la paginación. Es un campo obligatorio para poder realizar la consulta.
Vista previa Aquí se muestra una vista de la query formulada, el total de registros de la consulta total y un registro de ejemplo con los campos que se consultan.
  • Campos a mostrar
    En esta ficha seleccionamos los campos de la tabla seleccionada como origen de datos y las tablas relacionadas con esta que se quieren mostrar en esta sección. Si la consulta ha sido convertida desde una sección Tabla, aparecerán los campos ya cumplimentados, si por el contrario el origen es una consulta predeterminada, no habrá ningún campo seleccionado, con lo que la sección no mostrará contenido alguno, tal y como sucede con la sección 'Tabla'.
    Existen muy pocas diferencias entre esta ficha y la perteneciente a la sección 'Tabla', encontrándose las principales diferencias en el apartado Campo, como se aprecia en la siguiente imagen.
1245
Podrás encontrar lo siguiente:
Alias Mostrará el nombre del campo seleccionado en la tabla.
Tabla Selecciona una tabla cuyo atributo coincida con el tipo de datos que se desea consultar.
Nos permite acceder directamente al editor de la tabla seleccionada.
Permite seleccionar una tabla.
Atributo Muestra una lista de los campos disponibles de la tabla seleccionada. Se deberá seleccionar un campo que coincida en el tipo con el campo que se desea mostrar.
Posición Muestra el orden en que se mostraran los campos a la hora de mostrar el registro.
Columna En caso de que se elija 'Formato Libre', se mostrará para cada campo además de la posibilidad de definir la posición (fila) en que se mostrará la posibilidad de decir la columna en donde se mostrara ese valor. Tanto el número de posiciones como el de columnas estará acotado por el número de campos que se quieran mostrar, en otras palabras, son posiciones relativas a los campos del registro no a los registros en sí, no tiene nada que ver con el número de columnas en que se distribuyan los registros, es la distribución interna de los campos.
Etiqueta En este Campo se han de colocar la etiqueta que se desea que aparezca asociada al campo al momento de mostrar la tabla. Es posible utilizar Funciones de Kanecode, Variables Globales, Literales.
Estilos de etiqueta Muestra el orden en que se mostraran los campos a la hora de mostrar el registro.

Estilos de la etiqueta Permite seleccionar un estilo para aplicar a la etiqueta de manualmente (color, fuente, etc.), colocando código de hojas de estilo, usando una clase o indicando uno de los estilos predefinidos en Kanecode.

Ubicación etiqueta
·Etiqueta sobre valor: En este caso la etiqueta se muestra sobre el valor.

·Etiqueta al lado izquierdo del valor: Se debe seleccionar esta opción si se quiere que la etiqueta se muestre al lado izquierdo del valor.
Mostrar valor Aquí se indica si se quiere hacer algo con el valor del campo antes de mostrarlo

Editor de Expresiones: Abre un editor donde se puede configurar una expresión o una llamada a una función JavaScript que modifique el valor que se mostrará para ese campo.

Estilos de valor: Permite seleccionar o definir un estilo para aplicárselo al valor que se muestre.

Editor eBDML: Abre un editor donde se puede definir un código eBDML para calcular el valor que se mostrará en cada campo. De esta forma se puede formatear los valores de los campos con eBDML sin necesidad de convertir toda la sección a 'plantilla eBDML'.

Ignorar si es nulo: No se muestra en caso de que sea nulo el valor.

Es titular: Si se marca, al momento de listar se evita repetir el mismo valor del campo en cada registro, es decir, se mostrará el valor de este campo resaltado cada vez que cambie y se muestran solo el resto de campos.

ALT (Campos Imágenes): Aparece solo si el campo a mostrar es del tipo imagen, sirve para especificar un texto para la propiedad HTML ALT, de texto alternativo a la imagen.

Visibilidad
Permite definir la visibilidad del campo, para que solo se muestra a ciertos usuarios o en función del resultado de una expresión.

Campos clave Si alguno de los campos elegidos para mostrar es de tipo archivo o imagen, nos aparecerá debajo de los campos a mostrar una ficha de Campos Clave en la que se nos solicitará que designemos el campo clave de la tabla para poder calcular la ubicación del archivo. En caso de que la tabla no tenga un campo _idRegistro, deberemos identificar cuál de los tipos de campos seleccionados es utilizado como campo clave.