Explora Libros electrónicos
Categorías
Explora Audiolibros
Categorías
Explora Revistas
Categorías
Explora Documentos
Categorías
manual de usuario
C/Sardenya 56 Pso. Castellana 164 255 Le jeune Rd., Sutie 517 WTC, Montecito 38, 12º of. 12 Av. Calle 19 No 12-76, piso 4
Barcelona 08005 Madrid 28046 Coral Gables, FL 33134 Col. Napoles 03800 Bogotá
Spain Spain USA México DF Colombia
T. +34 93 225 10 70 T. +34 91 788 57 47 T. +1 305 448 21 48 T. +52 551 107 0753 T. +57 1 2430990
Índice
1. Introducción
2. Administración General
3. Modelo de datos
3.1. Tablas 24
3.1.1. Planificación y creación de tablas 24
3.1.2. Vinculación de tablas 26
3.1.3. Edición de los datos 27
3.1.4. Campos calculados 28
3.1.5. Eventos 29
3.1.6. Indices 29
3.2. Relaciones 30
3.3. Vistas 31
3.3.1. Opciones del editor HTML 33
4. Tipo de Sección
5. Servicios de Comunicación
6. Elementos Avanzados
7. Recursos
Índice
8. Herramientas
Anexos.
1. Introducción
eBD es un entorno integrado de desarrollo y publicación de aplicaciones web, que permite crear
aplicaciones basadas en estándares sin necesidad de profundizar en el conocimiento de la tecnología web.
Con eBD se puede desarrollar cualquier tipo de aplicación web, ya sea intranet, extranet, portal, etc. o bien
integrar cualquier otro desarrollo o aplicación ya implantada, permitiendo el acceso y la gestión de la
información de forma centralizada en un único entorno web.
Gracias a una potente interfaz de administración, eBD convierte la programación clásica basada en la
edición de ficheros de texto en una tarea totalmente visual, y la organización lógica de todos los elementos
permiten estructurar el desarrollo de cualquier aplicación mejorando la productividad y reduciendo costes.
eBD ofrece una arquitectura abierta y basada en estándares, que garantiza la total escalabilidad del
sistema, permitiendo ampliar la infraestructura conforme vayan aumentando las necesidades de los
usuarios. Gracias a esta arquitectura, eBD permite reducir el riesgo del sistema garantizando el servicio con
sistemas de redundancia tolerantes a fallos, y acelerando el rendimiento de las aplicaciones con sistemas
de balanceo de carga, clustering, etc...
Para desarrollar un proyecto con eBD no es necesario instalar ningún software adicional, únicamente hace
falta un navegador web. El entorno de desarrollo de eBD es compatible con Internet Explorer, Netscape,
Firefox y en general con cualquier navegador basado en las últimas versiones de Mozilla.
Simplicidad
Una de las principales características de eBD es su facilidad de uso. Para desarrollar aplicaciones web con
eBD no es necesario tener conocimientos avanzados sobre las tecnologías de desarrollo web.
Tanto las personas con experiencia como las que no han trabajado nunca con aplicaciones web son
capaces de desarrollar proyectos en muy poco tiempo, obteniendo resultados de forma inmediata.
Potencia y Flexibilidad
Con eBD se consigue una alta productividad en el desarrollo de las aplicaciones web, ya que el tiempo
dedicado a la programación de la mayoría de los elementos se reduce considerablemente gracias a la
utilización de los objetos predefinidos de eBD.
La posibilidad de desarrollar múltiples proyectos en eBD, y delegar la gestión de las diferentes partes de un
proyecto a diferentes personas permite planificar mejor las fases del desarrollo, tanto para el grueso del
proyecto como para las posteriores modificaciones o ampliaciones que se necesiten realizar.
La simplicidad y potencia de todas las herramientas que ofrece eBD se complementa con una gran
flexibilidad para el desarrollador, el cual puede programar sus propios componentes y librerías que
proporcionen la funcionalidad requerida en cada momento.
Conectividad e Integración
eBD puede trabajar con las mayores bases de datos relacionales del mercado (Oracle, SQLServer, MySQL,
PostgreSQL, Progress, ...). Desde el entorno de administración se pueden gestionar las tablas almacenadas
en cualquier base de datos, creando tablas nuevas o bien vinculando tablas o vistas ya existentes. También
se pueden utilizar procedimientos almacenados en la base de datos para el acceso a información
compartida.
Una vez definido el modelo de datos, el usuario desarrollador no necesita conocer con que sistema de base
de datos está trabajando, ya que eBD se encargará de generar las consultas a la base de datos con la
sintaxis correspondiente para cada tipo de servidor.
La gran capacidad de integración de eBD con aplicaciones externas permite desarrollar proyectos que
integren la información almacenada en otros sistemas de una forma muy sencilla. Se pueden integrar
contenidos externos usando los protocolos estándar de comunicación web (http, https), webservices (soap)
o conexiones a objetos remotos usando las apis de java (rmi, jms, etc...)
eBD también permite la conexión a sistemas externos de validación de usuarios, para garantizar la
unificación de las cuentas de usuario en un único sistema centralizado, ya sea un Active Directory de
Microsoft, otro sistema de directorio accesible mediante LDAP, un dominio Samba, un sistema basado en
PAM o simplemente una tabla de otra base de datos.
Gracias a la posibilidad de extender las funcionalidades de eBD, es posible integrar el sistema de login de
eBD con cualquier sistema de Single Sign On, facilitando la integración de las sesiones de usuario entre
varias aplicaciones web y todas las demás aplicaciones de un sistema heterogéneo. eBD incorpora a su vez
un sistema preconfigurado de Single Sign On, que permite compartir sesiones entre diferentes proyectos
realizados con eBD sin tener que programar ningun código adicional.
Multiplataforma y multicanal
eBD funciona sobre cualquier plataforma Windows, Unix o Linux, permitiendo así la instalación en la
mayoría de sistemas y plataformas del mercado.
Gracias al soporte multicanal de eBD, los desarrolladores pueden personalizar fácilmente la presentación de
la información en función del dispositivo que esté utilizando el usuario, sin necesidad de duplicar los
contenidos.
De esta forma se pueden adaptar las páginas generadas para que se puedan visualizar correctamente con
PDA’s, Teléfonos Móviles, Kioscos de información, Televisores, etc....
La arquitectura de eBD permite un alto grado de escalabilidad, pudiendo implantarse desde sistemas
simples con un único servidor, a sistemas más complejos con varios servidores dedicados a diferentes
tareas cada uno, o clusters avanzados de servidores.
La estructura de servicios y procesos de eBD permite diseñar el sistema adaptándose a las necesidades del
desarrollo, pudiendo crecer en número de servidores en cualquiera de los diferentes puntos en los que se
puede dividir el sistema (servidores web, servidores de aplicaciones, servidores de bases de datos, etc.)
Gracias a esta división de servicios, eBD puede implantarse utilizando múltiples capas con cualquier
sistema de balanceo de carga (ya sea software o hardware), para garantizar la escalabilidad y la tolerancia
a fallos.
Proyectos
Dentro de eBD se pueden desarrollar múltiples proyectos. Cada uno de estos proyectos estará formado
básicamente por una definición del modelo de datos con el que se trabaja (tablas, relaciones, etc...) y un
conjunto de elementos que permiten el acceso o la gestión de esos datos de forma visual (zonas, páginas,
secciones...)
Los diferentes elementos que forman un proyecto son privados, de forma que no se puede acceder a ellos
desde otros proyectos.
De todos los proyectos desarrollados en eBD se debe seleccionar uno que sea el proyecto por defecto. Este
proyecto será el que aparecerá por defecto al entrar en el sistema. Para poder entrar en el resto de
proyectos se pueden definir varios dominios, y a qué proyecto se dirige cada uno de ellos.
Por ejemplo, si tenemos 2 proyectos llamados "intranet" y "portal", podemos definir que en el dominio
"www.miempresa.com" se muestre directamente el proyecto "portal" y que en "intranet.miempresa.com" se
muestre el proyecto "intranet".
Visibilidad
En eBD se define el acceso a las páginas o a las funcionalidades mediante los grupos de usuario. Todos los
proyectos pueden tener varios grupos de usuarios, y cada usuario del sistema puede pertenecer a uno o
varios de estos grupos. En función de esos grupos el usuario tendrá o no acceso a las diferentes páginas o
funcionalidades del proyecto.
El desarrollador del proyecto es el encargado de asignar a qué grupos de usuarios pertenece cada usuario
del proyecto, y que funcionalidades están accesibles para cada uno de estos grupos.
Jerarquía de Usuarios
Administrador General
Existe un único administrador general que se encarga de la configuración del sistema. No puede desarrollar
proyectos, únicamente puede configurarlos, definir las conexiones a las bases de datos de cada uno y
gestionar los usuarios que pueden acceder a cada proyecto.
Administradores de Proyectos
Son los usuarios con capacidad para desarrollar proyectos. Pueden acceder al entorno de administración de
eBD y crear todos los elementos necesarios del proyecto (tablas, paginas, grupos, usuarios, etc...)
Usuarios Comunes
Son aquellos usuarios que tienen un login en el sistema (username/contraseña), y que pueden entrar en las
zonas privadas de la aplicación, pero no pueden desarrollar proyectos. Dependiendo de las características
del proyecto, pueden ser los encargados de editar los contenidos, los usuarios que se han registrado en un
portal, los clientes de una extranet o bien todos los usuarios de una intranet, por ejemplo.
En función de los grupos de usuarios a los que pertenezcan, y de las funcionalidades que se hayan
asignado a esos grupos tendrán más o menos privilegios sobre el sistema, pero nunca van a poder entrar
en el entorno de administración para desarrollar.
Usuario anónimo
Se trata de un único usuario especial que accede al contenido público de la aplicación, en el que eBD
autentifica automáticamente a todos los usuarios que se conectan al servidor antes de que hayan
introducido su login. Este usuario se usa para definir cuál es el contenido público de la aplicación, ya que
absolutamente todas las conexiones nuevas que se reciban se identifican con el usuario anónimo. Es decir,
aquellos contenidos o funcionalidades que se publiquen para los grupos de usuarios a los que pertenece el
usuario anónimo serán los contenidos o funcionalidades públicos.
En prácticamente todas las aplicaciones web se puede identificar una parte de la pantalla que es fija, y otra
parte que cambia en función de la página a la que se accede. Por ejemplo, las cabeceras o los menús
laterales suelen mantenerse igual durante toda la navegación a pesar de que la parte interna de la página
cambie completamente.
Es también bastante común que dentro de un mismo proyecto (normalmente los portales), se definan
distintos menús y cabeceras para diferentes partes de la aplicación. Suelen ser agrupaciones temáticas o en
función del tipo de contenido que presentan. Por ejemplo, un portal puede tener una parte de Noticias, otra
de Deportes y una tercera de Juegos.
Todas estas partes normalmente tendrán un menú diferente y una cabecera o estilos diferentes, pero
mientras el usuario está navegando por la parte de "Deportes" la estructura de la cabecera o los menús no
variarán.
En eBD, estas particiones del proyecto se denominan Zonas. Las zonas normalmente se encargan de
mostrar la cabecera y el menú o los elementos que aparecen en las columnas laterales. El resto de
elementos que se muestran en el navegador forman la Página.
Las Páginas de eBD se dividen en Secciones. Las secciones pueden ser de diversos tipos, cada uno de los
cuales está diseñado para proporcionar una funcionalidad específica. Por ejemplo, hay secciones que
permiten mostrar información de la base de datos, otras sirven para crear gráficas, formularios, etc...
Las Zonas únicamente se definen seleccionando que parte del menú se debe mostrar y la página que se
mostrará inicialmente (al entrar en la zona). El resto de páginas que se mostrarán dentro de la zona
dependerá de los enlaces del menú o de las propias páginas que se están viendo en cada momento.
Opcionalmente también se puede modificar la cabecera de la zona para que el usuario pueda reconocer
donde se encuentra.
Se puede entender la zona como el contexto en el que se muestran las páginas. Durante la navegación, un
usuario siempre estará visualizando una página dentro de una zona concreta. Por eso es necesario marcar
una de las zonas del proyecto como “inicial”. Esta zona será la que se verá al entrar en la aplicación, de
forma que la “home” del proyecto será la página principal de la zona inicial.
La estructura de una zona por defecto es siempre en forma de L invertida (Fig. 1), pero se puede modificar
para darle el aspecto que se quiera. Las zonas se pueden diseñar con secciones (igual que las secciones
de las páginas), con lo que se puede construir la estructura de la zona colocando las diferentes secciones
en el lugar necesario. Simplemente hay que tener en cuenta que se debe dejar una celda de la estructura de
la zona libre, que será el lugar donde se mostrará la página.
La interfaz con la que trabaja un desarrollador en eBD está optimizada para aprovechar al máximo el
espacio disponible, manteniendo siempre un alto grado de usabilidad. Todas las pantallas se han analizado
para conseguir un look&feel común, con el que los usuarios se sienten cómodos desde el primer momento
en el que empiezan a trabajar con eBD.
Cabecera
En ella se encuentra la información general relativa al usuario y el proyecto actuales, información de
situación (objetos que está editando el usuario) y las opciones de edición del objeto actual.
Panel de Menús
El panel situado en la izquierda de la pantalla contiene los menús que dan acceso a todos los objetos del
desarrollo, un explorador de objetos y un buscador de objetos dentro del proyecto actual.
Zona de trabajo
El centro de la pantalla lo ocupa la zona con la que se trabaja con los diferentes objetos del desarrollo. Aquí
aparecerán los listados de elementos, y los formularios que permitirán modificar las propiedades de cada
uno.
Panel de Secciones
El panel situado a la derecha de la pantalla aparece únicamente en ciertas ocasiones, y muestra el listado
de secciones que contiene el objeto que se está editando en ese momento.
Navegación
La navegación por el entorno de administración de eBD es muy intuitiva. Usando tanto el menú principal
como el explorador de objetos (panel lateral izquierdo) se puede acceder a la información o a los diferentes
objetos del proyecto.
En la barra de botones superior de la zona central de la pantalla aparecerán las diferentes acciones que se
pueden realizar en cada momento; por ejemplo “Crear página”, “Crear carpeta”, “Cortar”, “Copiar”, “Pegar”,
etc…
Para seleccionar los objetos que aparecen en el listado, simplemente se debe hacer clic sobre ellos y se
marcarán cambiando de color. Para seleccionar más de un objeto, se debe hacer clic manteniendo la tecla
Cabecera
En la parte superior de la cabecera se puede ver el Usuario que está autenticado y el proyecto que se está
editando. Haciendo clic en ellos se puede ir directamente a la pantalla de edición de cada uno.
En la cabecera también se encuentra una barra de situación que indica en cada momento el objeto que se
está mostrando en la zona de trabajo, y las diferentes opciones de edición que tiene disponibles.
Para los objetos principales también existe la posibilidad de editar notas o comentarios sobre el desarrollo
de ese objeto en particular, para facilitar la comunicación entre desarrolladores y la documentación de la
propia aplicación.
Carpetas
En la Zona de trabajo que se muestra en la parte central del entorno de administración se muestran los
diferentes objetos que forman la aplicación, y los formularios para editar sus propiedades.
Cuando en esta zona se muestra un listado de elementos, generalmente eBD permitirá estructurarlos en
carpetas. Estas carpetas no afectan al sistema de ficheros del servidor, únicamente son elementos que
ayudan a organizar el desarrollo.
Al navegar por una estructura de carpetas, el enlace situado sobre el nombre de la carpeta llevará a la
pantalla de edición de la misma, y el enlace situado sobre el icono permitirá desplegar la carpeta mostrando
los elementos que hay en su interior.
Cada una de estas carpetas puede contener a otras, esto hace que sea conveniente establecer previamente
un método propio para organizar el sistema de almacenamiento. Es necesario ser coherente con este
sistema en todas las ocasiones ya que una buena organización permitirá localizar fácilmente los objetos.
Una carpeta se crea, elimina y edita del mismo modo que cualquier otro elemento. Ha de tenerse en cuenta
que al borrar una carpeta no se elimina su contenido, sino que éste se traslada a la carpeta raíz.
2. Administración General
El administrador general de eBD es el único usuario que puede configurar los servidores de datos que se
van a utilizar en los proyectos. Cada servidor de datos define una conexión a una base de datos (ya sea
local o en un servidor remoto) en la que se van a poder crear tablas, o bien desde la que se podrán vincular
tablas ya existentes.
Se pueden crear tantos servidores de datos como sea necesario. Una vez definidos, se podrán asignar a los
proyectos, para que los administradores de proyectos puedan construir el modelo de datos.
Es recomendable que los diferentes proyectos del sistema usen diferentes servidores de datos, pero
también puede darse el caso que interese compartir alguna tabla de datos entre proyectos diferentes, de
forma que se deberá usar el mismo servidor de datos desde ambos proyectos.
Al crear un nuevo servidor de datos aparece un formulario con los siguientes campos:
2.2.1. Proyectos
Dentro de un sistema eBD se pueden definir tantos proyectos como sea necesario. Estos proyectos serán
independientes unos de otros, es decir, no se pueden usar elementos de un proyecto desde otro (tablas,
páginas, secciones, etc…).
Como se ha mencionado anteriormente, se debe seleccionar uno de los proyectos como “proyecto por
defecto”. Este proyecto será la aplicación que el usuario visualizará al acceder con su navegador al servidor.
Para poder acceder al resto de proyectos, se pueden configurar diferentes dominios de forma que cuando el
usuario acceda a uno de ellos, eBD mostrará el proyecto indicado (véase “Dominios”).
Para modificar los datos de un proyecto, simplemente se debe hacer click sobre el nombre del proyecto y se
mostrará la pantalla principal de edición del proyecto y un menú superior con las siguientes opciones:
Cuando se crea un proyecto es necesario asignarle uno o varios servidores de datos, para que los
administradores que desarrollen la aplicación puedan crear el modelo de datos en esos servidores.
Cuando se asignan varios servidores de datos a un proyecto, también se debe seleccionar cual de ellos es
el servidor de datos por defecto. Éste será el servidor que aparecerá seleccionado por defecto cuando un
desarrollador quiera crear una nueva tabla.
En la pantalla de asignación de servidores de datos, también aparece una opción especial con el texto
“Puede vincular tablas internas”. Si se marca esta opción, eBD permitirá que los desarrolladores del
proyecto vinculen algunas tablas internas del catálogo de eBD para utilizarlas como tablas de datos.
URL's Amigables
Todas las urls generadas por eBD se encriptan por motivos de seguridad, de modo que un usuario no puede
modificar los parámetros ni la página que está visitando simplemente editando la barra de direcciones de su
navegador.
Sin embargo, en la pantalla principal de edición de un proyecto se puede observar una opción llamada “Usar
URLs amigables”, que permite generar urls “comprensibles” a simple vista. Si ésta opción se activa, eBD
generará las urls del proyecto usando los nombres de carpetas, zonas y paginas para que el usuario pueda
ver donde se encuentra, dentro del árbol de navegación de la Web.
El hecho de usar urls amigables no perjudica la seguridad de la aplicación, ya que el texto “comprensible”
que aparece en la url no es significativo. Los parámetros reales de la pagina continúan siendo encriptados, y
viajando de forma segura.
Es recomendable activar las urls amigables para mejorar el nivel de indexación de la Web en los
buscadores públicos, ya que los robots de búsqueda distinguirán mejor las diferentes páginas generadas.
Single Sign On
eBD incorpora un sistema de Single Sign On que permite compartir la sesión de usuario entre varias
aplicaciones (ya sea desarrolladas con eBD o no), de forma que el usuario no necesite introducir su login y
contraseña en cada una de las aplicaciones.
Para configurar un SSO lo primero que se debe decidir es cual de los diferentes sistemas que participan
será el que gestione las sesiones de forma centralizada. El resto de aplicaciones deberan utilizar algun
mecanismo de comunicación que les permita validar la sesión y obtener la información del usuario.
eBD puede actuar tanto de gestor de sesiones centralizado como de “cliente” del Single Sign On. Como
gestor de sesiones, eBD ofrece varios webservices que permiten abrir una sesión nueva, hacer login/logout,
validar una sesión y obtener la información de usuario de una sesión válida. La definición de estos servicios
se encuentra en http://......./wsdl/login.wsdl y http://......./wsdl/sso.wsdl
La pantalla “Single Sign On” que aparece al editar un Proyecto permite configurar eBD como cliente de SSO
cuando un usuario acceda a ese proyecto en concreto. La opciones de configuración son:
eBD Single Sign On: Activa el single sign on, usando como gestor de sesiones otra aplicación
desarrollada con eBD. Para configurar este SSO, simplemente se debe indicar:
URL principal: url de la aplicación que gestiona las sesiones
2.2.2. Usuarios
Como se ha visto anteriormente en eBD hay 4 tipos de usuarios, pero todos ellos se gestionan desde la
administración general. En el listado de usuarios se pueden identificar los diferentes tipos por el icono que
se utiliza en cada uno:
Para editar las opciones de un usuario se debe hacer click sobre el nombre y aparecerá la pantalla principal
de edición de un usuario. En ella se puede modificar todos los datos personales del usuario, y si es un
administrador, también hay algunas opciones especiales para el entorno de administración:
Para cambiar la contraseña de un usuario, se debe usar el botón situado en la barra superior, pintado con
una llave. Se mostrará un formulario donde el administrador puede cambiar la contraseña de ese usuario,
pero no se podrá ver la contraseña que tiene actualmente.
La pantalla de Seguridad de un usuario permite seleccionar un conjunto de opciones para limitar el acceso
de ese usuario al sistema:
Validación de Con esta opción se puede forzar que la contraseña de este usuario se valide
password contra un sistema de usuarios remotos previamente configurado (véase
“Usuarios Remotos”). Esto permite mantener las contraseñas centralizadas en
un sistema remoto, pero utilizando los usuarios internos de eBD.
En la edición de un Usuario se muestra la pantalla “Proyectos”, donde se puede asignar los proyectos a los
que tiene acceso el usuario. Si se trata de un administrador de proyectos se podrá seleccionar además el
nivel de acceso que tiene dentro del proyecto.
Este control de acceso también se puede gestionar desde la edición del proyecto. Es decir, se puede
asignar los usuarios que tienen acceso a ese proyecto, indicando para cada uno el nivel de acceso del que
dispone.
eBD permite validar los usuarios que intenten acceder a las aplicaciones contra sistemas de validación
externos, para poder utilizar las cuentas de usuario de un sistema centralizado en lugar de duplicar esas
cuentas en los proyectos de eBD.
Un Origen de Usuarios Remotos define una conexión a alguno de estos sistemas, que pueden ser una tabla
de una base de datos, un directorio LDAP (Microsoft Active Directory, por ejemplo), o un sistema de
módulos PAM, entre otros.
Cuando se definen varios orígenes de usuarios remotos se debe especificar un orden de preferencia, de
forma que eBD validará el username y la contraseña introducidas por el usuario contra los diferentes
orígenes siguiendo el orden indicado.
Para cada origen de usuarios que se defina se debe indicar el proyecto con el que está ligado. Es decir, se
puede indicar que cuando un usuario se autentique con ese origen de usuarios, automáticamente se le
redirija al proyecto seleccionado.
Al editar las propiedades de un origen de usuarios remotos se mostrarán los datos necesarios para
configurar el acceso. Estos datos dependerán del driver que se esté utilizando (eBD, LDAP, PAM, etc…).
Por ejemplo, para configurar un origen de usuarios de tipo LDAP, se deberá introducir los datos de conexión
(host, usuario y password), el base DN a partir del cual se debe buscar los usuarios, el campo que actuará
de username, el campo para el password, etc…
Los Usuarios Remotos también son útiles cuando se desarrollan aplicaciones en las que el público en
general se tiene que poder registrar y obtener una cuenta de acceso. Para hacer esto, es conveniente
definir una tabla de usuarios propia, y validar los usuarios con un origen de usuarios remotos sobre esa
tabla. Así se consigue separar los usuarios del sistema de los usuarios registrados por web, y se facilita la
gestión.
eBD permite integrar la gestión de los usuarios remotos con la gestión de usuarios internos, de forma que
cuando el administrador del proyecto acceda a las pantallas de edición de Grupos y Usuarios, podrá editar
tanto los elementos propios de eBD como los Usuarios y Grupos almacenados en ese momento en el
sistema LDAP.
Gracias a esta opción, también se pueden usar los grupos remotos en las expresiones de Visibilidad de los
menús, paginas, secciones, etc.., de forma se puede trabajar con los grupos de usuarios reales, sin
necesidad de duplicar la información.
Cuando se activa la opción de “Integrar la gestión de Usuarios”, se debe especificar también el tipo de
servidor LDAP que se esta usando (Active Directory, Oracle ...), ya que el comportamiento de cada uno de
ellos es ligeramente diferente.
2.4. Dominios
Cuando se desarrollan varios proyectos en eBD es necesario definir la manera de acceder a cada uno de
ellos. Por ejemplo, si se han creado 3 proyectos uno de ellos será el proyecto por defecto (el que se
mostrará al entrar al servidor), pero los otros dos no serán visibles hasta que no se configure una manera de
acceder directamente a ellos.
Los Dominios permiten realizar esto de una forma muy sencilla y flexible a la vez. Únicamente se debe crear
el dominio indicando el nombre que debe usar (“intranet.midominio.com”, por ejemplo) y seleccionar el
proyecto que se deberá mostrar cuando algún usuario entre en ese dominio.
Al configurar un dominio se debe seleccionar también cual será la zona que se mostrará inicialmente (no
tiene porqué coincidir con la zona inicial del proyecto), y el usuario que debe actuar como Usuario Anónimo
(puede ser un usuario diferente del anónimo por defecto).
Gracias a estas opciones, se pueden usar los dominios para publicar los diferentes proyectos, cada uno en
un dominio, o para publicar diferentes zonas de un mismo proyecto en varios dominios.
Opcionalmente se puede introducir un código eBDML de inicialización del dominio, que se ejecutará la
primera vez que un usuario entre en este dominio. Éste código se suele utilizar para realizar las
inicializaciones de las variables globales, o algún otro tipo de acción que solo se debe ejecutar una vez por
sesión.
eBD permite personalizar el aspecto de la aplicación en función de la plataforma que está utilizando el
usuario para acceder. La plataforma puede depender del sistema operativo del usuario (Windows, Linux,
Mac OS, Windows CE, Palm …) o la versión del navegador web (Internet Explorer, Netscape, Mozilla,
Firefox,…).
Los administradores de proyectos pueden realizar varios diseños para la misma página, y cuando un
usuario acceda a ella el sistema aplicará el diseño correspondiente a la plataforma con la que está
navegando.
Las posibles plataformas que se van a detectar las puede configurar el administrador general, definiendo los
Perfiles de plataforma. Se pueden crear tantos perfiles como sea necesario. La detección del perfil se basa
en la cadena UserAgent que envía el navegador web cuando accede al servidor. Al editar un perfil, se debe
indicar el substring que se debe buscar en el useragent del usuario.
Ancho ventana Tamaño de la ventana para acotar el tamaño de las zonas genéricas
Usar CSS en estilos Activa o desactiva la generación de los estilos de eBD con CSS
Tipos de menú Indica el tipo de menú que se usará en las zonas genéricas
2.6. Localizaciones
Las Localizaciones representan los diferentes entornos de internacionalización con los que los usuarios van
a poder trabajar con las aplicaciones desarrolladas en eBD. Una localización no sólo define el idioma de las
páginas, sino que también indica otros parámetros como el formato de las fechas, etc…
El Administrador general es el único usuario que puede gestionar las localizaciones disponibles, definiendo
para cada una los siguientes campos:
Empezar la semana Indica a los calendarios que la semana debe empezar el domingo
en domingo
Una vez definidas todas las localizaciones disponibles, se debe marcar una de ellas como localización por
defecto. Esta localización será la que se usará inicialmente para todos los proyectos.
De todos modos, también es posible seleccionar la localización por defecto para cada proyecto (en la
pantalla de edición del Proyecto, opción “Localización por defecto”) con lo que cada proyecto puede
mostrarse inicialmente en idioma y con unas opciones diferentes.
Todos los textos que eBD incluye en las páginas (en los paginadores, calendarios, etc…) se mostrarán
automáticamente en el idioma definido por la localización actual. El resto de elementos (datos que se
muestran desde la base de datos, por ejemplo) deben ser controlados por el desarrollador. Es decir, el
administrador del proyecto debe construir las páginas y secciones para que muestren los datos en el idioma
correcto, ya que eBD no se encargará del filtrado de estos datos de forma automática. Para más
información sobre las técnicas de creación de aplicaciones multiidioma consultar el tutorial “Multiidioma”.
3. Modelo de datos
3.1. Tablas
Las Tablas son los elementos fundamentales en los que se almacena la información de una base de datos.
Una Tabla es un conjunto de datos (registros), los cuales comparten la misma estructura. Esta estructura se
divide en varios campos, de forma que todos los registros de una tabla tienen los mismos campos.
Los campos son las unidades básicas de información, y cada campo puede contener datos de diferentes
tipos. Hay campos para guardar textos, otros para guardar números, fechas, etc…. En eBD se han definido
todos los tipos de datos comunes de cualquier base de datos (textos, numéricos, fechas, horas,
booleanos…) y adicionalmente se han definido un conjunto de tipos de datos específicos para la creación de
aplicaciones web (hipervínculo, email, imagen, flash…).
Diseñar una tabla es un trabajo importante. El primer paso será saber que información se precisa, que tipo
de datos contendrá cada campo y para qué fin se utilizará la tabla creada. Para determinar el tipo de datos
de un campo el administrador deberá tener en cuenta el tipo de valores que desea permitir, por ejemplo, no
es posible almacenar texto en un campo cuyo tipo de datos sea numérico.
Desde el entorno de administración de eBD se pueden crear tablas en cualquiera de los servidores de datos
disponibles para el proyecto. Todas las tablas de definen de la misma forma, independientemente del driver
de base de datos que se esté utilizando.
Para crear una tabla, simplemente se debe indicar el nombre y el servidor de datos. Las nuevas tablas se
generan automáticamente en la base de datos sin ningún campo*. Una vez creadas, el administrador debe
definir su estructura creando los campos que forman la tabla uno a uno.
Breve El campo debe aparecer en la versión “breve” del registro (el listado que
aparece en la pantalla de “Editar Datos”)
Protegido Los ficheros almacenados en el campo deben estar protegidos por usuario.
(Solo los podrá descargar el usuario que tenga acceso al registro)
Valor por defecto Valor que debe tener el campo por defecto (sólo es aplicable en algunos tipos
de datos)
*Al crear una tabla se crean 5 campos internos, necesarios para el control de registros de eBD. Estos
campos no se ven en la estructura de la tabla, pero si existen en la base de datos real.
Texto corto Texto que no deberá exceder del número de caracteres que se indiquen en la
opción longitud. No puede contener saltos de línea
Texto largo Texto en el que no se especifica la longitud. Puede contener saltos de línea,
pero no opciones de estilo (negrita, itálica, etc…)
Boleano De tipo SI/NO. Aparece una casilla de verificación que deberá dejarse activada o
desactivada según el valor que se desee
Contraseña Texto corto que se almacena encriptado. No se puede desencriptar, solo es útil
para guardar contraseñas en tablas de usuarios remotos
HTML Texto largo con formato html. Se edita usando el editor HTML de eBD
HTML externo Parte especificada de una URL externa, comprendida entre dos TAGS
(fragmentos de código HTML)
Imagen Archivo de tipo imagen (.gif, .jpg o .png). Al visualizar el valor se mostrará la
imagen
Flash Archivo de tipo flash (.swf). Se puede definir el tamaño para visualizarlo y
parámetros adicionales en el momento de subir el archivo
En una tabla siempre debe haber un campo, o combinación de campos, cuyo valor identifique de forma
única cada registro de la misma tabla. Este campo, o campos, podrán definirse como Clave Principal. Al
marcar un campo como clave automáticamente este será obligatorio, además se creará un índice sobre este
campo. Para definir los campos clave se debe usar el formulario que aparece al pulsar el botón:
Las aplicaciones generadas con eBD también pueden utilizar tablas que ya existan en la base de datos, ya
sea porque se han creado manualmente o porque son tablas que pertenecen a otras aplicaciones. Para
poder usarlas, primero se deben vincular desde eBD, para que el sistema las pueda reconocer.
La vinculación de una tabla permite la lectura de datos en la tabla origen, pero también se puede agregar,
eliminar o editar sus datos a través de la tabla vinculada. También es posible realizar algunas
modificaciones sobre la estructura de una tabla vinculada, sin que estas afecten a la tabla base (cambiar
opciones en los campos como marcar como breve, especificar un valor por defecto). Se pueden también
crear nuevos campos en la tabla vinculada, sin embargo, los nuevos campos se gestionarán desde la nueva
tabla aunque los datos que estos contengan se almacenen en la tabla de origen. De la misma manera, al
borrar un campo en una tabla vinculada, este no se elimina en la tabla origen.
Nota: Al eliminar una tabla vinculada, se elimina el vínculo con la tabla, pero no la tabla original.
Convertir a formato eBD: Modifica la estructura de la tabla añadiendo los campos propios de eBD, de
forma que se pueda usar la tabla como si se hubiera creado con eBD.
Mantener estructura actual: Mantiene la estructura de la tabla (no añade ningún campo). Permite usar la
tabla normalmente, aunque se pierden las funcionalidades que aportan los campos ocultos de eBD.
Concretamente, con una tabla vinculada manteniendo la estructura no se puede:
Conocer la fecha de inserción / modificación de un registro. Filtrar los permisos de una vista en función del
usuario que ha creado el registro. Usar el flag “publicado” que se añade automáticamente en todas las
tablas creadas desde eBD
Al vincular una tabla manteniendo la estructura no se añaden los campos ocultos, con lo que para poder
identificar los registros es obligatorio seleccionar los campos clave de la tabla. Esto se realiza en el
momento de vincularla, pudiendo seleccionar mas de un campo como clave.
Si se desea vincular una tabla que se ha creado con eBD (ya sea desde otro proyecto, o desde otra
instalación de eBD que utilice la misma base de datos), es importante vincularla utilizando la opción de
Convertir a formato eBD. A pesar de que la tabla ya se encuentre en formato eBD es conveniente usar
este modo de vinculación, ya que no se van a duplicar los campos ocultos pero si se podrán usar como si se
hubiera creado desde el mismo proyecto.
Al vincular una tabla, eBD analiza y registra en el sistema su estructura. Esto provoca que si se modifica la
estructura de la tabla original después de haberla vinculado (usando algún cliente de base de datos
independiente, por ejemplo), eBD no se dará cuenta del cambio, con lo que pueden haber problemas de
inconsistencia de datos. Para solucionar este problema se debe actualizar la vinculación con el botón
El formulario de actualizar la vinculación de una tabla ofrece dos listados de campos, uno con los campos
reales y otro con los que se encuentran registrados en el sistema. Usando ese formulario se debe
seleccionar, para cada uno de los campos que no coinciden si se trata de un campo nuevo (se registrará
como un campo recién creado), si se trata de algún campo que ya existía pero que ha cambiado de nombre
(se actualizará el registro de ese campo). Los campos que estaban registrados pero que no tienen
coincidente en la tabla real serán eliminados del registro.
En la pantalla “Editar Datos” aparece el listado de registros almacenados en la tabla. Estos aparecen en su
versión “breve”, es decir, para cada registro se mostrarán únicamente los campos marcados como “breve”
en la estructura de la tabla.
Al añadir un registro aparece un formulario con la totalidad de campos que componen el registro. Para que
el registro se grabe correctamente deben introducirse, como mínimo, los datos que sean obligatorios y con
el tipo de datos que corresponda a cada campo. Al publicar los datos en las páginas (véase “Secciones”)
únicamente se mostrarán al usuario los registros que tengan activada la casilla “publicado”.
En el caso de un tipo de campo HTML en el formulario aparece el botón correspondiente al Editor HTML de
eBD. Si la tabla incluye un campo HTML externo aparece el botón que permite editar las opciones del
campo. Cuando se edite un campo de cualquiera de estos dos tipos, deberán guardarse las opciones
modificadas desde el editor del campo y, además, con el botón Guardar del formulario del registro.
En eBD se puede crear un campo cuyo valor se obtenga a partir de un cálculo que se realizará sobre otro
campo de la misma tabla. A estos campos se les llama “Campos Calculados”.
Hay varios tipos de campos calculados, dependiendo del tipo de datos que se quiera obtener. No todos los
tipos de datos soportan la definición de campo calculado. Para definir un campo calculado se usará el
formulario que aparece al pinchar sobre el botón
audiostram
3.1.5. Eventos
Los Eventos permiten definir un conjunto de acciones sobre un elemento, que se ejecutarán cuando se
cumplan ciertas situaciones. En el caso de las Tablas, se puede definir que un evento se ejecute:
Una vez determinado el nombre del evento y en qué momento se ejecutará, se programaran las acciones
que se deben llevar a cabo. Para más información sobre las acciones consultar el apartado “Eventos
Globales”.
3.1.6. Indices
Para acelerar las búsquedas, la ordenación de los registros o las consultas con referencias cruzadas, el
administrador puede crear índices sobre una tabla. Se pueden crear varios índices sobre una misma tabla, y
cada índice puede estar formado por uno o más de un campo. Para ello el administrador indicará el nombre
del índice, y el campo o campos sobre los que se creará.
Los índices se crean directamente sobre la tabla real, con el fin de que el motor de la base de datos utilice
los índices para optimizar las consultas que se realicen sobre esa tabla.
3.2. Relaciones
Cuando se define el modelo de datos de una aplicación se construyen varias tablas donde almacenar la
información. Estas tablas normalmente contienen datos que se relacionan unos con otros mediante los
campos clave; es decir, hay campos de una tabla que contienen el valor de los campos clave de otra tabla.
Las Relaciones permiten al desarrollador definir como se relacionan las tablas del modelo de datos, para
facilitar la posterior generación de consultas o informes que muestran datos de diferentes tablas de forma
combinada (véase “Secciones”).
Para crear una relación, primero se debe seleccionar que dos tablas participan en esa relación, y luego se
indica las condiciones que deben cumplir los registros de ambas tablas. Para cada relación también se debe
seleccionar el tipo de join (algoritmo de unión) que se debe realizar. Hay dos tipos de join:
INNER JOIN Mostrará todos los registros de la Tabla 1 que tengan algún registro coincidente
en la Tabla 2.
LEFT JOIN Mostrará todos los registros de la Tabla 1, tengan o no registro coincidente en la
Tabla 2
Por ejemplo, se puede utilizar INNER JOIN con las tablas Departamentos y Empleados para seleccionar
todos los empleados de cada departamento. Por el contrario, para seleccionar todos los departamentos
(incluso si alguno de ellos no tiene ningún empleado asignado) o todos los empleados (incluso si alguno no
está asignado a ningún departamento) se emplea LEFT JOIN.
Los registros de la primera tabla estarán relacionados con los de la segunda tabla que cumplan las
condiciones establecida por el Administrador. Si no se indica ninguna condición, la relación será de “todos
con todos”, es decir, cada uno de los registros de la primera tabla estará relacionado con todos los de la
segunda. Al definir una condición, el administrador deberá seleccionar un campo de la segunda tabla que
deberá compararse a un campo de la primera o a un valor.
3.3. Vistas
Las Vistas se usan para editar los datos de una tabla de distintas maneras, en función de los privilegios del
usuario o de las opciones que se hayan definido en la propia vista. En realidad, una vista se puede entender
como una herramienta de gestión del contenido de una tabla, donde se puede definir qué información va a
poder editar el usuario, y qué acciones va a poder llevar a cabo con esos datos.
Una Vista siempre edita el contenido de una Tabla, aunque se pueden usar diferentes técnicas para hacer
que las acciones realizadas en la vista afecten a mas de una tabla. Al crear la vista se debe seleccionar
sobre que tabla va a actuar.
Una vez creada la vista, el primer paso es definir que acciones va a poder realizar el usuario sobre esa
vista. Las posibles acciones o permisos son:
Permitir Insertar El usuario podrá añadir registros nuevos a la tabla. Se puede limitar el número
de registros que puede insertar cada usuario (por defecto, ilimitado)
Al permitir modificar o borrar registros debe especificarse sobre que registros podrán realizarse estas
acciones:
Registros del mismo Registros creados por usuarios que pertenecen al mismo grupo de usuarios
grupo
Una vez establecidos los permisos de los usuarios, desde la pantalla Campos a Mostrar, se pueden añadir
los campos de la tabla base que serán visibles en el formulario de edición de cada registro.
Opciones Editable: Marcar esta casilla para permitir al usuario modificar los datos del
campo
Imprimible: Marcar esta casilla para que los datos del campo aparezcan en la
impresión del registro
Lista desplegable Marcar para usar un desplegable. Deberá definirse la consulta sobre la base de
datos que obtendrá los posibles valores del desplegable. En la consulta, se
indicará la tabla de donde provendrán los datos, el campo para el valor a
almacenar y el campo para el valor a mostrar. También se puede aplicar filtros
para limitar los registros del desplegable
Visibilidad Define la visibilidad del campo, tanto en modo lectura como modo
lectura/escritura. De esta forma que puede configurar la vista para que
diferentes usuarios no puedan ver o editar los mismos campos
En la pantalla “Filtros” se pueden definir las condiciones que deben cumplir los registros para poder ser
editables desde la vista. Es decir, de la misma forma que al seleccionar los campos a mostrar se limitan que
campos se van a poder editar desde la vista, al poner filtros se limitan los registros de la tabla que se van a
poder editar.
En la pantalla “Formulario”, se puede ver la presentación del detalle de un registro que muestra la vista. Los
objetos del formulario pueden moverse arrastrándolos con el ratón, o editarse, haciendo clic encima de un
elemento se abrirá la ventana de propiedades de éste. Además de modificar sus propiedades es posible
asociar eventos al objeto, para ello se determina el código JavaScript que se ejecutará cuando el usuario
realice una acción indicada (hacer click, mover el puntero del ratón, apretar una tecla, etc…).
Además de poder editar los controles del formulario, también se pueden añadir nuevos elementos
(etiquetas, botones, imágenes, etc…). Una vez se ha editado el formulario de una vista desde esta pantalla,
es recomendable hacer todas las modificaciones siguientes desde el propio editor de formularios, (cambios
de etiquetas, tipos de letra, etc..)
Del mismo modo que en la edición de tablas, se pueden crear eventos sobre las vistas. De esta manera se
ejecutarán ciertas acciones según se actúe sobre una tabla desde una vista u otra. Los eventos de las
Vistas se programan de la misma manera que los eventos de las Tablas.
Al editar un campo de tipo HTML desde una vista se pueden especificar diferentes opciones para el editor
de contenido HTML. Estas opciones se muestran desde la pantalla “Campos a mostrar”, usando el botón
situado junto al editor de expresiones del campo en cuestión.
Desde este formulario se pueden especificar el tamaño que tendrá el editor (ancho y alto), si permite editar
el código fuente (HTML), y si permite crear enlaces directos contra páginas de eBD.
También se dispone de la opción “Usar editor HTML incrustado”. Esta opción permite sustituir el botón del
editor que aparece en el formulario (el que abre una ventana nueva con el editor HTML), por un editor de
HTML reducido, incrustado en el propio formulario (no abre ninguna ventana nueva). En este editor solo hay
disponibles algunas opciones básicas de edición, de forma que el usuario que edita el texto HTML podrá
definir textos en negrita, itálica, etc… , pero no podrá cambiar el color del tipo de letra (por ejemplo).
Desde la pantalla de opciones del editor también se puede definir diferentes orígenes de las imágenes, para
que el usuario que edita el contenido pueda usar imágenes almacenadas en otras tablas del modelo de
datos. En estas opciones se pueden seleccionar varias tablas como orígenes de las imágenes, e incluso
montar una estructura de carpetas basadas en otra tabla del modelo de datos para que los usuarios puedan
estructurar sus propias imágenes en carpetas.
4. Tipo de Sección
Cuando hablamos de secciones, estamos hablando de los componentes básicos que se han de utilizar para
construir una página eBD, en otras palabras, cualquier página eBD que podamos ver está definida en base
a secciones.
En las páginas siguientes se mostrarán todos los tipos de sección disponibles actualmente en eBD y los
posibles parámetros a definir para cada tipo. Las categorías son:
• Presentación de la información
• Estructura de la aplicación
• Entrada de datos
• Comunicación
• Secciones avanzadas
Para crear una sección debemos utilizar el panel de secciones, éste aparecerá en la parte derecha de la
pantalla de administración siempre que se esté editando una página o una zona con diseño basado en
secciones. Es posible crear secciones globales pero de ellas se hablará mas adelante.
En ese panel se muestran todas las secciones que se han creado para la página, en la parte superior de
ese panel se muestra una serie de botones que permiten crear, cortar, copiar pegar y eliminar secciones.
Una vez creada la sección se debe definir todas las propiedades que determinarán la apariencia y
comportamiento de ese componente. Para hacerlo basta con hacer clic sobre el nombre de la sección a
editar, en la parte central se mostrarán las propiedades generales de esta sección, y en la parte superior de
esta área central se mostrarán enlaces que permiten acceder a páginas que agrupan otras opciones de
configuración que se aplican a esa sección.
Dependiendo del tipo de sección serán accesibles unas opciones de configuración u otras, sin embargo
habrá algunas que serán comunes independientemente del tipo de sección, por ejemplo en toda sección se
pueden agregar etiquetas que se muestren como enlaces por ello para toda sección es visible una ficha que
permita configurar lo que en eBD se llama Enlaces de Sección. De la misma forma que para toda sección se
puede modificar el nombre, definir bordes, cabecera de la sección, etc., todos estas opciones se agrupan
dentro de una ficha llamada Editar Sección, pasa los mismo con las fichas donde se configuran la visibilidad
y propiedades avanzadas (caché).
Nota: A pesar de que estas fichas aparezcan en la configuración de todas las secciones los valores que se
introduzcan a ella serán independientes para cada sección, cada sección guarda estos valores.
A continuación se mostraran todas las fichas de configuración comunes a todas las secciones (Editar
Sección, Enlaces de Sección, Visibilidad, Avanzado), luego se describirán las fichas de configuración
específicas a cada tipo de sección.
Editar sección
La ficha o pestaña “Editar Sección” permite definir propiedades de apariencia general de una sección, el
aspecto de esta ficha se muestra en la siguiente pantalla:
Si se detalla la figura anterior, en la barra superior se puede ver un botón, éste permitirá guardar los
cambios que se realicen en esta página, antes de cambiar de página incluso dentro de la misma sección
hay que guardar.
En esta pantalla el primer apartado que se puede ver es el de Editar Sección con el campo:
Cabecera
Título El texto a mostrar en la cabecera, puede ser un valor literal, una función de eBD,
o una variable Global
Cuerpo
Fondo transparente No le coloca fondo a la sección y se vera el fondo que se haya definido para la
página
Estirar verticalmente Si se marca esta opción la sección ocupará todo el espacio vertical horizontal
que se le de en el diseño de la página o zona
Estirar Si se marca esta opción la sección ocupará todo el espacio horizontal que se le
horizontalmente de en el diseño de la página o zona
Englobar cabecera Si se engloba la cabecera, el borde superior aparecerá por encima de esta. Si
con los bordes no, se mostrará debajo
Superior
Inferior
Izquierdo
Derecho
Pausa El tiempo que estará visible la información del registro antes de que se pase a
mostrar el siguiente
Ancho de zona Define el ancho del contenido que se mostrará en un momento dado, no es el
visible ancho total del contenido
Alto de zona visible Define la altura del contenido que será visible en cualquier momento, es decir,
de que ancho será el scroll
Ancho Define la anchura total del contenido de la sección lo que irá pasando que ira
mostrándose a través de la ventana de scroll
Incluir tabla HTML Permite activar o desactivar el uso de tablas HTML en la generación del código
de la seccion
Visible desde Ajax Al activar esta opción, eBD permitira que la seccion se ejecute desde llamadas
ajax
Texto adicional Permite agregar código HTML que se mostrará en la parte final de la sección.
Desde aquí es posible abrir el edito HTML
Alineación Permite definir la alineación tanto horizontal como vertical del texto que se
adicione al pie de la sección. Opciones (izquierda, derecha o centro y arriba o
abajo)
Enlaces de sección
Esta es otra página que esta presente en la configuración de cualquier sección eBD, aquí se pueden definir
enlaces que se mostrarán dentro de la sección
Al momento de entrar en esta pestaña por primera vez, antes de crear ningún enlace se verá la figura
siguiente.
Nótese en la barra superior de esta pantalla; se tienen tres botones, los que permiten guardar cambios,
agregar y eliminar un enlace en ese orden (de izquierda a derecha).
Si se agrega un enlace, se mostrará una ventana con el campo etiqueta, en este campo se debe introducir
el valor que se mostrará como el enlace desde la página, y puede ser un texto, una llamada a una función
de eBD o una variable Global de eBD.
Por ejemplo podría colocar como etiqueta la llamada a la función de eBD #[eBDUser.Username] y se
mostraría como enlace el nombre del usuario que hizo el login.
Podríamos decirle %enlace_globlal, suponiendo que fuese una variable a la que le hemos dado valor
anteriormente en la sesión.
Alineación Conjunto de botones que permiten indicar en que parte de la sección se debe
mostrar la etiqueta con el enlace, es posible ubicarlo en la izquierda, centro o
derecha por encima o por debajo del contendido de la sección. Esta opción será
valida si no están marcadas ni la opción en el título ni en la cabecera, entonces
se mostrará el enlace según se especifique en está opción
Posición Si se definen varios enlaces, este campo determina en que orden se han de
mostrar
Estilo Haciendo clic en este botón es posible definir un estilo para el enlace, cambiar la
fuente, colores, tamaños, etc. Hay cuatro maneras de aplicar estilos, para más
información véase el Anexo A.
En el marco Destino es donde se creará el enlace, cada vez que se crea un enlace desde BD hay tres
posibles destinos:
Página Se usa para definir una página de eBD como destino de este enlace, para
indicar cual es la página se debe hacer clic en el botón que está al lado y se
abrirá una ventana con un árbol mostrando toda la estructura de páginas
creadas y carpetas que las contienen, basta con hacer clic en la página deseada
y guardar (haciendo clic) en el botón que aparece en la barra superior
Zona Se utiliza para definir una zona como destino de un enlace, es posible además
de indicar una zona indicar una página a mostrar en esa zona
URL Se utiliza para indicar que el destino del enlace es una URL (no una página eBD
ni una Zona) puede ser una dirección de cualquier Web, o la dirección de algún
recurso (por ejemplo un archivo dinámico), etc
Visibilidad Permite definir la visibilidad del enlace, de forma que solo aparezca para ciertos
usuarios, o según el resultado de una expresión
Visibilidad
En esta ficha de configuración se define que grupo(s) pueden ver esta sección, la ficha se muestra a
continuación:
Grupos Decir que grupos de los creados en el proyecto pueden ver esta sección, si no
se selecciona ningún grupo a la lista de seleccionados cualquier usuario podrá
ver la sección
Avanzado
En esta ficha se configura todo lo relativo a caché de la sección. Hay dos niveles en donde se pueden
cachear las secciones, en el servidor o en el cliente (proxys, navegadores, etc.).
Caché Activada: Si se marca, la sección se guardará en la caché del servidor. Esto quiere
decir que si se carga una página que contenga esta sección, la sección
solo se calculará una vez y si se vuelve a solicitar dentro de un periodo
menor al tiempo de expiración se devolverá el código HTML que se calculó
anteriormente, no se generará de nuevo la sección
Tiempo de Indica el tiempo por el cual será válida la imagen de la sección que esta
expiración guardada en caché
Tiempo de Indica el tiempo por el cual será válida la imagen de la sección que esta
expiración guardada en caché
Vista previa
Acerca de esta ficha no hay mucho que decir, simplemente que permite a la persona que está creando una
sección ver como lucirá ésta en la página resultante que se mostrará al usuario.
Nota: Hay que tener en cuenta que la finalidad es mostrar el resultado a nivel de diseño, por lo que en
secciones cuyo diseño dependan de parámetros (por ejemplo alguna sección eBDML) lo que se verá en la
vista previa puede tener errores, lo mismo que pueden haber funcionalidades o enlaces que no vayan
correctamente.
La funcionalidad de este tipo de secciones es mostrar el contenido de una tabla de base de datos
brindándole al desarrollador una gran cantidad de opciones configurables que permiten filtrar el contenido
que se quiere mostrar, y además definir el aspecto , el diseño de como se ha de ver la información.
Al momento de crear la sección de este tipo será necesario indicar el nombre de la sección y la tabla de
donde sacara la información a mostrar (véase la barra superior en la ventana Añadir Sección, en la imagen
anterior).
Una vez elegida una tabla no puede cambiarse, si quiere utilizarse otra tabla se ha de crear otra sección.
Cuando se ha creado la sección tabla y se la va a editar (haciendo clic sobre esta sección en el panel de
secciones), se debe recordar como navegar entre todas las posibles opciones de configuración para cada
sección. Podremos ver en la cabecera, en primer lugar un guía que informa acerca de que se está editando,
por ejemplo Páginas > Manual eBD 3.0 > tabla, indica que se esta editando la sección tabla de la página
Manual eBD 3.0. También es posible ver enlaces a todas las pestañas de configuración para esa sección.
Algunas de esas fichas de configuración son comunes a todas las secciones y ya se han comentado, a
continuación se explicará aquellas que se propias de esta sección.
Diseño
Opciones de
registros:
Máximo número a Indica cuantos registros como máximo se van a mostrar a la vez. Sino se pone
mostrar un límite se mostrarán todos los registros de la tabla a la vez, por lo tanto la
longitud de la sección, y por ende la longitud de la página, dependerá del
número de registros de la tabla. Si se acotan los registros a mostrar entonces
será necesario definir la paginación (ver Opciones de Paginación) si se desea
permitir a los usuarios poder visualizar el resto de los registros.
Utilizar "n" columnas Este campo permite indicarle a la sección tabla que muestre los registros
usando n columnas, es decir, los registros se distribuirán entre el número de
columnas que se especifique, la manera en que se distribuyan va a depender de
si se le especifica que lo haga de manera horizontal o de manera vertical
cuando definamos la alineación.
Acotar Imágenes a Permite restringir el ancho de la imágenes que se muestran como campo de los
"x" unidades de registros de la tabla. Al limitar el ancho la imagen se redimensiona para
anchura: mantener la proporción Ancho – Alto original.
Mostrar aunque no Indica a eBD que se debe mostrar la sección aunque la tabla asociada no
haya registros: contenga ningún registro
Sección alternativa: Si se marca la opción “Mostrar aunque no haya registros”, es posible especificar
una sección alternativa que se muestre solo cuando no existan registros en la
tabla asociada, en caso contrario se, mostrarán los registros con el diseño que
se defina en la sección tabla que se está editando. Esta sección debe existir en
la lista de secciones de la página, es decir debe estar en el panel de secciones
que se muestra al lado derecho de la ventana
Opciones de
paginación:
Página contenido: Permite paginar el contenido de la tabla que se quiere mostrar, es como si se
segmentara la tabla, en donde cada segmento va a contener "n" registros (el
valor definido en Máximo número a Mostrar). De alguna manera debe
permitirse al usuario navegar entre los segmentos e indicarle que segmento se
esta visualizando, Es posible mostrar estos controles en la parte superior de la
lista de registros, en la parte inferior o en ambas partes.
Tipo: Es posible elegir entre varias opciones para mostrar una paginación:
1. Por defecto
Por defecto para mostrar los iconos de los botones, o el aspecto de los
números, colores, etc., se utiliza una hoja de estilos llamada paginación.css, es
posible subir una nueva hoja de estilo que rescriba las clases que se definen en
paginación.css. y de esta manera es posible cambiar los iconos de los botones y
el estilo de la numeración de los segmentos.
2. Transiciones
3. Codigo EBDML
Eligiendo esta opción podrá utilizarse una plantilla eBDML para generar
dinámicamente el html que muestre los botones, los enlace a los segmentos de
registros, o cualquier otro elemento que quiera agregarse (javascripts,
hipervínculos, etc) y que no pueda hacerse mediante la hoja de estilo o las
propiedades de eBD.
Columnas Se mostrará una primera fila cuyas columnas son los valores de las etiquetas de
los campos a mostrar, y en las filas siguientes se mostrarán los valores de los
registros.
Simétrico Del Lado Izquierdo se mostrarán las etiquetas y del lado derecho se mostrarán
los valores, los campos. Es posible decirle que se alineen los registros vertical u
horizontalmente, sin embargo los campos solo se mostrarán alineados
verticalmente.
Libre Si se elige este formato inicialmente se mostrarán las todos los elementos (tanto
etiquetas como valores) uno debajo de otro, sin embargo será posible realizar
algunos cambios a este comportamiento en la ficha de campos a mostrar, lo que
no es posible si se elige otro formato.
Plantilla EBDML Se mostrarán cada registro aplicándole una plantilla eBDML, en otras palabras
cada vez que se vaya a mostrar un registro se ejecutará un script eBDML que
generará el código HTML con el que se desee mostrar el registro.
Padding de Indica el margen interno de cada celda de la tabla HTML en donde se muestran
Columnas: tanto etiquetas como valores de nuestra tabla de eBD.
Incluir tabla HTML: Permite activar / desactivar la generación de tablas html en el codigo de la
sección.
Ordenar por Si se utiliza el formato “columnas”, se puede activar esta opción para que el
columnas: usuario pueda reordenar los registros que aparecen en la sección simplemente
haciendo click sobre los nombres de las columnas.
Usar AJAX: Si se activa la opción anterior, también se puede forzar a que la ordenación use
ajax, para no recargar toda la pagina, sino simplemente en contenido de la
sección.
Alineación
Dirección de Indica como se orientarán los registros. Se puede indicar que se genera un
registros registro debajo de otro (Vertical) o un registro al lado de Otro (Horizontal).
Nota: Cuando se elige modo diseño columna, se esta indicando que la
alineación de los registros es siempre vertical y se obviara el tipo de alineación
que se indique aquí. Si se define un número de columnas en el diseño, por
ejemplo 2, y se elige alineación horizontal, el primer registro se mostrará en la
primera columna, el segundo en la segunda, el tercero en la primera y así
sucesivamente. En caso de elegir alineación vertical se mostrará la primera
mitad de los registros en la primera columna y la segunda mitad en la segunda
columna.
Dirección de campos Además de la orientación de los registros se puede definir la orientación de los
campos de cada registro, puede indicarse a eBD que los oriente de manera
Horizontal o Vertical.
Nota: Sólo cuando se ha elegido Formato Libre es posible alinear los campos
horizontal o verticalmente. En caso contrario (formato por columna o simétrico
los campo se alinearan verticalmente siempre)
Alineación Horizontal En este campo se ha de indicar la alineación Horizontal del valor dentro de la
celda, los posibles valores son (Independiente, centro, arriba, abajo)
Alineación Vertical Este campo se ha de indicar la alineación vertical del valor dentro de la celda de
la tabla html en donde se muestran los registros, los posibles valores son:
Independiente, centro, arriba, abajo
Nota: Solo aplica para Formatos Columna y Libre.
Colores
Permite definir los colores de los fondos cuando se muestran los registros de una tabla.
Colores de registro Fondo Registro 1: Permite elegir el color de fondo para mostrar los registros
impares.
Fondo Registro 2: Permite elegir el color de fondo para mostrar los registros
pares.
Rollover Registro 1: Permite elegir el color de fondo para cuando el puntero del
ratón pase sobre los registros impares.
Rollover Registro 2: Permite elegir el color de fondo para cuando el puntero del
ratón pase sobre los registros impares.
Colores de campos Fondo de etiquetas: Permite definir el color de fondo de las etiquetas de los
registros.
Espaciado
Separación entre Ancho: En este campo se debe especificar el numero de píxeles que debe
registros haber entre registro y registro.
Si se elige una opción del tipo línea, entonces se puede cambiar el aspecto de
tal línea modificando los campos:
separación entre Ancho: La separación (en píxeles) entre los de un registro campos.
campos
Relaciones
En esta pestaña se activan o desactivan las relaciones de tablas que se hayan configurado en este servidor
eBD y donde intervenga la tabla utilizada en esta sección.
Y además se mostraran las relaciones con un cuadro de check box que permite activar las relaciones que
se quieren activar.
Campos a mostrar
En esta ficha se deben indicar los campos de la tabla seleccionada como origen (al crear la sección) y las
tablas relacionadas con esta, se quieren mostrar en esta sección. Inicialmente no habrá ningún campo
seleccionado (véase la figura siguiente), por lo que en la página o en la vista previa esta sección no
visualizará contenido alguno, la cabecera, los márgenes si que se verán.
Nota:La estructura y el contenido de la tabla no se verán afectados por las modificaciones realizadas en
esta sección, solo se está definiendo una manera de ver mostrar los datos.
De la imagen anterior
Campos a mostrar
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 numero de posiciones
como el de columnas estará acotado por el numero de campos que se quieran
mostrar, en otras palabras, son posiciones relativas a los campos del registro no
a los registros en si, 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 quiere aparezca asociada
al campo al momento de mostrar la tabla. Es posible utilizar Funciones de eBD,
Variables Globales, Literales.
Estilos de etiqueta
Ubicación etiqueta:
Mostar Valor: Aquí se indica si se quiere hacer algo con el valor del campo antes de mostrarlo
Estilos por valor: Con este botón se abre una ventana en la cual se puede
decir que, para un campo especifico de la tabla al mostrar los valores les aplique
un estilo u otro dependiendo del valor de otro campo. En la Figura siguiente se
ve la ventana que nos permite configurar esto.
Primero se indica cual es el campo o los campos que definirán el estilo en base
a su valor, agregamos la condición y el valor, y luego se le indica el estilo a
aplicar utilizando el botón:
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.
Agrupación: En este campo es posible indicarle que agrupe por uno o más
campos, lo que nos permitiría utilizar funciones de agregación (máximo, mínimo,
total, suma, media), y estas funciones se pueden utilizar tanto para los campos a
mostrar como para los campos sobre los que se ordena, es decir, que al final
puede ordenarse por la suma promedio, de varios campos.
Filtros
Permite crear condiciones que restrinjan los registros de una tabla que se han de mostrar, se pueden
agregar tantas condiciones como se necesiten, las condiciones se definen sobre los campos de la tabla.
Nota: Los cambios que se realizan aquí no afectaran el como se vea el contenido de la tabla en otras
secciones, solo afectarán lo que se muestre en esta sección.
Inicialmente si no se tiene ningún filtro creado para esta sección, se podrá observar lo que se muestra en la
figura siguiente:
Agregar un filtro
Eliminar un filtro
Una vez se han agregado algunos campos sobre los que se quiera aplicar un filtro se deberán configurar:
Espaciado
Especificar: Literal (o valor numérico), función de eBD o Variable Global que se utilizará para
comparar con el calor del campo de la función
Campo: Permite comparar el campo sobre el que se aplica el filtro con otro campo de la
misma tabla o de otras tablas que están relacionadas
Estructura de Por defecto todas las condiciones que se agregan aquí son anidadas con el
Condición: operador “and”, es decir, se mostrarán los registros que cumplan con todas las
condiciones
Enlaces de contenido
En esta ficha permite crear y configurar enlaces sobre el contenido de la tabla que se está mostrando, es
decir si creo un enlace sobre un campo, cada vez que se muestre un registro para el valor del campo
señalado se creara un enlace.
Se puede crear enlaces a destinos diferentes sobre campos diferentes, un mismo campo en la misma
sección sólo puede apuntar a un solo sitio (URL, página de eBD, o zona de eBD). Aunque un campo apunte
a un mismo sitio los parámetros que se pasen a ese sitio pueden variar en función del registro, es decir se
puede pasar como parámetro el valor de los campos que contiene un registro.
Antes de agregar algún enlace, se observará una pantalla como se muestra en la figura siguiente.
Una vez que se han agregado campos de la tabla, se debe configurar el enlace propiamente dicho, esto es
básicamente definirle el destino y los parámetros:
Campo Valor del nombre del campo dentro de la tabla sobre el cual se creará el enlace
de contenido
Destino
Zona: Se marca en caso de que el destino de un enlace sea una zona de eBD de las
creadas en ese proyecto de eBD., al momento de elegir la zona destino también
será posible indicarle la pagina a la que se debe ir desde este enlace
Página: Se debe marcar si el destino del enlace es una página creada en eBD, en este
caso, al momento de navegar por este enlace no se cambiará la zona solo la
página
URL: Esta opción se ha de marcar en caso de que el destino sea una página en un
sitio externo o recurso externo a eBD, o bien un enlace a una carpeta virtual de
eBD. Basta con colocar la URL, por ejemplo: www.onu.org o
www.misitio.com/carpeta_virtual
Usar campo: Permite utilizar el contenido de un campo como dirección de destino, esto es útil
si se tiene un campo tipo hipervínculo o tipo fichero , o tipo imagen
Además de indicar el tipo de objeto que será el objetivo del enlace, se puede indicar:
Forzar download: Si el destino es un archivo se puede habilitar esta opción, lo que provocaría que
el navegador le muestre al usuario la ventana que permite guardar el archivo
Abrir en una ventana Al marcar esta opción se estará indicando que cuando el usuario haga clic en el
nueva: enlace, el destino (sea cual sea la opción que se haya elegido), se muestre en
otra ventana del explorador.
Es posible configurar algunos parámetros que definan la nueva ventana. Para
ver y modificar estos parámetros se debe hacer clic en el botón, al hacerlo
aparecerá una ventana como la que se muestra en la figura siguiente.
Parámetros
Valor: Se utiliza cuando se quiere pasar o bien un valor fijo, o el valor de una variable
global o bien lo que retorna la llamada a una función. No cambia en función del
Contenido del registro
Campo: Se utiliza cuando se quiere pasar el valor de uno de los campos del registro. Por
ejemplo si se quiere el identificador del registro (_idRegistro)
Visibilidad: Permite definir la visibilidad del enlace, para que solo se muestre para ciertos
usuarios, o en funcion del resultado de una expresión
Ejemplo
Si por ejemplo, se tiene un listado de contactos y un campo de la lista es la dirección de correo electrónico,
seria posible crear un enlace de contenido sobre este campo, de modo que si el usuario hiciera clic sobre el
email, este lo enviará a una página de mandar correo y se pasará como parámetro el valor del campo email,
la página recibirá la dirección de correo y después hacer un par de cosas enviará el correo a los contactos.
Para este ejemplo la configuración debería quedar parecida a lo que se muestra en la figura siguiente.
Una sección de este tipo permite introducir fragmentos de código HTML directamente en una página eBD o
Zona de eBD. Existen dos maneras de introducir este código, una de ellas es subir directamente un archivo
que contenga código HTML y la otra opción es abrir el editor de HTML y comenzar a crearlo, el editor brinda
la posibilidad de escribir el código directamente o en modo diseño, en este último el asistente permite ir
insertando diferentes elementos de HTML (tablas, imágenes, formateando texto, etc.).
Nota: Si se sube un archivo HTML hay que tener en cuenta que este archivo es parte de una página no es
la pagina en si, por ello no debe tener las etiquetas , y hay que tener cuidado con otras etiquetas como el
<BODY>, etc.
Archivos
En esta ficha es la única que es específica para este tipo de secciones, el resto son comunes con otras
secciones y ya se han explicado con anterioridad.
Guardar Cambios en la ficha, se debe hacer cada vez que se modifique el código.
Subir Archivos Adjuntos: toda imagen que se utilice (y que no sea un recurso de eBD), toda hoja de estilo,
etc. que sea utilizado en esta sección , debe ser subido usando este botón. Cualquier archivo que sea
subido por aquí podrá ser referenciado desde el código HTML de la sección como un recurso en la misma
carpeta, en otras palabras no hay que preocuparse por la ruta donde encontrar ese recurso.
Editor HTML
Es un editor sencillo para asistir en la creación tanto de contenido del sitio (editar campos tipo HTML de una
tabla por ejemplo) como de secciones HTML.
Modos de edición
Código Fuente: En este modo puede ver el código HTML que se genera en
modo diseño, puede editarse este código y agregarse código nuevo a la
sección.
Barra de botones
Nota: Para guardar cambios siempre hay que estar en el modo de diseño, si se
efectúan modificaciones en modo “Código Fuente” es necesario cambiarse al
modo de diseño y luego guardar, en caso contrario se perderán los cambios.
Recarga el código
Cambia la fuente del texto marcado a la fuente que este seleccionada en la lista
que esta a la izquierda de este botón
Panel de
herramientas
Inserta una tabla. Al hacer Clic en este botón muestra una ventana que ayudará
a definir la tabla que se quiere crear en este punto, definir columnas, filas,
estilos, etc.
Insertar una imagen. Al hacer Clic en este botón se abrirá una ventana que
permitirá seleccionar la imagen de entre todas las imágenes subidas como un
recurso de eBD previamente
Ayuda
Existe una versión “incrustada” del editor HTML, este editor está pensado para insertar (o modificar)
contenido desde una vista de eBD pero limitando las funcionalidades del editor HTML estándar. En este
editor solo se permite al usuario cambiar texto a Negritas, Itálicas y Cursivas, cambiar la alineación del texto,
tabulaciones y aumentar o disminuir el tamaño de la fuente.
En la imagen siguiente se puede ver como luce este editor. El tamaño de la caja de texto es configurable.
Este tipo de sección útil para mostrar un calendario y permitir asociar eventos (o datos de otra índole) a las
fechas mostradas. Las fichas de Configuración son:
Opciones
En esta ficha se han de configurar las opciones relativas formato en que se visualizará el calendario y
configurar las opciones propias para cada uno de esos modos de visualización.
El usuario final verá el calendario inicialmente en el modo que se marque como defecto, además podrá
cambiar este modo de visualización (eligiendo entre los modos activados para esa sección) en cualquier
momento, para ello se muestran unos enlaces sobre el calendario (cada uno de los enlaces lleva a uno de
los modos habilitados).
Modo de visualización
Modo semana En este modo se muestra una tabla con los días de la semana:
Aplicar colores en los datos: Al definir los orígenes de datos (tablas de donde
viene la data) se asocia un color a cada origen, si se activa esta opción cuando
se muestre un dato en una celda del calendario se mostrará en el color asociado
al origen.
Posición: Indica donde mostrar la leyenda, hay dos opciones una es debajo del
calendario o a la derecha del calendario.
Dirección: Indica como mostrar los elementos de la leyenda uno al lado del otro
(horizontal) o uno sobre el otro (vertical).
Hora de inicio: Indica desde que hora comienzan los días laborables.
Modo mes
Aplicar colores en los datos: Al definir los orígenes de datos (tablas de donde
viene la data) se asocia un color a cada origen, si se activa esta opción cuando
se muestre un dato en una celda del calendario se mostrará en el color asociado
al origen.
Posición: Indica donde mostrar la leyenda, hay dos opciones una es debajo del
calendario o a la derecha del calendario.
Dirección: Indica como mostrar los elementos de la leyenda uno al lado del otro
(horizontal) o uno sobre el otro (vertical).
Modo "n" meses Al elegir este modo se mostrarán el número de meses que especifique el
usuario. Cada mes será una tabla que esta contenida dentro de otra tabla.
Mostrar n meses: El número de meses que se quieren mostrar a partir del mes
actual.
Mostrar detalle del día: Si se especifica el valor “tooltip”, cada ves que se pose
el cursor sobre una celda de un día aparecerá un tooltip, mostrando la
descripción de los datos asociados a esa fecha.
Posición: Indica donde mostrar la leyenda, hay dos opciones una es debajo del
calendario o a la derecha del calendario.
Dirección Indica como mostrar los elementos de la leyenda uno al lado del otro
(horizontal) o uno sobre el otro (vertical).
Modo año
Posición: Indica donde mostrar la leyenda, hay dos opciones una es debajo del
calendario o a la derecha del calendario.
Dirección: Indica como mostrar los elementos de la leyenda uno al lado del otro
(horizontal) o uno sobre el otro (vertical).
Modo personalizado Este modo esta más orientado a mostrar la información de unos pocos días,
bastante parecida a la del modo n meses, solo que este se enfoca a presentar la
información por días.
Aplicar colores en los datos:Al definir los orígenes de datos (tablas de donde
viene la data) se asocia un color a cada origen, si se activa esta opción cuando
se muestre un dato en una celda del calendario se mostrará en el color asociado
al origen.
Posición: Indica donde mostrar la leyenda, hay dos opciones una es debajo del
calendario o a la derecha del calendario.
Dirección Indica como mostrar los elementos de la leyenda uno al lado del otro
(horizontal) o uno sobre el otro (vertical).
Hora de inicio: Indica desde que hora comienzan los días laborables.
Orígenes de datos
En esta ficha se configuran las fuentes de datos que se desea se muestren en el calendario. Inicialmente la
ficha esta en blanco cuando no se han configurado ninguna fuente de datos. Una Origen de datos no es otra
cosa que una tabla de eBD o vinculada desde la eBD, la única condición es que debe tener un campo fecha
que pueda ser utilizado para vincular registros con una celda correspondiente a esa fecha.
Agregar un origen de datos. (Indicar una tabla de la cual se extraerán los datos)
Una vez que se ha creado un origen de datos, se encontrará una pantalla como la que se muestra a
continuación.
Tablas
Posición El orden que se mostrarán los datos, es decir, caso de que para un día haya
datos de dos orígenes diferentes (diferentes), se mostrarán según el orden que
se establezca aquí
Leyenda Texto que describe al origen de datos, se mostrará debajo o a un lado del
calendario.
Campos Al hacer clic sobre este botón abrirá una ventana en la cual se podrán elegir los
campos de la tabla que permitirán mostrar un dato en una celda correspondiente
a la fecha y hora.
Campo fecha: Permite indicar a eBD cual de los campos de la tabla elegida
como fuente de datos es el que marca la fecha.
Color: Para cada origen de datos es posible definir un color que le identifique, de esta
manera cuando se muestren las descripciones en las celdas del calendario se
harán en ese color y así quienes vean el calendario podrán asociar la
descripción que se muestra en cada celda con lo que muestre la leyenda.
Relaciones: Permite activar relaciones que estén definidas y que involucren a la tabla que se
usa como origen de datos. Al activar una relación, los campos de la otra tabla
que participa en la relación se pueden utilizar para definir descripciones, fechas
y horas iniciales y finales de los registros a mostrar.
Filtros: Permite definir filtros sobre la tabla origen (y las relacionadas, si se ha activado
alguna relación).
Enlaces de datos
En esta ficha de configuración se definen enlaces tantos sobre las celdas vacías como los enlaces sobre
descripciones de eventos que aparecen en las celdas.
Enlace Principal: Permite crear un enlace a donde se deba ir cada vez que el usuario haga clic sobre el
espacio vacío de una celda. Como primer parámetro se pasa siempre la fecha de la celda donde se hizo clic
y como segundo parámetro la fecha de dicha celda. No es posible definir más parámetros, aunque se puede
modificar la posición de los dos parámetros predefinidos, y también reenviar los parámetros recibidos en la
sección actual.
Enlace Específico: Permite crear un enlace sobre las descripciones que aparecen en las celdas cuando se
encuentran registros para ese día y hora. Inicialmente no se pasa ningún parámetro fijo, si se quiere pasar
algún parámetro debe especificarse como se hace cuando se crea cualquier enlace, Primero se especifica
el número de parámetros que se quieren pasar , se guardan los cambios , y luego se especifican los valores
de estos parámetros, y se guarda de nuevo los cambios.
Diseño
En esta ficha de configuración de definen propiedades graficas de la tabla de calendario, colores, estilos,
etc.
Colores día normal Permite elegir el color de fondo y estilo de las celdas correspondientes a días
normales (no es domingo, no es nulo ni es el día de la fecha actual).
Día Hoy Define el color de fondo y estilo del contenido de las celda correspondiente a la
fecha en que se muestre el calendario.
Domingo Define el color de fondo y el estilo del contenido de la celda de los días
domingos.
Día nulo Color de Fondo de aquellos días que sirven de relleno cuando el mes no
comienza en lunes o no termina en domingo.
Fondo nombre Define el color de fondo de las celdas donde se colocan los nombres de los
días.
Estilos cabecera Define el estilo del título que se muestra sobre la tabla de calendario, que por lo
general muestra el nombre del mes y el año.
Espaciado interno Margen interno de cada celda, ese espacio entre el texto y el borde de la celda.
Este tipo de Secciones permiten mostrar graficas en una página o zona de un sitio eBD. Hay tres tipos de
gráficas predefinidas pueden que permite mostrar (barras, sectores, líneas).
Hay un par de pestañas de configuración que son propias a esta sección, Orígenes de Datos y Opciones.
Origenes de datos
Permite especificar cuantos orígenes de datos tendremos y de donde se extraerán los datos, solo se verá
una pantalla como la que se muestra a continuación, el primer paso es especificar el número de orígenes de
datos que se tendrán.
Una vez especificado el número de orígenes de datos, hay que definir cada uno de ellos, es decir, indicar de
donde vendrán los datos y de que manera se manipularán.
Orígenes de datos
Tipos de origen de Indica si los datos provienen de una tabla o si se crea una lista manual de los
datos datos (valores fijos).
Valores fijos: Los datos no son extraídos de ninguna tabla, se definen
manualmente.
Por fila: Agrupa por los valores de un campo, es decir, las series tendrán tantos
elementos como valores repetidos en esa columna (en ese campo). Y habrá
tantas series como columnas se incluyan en la consulta.
Agrupar por: Siempre que se elige la opción por fila es necesario indicar un
campo por el cual agrupar, este campo limitará la longitud de las series.
Series Permite darle nombres a las series de datos, este se usara para mostrar las
leyendas.
Escala Para cada serie de datos es posible asociarle un color con el que se pintará la
parte del gráfico correspondiente a esa serie.
Opciones La Primera serie son etiquetas: Si se marca esta opción la primera serie, es
decir el primer conjunto de valores de se tomaran como etiquetas, se mostrarán
en el eje x.
Valores Acumulados: Se van graficando los valores acumulados por cada
serie.
Un ejemplo muy Común de consultas por Fila puede ser una consulta que
produzca la siguiente tabla:
...
Produciría una salida como la siguiente, si le indico que la primera serie son
etiquetas.
Opciones
Esta Ficha permite configurar algunas opciones del gráfico que se generará.
Tipo de gráfica: Que tipo de gráfico se desea generar, tipo SVG o un gráfico
tipo PNG.
SVG: Plantilla XSL: Permite elegir una plantilla de transformación de los datos que se
extraen de los orígenes a gráficos. Estas plantillas transforman archivos XML a
archivos gráficos SVG. Por defecto eBD tiene definida tres plantillas XSLT para
gráficos (Líneas, Barras, sectores), pero cualquiera que conozca SVG y XSLT
puede crear nuevas plantillas a medida.
Opciones: Por cada plantilla se pasan parámetros que definirán títulos de
gráficos, títulos de ejes, tipos de fuentes etc. Estos parámetros pueden variar de
una plantilla a otra.
Este tipo de secciones permiten definir áreas dentro de una zona o página donde se muestren recursos del
tipo cartografías. En otras palabras usar un conjunto de imágenes de planos interrelacionados.
Orígenes de Datos
En este tipo de secciones es posible asociar registros de una tabla con ciertas posiciones sobre el plano, el
único requisito es que la tabla tenga los campos que permitan ubicar los registros en la imagen.
Leyenda: Texto que se mostrará como leyenda asociada a este origen de datos
Icono: En este campo se puede cargar un icono que se mostrará en las posiciones del
plano asociados a cualquier registro de la tabla. Se ha de usar si se quiere
mostrar un solo icono para todos los elementos de la tabla
Descripción: Indica cual campo de la tabla se utilizará como descripción del registro. Este
aparecerá como un tooltip sobre cada icono al mostrarlos en el plano.
Icono: Se define en caso de que se quiera mostrar un icono particular para cada
registro de la tabla, en este caso el icono se obtiene de un campo de la tabla
Filtros: Permite crear condiciones para restringir los registros a mostrar en el plano. Las
condiciones se crean de la misma manera
Enlaces de datos
En esta pestaña de configuración se han de definir los enlaces para cada una de las tablas utilizadas como
orígenes de datos. Estos enlaces se ubicarán en sobre los iconos que se mostrarán en el plano, es decir,
cada icono será un enlace.
Tabla de origen: Indica la tabla que se utiliza como origen de datos (definidos en la pestaña de
Orígenes de datos.
Destino de enlace: Como se define cualquier enlace dentro de eBD, se debe indicar cuál es la
página, zona o URL a la que e quiere ir.
Parámetros: Los parámetros que se quieren pasar al elemento (pagina o zona) de destino.
Es posible usar variables, funciones de eBD o pasar el valor de campos de la
tabla origen de recurso.
Opciones
En esta pestaña de configuración se definirán algunas propiedades de los controles asociados a los planos
y que permitirán interactuar con los planos de la Georeferencia.
Controles de Permiten movernos entre diferentes planos de una capa y un nivel de Zoom.
dirección: Tipo Puede mostrarse de dos maneras
Brújula Se muestra un control gráfico (en forma de brújula) cerca del plano que
permite al usuario moverse a los planos contiguos al que se está mostrando.
En el plano: Se muestran flechas con enlaces en cada margen del plano para
permitir la navegación entre planos contiguos
Posición respecto al Permite indicar (en caso de que el tipo seleccionado sea Brújula) en que parte
plano: se han de mostrar, sobre, debajo, derecha o izquierda del plano.
Controles de capa: Permite al usuario navegar entre las diferentes capas definidas en la cartografía.
Tipo: Existen dos posibles tipos:
Gráfico Muestra un control gráfico que permite al usuario desplazarse entre las
capas definidas.
Posición respecto al Permite indicar en que parte se ha de mostrar el control (sobre, debajo, derecha
plano: o izquierda del plano).
Desplegable: Muestra una lista desplegable con los niveles de zoom definidos
para que el usuario seleccione a que nivel quiere llegar.
Posición leyenda: Posición respecto plano: Indica el sector donde se mostrará el recuadro con
Posición Resultado Una sección cartografía puede ser utilizada también para mostrar el resultado de
de búsqueda: una búsqueda ejecutada en una sección de tipo buscador, en cuyo caso se
mostrará , además del plano, un listado de los registros que cumplan las
condiciones de búsqueda. En el listado de resultados solo se mostrará el campo
asociado a la propiedad “descripción” de cada registro. (definido en la ficha
Orígenes de datos de esta sección).
Posición respecto al plano: Indica la posición del listado del campo
descripción de los registros que cumplen la condición de búsqueda. El listado
puede mostrarse arriba, abajo, a la derecha o a la izquierda del titulo.
4.4. Estructura
Este tipo de secciones permiten incluir en una zona o página aquellas secciones que se han definido como
globales (en el menú de avanzados). En otras palabras, con una sección de este tipo se puede hacer uso de
una sección que ya ha sido creada y configurada una vez y puede ser reutilizada en varias páginas y/o
zonas.
En el siguiente diagrama se muestra una sección Global Calendario que se crea y configura en la sección
de avanzados del menú de administración.
Esta Sección es luego incluida en la página 1 y en la pagina 2, para ello es necesario crear en el diseño de
ambas paginas una sección global (del tipo que comentamos en esta sección), y al crearla decirle que use
la sección Global predefinida de tipo Calendario.
Una sección de este tipo se usa exclusivamente con la finalidades de diseño, la idea es de alguna manera
permitir agrupar secciones de modo que las secciones agrupadas siempre se desplieguen de la misma
manera a la hora de mostrar la página o la zona, independientemente de si las secciones que estén al lado
(y fuera del grupo) cambien de tamaño.
La separación entre sección 1 y sección 3 se vera afectada por el tamaño de la sección 2, esto no pasará si
se crea un grupo que incluya a la sección 1 y la sección 3 y en el diseño de la página se cambiara a:
Diseño de la Agrupación
En esta ficha se define el diseño del grupo, es decir que secciones de la pagina o zona se agruparan en
esta sección.
Botones en el panel:
Tipos de diseño:
Editar tabla El diseño se define usando una tabla de HTML. Si se elige el modo “editor tabla”
estarán disponibles las opciones que se muestran a continuación:
Diseño de la agrupación
Espacio entre El número de píxeles que se dejará de margen entre las secciones del grupo
secciones:
Diseño: Permite definir la tabla, crear filas y columnas, y distribuir las secciones creadas
para una página o zona entre las celdas de esta tabla.
Atributos de la tabla: Define atributos para la tabla que contiene las secciones del grupo.
Class: Este atributo permite aplicar una clase definida en alguna hoja de estilo cargada
en la página a la tabla.
Summary: Permite definir un texto corto descriptivo acerca del propósito y estructura de la
tabla, importante para temas de accesibilidad.
Ancho: Define el ancho de la tabla, y por ende el ancho del grupo. Si el valor que se
coloque aquí no va acompañado de las unidades, se asume en píxeles, pero
pueden darse también medidas en porcentajes, por ejemplo seria valido decir
que el alto es 100%.
Alto: Define una altura para la tabla. Si el valor que se coloque aquí no va
acompañado de las unidades se asume en píxeles, pero pueden darse también
medidas en porcentajes, por ejemplo seria valido decir que el alto es 100%.
Atributos de la celda: Permite definir atributos para cada una de las celdas de la tabla, es decir para
cada celda donde se muestra una sección. Para definirlos hace falta hacer clic
en la celda de la tabla y se habilitaran los siguientes campos para editarlos.
Class: Este atributo permite aplicar una clase definida en alguna hoja de estilo cargada
en la página a la tabla.
Colspan: Permite indicar que una celda ocupará el espacio de n columnas. Por ejemplo
en la siguiente tabla segunda fila tiene un colspan de 2. A pesar de ocupar el
espacio de dos filas es solo una celda por ello solo puede incluir una sección.
Rowspan: Permite indicar que una celda ocupará el espacio de n filas. Por ejemplo en la
figura siguiente la primera columna tiene un Rowspan de 2. A pesar de ocupar el
espacio de dos filas es solo una celda por ello solo puede incluir una sección.
Anchura: Define el ancho de la celda, es definir el ancho que ocupará la sección, por
defecto en píxeles, pero también puede especificarse otra unidad como tanto
por ciento, un valor valido sería 100%.
La funcionalidad de esta sección es permitir desplegar los menús creados para un proyecto. La forma en
que se muestren los nodos va a estar definida por la plantilla del menú que se aplique. La única ficha de
configuración que no es común al resto de las secciones es la de opciones.
Opciones
En esta ficha se configuran los parámetros que indica que menú mostrar y como mostrarlo.
Botones en el panel
Plantillas de menú: Permite seleccionar una plantilla de menú de las creadas en el proyecto para
aplicársela a los nodos al momento de mostrarlos en esta sección. Las plantillas
de menú se definen en el apartado Avanzado del menú principal de la
administración de proyectos.
Seleccione los nodos En esta área se presentan todos los grupos de menús creados en el proyecto
de menú: separados en menús laterales y menú superiores, para indicar cuales grupos de
nodos se han de mostrar en esta sección se deben marcar en esta lista.
Pudiese mostrarse todos los menús en una misma sección o mostrar cada menú
en una sección, según el diseño deseado.
Nota: En una sección menú, sino se aplica ninguna plantilla el menú sencillamente no se verá nada en la
sección.
La visibilidad de los nodos de un menú, como cualquier otro elemento en eBD esta condicionada a los
permisos que se hayan asignado a cada nodo.
La funcionalidad de este tipo de secciones es servir de contenedores a las vistas creadas en el Modelo de
Datos de eBD. Además de las fichas de configuración comunes a todas las secciones, existe una ficha
particular para este tipo de secciones.
Al momento de crear una sección de este tipo se debe indicar que vista tendrá asociada, si se llega a borrar
esta vista esta sección deberá ser borrada.
Opciones
Botones en el panel:
General
Campos con enlace Este campo permite identificar de manera univoca un registro cuando la consulta
principal: definida en la vista devuelve más de uno, solo es necesario especificarlo si se
quieren modificar o eliminar registros y los filtros definidos en la vista no
aseguran que esta encuentre sólo un registro.
Nota: Es importante recordar cual es el comportamiento de una vista, la vista
consulta la tabla asociada según las condiciones especificadas en los filtros. Si
no encuentra registro (que cumpla las condiciones de los filtros) muestra un
formulario en blanco para insertar un registro nuevo, si encuentra un registro
muestra un formulario con los datos del registro para permitir modificarlos, si
encuentra mas de un registro muestra una lista y en cada registro los campos
definidos como breves.
Enlace Añadir: Si se marca esta opción, se mostrará un enlace que permite ir a un formulario en
blanco donde añadir un nuevo registro. El enlace mostrará por defecto la
etiqueta “Añadir Registro”, es posible cambiar esta etiqueta colocando un
valor en la caja de texto al lado de la opción añadir registro, es posible utilizar
literales, funciones de eBD o Variables Globales.
Enlace Listado: Si se marca esta opción, se mostrará una etiqueta con el valor por defecto
“Listado” en el formulario de modificación o creación de un registro, este
enlace permitirá ir a la lista de registros que la vista recuperó en la consulta a la
tabla. El enlace sólo se mostrará si hay más de un registro que cumpla las
condiciones de los filtros. La etiqueta del enlace también se puede modificar
colocando un nuevo valor en la caja de texto al lado de la opción.
Texto nuevo registro: Si se marca esta opción, se mostrará una etiqueta con el valor ‘Nuevo
Registro’, en los listados de registros o formularios de modificación de una vista
y permitirán mostrar el formulario vacío para agregar un nuevo registro. También
es posible modificar el valor de la etiqueta del enlace.
Encuadrar Agrega a los formularios (tanto el de insertar registros como el de modificar) una
formulario: línea superior que delimitan el área que abarcan.
Mostrar barra de En los formularios que deban enviar mucha información, o que se permita el
progreso: upload de ficheros grandes, es conveniente mostrar una barra de progreso para
que el usuario pueda ver la velocidad a la que se estan enviando los datos.
Botón Confirmar: Este botón aparece en el formulario de insertar registro nuevo. Aquí es posible
cambiar el valor del texto por defecto “confirmar”. Como en los campos
anteriores también es posible utilizar además de literales, funciones de eBD y
variables Globales.
Botón Guardar: Este botón aparece en el formulario de modificación. Aquí es posible cambiar el
valor por defecto.
Botón Borrar: Este botón aparece en el formulario de modificación permite borrar el registro
que se encuentra modificando. Aquí es posible cambiar el valor por defecto.
Ver la paginación: Tanto en modo listado como en modo formulario (de modificación) es posible
paginar, en el primer caso las páginas mostrarán los registros de 10 en 10, si no
se página solo se verán los primeros 10 registros. En el caso del formulario de
modificación, si esta activada la paginación se mostrará en la parte superior del
formulario unos enlaces que permitirán moverse por los registros que haya
cargado la vista usando el formulario de modificación, es decir puedo ver en el
formulario cada registro (uno a la vez) y desplazarme al anterior y al siguiente.
Texto páginas: Indica un texto descriptivo que se mostrará en la barran de paginación del listas
de registros.
Texto Registro: Indica un texto descriptivo que se mostrará en la barra de paginación de los
registros.
Colores
Colores registro 1: Color de fondo de los registros pares (cuando se muestren listados de registros).
Colores registro 2: Color de fondo de los registros impares (cuando se muestren listados de
registros).
Estilos
Estilo Paginación Permite cambiar una hoja de estilos para la barra de paginación del listado de
Listado: registros.
Estilo Paginación Permite cambiar una hoja de estilos para la barra de paginación de los registros.
Registro:
Separación de registros
Espacio Blanco: Elegir esta opción si no se quiere que aparezca ningún separador entre los
registros que se muestran en modo listado.
Línea: Elegir esta opción si quiere que se muestre una línea separadora entre registros.
Anchura Separación: El número de píxeles que se dejarán de espacio antes y después de mostrar los
campos de un registro.
Esta Sección permite insertar en una página o zona un buscador que actuará sobre una tabla de las
definidas o vinculadas en el modelos de datos. Solo hay un par de fichas de configuración que difieren de
las del resto de las secciones, estas fichas son:
Opciones de Búsqueda
Botones en el panel:
Opciones Generales
Modo de búsqueda: Existen dos modos de hacer efectuar una búsqueda, modo simple o modo
Avanzado.
Simple: En este modo, sólo es posible especificar un valor a buscar en todos
los campos que se definan como campos a buscar (ver la siguiente ficha de
configuración). Si se elige este modo solo se mostrará en el formulario de
búsqueda el primero de los campos a buscar, aunque se buscará en todos los
campos especificados el mismo valor.
Botón de 'Buscar': Es posible cambiar el texto al botón para buscar, por defecto se muestra el valor
“Buscar”.
Texto: El Valor que se coloque aquí será la etiqueta del botón.
Mantener Parámetros Al activar esta opción, despues de una búsqueda la sección mostrará los valores
de Búsqueda: que ha introducido el usuario en los campos a buscar, para permitirle refinar la
búsqueda sobre los valores anteriores.
Campos a Buscar
En esta pestaña se definen los campos que se utilizarán para formar las condiciones de búsqueda.
Posición: Cuando se define más de un campo sobre el cuál buscar, indica en que orden
aparecerán estos campos en el formulario.
Valor: Longitud del campo que se mostrará para que el usuario ingrese la frase a
buscar. Puede especificarse la fuente y el estilo de este campo.
Condición: En este campo se definen los operadores con los cuales se comparan los
campos seleccionados con los valores introducidos por el usuario. Entre las
posibles opciones están:
IN
,
IS NULL,
IS NOT NULL,
NOT IN,
NOT LIKE,
LIKE,
BETWEEN
Además de estos operadores están los de mayor, igual y menor. Hay que se
cuidadoso al elegir un operador u otro en base a lo que se quiere buscar, por
ejemplo saber cuando usar igualdad y cuando usar un like.
Lista desplegable: Se marca si los valores a buscar se obtienen de una tabla, en este caso, en vez
de un campo de texto mostrará una lista cuyos valores se sacan de la tabla
asociada a este campo.
Visibilidad: Permite definir la visibilidad de este campo, para que solo aparezca a ciertos
usuarios, o según el resultado de una expresión.
Este tipo de secciones permite incluir un formulario de HTML en una página o zona de eBD. Tiene un par de
pestañas con opciones de configuración que no son comunes al resto de las secciones, ellas son Opciones
y Formulario, y se describen a continuación:
Opciones
Enlace: En este apartado se define a que zona, página o URL será enviado el formulario
cuando se haga un “submit”, en otras palabras, define la propiedad action del
formulario.
Eventos: Define Acciones en JavaScript para cada posible evento que puede ocurrir
sobre el formulario. Para definir las acciones debe elegirse el evento de entre la
lista desplegable que se muestra y acto seguido agregar el código en el
recuadro de texto, luego salvar. Lo más común para formularios es definir
acciones para el evento OnSubmit.
Formulario
En esta pestaña, se pueden agregar, eliminar y posicionar los elementos del formulario.
Es posible modificar las dimensiones del formulario, haciendo clic y desplazando los puntos negros que se
muestran en los bordes del recuadro gris que indica el área ocupada por el formulario.
Mostrar cuadricula: Muestra o Esconde la retícula sobre el área que ocupa el formulario.
Ajustar a cuadrícula: Si se activa esta opción se desplazaran los controles agregados, hasta que los
bordes izquierdos e inferiores coincidan con las líneas (de la retícula de ayuda al diseño) que estén más
próximas.
Crear Z-index automático: Define de manera automática los valores de esta propiedad para cada control.
La propiedad z-index indica que control se mostrará sobre otro en caso de solapamiento.
Crear Tab-index automático: Define de manera automática los valores de esta propiedad para cada
control. Define el orden de navegación por los controles utilizando el tabulador.
Manejos de eventos
A continuación se mostrarán las pantallas para configurar cada tipo de elemento que puede agregarse al
formulario, y se comentarán las opciones de cada pantalla. Hay una opción que parecerá en todas, esa es la
definición de “handlers” o manejadores de evento, lo cual es definir una serie de acciones en javascript que
permitirán responder ante acciones de los usuarios sobre los elementos de un formulario.
Eventos: Para agregarse código para manejar un evento debe primero seleccionarse el evento que se
quiere capturar. Luego se agrega el código, que debe ser javascript.
Se debe agregar sólo el cuerpo del manejador (la secuencia de instrucciones sin definición de funciones),
eBD se encargará de meter esas acciones en funciones que se llamen cuando ocurra el evento.
Cuando exista código definido para un evento se marcará en negritas el nombre del evento en la lista.
Select Editor
Se utiliza para definir propiedades de un elemento del tipo “Select” que despliega una lista de elementos. Al
hacer doble clic sobre un elemento de este en el formulario, se abrirá una ventana como la siguiente, donde
se podrán configurar algunas propiedades, eventos y valores de este objeto.
Propiedades
Valor por defecto: El valor que tendrá esta lista como valor seleccionado en caso de que no se
seleccione ningún ítem.
Tooltip Muestra un pequeño recuadro con el texto que se especifique en este campo
cuando el cursor pase sobre este elemento
TabIndex Indica el orden de tabulación entre los elementos del formulario, es decir, define
el orden en que se recorrerán los diferentes campos del formulario usando la
tecla de Tabulación. Los valores de este campo han de ser números enteros y
usando el tabulador el cursor se irá desplazando de los campos con menor
índice de tabulación a los que tienen un mayor índice
Size Permite indicar cuantos ítems serán visibles a la vez, es decir cuantos ítems
podrá ver el usuario sin utilizar las barras de scroll
Fuente Permite definir Fuentes y estilos para los nombres de los elementos que se
muestran en este control
Valores Esta opción permite elegir la fuente de donde se obtendrán los valores a mostrar
en la lista
Valores definidos en Si se elige esta opción los elementos que se listen se sacarán de una tabla que
una tabla se haya configurado en la eBD. Se abrirá una ventana como la que se muestra
a continuación. Hay dos formas de definir la consulta a la tabla, utilizando un
asistente eBD (Estilo eBD) o consulta directa a bases de datos (Query SQL).
Si se usa el estilo eBD se tendrá la siguiente pantalla:
Una vez que se ha elegido la tabla se podrán ver los botones de agregar campo
o quitar campo, agregar los campos que se necesiten para alimentar la lista,
tanto los usados para valores como para descripciones. Guardar después de
agregar los campos y cerrar esta ventana.
Valores definidos Permite generar una lista de pares (valores, descripción) que se mostraran en la
manualmente lista.
Button Editor
Al hacer doble clic sobre un elemento del tipo botón que se haya agregado al formulario, se abrirá una
ventana como la siguiente, donde se podrán configurar algunas propiedades, eventos y valores de este
objeto.
Valor: El valor que pasará este elemento a la página destino del formulario.
Tooltip: Muestra un pequeño recuadro con el texto que se especifique en este campo
cuando el cursor pase sobre este elemento.
Tab Index: Indica el orden de tabulación entre los elementos del formulario, es decir, Define
el orden en que se recorrerán los diferentes campos del formulario usando la
tecla de Tabulación. Los valores de este campo han de ser números enteros, y
usando el tabulador el cursor se irá desplazando de los campos con menor
índice de tabulación a los que tienen un mayor índice.
"Reset": Al hacer clic sobre este tipo de botón se limpiaría los campos del
formulario.
Radio Editor
Ventana que se mostrará al hacer doble clic sobre un elemento de tipo radio que se encuentre en el
formulario.
Atributo: Nombre del elemento radio dentro del formulario, si se nombran dos o más
radios con el mismo nombre, se estará diciendo que son exclusivos, es decir se
estará obligando a seleccionar solo uno de ellos.
Tooltip: Muestra un pequeño recuadro con el texto que se especifique en este campo
cuando el cursor pase sobre este elemento.
TabIndex: Indica el orden de tabulación entre los elementos del formulario, es decir, define
el orden en que se recorrerán los diferentes campos del formulario usando la
tecla de Tabulación. Los valores de este campo han de ser números enteros, y
usando el tabulador el cursor se irá desplazando de los campos con menor
índice de tabulación a los que tienen un mayor índice.
Seleccionado?: Indica si debe aparecer este control marcado como seleccionado por defecto o
no.
Check Editor
Ventana que se muestra al hacer doble clic sobre un elemento de tipo check en el formulario.
Valor: El valor que tendrá este control y que enviará a la URL destino.
TabIndex: Indica el orden de tabulación entre los elementos del formulario, es decir, Define
el orden en que se recorrerán los diferentes campos del formulario usando la
tecla de Tabulación. Los valores de este campo han de ser números enteros, y
usando el tabulador el cursor se irá desplazando de los campos con menor
índice de tabulación a los que tienen un mayor índice.
Label Editor
Esta ventana se mostrará cuando se haga doble clic en un control del tipo label o etiqueta:
Field Editor
Esta ventana se mostrará al hacer doble clic sobre un campo en la pestaña formulario.
Valor por defecto: Valor que aparecerá en el recuadro de texto al visualizar el formulario.
Anchura: Se puede explicitar en este campo el número de píxeles que deberá tener este
campo al mostrarse.
Max. Anchura: Número máximo de caracteres que puede introducirse en este campo.
Tab-Index: Indica el orden de tabulación entre los elementos del formulario, es decir, Define
el orden en que el usuario recorrerá los diferentes campos del formulario usando
la tecla de Tabulación. El valor de este campo ha de ser un número entero, y
usando el tabulador el cursor se irá desplazando de los campos con menor
índice de tabulación a los que tienen un mayor índice.
Textearea Editor
Ventana que se mostrará cuando se haga doble clic sobe un elemento del tipo “Text area”.
Columnas: Este campo indica la anchura del control, expresada en caracteres. Es un límite
visual, es decir, la longitud del valor dentro del control no estará acotada por los
valores de la propiedad columnas.
Filas: Este campo indica el límite “visual” en cuanto al número de filas que se
mostrarán. De la misma manera que pasa con el campo Columnas, este valor
no es una cota del valor del control.
TabIndex: Indica el orden de tabulación entre los elementos del formulario, es decir, define
el orden en que el usuario recorrerá los diferentes campos del formulario usando
la tecla de tabulación. El valor de este campo ha de ser un número entero, y
usando el tabulador el cursor se irá desplazando de los campos con menor
índice de tabulación a los que tienen un mayor índice.
Link Editor
Este tipo de controles permitirán crear un enlace sobre el elemento. Esta ventana se mostrará al hacer clic
sobre un control del tipo link.
Fuente: Permite definir el estilo que se aplicará al texto que tiene el enlace.
Permite incluir en la página o zona un área para Chat. Si el usuario que se conecta al Chat es un usuario no
logado, entonces debe especificar un “nick” con el que se conocerá en la sala.
Opciones
Chat Room: El texto que se mostrará al usuario y sobre el cual se creará el enlace.
Por Nombre: Si se conoce el nombre de la sala, se puede colocar directamente
en este campo.
Mostrar la hora del Muestra para cada mensaje la hora en se recibió en el salón.
mensaje:
Mostrar el usuario Muestra para cada mensaje que aparece en el Chat el usuario que lo envió.
del mensaje:
Color de Fondo: Define el color de los recuadros de Chat y del donde se muestran el nombre de
los usuarios conectados a la sala.
Fuente: Define la fuente en la que se mostrarán los nombres y mensajes de los usuarios.
aleatorios:
Permitir mensaje Permite a los usuarios enviar mensajes particulares entre ellos, sin que el resto
privados: de los usuarios puedan verlos.
Una sección de este tipo permite mostrar en la página o zona donde esté, una lista de las categorías que se
hayan configurado para un servicio de foro, y los mensajes para cada categoría.
Los servicios se crean desde el menú de administración (Servicios, Foros), al momento de crear la sección
de este tipo es necesario tener definido el servicio (foro) al cual va a ser asociada.
Opciones
En esta ficha se muestran las opciones que se han de definir para una sección foro.
Mostar página de Muestra un listados de los distintas categorías y por cada categoría un listado
índice: de los foros configurados dentro del servicio foro asociado a esta sección.
Estilo: Brinda tres opciones para definir el estilo que se aplicará para mostrar el
contenido de esta sección.
Original (foro.css): Indica que se utilice la hoja de estilos por defecto para los
foros.
Sustituir por: Permite reemplazar esta hoja de estilos por defecto por otra que
haya sido modificada. Es importante recordar que todas las clases de la hoja
Original han de ser respetadas.
Esta sección se utiliza para integrar la eBD con la herramienta de asistencia remota INQUIERO, por defecto
este tipo de sección está desactivada, no aparecerán entre los tipos de secciones que se pueden crear, si
se quieren utilizar deben habilitarse en los archivos de configuración de la eBD.
Opciones
En esta pestaña de configuración se definen valores para algunos parámetros que se utilizan en la conexión
al servicio INQUIERO, como textos de referencias que aparezcan en la ventana del operador, etc.
Nota: Para obtener una explicación mas detallada de los posibles valores de estos parámetros, consultar la
ayuda de Inquiero.
Una sección de este tipo permite mostrar en la página o zona donde esté, una aplicación de mensajería
instantánea conectada, que permite a los usuarios gestionar su propia lista de contactos y chatear unos con
otros.
Los servicios de mensajería instantánea se crean desde el menú de administración (Servicios, Mensajería
Instantánea), al momento de crear la sección de este tipo es necesario tener definido el servicio al cual va a
ser asociada.
Opciones
En esta ficha se muestran las opciones que se han de definir para este tipo de sección.
Permitir añadir Si esta activado, los usuarios podran añadir a otros usuarios en su lista de
contactos: contactos.
Permitir eliminar Si esta activado, los usuarios podrán eliminar los contactos de su lista.
contactos:
Este tipo de sección permite incluir fragmentos de HTML que son el resultado de solicitudes hechas a
servidores Web externos, es decir que puede ser cualquier servidor Web disponible.
Opciones
Tag inicial: Una ves que se recibe el HTML en respuesta a la solicitud hecha, se busca la
aparición del tag que se coloque en este campo y a partir de ahí se muestra el
código HTML devuelto en la sección.
Tag final: Este otro tag marcaría el límite del código que interesa mostrar.
Incluir tags: Si está habilitada esta opción se incluyen los tag en el código HTML a mostrar.
Opciones
Método HTTP Es posible indicar el método que se usará para enviar la petición al servidor,
usar método GET o método POST.
Parámetros Muestra una lista de los parámetros (y los valores) que se agregaron usando el
botón agregar parámetros de esta ficha.
Es Posible editar los valores de los parámetros cambiándolos directamente en el
campo llamado valor. Es posible usar valores literales, llamadas a funciones, y
variables globales de eBD.
Guardar cookies Si se habilita esta opción se esta indicando a eBD que si en el código devuelto
remotas se crea o se da valor a alguna cookie esta se guarde también para el cliente que
está abriendo la pagina que incluye el HTML externo.
Esta sección crea un Iframe que mostrará una página externa. Un Iframe es un elemento de HTML que
representa una región cuyo contenido es independiente y que puede ser “incrustado” en una página. Es
como incluir una página dentro de otra.
Opciones
Guardar cambios
URL Origen:
Opciones:
Sincornizar cada n Le indica a eBD que el contenido del iframe debe ser recargado cada n
segundos segundos, donde n es el valor que se coloca en este campo.
Permite incorporar a la página o zona el resultado de la llamada a una operación de un servicio Web.
Opciones:
Web Service:
Web Service Permite seleccionar unos de los servicios Web que se han configurado para este
servidor.
Visualización:
Plantilla XSL Permite aplicar una plantilla de transformación al XML devuelto originalmente, la
plantilla ha de ser creada en el servidor eBD (en el menú de la administración,
recursos compartidos, platillas XSL).
Ver Datos XML En esta ficha se muestran el XML “crudo” (sin aplicar ninguna trasformación)
que retornó la llamada a la operación en el Servicio Web utilizado en esta
Sección.
Este tipo de secciones permiten subir, compilar y ejecutar código java y mostrar los resultados en la página
que incluye la sección.
Las clases implementadas usando una Sección Java son POJO (Plain Old Java Objects). Es decir,
simplemente son clases Java que implementan una interface definida por eBD para posibilitar la
comunicación y el paso de parámetros.
Código fuente
Código Fuente:
Código Fuente:
Opciones:
Permitir la lectura de Si se activa, el código de Java podrá tener acceso de lectura a las variables
variabes globales globales definidas en la sesión de eBD.
Permitir la escritura Si se activa, el código se Java podrá tener acceso de escritura a las variables
de variabes globales globales definidas en la sesión de eBD.
Archivo
Esta ficha de configuración permite incorporar código eBDML a las secciones de este tipo. Para más
información sobre eBDML, véase el manual de eBDML.
Uno Subiendo un archivo donde se encuentre el código. Para ello se debe hacer uso de botón Examinar y
desde ahí seleccionar el archivo que contiene dicho código.
haciendo clic en el se abrirá el editor de eBDML. En la figura siguiente se muestra el aspecto del editor.
Guarda los cambios al código. Los cambios no serán visibles hasta que se haga clic en el botón guardar en
la ficha archivo una vez que se haya cerrado este editor, ya que el código fuente de este archivo ha de ser
compilado por eBD y la compilación se efectúa al guardar los cambios en la ficha archivo. Si solo se guarda
el código (solo se guarda desde el editor) entonces el archivo compilado no sufrirá cambios.
Recargar el último código que se había guardado, en otras palabras, deshace los cambios que se habían
hecho al código desde la ultima vez que se salvo el contenido.
5. Servicios de Comunicación
5.1. Chats
Los Chats permiten la comunicación interactiva entre diferentes usuarios mediante mensajes de texto. En
eBD se pueden crear tantas salas de chat como se necesiten en cada proyecto.
Para crear una Sala de chat (o Chatroom) simplemente se debe indicar un nombre para la sala. En la
pantalla de edición se puede especificar:
Mensaje de Mensaje que se mostrará a todos los usuarios cuando se conecten a la sala.
bienvenida:
Mensaje de sala Mensaje que se mostrará a todos los usuarios cuando se conecten a la sala si
cerrada: esta se encuentra cerrada.
Una vez definida la Sala de Chat, se puede publicar en cualquier página usando la Seccion de tipo Chat
(véase “Secciones”), en la que se pueden especificar las opciones de diseño o de otras funcionalidades
para esa sección.
5.2. Foros
eBD facilita la creación de Foros mediante los Servicios de tipo Foro. Estos servicios comprenden un
conjunto de opciones que permiten la definición de varias categorías dentro de un servicio, y varios foros
dentro de una categoría. En cada uno de estos foros, los usuarios podrán iniciar conversaciones, o
responder a los mensajes de otros usuarios.
Todos los mensajes de los Foros se almacenan en Tablas de la base de datos. Estas tablas se deben crear
como siempre, salvo que debe activarse el checkbox “Tabla de tipo Foro”, para que eBD reconozca que
debe almacenar mensajes de los foros en ella.
Para crear se foro, primero se debe crear el “Servicio Foro”. Dentro del servicio, hay que crear como mínimo
una Categoría de Foros. Las categorías son agrupaciones de foros por temas.
Una vez creada la categoría, se pueden crear tantos foros como sea necesario dentro de ella. Para crear un
foro, se indica inicialmente el nombre y la descripción. En la pantalla de edición del foro, se muestran las
siguientes opciones:
Tabla mensajes: Se debe seleccionar la tabla en la que se almacenarán los mensajes del foro. Esta tabla
debe tener activada la opción “Tabla de tipo Foro”.
Opciones
Descripción: Descripción del Foro que se mostrará en la página de índice del servicio foro.
Ver mensajes a Indica si se debe mostrar toda la conversación cuando el usuario quiere añadir
responder: una respuesta.
Número de topics por Número de conversaciones que se muestran a la vez en el índice de mensajes
página: del foro.
Campos a mostrar
En esta ficha de configuración se debe seleccionar los campos de la tabla que deben mostrarse en el foro.
Como mínimo es imprescindible seleccionar dos, y marcarlos de forma que uno de ellos actúe como “Titulo”
y el otro como “Cuerpo”:
El resto de opciones de esta ficha son similares a la mayoría de pantallas de “Campos a mostrar” de eBD
(posición, etiqueta, estilos, ordenación, etc…).
Diseño Lista
Es esta ficha se puede modificar el diseño por defecto que eBD aplica a la lista de mensajes, en la pantalla
de visualización de un foro.
Desde el editor de tablas HTML, se pueden añadir o quitar columnas, y seleccionar el campo que debe
mostrarse en cada una de ellas, así como cambiar las clases CSS que se aplica en cada celda.
Diseño Mensaje
Es esta ficha se puede modificar el diseño por defecto que eBD aplica al mostrar un mensaje concreto, y en
la pantalla de edición de un nuevo mensaje.
Desde el editor de tablas HTML, se pueden añadir o quitar filas y columnas, y seleccionar el campo que
debe mostrarse en cada una de las celdas, así como cambiar las clases CSS que se aplica en cada celda.
5.3. Mailings
Los Servicios de Mailing permiten definir envíos masivos de correo electrónico a un conjunto de direcciones
de forma automatizada. Los administradores pueden programar el envío de forma que el contenido del mail
que se enviará sea una página desarrollada con eBD. Éste envío se puede ejecutar una única vez (de forma
manual), o bien de periódicamente (de forma automatizada).
Al crear un mailing, se debe seleccionar la Tabla de la que se extraerán las direcciones de email de los
destinatarios, el campo que actúa de dirección email y la página que se enviará como contenido:
Opciones
Enviar sólo si hay Si está marcada, el mailing sólo se enviará si ha habido algún cambio en la
cambios: página de contenido desde la última vez que se envió.
Adjuntar imágenes y Se adjuntarán todos los archivos adicionales en el mail (imágenes y ficheros
ficheros adicionales: enlazados). Si no está marcada, todas las imágenes serán referenciadas desde
el mail con urls de internet.
Calcular página una Se generará la página de contenido una vez y se enviará igual a todos los
sola vez: destinatarios.
Calcular página para Se generará la página para cada uno de los destinatarios, con lo que se puede
cada destinatario: realizar un mailing personalizado en el que el contenido dependa de la persona
a la que se le está enviando el mail. En este caso, la variable global %_EMAIL
almacenará la dirección del destinatario actual.
Filtros
En esta ficha se pueden configurar los filtros sobre la tabla de destinatarios, para restringir el conjunto de
direcciones de email a las que se les enviará el mailing.
Automatización
Para programar el mailing de forma que se envíe automáticamente cada cierto periodo de tiempo, es
necesario crear una Tarea Programada de envío de mailing. Para más información, véase el apartado
“Tareas Programadas” del siguiente capítulo.
Los Servicios de Mensajes SMS siguen exactamente la misma estructura que los servicios Mailing. La única
diferencia entre ellos es el contenido del mensaje que se envia y la forma de generarlo. Éste envío tambien
se puede ejecutar una única vez (de forma manual), o bien de periódicamente (de forma automatizada).
Los envíos de Mensajes SMS no ejecutan una Página de eBD para generar el contenido del mensaje, sino
que ejecutan un código eBDML programado por el administrador, cuyo resultado será el contenido del
mensaje que se va a enviar.
Opciones
Enviar sólo si hay Si está marcada, los mensajes solo se enviarán si ha habido algún cambio en el
cambios: contenido generado desde la última vez que se envió.
Calcular contenido Se ejecutara la función una vez y se enviará el mismo contenido a todos los
una sola vez: destinatarios.
Calcular contenido Se ejecutará la función para cada uno de los destinatarios, con lo que se puede
para...: realizar un envío personalizado en el que el contenido dependa de la persona a
la que se le está enviando el mensaje. En este caso, la variable global %_SMS
almacenará el número de teléfono del destinatario actual.
Automatización
Para programar el mailing de forma que se envíe automáticamente cada cierto periodo de tiempo, es
necesario crear una Tarea Programada de envío de mailing. Para más información, véase el apartado
“Tareas Programadas” del siguiente capítulo.
Los Servicios de Mensajería Instantánea son la base para utilizar las secciones de Mensajería Instantánea.
Gracias a ellos, se mostrara la aplicación de mensajería, que permite a los usuarios comunicarse en tiempo
real unos con otros, y mantener su lista de contactos en la que pueden comprobar el estado de cada uno
(conectado, ocupado o desconectado).
Al crear un Servicio de Mensajería se crean de forma automática 5 tablas de datos, en las que se
almacenará toda la información relativa a los usuarios, contactos y conversaciones activas. Por ello, en la
pantalla de creación del servicio se debe seleccionar un servidor de datos, en el cual se crearán estas
tablas.
6. Elementos Avanzados
Los Eventos Globales son eventos que se ejecutan cada vez que cualquier usuario entra en cualquier
página. Se usan para definir ciertas reglas o acciones que deseamos que se ejecuten siempre, para realizar
comprobaciones sobre el usuario, o para implementar un registro de visitas de una forma muy sencilla.
Gracias a los Eventos globales eBD facilita mucho la trazabilidad de los usuarios, pudiendo crear una tabla
de estadísticas o páginas visitadas con la información deseada en cada momento (usuario, pagina visitada,
fecha, hora, sesión, parámetros de la página, etc…)
Cada Evento (ya sea global o no), se compone de una serie de acciones. Estas acciones pueden ser de
varios tipos:
Insertar registro: Al editar la acción se indicará: la tabla, los valores a insertar y los campos en los
que se insertarán.
Modificar registro: Al editar la acción se indicará: la tabla, los campos a modificar y en que campos
se realizará la modificación. Podrán establecerse filtros para que la acción se
ejecute cuando un campo tenga un valor determinado.
Eliminar registro: Al editar la acción se establecerán filtros para eliminar selectivamente los
registros de la tabla indicada.
Ejecutar proceso: Se indicará el proceso que se ejecutará y el username y password con el que
podrá ejecutarse.
Las Secciones Globales permiten al desarrollador utilizar la misma sección en diferentes páginas o zonas
sin tener que copiarla o volverla a crear desde cero. Esto garantiza la flexibilidad del desarrollo, ya que
aquellos elementos comunes a varias páginas estarán centralizados, de forma que las modificaciones que
se realicen en la sección global se reflejarán en todas las páginas donde se esté mostrando.
Una Sección Global puede ser de cualquiera de los tipos que se han visto anteriormente, excepto el tipo
“Sección Global”, que es la sección que se crea en la página referenciando a la sección que realmente es
global.
Para más información, véase el apartado “Estructura de la aplicación”, del capítulo IV.
Los Objetos de Servidor agrupan diferentes funcionalidades, como las carpetas virtuales, la creación de
archivos dinámicamente en el momento de la descarga, la generación de webservices o el acceso via
webdav a los ficheros almacenados en la base de datos.
Sin embargo, todas estas funcionalidades tienen un punto en común: Todas ellas definen una url “especial”
en el servidor, y el acceso a estas funcionalidades se realiza principalmente mediante esta url.
Por ello, la categoria de “Objetos de servidor” permite crear una estructura de carpetas propia, en la que se
pueden añadir los diferentes objetos dinámicos que compartirán el árbol de carpetas.
• Carpetas virtuales
• Archivos dinámicos
• Web services
• Carpetas webdav
Las Carpetas virtuales se utilizan para configurar diferentes URLs que deben acceder a zonas o páginas
concretas de la aplicación de forma directa. Es decir, se pueden configurar carpetas que en realidad no
existen en el servidor, pero que cuando un usuario intenta acceder a la url
http://www.midominio.com/<carpeta_virtual>, eBD mostrará la zona o página indicada en la carpeta virtual.
Una carpeta virtual también se puede definir usando una expresión regular, para englobar todo un conjunto
de posibles urls. La expresión regular definirá un patrón, y cuando un usuario acceda a una url que coincida
con ese patrón, eBD mostrará el contenido de la carpeta virtual.
Visibildad: Permite definir la Expresión de visibilidad, y/o los grupos de usuarios que
tendrán acceso a esta carpeta virtual.
Destino: Indica el destino de la carpeta virtual. Se puede escoger entre enlazar con una
Zona, una Página o una URL externa.
Un Archivo Dinámico es un archivo descargable por el usuario, cuyo contenido se genera dinámicamente en
el servidor en el momento de realizar la petición. Esta funcionalidad es útil para realizar exportaciones de la
base de datos a ficheros CSV, XML, etc.. También se suele utilizar para integrar contenido dinámico en
archivos Flash, o para realizar otro tipo de integraciones con aplicaciones de diversa índole.
El contenido del archivo se define programando un código eBDML que se ejecutará cuando un usuario
intente descargarse el archivo. Debemos tener cuidado en que no se cree código HTML (normalmente no
nos interesará) para ello usamos los tags eBDML <eBD:CODE> (véase el Manual de eBDML).
Si el archivo dinámico genera un archivo XML, se puede aplicar con posterioridad una plantilla XSLT de
forma que lo que recibe el usuario es el resultado de la transformación.
También se puede indicar una visibilidad (por expresión y/o grupos), para limitar los usuarios que pueden
descargarse el archivo.
6.3.3. WebServices
Los objetos de servidor de tipo WebService representan un conjunto de funciones relacionadas entre sí, que
se pueden ejecutar de forma remota usando los protocolos SOAP o HTTP.
Al crear un webservice, se debe especificar un namespace único, que permite identificar de forma universal
la definición del servicio. De forma automática, eBD generará el archivo WSDL para facilitar la integración
del servicio con otras aplicaciones.
Para cada una de las funciones que se crean en el webservice se debe especificar los parámetros de
entrada y de salida, indicando para cada uno el nombre y el tipo de datos que representa.
También se pueden especificar tipos de datos propios, como secuencias de n elementos, listas o arrays.
El código de las funciones del webservice se programa en eBDML, usando la instrucción eBD:ARGS para
obtener el valor de los parámetros recibidos, y eBD:RETURN para devolver los parámetros de salida.
Para ejecutar las funciones del webservice usando HTTP, se debe acceder a la url:
http://...../carpeta/webservice.funcion?parametro=valor
Estas requests HTTP pueden devolver el resultado en XML, JSON o texto plano. La posibilidad de devolver
una estructura de datos en JSON como resultado hace que los webservice sean un aliado muy eficaz de la
programación a nivel de cliente (AJAX).
eBD permite definir visibilidad a nivel de todo el webservice, o especificar una visibilidad propia para cada
función.
Las carpetas WebDAV definen un sistema de ficheros “virtual”, accesible usando el protocolo webdav. En
este sistema de ficheros “virtual”, tanto los ficheros como las carpetas son en realidad registros de tablas de
la base de datos, de forma que cada vez que el usuario crea un nuevo fichero, se está generando un nuevo
registro en la tabla, etc..
Al crear la carpeta webdav, se debe seleccionar en que tabla/campo se almacenan las carpetas y en cual
los ficheros. Se puede usar cualquier campo de tipo fichero como origen para los ficheros.
Este tipo de carpetas permite extender las funcionalidades ofrecidas por un sistema de archivos común, ya
que en los registros de la base de datos se puede almacenar información adicional sobre el fichero, de
forma que se mantenga una meta-información de forma automática (se pueden usar eventos, valores por
defecto, etc..)
Las carpetas webdav permiten definir visibilidad a nivel global, filtros a nivel de ficheros y carpetas, y
funciones para calcular los permisos de lectura y escritura en cada caso, de modo que se puede
personalizar al máximo los elementos que puede ver/editar un usuario.
Tabla de ficheros
Permite seleccionar la tabla donde se almacenarán los ficheros. Los campos que se deben usar son:
Metadatos: Campo de tipo “texto largo” donde eBD almacenará metadatos sobre el fichero
(básicamente, bloqueos para permitir editar el fichero).
Destino
Nombre de carpeta: Campo de tipo “texto corto”, donde se guardará el nombre de la carpeta.
Metadatos: campo de tipo “texto largo” donde eBD almacenara metadatos sobre el fichero
(básicamente, bloqueos para permitir editar el fichero).
Valor de la carpeta Valor que se usara en los campos “Identificador de carpeta”, tanto de los
raíz: ficheros como de las carpetas, para identificar a la carpeta raiz. Si los campos
Identificador de Carpeta son de tipo “Autonumerico”, es recomendable usar el
valor 0. Si no, debe buscarse un valor que no pueda aparecer nunca en ninguna
carpeta.
Una plantilla de tipo menú es una serie de trozos de código eBDML que se ejecutarán en determinados
momentos al mostrar una Sección de tipo Menú. Estos momentos están definidos por la estructura de árbol
de los menús. Por ejemplo se ejecutará un trozo de código en el inicio del menú, éste será típicamente la
abertura de una tabla. Tenemos total libertad para escribir el código eBDML, podemos subir ficheros CSS
para incluir estilos, utilizar scripts, etc.
Rama: Se ejecuta cada vez que se muestra un nodo de primer nivel (Rama de menú).
Inicio Hijos Rama: Se ejecuta antes de mostrar los nodos hijos de la rama (sólo si la rama contiene
hijos).
Fin Hijos Rama: Se ejecuta después de mostrar los nodos hijos de la rama (sólo si la rama
contiene hijos).
Nodo: Se ejecuta cada vez que se muestra un nodo de segundo (o mayor) nivel.
Inicio Hijos Nodo: Se ejecuta antes de mostrar los nodos hijos (sólo si el nodo contiene hijos).
Fin Hijos Nodo: Se ejecuta después de mostrar los nodos hijos (sólo si el nodo contiene hijos).
Las Librerías se utilizan para agrupar funciones eBDML, con el objetivo de facilitar la reutilización de código.
Estas funciones se podrán llamar desde cualquier código eBDML, ya sea una sección, una acción de un
evento, una plantilla de menú, etc…
Una librería puede contener varias funciones, cada una de ellas con unos parámetros diferentes. Por
defecto las librerías son privadas al proyecto, pero se pueden compartir, de forma que se puedan llamar a
las funciones que contiene desde las páginas de otros proyectos.
Los administradores de estos otros proyectos no podrán ver el código de las funciones, por eso es
importante documentar bien los parámetros y la funcionalidad que ofrecen, para que se puedan usar
correctamente.
eBD incorpora un generador de imágenes de seguridad, que se pueden incluir en los formularios para
distinguir si los datos los esta enviando un “humano” o un proceso automatizado. Estas imágenes suelen
mostrar una combinación de números y letras distorsionadas, para evitar que programas OCR puedan
reconocer el texto que están mostrando.
El uso de las imágenes CAPTCHA de eBD es muy sencillo. Simplemente se debe incluir en el formulario
una imagen cuya url sea la siguiente: http://......./handlers/captcha/code.png Una vez colocado en el
formulario, solo hay que editar la página que recibe los datos del formulario, y añadir la comprobación
correspondiente, entre el campo que haya escrito el usuario y el valor de la variable globla
%_CAPTCHA_CODE (donde se habrá almacenado el código generado para ese usuario).
La barra de progreso que se muestra en las secciones vista también se puede utilizar en cualquier
formulario programado con eBDML.
• Crear un DIV dentro del formulario, con un identificador conocido (por ejemplo: “barra_progreso”.
• Enlazar la hoja de estilos que se aplica a la barra de progreso en la cabecera de la zona: <link
rel=”stylesheet” href=”/styles/progressbar/progressbar.css” type=”text/css”>
• Enlazar el siguiente archivo javascript desde la página (ya sea en la cabecera de la zona, o en el
propio código del formulario). <script src="/includes/progressbar/progressbar.js"></script>
• Modificar el evento onsubmit del formulario, para que active la barra de progreso: <form
onsubmit="return progressBar.showProgressBar(this,'id_div')">
6.5.3. Ajax
Como se ha visto anteriormente, eBD lleva ya incorporadas varias funcionalidades basadas en AJAX, que
permiten modificar el contenido de la página de forma asíncrona, sin tener que recargar toda la página de
nuevo.
También se ha visto la posibilidad de usar AJAX para invocar la ejecución de métodos remotos en el
servidor, ya sea definidos como webservices o como archivos dinámicos.
Además de todo esto, eBD también permite usar AJAX para ejecutar remotamente secciones eBD, y usar el
contenido html generado por ellas para modificar la página original. Por ejemplo, se puede usar para
mostrar el contenido de una sección dentro de un DIV de forma dinámica.
Para ello, es necesario activar la opción “Visible desde AJAX” en la sección que queramos mostrar, y luego
seguir los siguientes pasos:
• Usar eBDML para generar la url encriptada, que invoca la sección que queremos mostrar. Por ejemplo,
si el identificador de la seccion es el 9, el código seria: <eBD:ENCRYPT VAR="url"
VALUE="?idsection=9"/>
• Programar la función Javascript de respuesta, la cual recibirá como único parámetro el contenido de la
sección que se ha ejecutado:
<script language="Javascript">
function mostrar_seccion(html)
{
var obj=document.getElementById('ampliacion_target');
if (obj != null)
{ obj.innerHTML=html; }
}
</script>
7. Recursos
Denominamos recursos a aquellos elementos comunes que se utilizan de forma generalizada en toda la
web. Especialmente cabe destacar los recursos gráficos, como son los colores y las imágenes que se
usarán para especificar estilos de fuentes, o secciones comunes en diferentes páginas de las aplicaciones.
NOTA: Todos estos recursos están compartidos entre todos los proyectos definidos dentro de eBD. Un
cambio en los colores, estilos globales, etc..., afectará a todos los proyectos, no únicamente al proyecto
desde el que se haya realizado el cambio.
Los administradores tienen la posibilidad de editar los Colores, con el objetivo de definir un conjunto de
colores corporativos comunes a todas las páginas y facilitar así el proceso de diseño de todos los
documentos que se generen desde eBD.
Esta lista de colores será la que eBD ofrecerá al usuario cuando éste deba seleccionar un color, de forma
que garantiza la utilización de los mismos colores en toda la aplicación.
Para crear un nuevo color, el usuario dispone de un selector de colores avanzado, en el cual puede
seleccionar los componentes RGB, o introducir el código hexadecimal del color.
Del mismo modo se pueden crear Imágenes en el menú de recursos, para poderlas utilizar desde el editor
HTML propio de eBD, y así no duplicar la misma imagen tantas veces como documentos la utilicen. Por
ejemplo, en el apartado de imágenes se pondrían los logos de la empresa, o imágenes corporativas que se
suelen utilizar en muchas páginas.
Además de imágenes, este repositorio se puede usar también para almacenar otros tipos de archivos
adicionales (flash, css, javascript), que se vayan a utilizar en varias páginas o secciones.
Se pueden crear estilos tipo, para poderlos utilizar en cualquier lugar que se puede aplicar un estilo en eBD
(títulos de sección, estilo de etiquetas o campos, estilos de enlaces, etc…)
El objetivo de estos estilos globales es definir una única vez como se debe mostrar el texto, y reutilizar ese
estilo en todos los lugares donde se deba aplicar. Los Estilos Globales (igual que el resto de estilos), podrán
ser del tipo eBD, CSS o CLASS. Los primeros se definen seleccionando las distintas opciones en el selector
de fuente, para los estilos CSS se escribirá el texto con las especificaciones de formato, también podremos
importar un fichero CSS y activar una clase desde la pestaña CLASS.
De entre todos los estilos globales creados, se puede seleccionar uno como estilo global predeterminado.
Cuando eBD genere cualquier objeto que incluya estilos (al crear una nueva sección, por ejemplo), todos los
estilos creados estarán referenciando al estilo global predeterminado.
Por defecto, está desactivado el estilo predeterminado, pero se puede activar o desactivar en cualquier
momento usando la opción “Desactivar estilo predeterminado”.
7.3. Cartografías
Las Cartografías permiten crear planos donde, mediante coordenadas, quedarán identificados todos los
puntos del mapa. Se usan conjuntamente con las Secciones de tipo Georeferencia para mostrar la
información de la base de datos referenciada sobre un plano, por ejemplo para hacer callejeros, o mapas de
situación.
Cada cartografía puede tener varios niveles o capas. Para cada capa el administrador especificará el valor
máximo y mínimo de la coordenada Z, y los distintos niveles de zoom. Para cada nivel de zoom de una capa
se añade una o varias imágenes y se especifican los valores máximo y mínimo de las coordenadas X e Y de
cada una de ellas.
Para conocer las coordenadas de cualquier punto del plano simplemente moveremos el puntero por encima
de este, en los cuadros de texto X e Y irá apareciendo el valor de cada coordenada según el punto donde se
sitúe el puntero.
Una vez creadas todas las imágenes de un cierto nivel de zoom, se deben relacionar usando el editor de
tablas que aparece al pulsar el enlace “Relaciones”. Con este editor se sitúan las imágenes formando una
rejilla que completa todo el plano en ese nivel de zoom determinado.
Las Plantillas XSL se utilizan para transformar datos de un cierto formato XML en otro tipo de formato,
también XML. En eBD se suelen usar para la comunicación vía webservice con otras aplicaciones, o en el
caso de graficas SVG para definir la transformación a aplicar entre los datos y el formato SVG resultante.
Desde la gestión de plantillas XSL, únicamente de dispone de las opciones de creación, modificación o
eliminación de plantillas. (subiendo el archivo XSL desde el disco duro del desarrollador).
eBD puede usar servicios remotos proporcionados por aplicaciones externas para integrar el contenido o las
funcionalidades dentro de las aplicaciones que se desarrollen. Para conseguir esto, el administrador debe
configurar los WebServices a los que quiera acceder usando el menú “WebServices”.
Para definir el WebService, se debe indicar la url del archivo de definición del servicio (wsdl). Una vez hecho
esto, eBD analizará el contenido de ese archivo, y facilitará al desarrollador una relación de las operaciones
disponibles en el servicio, y los parámetros que necesita cada una.
Para usar un webservice, es necesario crear una sección de tipo WebService, o bien utilizar la instrucción
de eBDML dedicada a ello (eBD:WS).
7.6. Procesos
Los procesos en eBD son archivos ejecutables en el servidor, que se encargarán de realizar tareas
mayoritariamente de mantenimiento del sistema, o de cálculos complejos que se deseen ejecutar de forma
oculta al usuario.
8. Herramientas
eBD permite la ejecución de ciertos tipos de procesos o tareas de forma periódica, mediante las tareas
programadas. Una Tarea Programada puede ser de uno de estos 3 tipos:
Log Activado: Activa el registro de las acciones que realiza la tarea en un fichero de log. Este
fichero se puede visualizar o vaciar desde la misma pantalla.
Mensual: La Tarea se ejecuta cada X meses, en unos días del mes en concreto y a una
cierta hora.
Desde la opción de Literales, los desarrolladores pueden crear textos que variarán en función del idioma
(localización) con el que esté navegando el usuario. De esta forma, un “Literal” esta formado por una
palabra clave, y un valor para cada una de las localizaciones creadas en el sistema.
Para usar los literales en las páginas o secciones de eBD, se debe utilizar la función “literal” del objeto
eBDLocale. Para más información véase el apéndice B “Funciones internas (#)”.
El Gestor de Envíos de eBD es un subservicio que se encarga del envío de forma controlada de todos los
mensajes de EMail o SMS que se lanzan desde una aplicación eBD. Estos mensajes se almacenan en una
cola, y el gestor de envios realiza la conexión son los servidores correspondientes (SMTP o SMPP) para
efectuar la entrega. De esta forma, se evitan problemas de saturación de los servidores smtp en caso de
realizar un envio masivo de correo.
eBD permite al Administrador de un proyecto ejecutar consultas sobre la base de datos que agilicen
determinadas acciones, como búsquedas, modificaciones en el contenido, eliminar registros que cumplan
determinadas condiciones, etc, utilizando SQL.
Para ejecutar una consulta, debe seleccionarse un servidor de la lista desplegable y escribir en el cuadro
Query la sentencia SQL. Al usar el botón Ejecutar, se llevará a cabo la consulta, presentando en la parte
inferior de la pantalla un informe tabulado sobre los datos solicitados.
Cuando un usuario desarrollador (administrador de un proyecto) está navegando por la aplicación, puede
activar una herramienta incorporada en eBD que facilita la edición de los objetos. Esta herramienta es la
administración asistida.
Gracias a ello, cuando el usuario pasa el cursor sobre las secciones de la página, éstas se destacan con un
borde azul. Esto permite ver realmente las secciones que hay en la página, pero también facilita la gestión,
ya que si el usuario hace doble click sobre una sección, se abrirá una ventana nueva son las pantallas de
edición de esa sección en concreto.
8.6. Debugger
Otra herramienta de ayuda al desarrollo es el debugger de eBD. Al tenerlo activado, el desarrollador verá un
listado de las acciones que ha realizado eBD para construir la página que está viendo en ese momento. Hay
varios niveles de debug, que permiten ver más o menos detalle de los mensajes.
En el debugger también aparecerán los errores de ejecución, o los mensajes creados con la instrucción de
eBDML eBD:WARN. El debugger se activa o desactiva desde el formulario de edición del usuario, pero igual
que la administración asistida también tiene un atajo de teclado que es CTRL + SHIFT + D.
Debug de Querys
Cuando el debugger muestra una query, también mostrará a su lado el tiempo de ejecución total, el tiempo
de ejecución desglosado (en escritura, ejecución y lectura de datos), y el tamaño total de los datos que ha
generado la query. Si eBD detecta que hay alguna query lenta, la pintará en rojo, para avisar al
desarrollador. Gracias a esto, se puede detectar muy fácilmente si hay alguna query que está consumiendo
muchos recursos para ejecutarse, ya sea porque tarda mucho o porque devuelve muchos datos.
A la izquierda de la query, aparecerá también el botón (?), que permite lanzar un EXPLAIN de la query en
cuestión, para comprobar cual es el plan de ejecución de la misma según el sistema de gestión de base de
datos. El resultado del EXPLAIN se mostrará en el panel de inspección.
Breakpoints
El debugger de eBD también permite activar breakpoint en ciertos puntos de la ejecución de una página
(gen