Voir les sources : https://github.com/EsupPortail/esup-signature
Cette page présente les changements de chaque version ainsi que les opérations à effectuer pour monter de version, quand c'est nécessaire. Les versions sont numérotées X.Y.Z où:
Seules les releases des versions mineures sont conservées (dans la dernière version de correctif) Les dates de release font référence à la date le mise à disposition de version mineurs |
Une page dédiée précise la marche à suivre pour effectuer les mises à jour d'esup-signature : Exploitation |
Attention, pour compiler le projet il faut OpenJDK 17 au minimum Voir les nouvelles configurations ldap ici : Sources et configuration |
Le format du token des demandes de signature change pour éviter les collisions. De plus l'image pour le tampon "watermark.png" doit maintenant respecter les proportions 300x150 ou 600x300 |
Deux scripts sont à executer pour cette mise à jour, sinon le tableau de bord sera vide : src/main/resources/update_1.23.sql et src/main/resources/update_1.23-2.sql |
Attention le refactor des noms de parapheur nécessite une mise à jour. Un nouveau système de mise à jour lancera automatiquement des modifications sur la base de données. Prévoir une sauvegarde pour un eventuel retour arrière |
La version minimal est maintenant OpenJdk 14. Cette version comporte beaucoup de changements sur les dépendances du projet. Si le projet ne compile pas directement, il est conseillé de vider le dossier /home/<USER>/.m2/repository/ et de relancer un mvn clean package Il est maintenant possible de lancer l'application directement en lancant le war : ./esup-signature.war --spring.config.location=/<DIR>/application.yml |
Des propriétés ont été ajoutées et la propriété share-mode est passée à 1 par défaut (le délégué ne peut signer qu'avec sa propre signature) |
Cette version ajoute une contrainte d'unicité entre les formulaire et les circuits. Chaque formulaires doit posséder son propre circuit. Dans le cas ou des circuits étaient partagés entre plusieurs formulaires il va falloir les dissocier et en créer de nouveaux (la fonction import/export peut aider). De plus attention à bien contrôler l'affectation des champs signature aux bonnes étapes après vos manipulations. |
Après compilation et tests il faut lancer le script : https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.14.4.sql |
Après compilation et tests il faut lancer le script : https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.14.sql |
Attention aux rôles qui ont déjà été attribués à des formulaires ou à des circuits, après la mise à jour, il faudra les contrôler et les remettre en place |
Attention à bien corriger les rôles au niveau du fichier de configuration, le groupe associé au rôle dans "mapping-group-roles" doit correspondre au nom du groupe obtenu à l'aide de "mapping-filters-groups" |
Après compilation et tests il faut lancer le script : https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.11.sql |
Après compilation et tests il faut lancer le script : https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.9.sql De plus les classes Workflow change de nom en base : la colonne "name" prend le nom présent dans le getName() des classes workflow. Pour remettre tout cela en ordre il faudra, soit renommer les workflows en base pour que les noms correspondent, soit les supprimer pour que l'application les recrées comme il faut. |
Il faudra lancer "mvn clean initialize" une première fois avant de pouvoir compiler |
pour cette version il faudra passer les commandes sql suivantes : https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.6.sql |
Un script à passer sur la base de données avant de lancer "mvn clean package" si la version 1.3.1 à été sautée: https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.3.1.sql Puis compiler avec "mvn clean package" Puis passer le script https://github.com/EsupPortail/esup-signature/blob/master/src/main/resources/update_1.4.sql et enfin https://github.com/EsupPortail/esup-signature/blob/master/src/main/resources/update_1.4_clean.sql Beaucoup de changements au niveau du fichier de configuration vont nécessiter de revoir quelque peu le fichier application.yml : Dans le bloc security sont rassemblé toutes les propriétés permettant d'attribuer des rôles. Pour plus de détails voir ici : Sources et configuration
Dans le bloc ldap les attributs ont été renommés pour plus de clarté. Ici il est possible d'attribuer des groupes en fonction de filtres ldap. Pour plus de détails voir ici : Sources et configuration
Finalement la gestion de la securité à été consolidée dans la version 1.11.3 voir : Configuration de la sécurité |
Corrections de bugs
Lancer le https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.3.1.sql après compilation et tests |
Le modèle de données a beaucoup évolué pour nous permettre plus de souplesse et pour améliorer grandement les performances. Ceci implique de passer des scripts de mise à jour. Si vous ne souhaitez pas passer dès maintenant sur cette version, merci de basculer sur la branche 1.2.x Nous conseillons de procéder à des tests en restaurant votre base de production sur une autre plateforme. Voici les étapes de migration
|
Une branche 1.2.x a été créée sur le dépôt github pour permettre à ceux qui ne souhaitent pas migrer vers la v1.3 de bénéficier de corrections de bugs |
Il faudra passer les commandes sql suivantes : https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.2-RELEASE.sql pour supprimer une contrainte sur la table form_fields Si vous passez directement de la release v1.0 à la v1.2 il faudra bien-sûr procéder aux deux précédentes modifications de la base de données |
Cette version apporte beaucoup de changements notamment au niveau du fichier de configuration. Lors du git pull le fichier src/main/ressources/application.yml devra être corrigé. La documentation précise les nouveautés (notamment au niveau du groupe admin) : Sources et configuration Par ailleurs, après une première compilation (mvn clean package), il faudra passer les commandes sql suivantes : https://raw.githubusercontent.com/EsupPortail/esup-signature/master/src/main/resources/update_1.2.sql Enfin si vous aviez des formulaires PDF Forms comportant des champs pré-remplis, il faudra les corriger en vous référent à la Documentation administrateur |
Mise à jour de la base : lancer le script suivant https://github.com/EsupPortail/esup-signature/blob/master/src/main/resources/update_1.1.sql |