Agendas plages libres

Les agendas plages libres permettent la réservation de ressources (salles, véhicules...) pendant une durée choisie par l’usager, à condition que cette réservation débute et se termine dans la même journée.

Ce type d’agenda présente beaucoup de similitudes avec les rendez-vous, à commencer par les vues calendaires, qui sont les mêmes.

Paramètres de réservation

Plusieurs réglages permettent de restreindre les plages horaires réservables :

• Par défaut, un créneau est sélectionnable toutes les 30 minutes, ce qui signifie que les heures de réservation sont proposées par tranche de 30 minutes. On peut modifier ce paramètre, par exemple si une salle peut être réservée pour une durée de 1h, 2h, etc. mais pas 1h30, on mettra 60 minutes.
• La délai minimum entre deux réservations permet de rendre non réservable un temps avant et après chaque réservation. Cela peut correspondre au temps de rangement d’une salle entre deux réservations successives.
• Il est possible de borner la durée d’une réservation en indiquant une durée minimale et/ou une durée maximale.

Ressources

Il est possible de créer plusieurs ressources, qui pourront être sélectionnées au moment de la réservation.

Gestion globale

Par défaut, l'agenda est créé en gestion globale des ressources, cela signifie que la configuration des plages horaires d'ouverture et des exceptions est commune à toutes les ressources.

Gestion unitaire

Mais il est possible de basculer en « Gestion unitaire des ressources » dans le menu burger. Chaque ressource peut alors être configurée indépendamment des autres, avec ses propres plages horaires et ses propres exceptions.

Paramétrage

Le reste du paramétrage est commun avec les agendas de type rendez-vous : https://doc-publik.entrouvert.com/admin-fonctionnel/prises-de-rendez-vous/rendez-vous/#parametrage

Exposer les créneaux horaires dans un formulaire

Les créneaux disponibles peuvent être exposés dans un champ de type plage horaire.

Quelques minutes après la création d’un agenda (ou après avoir cliqué sur « Actualiser les agendas » dans l'écran des sources de données), une source de données « Nom de l’agenda - Créneaux pour la ressource "Nom de la ressource" » est disponible pour chaque ressource et peut être utilisée dans le champ précédent.

Une autre source de données disponible est « Nom de l’agenda - Ressources ». Elle s’utilise dans un champ de type liste, pour permettre de sélectionner une ressource parmi celles disponibles dans l’agenda.

Une dernière source de données disponible est « Nom de l’agenda - Créneaux pour la ressource form_var_resource_raw ». En combinaison avec la source de donnée précédente, qui serait utilisée dans un champ avec pour identifiant « resource » (avec un seul « s »), elle permet d’afficher dynamiquement les créneaux de la ressource choisie.

Enregistrer une réservation dans l’agenda

Après sélection du créneau, la réservation s’effectue de manière analogue aux autres types d’agenda : https://doc-publik.entrouvert.com/admin-fonctionnel/prises-de-rendez-vous/enregistrement-dans-agenda/#enregistrer-un-rendez-vous-ou-une-inscription

Il est néanmoins nécessaire d’ajouter, dans les données du corps de la requête :

• start_datetime avec pour valeur {{ form_var_IDENTIFIANT-CHAMP_start_datetime }}
• end_datetime avec pour valeur {{ form_var_IDENTIFIANT-CHAMP_end_datetime }}

Modifier une réservation

Pour modifier une réservation, il suffit d'ajouter dans l'appel précédent le paramètre user_external_id, avec pour valeur {{ form_uuid }} et de passer le paramètre cancel_booking_id comme pour la modification d'un rendez-vous classique. À la première utilisation de cet appel, lors de la soumission du formulaire, cela permettra de lier la demande en cours à la réservation dans l'agenda. À la seconde utilisation, dans le cadre d'un formulaire de workflow ou d’une action « Édition », le créneau déjà réservé par l’usager apparaîtra libre dans le widget, permettant à l’usager de sélectionner librement un nouvel horaire.