Paneles de Calendario¶

Un panel de calendario

Los paneles de calendario llenan un calendario con información de una fuente de datos, haciendo uso de tres tipos de control únicos: Descripción, Inicio del evento y Fin del evento. El control Descripción designa lo que aparecerá en el calendario y, por lo general, es un nombre de evento. Los controles Inicio del evento y Fin del evento designan el día en que aparecerá el evento y pueden incluir marcas de tiempo, que se mostrarán junto con la descripción del evento. Al igual que con los paneles de gráficos, los paneles de calendario se pueden vincular a otro panel para mostrar más detalles sobre el evento en el calendario.

De manera predeterminada, el panel de calendario se mostrará en función de los datos de la regla de negocio, respetando cualquier orden que se aplique en la regla de negocio. Revise su 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 los datos, es probable que desee agregar un orden a la regla de negocio.

Cómo Mostrar el Mes Actual en el Calendario¶

Para asegurarse de que el panel devuelva el mes, día o año actual, agregue una columna llamada Ordenar con un tipo lógico numérico y aplique un orden ascendente a esta columna. Por ejemplo, si el objeto comercial que respalda el panel de calendario tiene una columna llamada Fecha de inicio que desea utilizar y es una fuente de datos SQL, puede utilizar una función de escape SQL:

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

o an App Builder declaración IIF:

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

Para ver otros meses, haga clic en los botones de flecha hacia adelante y hacia atrás en la esquina superior izquierda del panel. Para alternar entre las vistas de día, semana y mes, haga 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 independiente que muestra los controles de eventos.

Cómo Cambiar la Fecha y Hora de un Evento¶

1. Seleccione el evento
2. En el panel que muestra la información del evento, haga clic en el ícono Lápiz
3. Ajuste la fecha y la hora según sea necesario, luego haga clic en la Marca de verificación para guardar

Cómo Agregar un Nuevo Evento al Calendario¶

1. Seleccione cualquier evento preexistente y haga clic en el botón Crear
2. Ingrese un título para el evento, seleccione una fecha del menú desplegable del calendario
3. Para los controles con hora y fecha habilitadas, haga clic en el ícono de Hora para que aparezca un reloj
4. Haga clic en la Marca de verificación para guardar
5. Después de realizar cualquier revisión al calendario, actualice la página y confirme las actualizaciones

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 la que se registran los pedidos en Northwinds.

Crear un Objeto Comercial para Utilizar con el Panel de Calendario¶

1. Crear una nueva regla de negocio
2. Dale un Nombre a la regla. Por ejemplo: Orden (Calendario)
3. Establezca el propósito en Calendario
4. Apunta a la tabla Orden
5. Haga clic en el botón Guardar
6. En la tabla Pedidos, haga clic para seleccionar las columnas OrderID y OrderDate
7. Haga clic en la pestaña Dónde. Agregue la columna FechaDePedido al campo Izquierdo. Elija NO ES NULO como Operador. Deje el campo Derecho en blanco.
8. Si lo desea, agregue una columna que admita la función Ordenar a la pestaña Columnas. Por ejemplo: DatePart(mm, O.OrderDate)

Crear el Calendario¶

1. Vaya a App Workbench > Agregar una página
2. Nombre la página Calendario de pedidos y haga clic en Crear
3. Seleccione el diseño de una sola columna, haga clic en Agregar panel
4. Seleccione Calendario
5. Ubique la regla de calendario y haga clic en Seleccionar
6. Haga clic en Personalizar página
7. Ingrese Calendario de pedidos como Nombre, seleccione Panel de calendario como Tipo y seleccione Mensual como Subtipo.

8. Agregue dos controles con las siguientes configuraciones:

   	Columna	Nombre	Tipo de uso
   Control n.° 1:	ID del pedido	Pedido	Descripción
   Control n.° 2:	Fecha del pedido	Fecha del pedido	Inicio del evento

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

Configurar los Eventos del Calendario para Enlace a Otra Página¶

1. Desde la página Calendario de tu aplicación, haz clic en Cajón de acciones > Diseñador en vivo
2. Haga clic en el botón Controles en el panel Calendario
3. Haga clic en el ícono Abrir registro para el control desde el que desea enlace.
4. En Actualizar y vincular, configure Enlace a página en Pedidos
5. Verifique que esté vinculado por OrderID en los Criterios
6. Navegue hasta la vista de la aplicación y confirme la actualización.

Utilice el Control de Color para Cambiar el Color de los Eventos.¶

1. Agregue una nueva columna a la regla de negocio del calendario. Por ejemplo: ingrese '#000343' en el campo Columna o Expresión. Ingrese Color en el campo Alias.
2. Navegue hasta la página Calendario de su aplicación y seleccione Action Drawer > Live Designer

3. Agregue un nuevo control.

   • Seleccione Color para la columna
   • Asigne al control el nombre Color
   • Seleccione Color para el tipo de control

4. Navegue hasta la vista de la aplicación y confirme la actualización