Cómo ver el calendario de un empleado
Consulta el calendario operativo de una persona de la ubicación seleccionada para revisar turnos, horarios derivados de servicio, vacaciones, bajas, cierres de ubicación y bloqueos de vacaciones aplicables según permisos.
En este artículo
En Marea Gran Via, un responsable puede abrir el calendario de Marta Ruiz para entender su cobertura semanal antes de tomar decisiones operativas.
La vista combina eventos propios del empleado con cierres o bloqueos compartidos que le afecten, siempre limitada por los permisos de vista del usuario.
Antes de empezar
- Tener seleccionadas la organización Grupo Marea Demo y la ubicación Marea Gran Via, o el contexto equivalente de trabajo.
- Contar con permisos de vista aplicables al calendario de empleados, como `staff-schedule:view`, `staff-shifts:view`, `vacation:view`, `staff-leave:view` o `vacation-blackout:view`.
- Abrir la pantalla con un `staffId` cuando se quiera consultar a una persona concreta, por ejemplo Marta Ruiz en el runtime ES.
Instrucciones
- 1.
Abre el calendario del empleado
Desde Calendarios, entra en Calendario de empleados y selecciona la persona que quieres revisar. También puedes abrir un enlace directo a `/:orgId/:locationId/calendars/staff/:staffId?`.
- 2.
Comprueba la vista inicial
La pantalla abre el calendario con el empleado filtrado. Si el enlace incluye `mode=week`, muestra la semana; si no recibe un modo válido, usa la vista mensual.
- 3.
Revisa los eventos del empleado
Lee los bloques como una combinación operativa de turnos, horarios de servicio asignados, vacaciones, bajas, cierres de ubicación y bloqueos de vacaciones que afecten al empleado.
- 4.
Interpreta etiquetas y ausencias
Usa las etiquetas localizadas para distinguir motivos: `Vacaciones` identifica vacaciones del empleado, `Baja` identifica ausencias por baja y `Cerrado por vacaciones` identifica cierres de ubicación.
- 5.
Cambia fecha, vista o refresca
Usa los controles del calendario para moverte por día, semana, mes o año. Cada cambio recalcula el rango visible y recarga los eventos necesarios; refrescar solo fuerza una nueva lectura.
- 6.
Entiende resultados vacíos
Si el empleado no existe o el enlace llega sin `staffId`, no aparece un error específico. El resultado puede quedar vacío o listar más datos de los esperados si no se envía filtro de empleado.
Validaciones y límites
- La pantalla necesita organización, ubicación y al menos un permiso de vista operativo; sin contexto o permiso muestra un estado de error y no carga eventos.
- Los modos aceptados son `day`, `week`, `month` y `year`; las fechas inválidas en `startDate` o `firstVisibleDate` se ignoran.
- El preset de empleado solicita `staff_shift`, `staff_schedule`, `staff_vacation`, `staff_leave`, `vacation_blackout` y `location_vacation`, pero la API solo devuelve los tipos permitidos para el usuario.
- Los horarios de servicio del empleado se omiten cuando ese día está cubierto por vacaciones o baja, y las vacaciones ficticias de prorrateo no se muestran como vacaciones reales.
- Si el endpoint `feed` falla de forma recuperable, la app usa el endpoint clásico de listado de eventos.
Resultado esperado
El responsable obtiene una lectura de consulta del calendario de un empleado concreto, sin crear ni modificar eventos.