> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/documentations/efalia-doc/annexes/notes-de-version.md).

# Notes de version

{% updates format="full" %}
{% update date="2026-06-26" %}

## Canari 67

**En résumé**

* Conversion d'un document en PDF, désormais possible depuis une armoire et via l'API.

**Sécurité**

* Correction de trois vulnérabilités (CVE) dans la librairie Guzzle.
* Mises à jour de sécurité automatiques du système d'exploitation.
* Protection contre les attaques par force brute.

**Corrections de bugs**

* Les valeurs en double des métadonnées de type liste sont désormais supprimées automatiquement.
* Correction de la configuration du service de conversion PDF.

**API**

* Accès via clé publique étendu aux endpoints non-administrateur.
* Date d'expiration configurable pour les clés publiques.

**Front**

* Tri des résultats de recherche possible sur plusieurs valeurs simultanément.
* Possibilité de renvoyer un document d'un dossier vers une bannette.

**Infrastructure**

* Correction de la configuration du pare-feu applicatif (mod\_security2).
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-06-11" %}

## Canari 66

**Sécurité**

* Correction de vulnérabilités dans le framework backend (Symfony).
* Mise à jour de cinq composants concernés par des vulnérabilités CVE connues.
* Vérification systématique des CVE avant chaque libération de version.

**Corrections de bugs**

* L'édition en ligne OnlyOffice est de nouveau fonctionnelle dans les environnements derrière un proxy.
* La connexion via Efalia Login est rétablie après le remplacement des ports de l'API par un proxy.

**API**

* La prévisualisation et un fichier d'OCR peuvent être précisés lors de l'upload d'un document.
* Les informations du coffre sont exposées pour les documents archivés.
* Suppression des ports dédiés à l'utilisation de l'API (accès via proxy).

**Front**

* Gestion d'un nom d'affichage pour les utilisateurs sans nom renseigné.

**Infrastructure**

* Création automatique d'un compte administrateur à l'installation.
* Documentation améliorée sur les interactions entre les services de la suite.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-05-20" %}

## Canari 65

**En résumé**

* Interface disponible en espagnol, avec révision de l'ensemble des traductions existantes.

**Corrections de bugs**

* Correction de lenteurs et blocages sur certaines listes déroulantes (consommation mémoire du navigateur).
* Interception correcte des erreurs HTTP lorsque l'en-tête n'est pas disponible.
* La génération de la prévisualisation est relancée automatiquement après un échec mémoire.

**API**

* Possibilité de forcer le changement de mot de passe à la création d'un compte administrateur.

**Front**

* Amélioration des temps de chargement de l'interface (lazy loading).
* Suppression d'un outil de tracking tiers (Mixpanel).
* Poursuite de la migration vers Angular 21.

**Infrastructure**

* Correction d'une saturation mémoire possible lors de la migration d'infrastructure.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-04-17" %}

## Canari 64

**En résumé**

Release de stabilisation.

**Corrections de bugs**

* Correction de la prévisualisation.
* Correction d'une erreur de logique dans l'allotage des documents d'une demande d'archivage.

**API**

* Accès via clé publique étendu aux endpoints des armoires.

**Front**

* Mise à jour Angular 21.

**Infrastructure**

* Configuration NTP (synchronisation de l'horloge système).
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-04-13" %}

## Canari 63

**Corrections de bugs**

* Correction de la surcharge d'Elasticsearch lors de la réindexation des documents et des dossiers.
* Meilleure remontée de l'erreur de format lors du listing des utilisateurs MGLogin.

**API**

* Nettoyage des fichiers en cas d'échec de duplication d'un document.
* Messages d'erreur HTTP plus explicites.
* Accès via clé publique étendu aux endpoints des bannettes.

**Front**

* Mise à jour Angular 20.
* Mise à jour de la licence Kendo.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-03-26" %}

## Canari 62

**En résumé**

* Premières briques de l'archivage documentaire : paramétrage de l'archivage (DUA/DUC) au niveau d'un gabarit de document, puis consultation et prévisualisation des documents archivés directement dans un dossier.

**Sécurité**

* Mise à jour de `symfony/process` corrigeant un risque de sécurité.

**Corrections de bugs**

* La prévisualisation reflète correctement la mise à jour des messages.
* Les documents sont désindexés de la recherche après leur archivage.
* Contrôle de l'intégrité d'un document après classement ou modification.
* La recherche rapide sur une métadonnée de type liste vérifie la validité de l'identifiant sélectionné.
* Meilleure gestion de l'indisponibilité des services tiers et des erreurs d'écriture sur le disque.

**API**

* Règle DUC paramétrable sur la date de création des documents.
* Consultation du binaire et prévisualisation des documents archivés (avec vérification du type d'utilisateur).
* Montée de PHP en version 8.5.
* Validation du format des utilisateurs renvoyés par MGLogin.

**Front**

* Écran de paramétrage de l'archivage (DUA/DUC) pour un gabarit de document.
* Affichage des documents destructibles ou archivables et de la liste des documents archivés dans l'arborescence d'un dossier.
* Prévisualisation d'un document archivé dans un dossier.

**Infrastructure**

* Communauté SNMP paramétrable via une variable d'environnement.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-02-24" %}

## Canari 61

**En résumé**

* Prévisualisation des plans AutoCAD (format DWG) directement dans la GED, sans licence AutoCAD ni logiciel tiers.
* Personnalisation de l'ordre des colonnes dans les résultats de recherche, mémorisée automatiquement pour les sessions suivantes.
* Archivage automatique au niveau d'un dossier : les administrateurs fonctionnels peuvent activer des indicateurs d'archivage (DUC/DUA) sur les dossiers pour forcer l'archivage de tous les documents qu'ils contiennent.

**Corrections de bugs**

* Les caractères spéciaux dans les noms des modèles de recherche s'affichent correctement (plus d'encodage visible).
* Le champ de recherche reste visible lors d'imports depuis des bannettes volumineuses (600+ éléments).
* La synchronisation LDAP fonctionne désormais pour les organisations de plus de 1 000 utilisateurs.
* La configuration du proxy HTTP est correctement appliquée dans les déploiements derrière un proxy HTTPS.

**API**

* Harmonisation du format de données de l'API d'archivage (DUC/DUA).

**Infrastructure**

* Documentation améliorée pour les installations hors ligne.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2026-01-29" %}

## Canari 60

**En résumé**

* Possibilité d'enregistrer des critères de recherche dans un modèle, afin de pouvoir relancer rapidement la recherche depuis une armoire.
* Optimisation de la vue des résultats d'une recherche multicritères : les utilisateur·rice·s peuvent désormais ordonner les colonnes dans l'ordre qu'ils souhaitent afin de faire apparaître en premier les métadonnées qui les intéressent.

**Corrections de bugs**

* Les balises HTML ne sont plus interprétées dans le nom des documents.

**API**

* Identification avec une clé publique et impersonification d'un utilisateur.
* Ajout d'un feature flag pour la fonctionnalité d'archivage.
* Possibilité de paramétrer une règle DUC à partir d'une métadonnée d'un gabarit de document.

**Front**

* Les colonnes peuvent être réordonnancées dans la page de résultats de recherche.
* Enregistrement de l'état du tableau de résultat d'une recherche par formulaire dans la personnalisation.
* Possibilité d'enregistrer les modèles de recherche.

**Infrastructure**

* Modification du script principal de déploiement.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-12-15" %}

## Canari 59

**Corrections de bugs**

* Suppression des anciennes sourceslist de NodeJS.
* L'auto-complete s'affichait lors de la suppression de la saisie via la croix dans la recherche contextuelle.
* Problème de rafraîchissement lors de la sélection d'un dossier dans la duplication de document.

**API**

* Ajout de la pagination dans la synchro LDAP.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-12-15" %}

## Canari 58

**Corrections de bugs**

* Fix des tests d'intégration de la suite.
* Application de la limite de caractère sur l'ensemble de la recherche rapide au lieu d'être par mot clef.
* Fix test E2E en CI.
* Fix du bug de l'impossibilité de modifier une métadonnée optionnelle si des documents sont classés dans le gabarit.
* Recherche rapide contextuelle.
* Fix récupération du proxy pour l'appel au QG avant une mise à jour.

**API**

* Fix random fail sur les tests de recherche rapide de document.
* Recherche rapide contextualisée par dossier ou armoire.
* Mise à jour Symfony 7.3.
* Mise à jour de PHP CS Fixer.
* Endpoints des clés publiques.
* Mise à jour PHP 8.3 et Symfony 7.4.
* Ajout du fichier de config `api/config/reference.php` généré depuis Symfony 7.4.

**Front**

* Mise à jour des liens vers le nouveau site Efalia.
* Message de consultation de document d'un dossier lié.
* Outillage pour test volumétrie front.
* Ajout du contexte dans la recherche rapide.

**Infrastructure**

* Mise à jour en ES 9.1.
* Mise à jour de Tika.

**Autres**

* Fix typo : administration → administration.
  {% endupdate %}

{% update date="2025-10-22" %}

## Canari 57

{% hint style="warning" %}
⚠️ **Attention :** cette montée de version nécessitera un temps de mise à jour long car elle implique une réindexation de toutes les données de la recherche rapide.
{% endhint %}

**Corrections de bugs**

* Fix sensitivestring dans creerbannette.
* Suppression de validator sur les input number.
* Correction des tests d'intégration après ajout d'expander dans l'administration.
* Fix fuite de mémoire lors de l'indexation des documents.
* Fix syntax des tests d'intégrations.

**API**

* Déclaration atomique OpenAPI.
* Correction définitions OpenAPI invalides.
* Fix des tests de recherche sur les valeurs des enums des métadonnées.
* Ajout de la réindexation de la recherche rapide dans la Canari 57.

**Front**

* Ouverture des actions par lot (téléchargement) aux documents des dossiers liés dans un dossier.
* Augmentation du nombre de documents maximum à uploader en drag-n-drop en bannette (limite de 20 documents).

**Autres**

* Tests E2E de l'affichage du classement pour un document pré-classé en bannette.
* Implémentation des tests E2E sur la gestion des valeurs de métadonnée de type liste dans l'administration.
* Tests E2E sur le renommage en lot de documents en bannette.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-10-15" %}

## Canari 56

{% hint style="warning" %}
⚠️ **Attention :** cette montée de version nécessitera un temps de mise à jour long car elle implique une réindexation de toutes les données de la recherche rapide.
{% endhint %}

**Corrections de bugs**

* Fix métadonnées manquantes pour les documents pré-classés.
* Utilisation sudo pour supervisor.
* Remplacement du système de validation des requêtes via la définition OpenAPI.
* Optimisations pour des dossiers volumineux.
* Fix test de la recherche dans une liste de valeur d'un enum d'une métadonnée.
* Ajout de la gestion du port 389 pour le LDAP de Doc.

**API**

* Mise à jour des dépendances Innmind.
* Ajout du support de la prévisualisation des `.rtf`.
* Amélioration de la recherche.
* Documentation volumétrie.
* Refacto de la gestion du typage des valeurs des métadonnées.
* Réactivation du shrinking.
* Wrapping et caviardage des données sensibles pour s'assurer de la confidentialité dans Sentry.
* Optimisation de la suppression des bannettes, gabarits de documents/dossiers et liens entre dossiers.
* Ajout de la possibilité de rendre une métadonnée obligatoire si toutes ses valeurs sont renseignées.
* Fix la non prise en compte du status code dans la validation des réponses.
* Ajout du logging des requêtes SQL pour les environnements de dev et de test.
* Suppression endpoint qui liste les documents dans les dossiers liés d'un dossier.
* Optimisation de la récupération des bannettes et des gabarits de documents.
* Restructuration du mapping Elasticsearch.
* Ajout d'un index sur le nom du document dans le mapping ES.
* Simplification gestion des requêtes.
* Optimisation récupération gabarit de dossier et gabarit de document.
* Suppression de la limite des 500 documents/dossiers dans un gabarit pour l'ajout/suppression d'une métadonnée.
* Utilisation d'une Specification pour vérifier si une métadonnée est utilisée dans un lien vers un gabarit de dossier avant suppression.
* Ajout d'un warning dans la description OpenAPI des routes déclenchant une réindexation massive.

**Front**

* Refonte flex.scss pour pouvoir utiliser les classes de largeur `.wf`.
* Réduction de la taille du QRCode de 10%.
* Duplication rapide d'un ou plusieurs documents dans un dossier lié.
* Gestion des rôles par l'écran administration utilisateur.
* Test E2E de tri de document d'un dossier.
* Amélioration du centrage du QRCode sur la page.
* Ajout d'un expander dans l'administration des gabarits de dossier.
* Affichage de la description de la métadonnée dans le formulaire de recherche.

**Infrastructure**

* Utilisation de Docker dans Vagrant.
* Finalisation du nouvel environnement de dev via Docker.
* Mise à jour de NodeJS 24.
* Lancement de supervisor sans "sudo".
* Gestion de Traefik pour gérer tous les ports.
* Déploiement des branches : fichier de logs spécifique par build.

**Autres**

* Implémentation des tests sur la duplication des documents depuis un dossier.
* Implémentation des tests E2E sur la fonctionnalité de mise en favori d'un document.
* Implémentation des tests E2E sur la gestion des rôles depuis l'administration d'un utilisateur.
* Implémentation des tests E2E sur la génération des QR codes.
  {% endupdate %}

{% update date="2025-08-22" %}

## Canari 55

**Corrections de bugs**

* Fix de Ng Select Dossier lors d'une recherche de dossier.
* Fix de l'erreur lors du classement d'un document en bannette depuis un dossier avec un document pré-classé.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-08-22" %}

## Canari 54

**Corrections de bugs**

* Désactivation de la vérification du nom des documents stockés en BDD.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-08-18" %}

## Canari 53

**Corrections de bugs**

* Erreur JS « undefined reading firstChange ».
* Affichage du nom de fichier.
* OpenAPI : paramètres range.
* Typage Blackbox.
* Statut Elasticsearch.
* Rotation PDF.
* Vérification des droits en recherche rapide.
* Erreur 500 au logout.
* Scripts de mise à jour.
* Ouverture d'un dossier depuis la recherche.
* Lancement d'ES dans Docker.
* Partage Teams.
* Lenteur sur les habilitations.
* Upload : conformité du nom de fichier.
* Lenteur sur les dossiers contenant de nombreux documents.
* Random fail en CI.

**API**

* Contraintes de verrouillage/suppression lors de la duplication.
* Exemple de champ OpenAPI.
* Pagination.
* Tests volumétrie.
* Génération de gros fichiers.
* Récupération des binaires.
* Variables d'environnement.
* CI périodique.
* Temps des transactions.
* ADR import en masse.

**Front**

* Navigation clavier dans la recherche rapide.
* Duplication de documents depuis un dossier.
* Entrées de numérisation par code-barre.
* Génération des intercalaires QR codes.

**Infrastructure**

* Génération des domaines localement.
* Notification de déploiement.
* Téléchargement de Tika.
* Suppression des patchs Apache.
* Mise à jour d'Elasticsearch.
* Dispatch manuel du workflow de volumétrie.
* Gestion Elasticsearch.

**Autres**

* Tests d'intégration.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-07-10" %}

## Canari 52

**Corrections de bugs**

* Formatage des paramètres de suppression intermédiaire.
* Prévisualisation en attente.
* Téléchargement et prévisualisation des documents versionnables.
* Entrées chronologiques du journal fonctionnel.
* Random fail HabilitationTest.
* Hauteur du panel coffre.
* Pagination incohérente.
* Indexation après annulation de suppression.
* Mise à jour impossible.

**API**

* Endpoint de prévisualisation de version.
* Intégration BlackBox.
* Nouvelle suite de tests API.
* Commande de génération de fichiers volumétrie.
* Suppression intermédiaire à la racine d'une armoire.
* Délai de suppression configurable.
* Bannettes : génération.
* Information sur la suppression intermédiaire dans ES.
* Renommage suppression intermédiaire.
* Test des gabarits de documents.
* Parallélisation.
* LDAP tests.
* Variables d'environnement.
* Archive volumétrie.

**Front**

* Message informatif lors de la connexion au QG.
* Suppression intermédiaire des documents.
* Déconnexion en cas d'erreur de configuration.
* Rafraîchissement du résultat de recherche avancée.
* Suppression intermédiaire par lot.
* Nettoyage de la recherche rapide.

**Infrastructure**

* Build des branches.
* Passage Elasticsearch 8 → 9.
* Instance PR label front.
* HTTPS manifeste.
* Modification du script d'installation.

**Autres**

* Lien Teams sur un document.
* Affichage de la découpe PDF.
* Commande de génération de données volumineuses.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-05-22" %}

## Canari 51

**Corrections de bugs**

* Fix génération du routing qui ne prend pas en compte les requirements.
* Fix bug de deadlocks DB lors de l'indexation.
* Fix scrolling dans PDFTron.
* Les vignettes ne se généraient plus dans la découpe PDF.
* Fix regression de la commande `load-db`.
* Correction du chargement de PDFTron.

**API**

* Purge du journal des tâches pour les tâches en succès de plus d'un mois.
* Refacto test RechercherDocumentArchives.
* Utilisation des `Effect`s pour fusionner les dossiers.
* Optimisation du processus de stockage des documents.
* Exposition du `nom` dans les `Version`s de `Document`s.

**Front**

* Création et utilisation du nonce.

**Autres**

* Optimisation de la modification et de la suppression de métadonnées de gabarit.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-04-25" %}

## Canari 50

**Corrections de bugs**

* Fixe la date des dossiers consultés non entière pour tous les contextes (gain ou perte de ms dans un jour).
* Changement des icônes pour la fonctionnalité de pleine largeur dans le dossier.
* Fix reset du filesystem dans les tests.
* Le splash screen était toujours présent dans le DOM.
* La numérisation n'est pas proposée si la bannette est vide.
* Fix "random fail" sur le test `RechercherDocumentArchives`.
* La recherche rapide simplifiée bogue quand le résultat doit afficher des documents issus de bannette.
* Le rafraîchissement de l'affichage de la personnalisation ne se faisait parfois pas.

**API**

* Maj dépendances.
* Changement de nom de la méthode de test d'écriture dans le journal fonctionnel.
* Versionning document bannette.
* Ajout du feature flag pour la recherche rapide simplifiée.
* Dupliquer un document classé dans un dossier.
* Lister les noms de documents archivés à partir d'un dossier.
* Ajout du support des clefs API avec et sans impersonnification sur le endpoint de reclassement.

**Front**

* Mise à niveau de la configuration d'OnlyOffice pour la version 5.4 du composant OnlyOffice Angular.
* Système de sélection utilisateur avec recherche via API.
* Affichage de recherche rapide "simplifiée".
* Ajout d'un document en favoris.

**Infrastructure**

* Augmentation du fichier de swap.

**Autres**

* Tests sur la personnalisation.
* Mise à jour de la documentation pour le suivi des prérequis à la libération d'une révision.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-04-01" %}

## Canari 49

**Corrections de bugs**

* Fix de la mise à jour manquante du dossier lors de la suppression d'un document classé.
* Fix de l'anonymisation d'Efalia Process dans le tracking.
* Suppression du chargement dans le DOM du quickpanel de Fuse.
* Améliorations de l'affichage des libellés longs.
* Fix OpenAPI.
* Fix du bug du listener `EndpointExperimental`.
* Fixe la date des dossiers consultés non entière.

**API**

* Demande de suppression intermédiaire d'un document.
* Ajout indirection classer avec métadonnées.
* Ajout flag experimental OpenAPI.
* Restauration document archivé.
* Information de l'état de connexion avec le QG.
* Ajout des URLs des dossiers pour Efalia Capture.
* Optimisation de `make static`.
* Utilisation de BlackBox 6.
* Recherche rapide document archivé.
* Ajout header experimental dans les réponses.
* Optimisation de la validation OpenAPI des requêtes.
* Simplification de l'accès aux valeurs par défaut d'une route.
* Ajout fixtures bannettes.

**Front**

* Migration Angular 18.
* Migration Angular 19.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-04-01" %}

## Canari 47 & 48

**Canari 47**

* Fix precheck vérification de l'existence de la table.

**Canari 48**

**Corrections de bugs**

* Correction de la config MySQL pour conserver la résolution de nom.
* Annulation du blocage des mises à jour pour les doublons des options possibles.

**API**

* Remontée du nombre de doublons des options possibles dans la notification de déploiement.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-03-11" %}

## Canari 45 & 46

**Corrections de bugs**

* Mise à jour de `innmind/immutable` pour corriger des problèmes de deferred `Set`.

**API**

* Lister documents d'un dossier et dossiers liés.
* Prévention de la duplication des options possibles dans les gabarits.
* Migration : ajout d'un index pour `documents.creeLe`.
* Échantillonnage DUA.

**Front**

* Utilisation du nouveau compilateur front.
* Enregistrement dans la personnalisation du tri de l'arborescence de dossier.
* Recherche données système pour un gabarit de document.
* Améliorer l'affichage des noms de documents et dossiers dans l'application.

**Autres**

* Ajout de toutes les PRs dans les release notes.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-02-25" %}

## Canari 43 & 44

**Canari 43**

**Corrections de bugs**

* L'ordre de tri par date de l'arborescence ne fonctionne pas.
* Fix duplication des `optionsPossibles`.

**API**

* Finalisation de la migration OpenAPI.

**Front**

* Mise à jour PDFTron 11.2.0.

**Infrastructure**

* Mise en place de HTTP2.
* Optimisation de la configuration MySQL.

**Canari 44**

**Corrections de bugs**

* Le document était rechargé dans la visionneuse lors de l'application d'un nouveau tri sur l'arborescence de dossier.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-02-19" %}

## Canari 42

**Corrections de bugs**

* Modification du test ValiderDemandeSansTousSesDocuments.
* Fix random fail test `ModifierMetadonneesDUnDocumentVerrouille`.
* Le menu principal n'est pas cliquable sur les petits écrans.
* Fix de la découpe PDF dans un dossier.

**API**

* Commentaire additionnel dans les fixtures.
* Ajout des fixtures pour les démonstrations du parcours de numérisation.
* Refacto recherche sur les données système des documents.
* Ajout des fixtures pour le connecteur Iodas.
* Fix des identifiants externes des fixtures du connecteur Iodas.
* Ajout d'une commande Makefile de mise à jour des JS de Redoc et Scalar.
* Refacto demande archivage DUA.
* MySQL : utilisation user non-root.

**Front**

* Découpe lors de l'import d'un document dans un dossier.
* Gestion du tri dans les dossiers.

**Infrastructure**

* Nettoyage des anciens noyaux.
* Log Apache en JSON + séparation logs API/front.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-01-27" %}

## Canari 41

**Corrections de bugs**

* Le plan de classement est incomplet lors du déplacement d'un document.
* Fix preview PDF affichant parfois un écran noir.
* Fix entrée invisible dans le menu utilisateur.
* Fix du crash sur une recherche par formulaire dans un dossier sur une métadonnée numérique avec une valeur au format `string`.
* Le spinner de la liste des favoris restait affiché quand celle-ci était vide.

**API**

* Ajout de `maxLength` pour les `/api/utilisateurs`.
* Demande archivage DUA.
* Recherche sur les données systèmes d'un document.

**Front**

* Test E2E de la découpe PDF.
* Workaround pour détection CVE pdf.js.
* Liste des dossiers favoris en page d'accueil.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2025-01-10" %}

## Canari 40

**Corrections de bugs**

* Gestion pour que Sentry ignore les erreurs taguées comme telles.
* Mise en forme du nom de dossier dans les derniers dossiers consultés.
* Détection de l'IP v6 pour la configuration SNMP.
* Fix mise à jour des métadonnées d'un document préclassé après ajout de métadonnées à un gabarit.
* Fix augmentation du timeout pour le controller de synchronisation MgLogin.

**API**

* Ajout des fixtures E2E.
* Refacto ajout d'une méthode `TestCase::assertResponseStatusCode`.
* Remonter le nombre d'utilisateurs actifs dans la notification de déploiement d'une instance.

**Front**

* Fix pdf.js CVE-2024-4367.

**Infrastructure**

* Installation de "unoserver" via un paquet Python local.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-12-18" %}

## Canari 39

**Corrections de bugs**

* Fix erreur linter suite au merge de la PR des derniers dossiers consultés en page d'accueil.
* Fix modification impromptue du datastore dans les derniers dossiers consultés de la page d'accueil.
* Empêcher la modification des métadonnées d'un document verrouillé par un autre utilisateur.

**Front**

* Ajout des derniers dossiers consultés sur la page d'accueil.
* Adaptation taille recherche.
* Augmentation des timeouts front pour les routes retournant des documents.

**Infrastructure**

* Suppression de l'installation de Composer en env de prod.
* Correction de l'envoi des fichiers map du front à Sentry.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-12-11" %}

## Canari 38

**En résumé**

* Importer un ou des documents dans un dossier depuis une bannette avec classement rapide.
* Mettre en gras des métadonnées pour notamment une meilleure visibilité des dossiers liés.

**Corrections de bugs**

* Fix de la documentation OpenAPI de la personnalisation de la page d'accueil.
* Changement du chemin du fichier manifeste.json dans les scripts Ansible.
* Fix sélection multiple de valeurs d'un filtre sur un dossier.
* Correction de droit dans la config de MySQL et du logrotate.
* Correction de "apt-key" derrière un proxy HTTP.
* Configuration de la release dans Sentry.
* Corrections OpenAPI.
* Ajout d'un index MySQL sur la table des journaux.
* Correction de la persistance des modifications des catégories de gabarit de document.
* Précision dans la doc de l'API concernant des champs optionnels mais parfois obligatoires.
* Suppression de la visualisation de l'état système.
* Ajout d'un index MySQL sur la table du journal des tâches.
* Fix fuite de mémoire dans la gestion des autorisations.

**API**

* Finalisation de la migration de Doctrine vers Formal.
* Mise à jour Symfony 7.1.
* Lister demande archivage.
* Simplification API `Personnalisation`.
* Optimisation gestion demande archivage.
* Valider/annuler une demande d'archivage.
* Nettoyage des GitHub actions.

**Front**

* Ajout du classement rapide lors de l'import de document issu d'une bannette dans un dossier.
* Gestion du gras dans le nommage dynamique.
* Indépendance du composant thumbnail du découpeur PDF.

**Infrastructure**

* Suppression de Node en prod.
* Suppression du téléchargement des collections Ansible.
* Mise en place des archives de l'application.
* Installation/mise à jour sans connexion internet.
* Création d'archive pour installer l'application sans internet.
* Suppression des anciennes releases précédemment déployées.
* Ajout des fichiers source map JS dans les releases Sentry.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-11-04" %}

## Canari 37

**En résumé**

* La découpe de PDF est disponible depuis la bannette.
* Le parcours de numérisation évolue et permet de faire de l'import multiple en bannette pour gagner du temps dans les indexations.
* Les APIs continuent d'évoluer pour permettre les configurations du cycle de vie sur les documents.

**Corrections de bugs**

* Amélioration de la découpe PDF.
* Fix préclassement liste vide.

**API**

* Ajout de la propriété `idExterne` manquante.
* Migration OpenAPI des routes `Armoires`.
* Fix charset et collation pour l'entité `Archivage\Document` (DUA/DUC).
* Génération demande archivage (DUA/DUC).
* Sauvegarder et consulter la personnalisation de la page d'accueil d'un utilisateur.

**Front**

* Import en lot de documents d'une bannette depuis un dossier.
* Découpe PDF.
* Externalisation de la lib de découpe PDF.

**Infrastructure**

* Fix du dockerfile.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-10-10" %}

## Canari 36

**En résumé**

Release de stabilisation suite à la Canari 35 — fix sur la recherche utilisateur.

**API**

* Ajout d'index sur les clés des permissions des dossiers et des documents en BDD.
* Entité `Archivage\Document`.
* Possibilité de récupérer un utilisateur par ID.

**Infrastructure**

* Utilisation d'un rôle Ansible pour redémarrer le serveur.
* Génération de la liste des domaines utilisés lors d'une installation.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-10-02" %}

## Canari 35

**Corrections de bugs**

* Fix problème de fermeture lors d'un multi-renommage.
* La sélection par lot ne pouvait plus être désactivée dans un dossier.
* Fix mise à jour DDL des filtres d'accès dans les infos dossier.

**API**

* Ajout de fixtures additionnelles pour Complement Info.
* Ajout filtre synchro LDAP.
* Corrections "filtre LDAP".
* Route de récupération des informations sur l'état du `stockage`.
* Configuration `DUA` sur les gabarits de document.
* Migration vers Formal des Liens et des Catégories.
* Hardcoding de tous les UUIDs dans les fixtures pour faciliter les tests d'intégration avec Workey.
* Fix gestion des erreurs à l'identification d'un utilisateur MGLogin.
* Suppression de la vérification de l'accessibilité des domaines à la demande de mise à jour automatique.

**Front**

* Recherche d'un utilisateur dans l'administration des utilisateurs.
* Ajout du lien de la documentation API pour les administrateurs.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-07-26" %}

## Canari 33

**Corrections de bugs**

* L'icône Corbeille de suppression d'une valeur de filtre d'accès ne devrait pas apparaître dans l'administration.
* Fix vérification que le document est modifiable pour pouvoir attacher un processus.
* Fix test sur les filtres d'accès.
* Fix des erreurs `429` remontées par Elasticsearch.
* Correctif suite à la redirection après un reclassement.

**API**

* Amélioration de l'interface de réindexation pour faciliter la lecture lors des déploiements.
* Refacto structure métadonnée enum valeur.
* Migrations de la persistence des utilisateurs vers Formal.
* Ajout `IdExterne` dans les `OptionDisponible`s.
* Vérification que certains domaines sont accessibles avant de lancer une maj.
* Mise à jour blackbox qui améliore le shrinking.
* Exécution de tous les tests API même dans les PR.
* Refacto – renommage `Enum` → `OptionSelectionnee`.
* Deprecate de la liste des gabarits de documents dans un gabarit de dossier.

**Front**

* Passage de Material Icons à Material Symbols.
* Gestion ID externe sur les listes de valeur.
* Reclassement d'un document sans contrainte.
* Vérification des droits d'upload dans un dossier.

**Infrastructure**

* Correction de la migration vers Debian 12 pour les anciennes instances.
* Redémarrage du serveur pour mise à jour du noyau Linux.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-06-21" %}

## Canari 31

**En résumé**

* Amélioration de l'expérience en bannettes avec l'ajout d'une nouvelle fonctionnalité de filtre de bannette.
* Possibilité de reclasser des documents par API dans le cas d'une erreur lors de la saisie du gabarit.
* Interfaces retravaillées sur les dossiers liés dans le cadre de dossier vide pour plus de lisibilité.

**Corrections de bugs**

* Fix recherche formulaire sur les métadonnées numériques utilisant des float.
* Prévisualisation de document Office.
* Fix indexation après renommage d'un document.
* Fix du dossier utilisé pour stocker l'ancien fichier OpenAPI.
* Fix tests de recherche de document dans une bannette.
* Fix validation de l'OpenAPI en production.
* Fix message journal.
* Fix génération de valeur qui peuvent être castées en booléen.
* Fix d'un problème de redirection URL quand l'utilisateur arrive sans historique.
* Renommage d'une migration dont la date était impossible.
* Suppression des anciennes tables de données qui empêchent les suppressions.
* Test d'intégration : fix fermeture de la popup OnlyOffice.

**API**

* Remplacement de la documentation informelle `Impersonification` par une spécification OpenAPI.
* Refacto formal ORM filtre accès.
* Recherche rapide documents dans bannettes.
* Refacto OpenAPI.
* Migration opération OpenAPI modification/suppression d'une armoire.
* Reclassement document.

**Front**

* Migration de la nouvelle syntaxe des control flow d'Angular 17.
* Affichage des dossiers liés à l'ouverture du dossier même vide.
* Ajout d'un filtre de recherche dans les bannettes.
* Document préclassé : seconde ligne en bannette.
* Refactorisation et harmonisation de la gestion du contexte d'affichage.

**Infrastructure**

* Automatisation de la libération de canari.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-06-05" %}

## Canari 30

**En résumé**

Stabilisation de l'application et amélioration des performances de la recherche.

**Corrections de bugs**

* Correctifs sur les bugs d'affichage suite à la maj Angular Material.
* Fix commande de comptage des métadonnées orphelines.

**API**

* Refacto formal ORM habilitation.
* Conservation des champs `droits` legacy.
* Changement du stockage des métadonnées.
* Appliquer le filtrage des droits directement en SQL.
* Compter et lister le nombre de tâches asynchrones en attente par type.
* Utilisation de la base de données pour la recherche par formulaire.
* Lazy loading des `Command`.
* Gestion erreurs additionnelles.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-05-15" %}

## Canari 29

**En résumé**

Thématique clef : volumétrie de documents. Ajout de la pagination sur les listes de dossiers, documents, utilisateurs et entrées des journaux.

{% hint style="info" %}
💡 **API paginées :** les endpoints de listes (dossiers, documents, entrées de journaux) retournent désormais 1 000 résultats par page. Sans utilisation de la pagination, 1 000 résultats maximum seront renvoyés.
{% endhint %}

**Corrections de bugs**

* Fix recherche dossier retourne une `400` si la valeur recherchée est `null`.
* Ajout de la pagination sur les listes de dossiers, documents, utilisateurs et entrées des journaux.
* Mise à jour des paquets.

**API**

* Ajout du type `idExterne`.

**Front**

* Gestion du champ ID externe pour les différents conteneurs et les métadonnées de gabarit.

**Infrastructure**

* Ajout d'une documentation pour augmenter la taille des partitions.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-05-15" %}

## Canari 28

**Corrections de bugs**

* Fix sur la sauvegarde des tâches de prévisualisation en cas d'erreur.
* Fix crash de la recherche par formulaire.

**Infrastructure**

* Mise à jour des paquets Debian à la mise à jour de l'instance.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-04-19" %}

## Canari 27

**Corrections de bugs**

* Fixes front divers.
* Fix regénérer résultat de recherche en cas de retour arrière navigation après fusion de dossier.
* Fix crash de la liste des documents d'un gabarit.
* Fix scroll sur la liste des rôles administrateurs.
* Fiabilisation du test de l'affichage des boutons au survol d'un utilisateur dans l'administration.
* Suppression des backports Debian lors de la MAJ en Debian 12.
* Refacto de la génération des tâches asynchrones.
* Upgrade Symfony 7.
* Fix état connexion CCFN.
* Correction du type du champ "id" d'un processus dans la doc API.
* Ajout commande pour générer le SQL pour créer les tables d'un aggregate.
* Fix login dans les tests d'intégration de la suite.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-04-10" %}

## Canari 26

**En résumé**

* Créer plus de lien entre les deux modules Process et Doc.
* Fluidifier le parcours de numérisation.
* Optimiser les APIs et la récupération de liste de dossiers (100 000+) pour faciliter le pilotage par la data.
* Débloquer de nouveaux cas d'usages (notamment dans les parcours RH) et la gestion des dossiers pour une meilleure qualité de classement.

**Nouveautés**

* Ajout du filtre par gabarit de document dans la recherche rapide.
* Pré-classement sans sélection préalable d'un dossier.
* Fusion de 2 dossiers.
* Rendre visibles les processus et documents liés ainsi que les anciens processus sur lesquels le document a été attaché (Doc/Process).
* Permettre le lancement de processus depuis un document.
* Permettre l'ouverture d'un processus depuis un document.

**Améliorations et corrections**

* Optimisation des APIs dont la liste de dossiers.
* Fix MAJ Debian 12.
* Correction d'un bug d'upload fichier vers Safe.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-03-18" %}

## Canari 25

**En résumé**

* Contribuer à l'adoption et une utilisation de qualité de la GED dans le cadre de la démarche de numérisation : réduction du nombre de documents qui sortent de la GED, correction des erreurs de classement.
* Donner plus d'autonomie lors de l'administration du plan de classement.

**Nouveautés**

* **Déplacement de documents entre des dossiers de même gabarit :** les utilisateurs qui ont un droit de suppression sur un dossier et d'ajout dans un autre peuvent déplacer un document entre deux dossiers de même gabarit. Ce déplacement est tracé dans les journaux fonctionnels.
* **Suppression des valeurs inactives :** depuis l'administration, il est désormais possible de supprimer les valeurs inactives d'une métadonnée de type liste de valeurs (si elles ne sont plus associées à des documents). Cette action est tracée dans les journaux fonctionnels.

**Améliorations et corrections**

* Correction de problématiques liées à l'interface : amélioration de l'UI.
* Fix injections d'IDs invalides lors de l'import du plan de classement.
* Fix erreur d'email invalide dans la synchro LDAP.

**Environnement et qualité**

* Mise à jour des composants de la librairie front.
* Mise à jour NodeJS.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-03-18" %}

## Canari 24

**Améliorations et corrections**

* Changement de l'inclusivité de la période pour l'utilisation des journaux fonctionnels : la date de fin correspond désormais à la date de fin de période souhaitée.
* Modification du composant font pour le nommage dynamique afin de permettre un drag-and-drop plus fluide de l'ordre des valeurs.
* Correction de problématiques liées à l'interface : amélioration de l'UI.
* Fix injections d'IDs invalides lors de l'import du plan de classement.
* Fix erreur d'email invalide dans la synchro LDAP.

**Environnement et qualité**

* Mise à jour des composants de la librairie front.
* Mise à jour NodeJS.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-02-09" %}

## Canari 23

**En résumé**

Retravailler la recherche multicritères et améliorer la performance de cette recherche dans le cas de volumes importants.

**Nouveautés**

* **Scalabilité du produit :** moteur de recherche Elasticsearch mis en place pour la recherche multicritère, garantissant des performances décuplées (testé sur 200 000 documents).

**Améliorations et corrections**

* Correction de problématiques liées à l'interface : amélioration de l'UI.
* Fix des anomalies liées à la pagination de l'API avec un important volume de dossiers.

**Environnement et qualité**

* Mise à jour des composants de la librairie front.
* Correction de quelques anomalies liées notamment à la recherche.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2024-02-09" %}

## Canari 22

**Nouveautés**

* **Politique de mot de passe configurable :** il est désormais possible de configurer la longueur minimale du mot de passe directement dans le manifeste de l'application.

**Améliorations et corrections**

* Correction des problématiques liées à la taille de l'interface.
* Les noms dynamiques sont maintenant limités à 255 caractères pour éviter les incohérences et problèmes d'affichage.
* Informer les utilisateur·rice·s lors des erreurs de login LDAP.

**Environnement et qualité**

* Mise à jour des composants de la librairie front.
* Correction de quelques anomalies liées notamment à la recherche et au thème sombre.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2023-12-05" %}

## Canari 21

**Nouveautés**

* Il est désormais possible de modifier les fichiers de type Office (Word, Excel, PowerPoint) directement depuis le navigateur grâce à l'intégration OnlyOffice. Pour en bénéficier, il est nécessaire d'acquérir des licences "Pack collaboratif unique".

**Améliorations**

* Amélioration de la fonction de classement des documents depuis la bannette avec la possibilité de faire des recherches directement depuis la liste des dossiers.
* Refonte en profondeur du design de l'application pour s'aligner sur la nouvelle charte graphique et prendre en compte les retours utilisateurs.
* La recherche globale a été optimisée d'un point de vue performance.
* Les mécanismes d'OCR ont été revus pour améliorer grandement la performance de ce traitement.

**Environnement et qualité**

* Mise à jour du système d'exploitation en Debian 12 et amélioration du système de mise à jour de l'infrastructure.
* Correction de quelques anomalies.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2023-10-19" %}

## Canari 20

**Nouveautés**

* Il est désormais possible d'utiliser des métadonnées facultatives pour créer des dossiers liés, réaliser des regroupements dans un dossier ou encore nommer dynamiquement des documents ou des dossiers.
* Possibilité d'utiliser les métadonnées systèmes dans le cadre du nommage dynamique des documents.
* Filtres d'accès : il est désormais possible d'attribuer plusieurs valeurs à une personne dans l'administration, simplifiant l'usage de cette fonctionnalité.
* La documentation est accessible directement depuis le header (en cliquant sur l'icône utilisateur).

**Améliorations**

* Mise en place de la pagination sur l'API de récupération des journaux techniques.
* La mire de login Efalia Login est désormais la page par défaut lorsqu'un utilisateur n'est pas connecté et qu'Efalia Login est défini comme le mode d'authentification par défaut.
* Amélioration des performances de l'application.

**Corrections**

* Harmonisation du nom de produit Efalia Login dans toute l'application.
* Correction de l'import de plan de classement pour conserver l'ordre des métadonnées du plan de classement initial.
* Correction sur le tri des tableaux de recherche.

**Environnement et qualité**

* Mise à jour de la visionneuse PDF et de diverses dépendances.
* Mise en place de tests d'intégration avec Efalia Login.
* Optimisation du temps de réalisation des tests automatiques.
* Suppression de librairies plus utilisées.
* Amélioration globale du déploiement. En particulier, un tunnel SSH sortant n'est plus demandé pour installer ou mettre à jour l'application à partir de la Canari 20.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2023-07-21" %}

## Canari 19

**Nouveautés**

* Ajout du principe de webhooks pour répondre à certaines demandes spécifiques.
* Possibilité de filtrer les éléments des listes contenant le plan de classement.
* Possibilité de renommer un ou plusieurs documents en bannette.
* Ajout des dernières traductions en anglais et en arabe.
* Possibilité de récupérer les sources de l'application en HTTP pour son installation et mise à jour.
* Ajout de la gestion des clés d'API.
* Ajout des tests E2E pour les boutons de numérisation en bannette.

**Améliorations**

* Affichage de la liste complète des armoires dans l'administration.

**Corrections**

* Correction de l'affichage des valeurs désactivées des filtres d'accès.
* Correction de l'erreur de création de dossier si sélection d'une valeur de filtre d'accès suivi d'une remise à vide.
* Correction d'un problème d'affichage avec certains PDFs dans la prévisualisation.
* Correction du bouton invisible permettant de supprimer l'utilisateur.
* Correction du bouton invisible permettant de retirer un utilisateur d'un rôle.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2023-06-14" %}

## Canari 18

**Nouveautés**

* Possibilité de numériser un document avec ou sans code-barres depuis une bannette avec l'outil Efalia Capture du poste client.
* Upload de document dans Efalia Safe à partir d'une bannette.
* Ajout de la rubrique coffre-fort dans les informations du document.

**Corrections**

* Correction du chargement de la liste des conteneurs Efalia Safe lors de la création d'une bannette.
* Correction des incohérences de l'interface des valeurs de filtre d'accès de type liste.
* Ajout de la traduction manquante pour le libellé "Dossiers liés".
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2023-06-02" %}

## Canari 17

**Nouveautés**

* Ajout des filtres de recherche sur l'interface des utilisateurs et des rôles.
* Paramétrage de la connexion avec Efalia Safe.
* Ajout d'un menu "Coffre-fort" et affichage de l'état de la connexion au coffre.
* Possibilité de sélectionner un conteneur Efalia Safe pour les bannettes et les gabarits de document.
* Upload de document dans Efalia Safe.
* Ajout de la pagination pour le journal fonctionnel (API).
* Ajout de la gestion de l'affichage de l'erreur dans les interfaces d'état des serveurs LDAP, Efalia Process et Efalia Connect.
* Ajout d'un onglet Efalia Process dans l'administration des processus.

**Améliorations**

* Modification de l'affichage des informations du document.

**Corrections**

* Correction de l'affichage du paramètre conteneur dans l'administration du plan de classement.
* Correction de l'affichage de la valeur historisée lors d'un classement depuis une bannette.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2023-04-07" %}

## Canari 16

**Nouveautés**

* Ajout d'un message de téléchargement en cours.
* Ajout d'un filtre de recherche dans la liste de choix de dossiers dans la bannette.
* Possibilité de changer son mot de passe (utilisateur créé manuellement uniquement).
* Possibilité de demander le changement du mot de passe à la prochaine connexion (utilisateur créé manuellement uniquement).
* Mise à jour de la page de la doc API suivant la nouvelle charte Efalia.
* Support du LDAPS.
* Mise à jour de PHP en version 8.2.

**Améliorations**

* Meilleure lisibilité des valeurs longues dans les filtres d'accès de type liste personnalisée.
* Possibilité de choisir la valeur sélectionnée précédemment lors du classement multiple en bannette.
  {% endupdate %}
  {% endupdates %}

{% updates format="full" %}
{% update date="2023-03-08" %}

## Canari 15

**Nouveautés**

* Ajout de la multi-sélection dans les dossiers et les bannettes pour permettre de télécharger ou supprimer un lot de documents.
* Il est possible de sélectionner plusieurs documents dans une bannette pour les classer à la suite.
* L'import d'un document depuis une bannette est possible dans un dossier vide d'une armoire.
* Ajout des traductions anglaises dans l'application.
* Support des liens cliquables dans les métadonnées de type texte.

**Améliorations**

* L'affichage des signatures est maintenant possible dans les PDF en prévisualisation.
* Refonte des boutons "Tout cocher" / "Tout décocher" dans les actions par lot en bannette.
* Ajout des traductions manquantes dans le formulaire de classement pour le support multi-langue.
  {% endupdate %}
  {% endupdates %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.efalia.com/documentations/efalia-doc/annexes/notes-de-version.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.