Étude de cas · Grav et API métier
Publié le
Un site de formation présente des programmes, des dates et des modalités d’inscription. Le logiciel de gestion contient les informations nécessaires au traitement des demandes : formations, sessions, clients, participants et documents.
Pour relier ces usages, Codisys a développé un socle web associant le CMS Grav à un connecteur API Formadmin. Cette architecture est utilisée sur les sites OFCIS Formation et CAP CDO.
Le site exploite les données du logiciel pour présenter l’offre de formation. Les visiteurs peuvent ensuite consulter les sessions, demander un devis ou transmettre une préinscription. Voici comment les différentes parties de cette intégration s’articulent.
Répartir les rôles entre Grav et Formadmin
Grav prend en charge la présentation du site, sa navigation et ses contenus éditoriaux. Ce CMS s’appuie sur des fichiers pour organiser les contenus et sur le moteur de modèles Twig pour produire les pages. Son système de plugins permet d’ajouter des traitements adaptés au projet. La documentation Grav présente ces principes.
Dans cette réalisation, Formadmin fournit les données métier utilisées par les pages : informations pédagogiques, sessions, tarifs et éléments des dossiers clients.
Un plugin développé par Codisys assure la liaison. Il identifie la page demandée, appelle les modules nécessaires et transmet les données au thème graphique.
Cette répartition permet de faire évoluer la présentation du site tout en conservant les formations et les sessions dans leur environnement de gestion.
Un plugin pour relier les pages aux données métier
Le connecteur organise les traitements autour de routes et de contrôleurs. Une route correspond à une adresse du site : catalogue, fiche formation, sessions ou rubrique de l’espace client. Le contrôleur associé prépare les informations utiles à cette page.
Pour une fiche formation, le parcours technique suit plusieurs étapes :
- L’adresse demandée permet d’identifier la formation.
- Le module métier récupère sa fiche dans Formadmin.
- Il recherche les sessions associées.
- Les informations sont préparées pour l’affichage.
- Le modèle Twig construit la page.
Les fiches sont ainsi produites à partir des données récupérées par le connecteur, sans créer manuellement une page éditoriale complète pour chaque formation.
Le thème reste responsable de la mise en forme : organisation du programme, présentation des dates, informations pratiques et boutons de demande.
Alimenter les fiches formation et les listes de sessions
Le connecteur récupère plusieurs informations nécessaires à la présentation d’une formation :
- intitulé et référence ;
- objectifs, public et prérequis ;
- programme et méthodes pédagogiques ;
- durée et informations tarifaires ;
- modalités d’évaluation ;
- coordonnées de contact ;
- programme PDF lorsqu’il est disponible.
Les sessions ajoutent les dates, les lieux, les tarifs et les informations de disponibilité. Le traitement de la fiche prévoit également d’écarter les sessions marquées comme privées.
La fiche MAC SST de CAP CDO illustre cette articulation entre programme, sessions et accès aux demandes.
L’interface combine deux modes de chargement. Les fiches détaillées sont construites côté serveur. Les tableaux du catalogue et des sessions utilisent aussi des appels AJAX pour charger leurs résultats, avec une pagination traitée côté serveur.
Cette combinaison répond à des usages différents : consulter un programme détaillé ou parcourir une liste de formations et de dates.
Créer un devis inter depuis une session
Le raccordement comprend également des opérations d’écriture dans Formadmin.
Dans le parcours inter-entreprises examiné, un client connecté sélectionne une session et renseigne le nombre de participants. Le traitement récupère les informations du client, de la session et de la formation pour créer un devis dans le logiciel.
Il demande ensuite la génération des documents correspondants. Le devis et le programme peuvent être joints au message de confirmation, avec les conditions générales lorsqu’elles sont disponibles.
Ce parcours relie directement une action sur le site à un document commercial dans l’outil de gestion.
Les demandes intra suivent un fonctionnement différent dans le socle étudié : elles déclenchent un échange par email avec l’organisme. Leur traitement commercial peut ensuite être poursuivi par l’équipe administrative.
Cette distinction compte dans la conception des formulaires et des messages affichés : chaque demande doit annoncer clairement la suite du parcours.
Enregistrer une préinscription soumise à validation
Le parcours d’inscription permet de transmettre les informations d’un participant pour une session.
Le traitement vérifie notamment la disponibilité déclarée pour une session inter, crée la fiche du stagiaire et l’associe à la session dans Formadmin. Cette association est enregistrée avec un statut en attente de validation.
Le site propose donc une préinscription, dont l’organisme conserve la validation administrative.
Le traitement prévoit aussi la génération d’une fiche d’inscription et l’envoi de documents par email. L’équipe retrouve ainsi dans son logiciel les éléments nécessaires pour poursuivre le dossier.
La précision du vocabulaire fait partie du travail technique : le bouton, la confirmation et le statut enregistré doivent décrire la même action.
Prolonger le parcours dans un espace client
Le socle comprend des rubriques consacrées aux devis, aux sessions, aux inscriptions et aux informations du client.
Les contrôleurs de ces pages s’appuient sur les identifiants clients associés au compte connecté pour préparer les données à afficher. Selon la rubrique, les modules récupèrent les éléments commerciaux, les participants, les sessions ou les documents correspondants.
L’espace client prolonge ainsi les échanges commencés sur le site public.
Pour découvrir ces usages du point de vue d’un organisme de formation, la présentation de l’espace client Formadmin détaille le suivi des devis, des sessions et des documents.
Prendre en compte la dépendance à l’API
Une page connectée dépend aussi de la disponibilité du service qui lui fournit ses données.
Le connecteur comporte une authentification serveur par jeton, un renouvellement de ce jeton et des délais limites pour les appels réseau. Le plugin prévoit également des messages lorsque la configuration du raccordement est incomplète ou que Formadmin devient inaccessible.
Ces mécanismes font partie de la maintenance de l’intégration. Les évolutions doivent être vérifiées sur des parcours complets : consultation d’une formation, affichage des sessions, création d’un devis et transmission d’une préinscription.
Notre guide consacré à la connexion d’un logiciel métier à une API externe présente plus largement les sujets à cadrer pour ce type d’échange.
Prévoir le référencement des pages dynamiques
Le référencement nécessite lui aussi un travail spécifique lorsque les pages sont alimentées par une API.
Chaque fiche doit disposer d’une adresse stable, d’un titre descriptif et de métadonnées adaptées. Les liens internes doivent permettre de découvrir les formations. Les contenus chargés en JavaScript demandent une vérification de leur accessibilité aux moteurs.
Les balises canoniques doivent également rester cohérentes avec les URL que l’on souhaite indexer. Elles constituent un signal utilisé par Google pour choisir l’adresse représentative d’un contenu. La documentation Google sur les URL canoniques précise leur rôle.
Ces points sont à contrôler lors de la mise en place du site et après les évolutions du thème ou du connecteur.
Une réalisation à la croisée du web et du logiciel métier
Les projets OFCIS Formation et CAP CDO illustrent plusieurs dimensions d’un site connecté : présentation éditoriale, consultation du catalogue, échanges commerciaux et continuité avec la gestion administrative.
Le travail de développement consiste à faire correspondre chaque action du visiteur à un traitement identifié dans le logiciel, avec les données et les documents nécessaires.
Retrouvez notre approche des API, connecteurs et intégrations et des sites web connectés aux outils métier.