Documentation #83001
Documenter l’intégration de deux nouveaux paramètres à passer lors de la réservation, presence_callback_url et absence_callback_url
0%
Description
Nous pourrions documenter "Possibilité de notifier une demande lors de la validation du pointage, cela passe par l’intégration de deux nouveaux paramètres à passer lors de la réservation, presence_callback_url et absence_callback_url." des notes de mises à jour du 13 avril 2023 sur
https://doc-publik.entrouvert.com/admin-fonctionnel/prises-de-rendez-vous/evenements/#pointage
- absence_callback_url : URL à appeler lorsque l’événement est marqué comme pointé, en cas d’absence
- presence_callback_url : URL à appeler lorsque l’événement est marqué comme pointé, en cas de présence
La documentation de référence sur l'API https://doc-publik.entrouvert.com/dev/api-agendas/chrono-fillslot/ a été mise à jour.
Le workflow doit avoir deux actions globales avec des appels externes pour identifiant "presence", "absence".
L'url a passer dans presence_callback_url serait {{form_api_url}}hooks/presence/.
L'appel au workflow se fait « lors de la validation du pointage » ça veut dire que le workflow est pas appelé au clic sur "present" "absent", seulement sur le clique de « marquer l'évènement comme pointé »
Historique
Mis à jour par Olivier Renard il y a 6 mois
- Sujet changé de Documenter à Documenter l’intégration de deux nouveaux paramètres à passer lors de la réservation, presence_callback_url et absence_callback_url
Mis à jour par Anaïs Ecuvillon il y a 6 mois
J'ai voulu mettre ça en place (pour un atelier que je prépare pour la semaine prochaine), mais j'ai pas vraiment compris comment faire, vous auriez l'url d'un WF qui fait ça, que je m'en inspire ?
De mon côté, mon WF : https://demarches-aecuvillon.test.entrouvert.org/backoffice/workflows/96/
Mis à jour par Olivier Renard il y a 6 mois
- dans l'appel webservice de réservation ajouter presence_callback_url avec pour valeur {{form_api_url}}hooks/presence/
- dans l'appel webservice de réservation ajouter absence_callback_url avec pour valeur {{form_api_url}}hooks/absence/
- dans le workflow ajouter l'action globale Présence, avec déclencheur "appel externe", avec pour identifiant presence
- dans le workflow ajouter l'action globale Absence, avec déclencheur "appel externe", avec pour identifiant absence
Un exemple sur https://demarches-orenard.test.entrouvert.org/backoffice/workflows/45/
(A noter que la documentation pourrait avoir une explication sur toutes les callback, dont cancel_callback_url)
Mis à jour par Anaïs Ecuvillon il y a 6 mois
Merci Olivier, j'avais correctement paramétré l'appel WS, mais je ne voyais rien car j'avais zappé d'ajouter une action dans l'action globale. Merci de ton aide.
Mis à jour par Pierre Cros il y a 5 mois
- Statut changé de Nouveau à Information nécessaire
- Assigné à changé de Pierre Cros à Olivier Renard
Avant de sortir ça de la page API et donc de l'usage développeur et donc de devoir faire du support fonctionnel dessus, j'aimerais qu'on soit sûr qu'on est sur quelque chose d'important. Je n'ai compris ni le cas d'usage ni l'utilisation.
Quel est le cas d'usage ?
Qu'est-ce qu'on doit mettre en face de absence_callback_url et presence_callback_url ?
Tu indiques la page de doc sur le pointage des événements mais en réalité c'est plutôt la page de doc sur l'usage avancée des agendas dans les WFs qui est concernée : https://doc-publik.entrouvert.com/admin-fonctionnel/prises-de-rendez-vous/workflow-agendas-avance/
Mis à jour par Anaïs Ecuvillon il y a 5 mois
ah j'ai, je peux répondre,
absence_callback_url : {{ form_api_url }}hooks/absence/
presence_callback_url : {{ form_api_url }}hooks/presence/
Le workflow où je l'ai implémenté : https://demarches-aecuvillon.test.entrouvert.org/backoffice/workflows/96/
Des idées de cas d'usage, renseigner une donnée de traitement avec l'info présence / absence pour les stats. Un peu comme pour les rdv, mais qui est gérée automatiquement par le pointage.
Autre idée, déclencher l'envoi d'un mail aux absents pour leur proposer de réserver un nouveau créneau (dans le cas de formation interne "obligatoire" par exemple).
Mis à jour par Olivier Renard il y a 5 mois
- Assigné à changé de Olivier Renard à Pierre Cros
exemple:
- les personnes pointées présentes à une formation, peuvent venir chercher leur composteur,
- les personnes pointées absentes sont invitées à s'inscrire à une autre formation.
Le cas d'usage est vraiment lié au pointage dans Chrono.
Oui cela peut être documenté dans la page que tu pointes (et nous pouvons ajouter des liens vers cette page ailleurs)
Mis à jour par Pierre Cros il y a 5 mois
- Statut changé de Information nécessaire à Fermé
Ok compris, merci à vous deux :
https://doc-publik.entrouvert.com/admin-fonctionnel/prises-de-rendez-vous/workflow-agendas-avance/#actions-depuis-lagenda