Paneles de calendario en Jitterbit App Builder

Un panel de calendario

Paneles de Calendario llenan un calendario con información de una fuente de datos, utilizando tres tipos de controles únicos: Descripción, Inicio del Evento y Fin del Evento. El control de Descripción designa lo que aparecerá en el calendario, y típicamente es el nombre de un evento. Los controles de Inicio del Evento y Fin del Evento designan en qué día aparecerá el evento, y pueden incluir marcas de tiempo, que se mostrarán junto a la descripción del evento. Al igual que con los Paneles de Gráficos, los Paneles de Calendario pueden estar vinculados a otro Panel para mostrar más detalles sobre el evento en el calendario.

Por defecto, el Panel de Calendario se mostrará según los datos en la Regla de Negocio, respetando cualquier orden que se aplique en la Regla de Negocio. Revisa tu Regla de Negocio para verificar el orden.

Si no hay datos en la Regla de Negocio, entonces el mes, día o año actual debería aparecer en el Calendario. Tan pronto como se agreguen datos, probablemente querrás agregar un orden a la Regla de Negocio.

Cómo mostrar el mes actual en el calendario

Para asegurarte de que el panel devuelva el mes, día o año actual, agrega una columna llamada Orden con tipo lógico numérico y aplica un orden ascendente en esta columna. Por ejemplo, si tu objeto de negocio que soporta tu panel de calendario tiene una columna llamada StartDate que te gustaría usar y es una fuente de datos SQL, puedes usar una función de escape SQL:

${ABS(DateDiff(day, getdate(), StartDate))}

o una declaración IIF de App Builder:

IIF(DateDiff(dd, Now(), StartDate) < 0, (DateDiff(dd, Now(), StartDate))*-1, DateDiff(dd, Now(), StartDate))

Para ver otros meses, haz clic en los botones de chevrón hacia adelante y hacia atrás en la esquina superior izquierda del panel. Alternar entre las vistas de Día, Semana y Mensual se puede hacer haciendo clic en los botones correspondientes en la esquina superior derecha del panel. Los paneles de calendario no se pueden editar; sin embargo, se puede editar un panel separado que muestra los controles de eventos.

Cómo cambiar la fecha y hora de un evento

1. Selecciona el Evento
2. En el panel que muestra la información del evento, haz clic en el ícono de Lápiz
3. Ajusta la fecha y hora según sea necesario, luego haz clic en el Checkmark para guardar

Cómo agregar un nuevo evento al calendario

1. Selecciona cualquier evento preexistente y haz clic en el botón Crear
2. Ingresa un título para el evento, selecciona una fecha del menú desplegable del calendario
3. Para los controles con fecha y hora habilitados, haz clic en el ícono de Hora para mostrar un reloj
4. Haz clic en el Checkmark para guardar
5. Después de realizar cualquier revisión en el calendario, actualiza la página y confirma la(s) actualización(es)

Cómo crear un calendario utilizando la base de datos northwinds

En este ejemplo, agregaremos un nuevo panel de Calendario para representar visualmente la fecha en que se registran los Pedidos en Northwinds.

Crear un objeto de negocio para usar con el panel del calendario

1. Crea una nueva Regla de Negocio
2. Asigna un Nombre a la regla. Por ejemplo: Pedido (Calendario)
3. Establece el Propósito en Calendario
4. Dirige a la tabla Pedido
5. Haz clic en el botón Guardar
6. Desde la tabla Pedido, haz clic para seleccionar las columnas OrderID y OrderDate
7. Haz clic en la pestaña Where. Agrega la columna OrderDate al campo Izquierdo. Elige IS NOT NULL como el Operador. Deja el campo Derecho en blanco.
8. Si lo deseas, agrega una columna que soporte Ordenar a la pestaña Columnas. Por ejemplo: DatePart(mm, O.OrderDate)

Crear el calendario

1. Ve a App Workbench > Agregar una Página
2. Nombra la página Calendario de Pedidos y haz clic en Crear
3. Selecciona el diseño de una sola columna, haz clic en Agregar Panel
4. Selecciona el Calendario
5. Localiza la Regla del Calendario y haz clic en Seleccionar
6. Haz clic en Personalizar Página
7. Ingresa Calendario de Pedidos para el Nombre, selecciona Panel de Calendario como el Tipo, y selecciona Mensual como el Subtipo.

8. Agrega dos Controles con la siguiente configuración:

   	Columna	Nombre	Tipo de Uso
   Control #1:	OrderID	Pedido	Descripción
   Control #2:	OrderDate	Fecha de Pedido	Inicio del Evento

9. Navega a la vista de la aplicación y confirma que ahora ves el Calendario

Configurar los eventos del calendario para enlazar a otra página

1. Desde la página del Calendario en tu aplicación, haz clic en Action Drawer > Live Designer
2. Haz clic en el botón Controls en el panel del Calendario
3. Haz clic en el ícono Open Record para el control desde el cual enlazar
4. En Actualización y Enlace, establece Link To Page en Orders
5. Verifica que esté vinculado por OrderID en los Criterios
6. Navega a la vista de la aplicación y confirma la actualización

Habilitar el formato de hora de 24 horas

Desde App Builder 4.60, los paneles de calendario soportan un formato de hora de 24 horas. Por defecto, los tiempos de los eventos se muestran en formato de 12 horas. Para cambiar a formato de 24 horas:

1. Navega a la página del calendario en tu aplicación y selecciona Action Drawer > Live Designer.
2. Haz clic en el botón Controls en el panel del calendario.
3. Haz clic en la pestaña Edge Case.
4. En la sección General, habilita la configuración Use 24-Hour Clock.
5. Navega a la vista de la aplicación y confirma la actualización.

Usa el control de color para cambiar el color de los eventos

1. Agrega una nueva columna a la Regla de Negocio del Calendario. Por ejemplo: ingresa '#000343' en el campo Columna o Expresión. Ingresa Color en el campo Alias.
2. Navega a la página del Calendario de tu aplicación y selecciona Action Drawer > Live Designer

3. Agrega un nuevo Control.

   • Selecciona Color para la Columna
   • Nombra el control Color
   • Selecciona Color para el Tipo de Control

4. Navega a la vista de la aplicación y confirma la actualización