Cómo crear una nueva caja
Conceptos básicos
Las cajas son aplicaciones de pequeño tamaño, consistentes por sí mismas y con capacidad de comunicarse con otras cajas que se ejecutan en el mismo escritorio.
Las cajas son de los siguientes tipos:
- Formulario
- Consulta de objeto de negocio (lista previa de registros)
Pasos que hay que seguir
Para crear una nueva caja puede acceder al mantenimiento de cajas de escritorio; para ello desde UI y la vista Principal, en Sistema, Diseño y Escritorios, acceda a Cajas de escritorio.
O también desde un escritorio:
- Pulsar el botón Añadir caja, situado en la parte superior derecha del escritorio, se abre un diálogo de selección de cajas.
- En este diálogo puede buscar la caja que desee, mediante las opciones de filtro y, una vez localizada, pulsar el hipervínculo asociado para incorporarla en el escritorio.
Al crear una caja se ha de indicar el nombre o código y el producto al que estará asociada. Se puede indicar el título multiidioma que mostrará la caja cuando se utilice en un escritorio.
La información general de la caja es la siguiente:
- Tipo. Las cajas pueden ser de dos tipos: formulario o consulta de objeto de negocio (lista previa de registros). Se debe seleccionar el formulario que mostrará la caja, o bien el objeto de negocio del que se mostrará la lista previa de registros.
- Objeto. Indica el contenido de la caja dependiendo del tipo de caja. Puede ser el nombre de un formulario o de un objeto de negocio.
- Filas. Número de filas por defecto que ocupará la caja en el escritorio. Cuando el usuario use la caja, podrá cambiar dinámicamente este valor.
- Columnas. Número de columnas por defecto que ocupará la caja en el escritorio. Cuando el usuario use la caja, podrá cambiar dinámicamente este valor.
- Icono. Opcionalmente, se permitirá asociar una de las imágenes del repositorio como icono de la caja. Este icono se mostrará en la cabecera de la caja inmediatamente antes del título de la misma. Para asociar una imagen se deberá indicar mediante el botón de selección existente junto al campo Icono del formulario. A la vez se mostrará una previsualización de la imagen indicada. La imagen asociada al icono no puede ser superior a 32 pixeles.
- Consulta. Consulta que se utilizará al abrir la caja, si no se desea usar la consulta por defecto del objeto de negocio seleccionado o del objeto de negocio del formulario seleccionado en el tipo de caja.
- No parámetros vacíos. Opción para no cargar los datos en caso de que haya parámetros de entrada no informados.
- Formulario de detalle. Si la caja es de tipo de consulta del objeto de negocio (lista previa de registros), se puede indicar qué formulario se abrirá al seleccionar un registro de la lista previa de registros de la caja. Si no se indica un formulario, abrirá el formulario por defecto del objeto de negocio indicado en el tipo de caja.
- Solo lectura. Para abrir el formulario integrado en la caja en modo solo lectura.
Las cajas utilizan parámetros para comunicarse con otras cajas. Para ello, se pueden definir unos parámetros de entrada y de salida.
Cuando se utiliza una caja en un escritorio se pueden enlazar los parámetros que tiene definidos para personalizar su comportamiento y los datos que muestran. Los parámetros de entrada permiten filtrar el contenido de la caja. Los parámetros de entrada que no se hayan enlazado se muestran automáticamente en la caja para que el usuario los indique.
Los parámetros de entrada tienen las siguientes propiedades:
- Código. Nombre interno del parámetro de entrada.
- Nombre. Descripción completa multiidioma que se mostrará al usuario para enlazar el parámetro en el escritorio.
- Tipo. Los parámetros pueden ser asociados a un ítem del objeto de negocio o libre.
- Campo. Indica el campo del objeto de negocio asociado al parámetro.
- Tipo de origen por defecto. Se puede indicar el origen del parámetro, si éste no se enlaza al utilizar la caja en un escritorio. Sólo se puede indicar un valor constante o un valor del sistema.
- Origen por defecto. Cuando se indica que se utilizará un valor de sistema como tipo de origen por defecto, se puede seleccionar el valor de sistema deseado. Los valores de sistema que se pueden utilizar son:
- Sólo hoy.
- Fecha del escritorio donde esté la caja.
- Usuario actual.
- Fechas posteriores a la del escritorio, fechas anteriores a la del escritorio, fechas desde la del escritorio y fechas hasta la del escritorio.
- Origen constante. Cuando se indica que se utilizará un valor constante como tipo de origen por defecto, se puede indicar un valor constante.
- Usar en título. Indica si el valor de este campo se debe incluir en la cabecera de la caja.
- Preguntar. Indica si se debe preguntar el valor del campo en caso de que no esté informado.
Los parámetros de salida pueden utilizarse como parámetros de entrada de otras cajas.
Los parámetros de salida tienen las siguientes propiedades:
- Código. Nombre interno del parámetro de salida.
- Nombre. Descripción completa multiidioma que se mostrará al usuario para enlazar el parámetro en el escritorio.
- Tipo. Los parámetros pueden ser asociados a un ítem del objeto de negocio o libre.
- Campo. Indica el campo del objeto de negocio asociado al parámetro.
Temas relacionados
Cómo crear un nuevo escritorio
Cómo enlazar los parámetros de una caja