Montée de version v23.10 → v23.18
Ce document récapitule l'ensemble des changements, nouvelles fonctionnalités, correctifs et points d'attention à prendre en compte lors d'une montée de version de v23.10 vers v23.18.
Chemin de migration
La montée de version doit être effectuée de manière séquentielle, version par version :
v23.10 → v23.11 → v23.12 → v23.13 → v23.14 → v23.15 → v23.15.1 → v23.16 → v23.17 → v23.18
Il n'est pas possible de sauter une version intermédiaire. Chaque pack de mise à jour exige que la version précédente soit installée.
Procédure d'installation
Pour chaque version, récupérer le paquet de mise à jour depuis le serveur FTP Avanteam et lancer AutoUpgradeTool.exe en tant qu'administrateur.
| Version | AutoUpgradeTool |
|---|---|
| v23.11 | v2.3 |
| v23.12 à v23.18 | v2.4 |
Points d'attention critiques
Passage à .Net 8 (v23.12) — ACTION REQUISE
La version v23.12 migre l'ensemble de la solution vers le Framework .Net 8. Il est impératif d'installer ASP.Net Core Runtime 8 (Hosting Bundle) sur le serveur web avant d'appliquer la mise à jour.
Télécharger ASP.Net Core Runtime 8
Cette migration entraîne également la fin du support des bases Oracle 18c et versions inférieures (fin de maintenance par Oracle).
Restructurations de bases de données
Plusieurs versions apportent des modifications structurelles importantes en base de données. Ces modifications sont automatisées lors de la montée de version mais sont irréversibles :
v23.11 — Suppression de colonnes
- La colonne
idest supprimée des tablesDelegationTargetsetDelegationDelegates. - Suppression de la classe
Avanteam.Views.Data.ViewDataSourceet de ses types associés.
v23.12 — Restructuration de la base applicative
- La suppression d'un formulaire entraîne désormais la suppression en cascade de l'ensemble de ses documents en base de données.
- Suppression du champ
idde la tableProcessInstanceExecutorProp. - Suppression des champs
idetproperty_typede la tableProcessInstanceProperties. - Suppression de la classe
Avanteam.Kernel.ObjectByteArrayConverter(sérialisation binaire proscrite).
v23.13 — Suppression de tables SQL obsolètes
Les tables suivantes ont été supprimées de la base annuaire :
DelegationTargets
Les tables suivantes ont été supprimées de la base applicative :
ApplicationACL,ApplicationProperties,ApplicationRoles,ApplicationsDocumentAccess,DocumentRoles,FormulasLogColumns,LogLevels,LogTableTemplateOfficeTemplateFilters,ProcessScripts,Settings
De plus, dans la base annuaire :
- La colonne
idest supprimée deDirectoryRelationsetDirectoryResourceAttributes. - Les signatures de plusieurs fonctions de
Avanteam.Directory.DataSource.DirectoryManagerWrapperont évolué.
v23.14 — Table DocumentObjects
- Dans la table
DocumentObjects, les colonnesobject_name,object_type,size,creation_date,modification_dateetvisibilitysont désormais non nullables. - Les entrées corrompues (valeur
NULLdansobject_name) ont été supprimées lors de la migration.
v23.15 — Transactions avec IRawDbDataSource
Sur SQL Server, l'utilisation de SQL_ExecuteScalarCollection imbriquée peut générer l'erreur :
There is already an open DataReader associated with this Connection which must be closed first.
Si vous avez des développements spécifiques utilisant cette fonction, il est nécessaire de matérialiser les résultats avec .ToList() ou .ToArray() avant d'exécuter une requête suivante.
v23.16 — Renommage de tables et options CLI
- Les tables
TrashetTrashDocumentont été renommées respectivement enTrashedItemsetTrashedItemDocument. - Les options des commandes
aps trash purgeetaps trash restoreont été renommées (voir les release notes v23.16 pour le détail).
v23.17 — Icônes et feuilles de style supprimées
Les icônes suivantes sont remplacées automatiquement lors de la montée de version :
| Icône supprimée | Remplacée par |
|---|---|
fa-user-large | fa-user |
fa-user-large-slash | fa-user-slash |
fa-headphones-simple | fa-headphones |
fa-vector-square | fa-draw-square |
fa-handshake-simple | fa-handshake |
fa-handshake-simple-slash | fa-handshake-slash |
Les feuilles de style suivantes ne sont plus livrées : DualView.css, AdminDirectory.css, Banner.css, DefaultFeed.css, ImportDlg.css, LayoutMain.css, Portal.css, PortalDesign.css, StdNavigator.css, etc.
La fonctionnalité Importer / Exporter des formulaires depuis Process Studio a été supprimée car elle n'est plus supportée.
v23.18 — Remplacement du lecteur vidéo QuickTime
Le lecteur QuickTime a été remplacé par le lecteur HTML5 natif des navigateurs. Les lecteurs VLC et WMP ne sont plus livrés dans la solution.
Sécurité
Les versions v23.11 à v23.18 apportent de nombreuses corrections de sécurité :
| Version | Correctif |
|---|---|
| v23.10 | Correctif faille XSS stockée sur les formulaires ; suppression référence CDN Polyfill compromis |
| v23.11 | Correction de 4 failles XSS ; mise à jour de la librairie HtmlSanitizer (v8.0.723+) |
| v23.12 | Correction faille XSS stockée sur les vues |
| v23.14 | Configuration HSTS paramétrable (HstsSettings:MaxAge, HstsSettings:IncludeSubDomains, HstsSettings:Preload) |
| v23.15 | Renforcement du cloisonnement des utilisateurs ; correctifs XSS sur le portail ; protection contre les fichiers PDF avec scripts ; sécurisation du module de supervision des mails ; implémentation de SCIM |
| v23.16 | Correctifs XSS (SVG, bandeau de maintenance) ; correction faille Path Traversal dans la navigation visuelle |
| v23.17 | Correctifs XSS multiples (TeamConnect, recherche plein texte, page d'accès aux enregistrements, envoi mot de passe) ; correction Open Redirection (seules les URLs configurées dans Security.Redirection.AllowedUrls sont autorisées) |
| v23.18 | Mise à jour des librairies Magick.Net et SharpZipLib |
Pour activer HSTS avec une durée d'un an, décommenter et configurer les clés suivantes dans programs.ini :
HstsSettings:Preload=true
HstsSettings:IncludeSubDomains=true
HstsSettings:MaxAge=365.00:00:00
Recycler le pool d'applications pour appliquer les modifications.
Nouvelles fonctionnalités
Gestion documentaire
Corbeille web enrichie (v23.12 à v23.13)
La corbeille accessible depuis l'interface web a été enrichie progressivement :
- v23.12 : Restauration du document et de son workflow associé (sur la définition du workflow au moment de la suppression).
- v23.13 : Affichage de l'auteur de la suppression, de la date et du formulaire associé.
Champ Fichier — nouvelles capacités (v23.12 à v23.16)
Le champ Fichier s'enrichit progressivement de fonctionnalités auparavant réservées au module bureautique :
- v23.12 : Conversion de pièces jointes en PDF (configurable par champ dans Process Studio).
- v23.14 : Gestion de la visibilité des pièces jointes ; tri manuel des pièces jointes ; amélioration de l'icône et du libellé de renommage.
- v23.16 : Gestion du doublon de nom de fichier : l'utilisateur peut remplacer, renommer (incrément automatique) ou annuler lors d'un ajout de fichier avec un nom existant.
Liens documentaires — éclatement de ressources (v23.16)
Dans les fenêtres de sélection de ressources (ex. : diffusion), il est désormais possible d'éclater un rôle, un service ou un groupe de diffusion pour en extraire les membres individuellement.
Process Studio
Barre de navigation par défaut pour un formulaire (v23.14)
Il est possible de définir dans les propriétés d'un formulaire la barre de navigation par défaut dans laquelle s'ouvre un enregistrement lorsqu'il est accédé via un lien email. Si l'utilisateur n'a pas les droits, la première barre accessible est utilisée.
Aide contextuelle sur les champs (v23.16)
Il est désormais possible d'associer un texte d'aide à chaque champ de formulaire depuis Process Studio (onglet Paramètres > propriété Aide). L'icône d'aide apparaît au survol du libellé en mode édition.
Pour localiser le message d'aide, utiliser l'écran Traduction > Application dans Process Studio.
Supervision des agents améliorée (v23.16 à v23.17)
- Logs des agents classifiés par niveaux :
Trace,Debug,Info,Warn,Error,Fatal. - Affichage d'une icône d'avertissement dans Process Studio si le dernier run est en échec.
- Nouvelles colonnes Dernier échec et Message d'échec dans la liste des agents.
- v23.17 : Bouton Exécuter pour lancer manuellement un agent depuis Process Studio.
Nouvelle bibliothèque d'icônes (v23.17)
La bibliothèque d'icônes passe de 2 089 à 7 384 icônes, avec recherche par champ lexical en anglais. Les icônes sont disponibles en deux styles : solid et regular, automatiquement appliqués selon le contexte (formulaire, navigateur, barre de navigation, etc.).
Tableau 4 colonnes dans les formulaires (v23.17)
Il est désormais possible d'ajouter un tableau à 4 colonnes dans un formulaire Process Studio.
Interface web
Export des listes de valeurs (v23.16)
Depuis l'AdminTools > AdminValueList, un administrateur peut exporter une liste de valeurs au format Excel, la modifier et la réimporter.
Diffusion — liste de types de lien triée (v23.12)
La liste des types de lien documentaire est désormais triée par ordre alphabétique.
Email récapitulatif enrichi (v23.13)
Le format de l'email récapitulatif des notifications a été revu. Les informations sont maintenant présentées sous forme de tableaux distincts par catégorie : Messages Team Connect, Diffusions, Notifications de workflow, Relances.
Comparaison de pièces jointes dans le champ Fichier (v23.13)
La comparaison d'une pièce jointe avec sa version précédente est désormais disponible dans le champ Fichier (formats supportés : .odt, .ott, .doc, .docx, .dotx, .docm, .dotm).
Génération de liens pour les pièces jointes (v23.13)
Il est possible de générer un lien direct pour chaque pièce jointe d'un champ Fichier ou Image.
Règles de visibilité sur les boutons de workflow (v23.12)
Il est désormais possible de définir des règles de visibilité sur les boutons d'actions de workflow en s'appuyant sur les valeurs des champs du formulaire (en plus des règles par rôle existantes).
Bouton switch (v23.18)
Un nouveau type de champ est disponible dans les composants de formulaire : le bouton switch. Il permet de représenter des états binaires (vrai/faux, oui/non, activé/désactivé) pour une meilleure expérience utilisateur.
Logs dans la visionneuse de pièces jointes (v23.15)
Les actions d'impression, de téléchargement et de sauvegarde depuis la visionneuse Apryse génèrent désormais des logs pour tracer les actions utilisateur.
Correctifs notables
| Version | Domaine | Description |
|---|---|---|
| v23.11 | Process Studio | Avertissement lors de la création d'un champ avec un nom système déjà existant |
| v23.11 | Interface web | Suppression des actions de diffusion sur les documents obsolètes ou annulés |
| v23.11 | Interface web | Correctif ajout de favoris sous Oracle |
| v23.12 | Interface web | Correctif de la corbeille lors de la suppression de documents importés via ImportDocs |
| v23.12 | Interface web | Conservation des pièces jointes lors du changement de modèle d'email en diffusion |
| v23.13 | Interface web | Correction des préfiltres sur les champs Date (adapatation à la langue de la base) |
| v23.13 | Interface web | Correction de l'ouverture des liens dans les exports Excel depuis OneDrive |
| v23.14 | Interface web | Déconnexion automatique après inactivité correctement prise en compte |
| v23.14 | Interface web | Renommage des pièces jointes avec un "." fonctionne désormais correctement |
| v23.14 | Interface web | Correctif import listes de valeurs sous Oracle |
| v23.15 | Scheduler | L'archivage par copie ne s'interrompt plus en cas d'incohérence des données archive |
| v23.15 | Interface web | Notifications de relance ne sont plus envoyées aux utilisateurs désactivés |
| v23.16 | Interface web | Correction de la prévisualisation des graphes (GraphBuilder) |
| v23.16 | Interface web | Correctif restauration de documents depuis une base d'archivage active |
| v23.17 | Interface web | Correction de l'annulation du changement d'intervenant dans un workflow |
| v23.18 | Interface web | Correction du filtre de niveau hiérarchique dans Field_OpenKeywordsWithFilter |
| v23.18 | Interface web | Correction de l'affichage des destinataires en diffusion externe/papier |
| v23.18 | Interface web | Correction de la mise à jour des signets Word (régression depuis v23.13) |
Technique
Optimisations de performance
- v23.12 : Restructuration de la base applicative avec ajout d'indexes, nettoyage des données dupliquées et optimisation des types de colonnes. Gains en performance significatifs.
- v23.13 : Restructuration de la base annuaire (DirectoryRelations, DirectoryResourceAttributes) avec gains de performance.
- v23.17 : Optimisation de l'export des historiques de workflow (plus de 1 000 enregistrements). Optimisation des feuilles de style (chargement uniquement des classes nécessaires).
Installation via EF Core (v23.12)
L'installateur utilise désormais Entity Framework Core au lieu de scripts SQL, garantissant une meilleure compatibilité entre SQL Server et Oracle.
Reprise du scheduler après maintenance BDD (v23.17)
Le planificateur de tâches (scheduler) continue désormais à tenter de s'exécuter lors d'une opération de maintenance de la base de données, sans nécessiter un redémarrage manuel.
SCIM (v23.15 à v23.17)
L'implémentation du protocole SCIM permet de simplifier et d'automatiser la gestion des comptes utilisateurs. Des améliorations ont été apportées en v23.17 : support des filtres simples (OKTA), identification des utilisateurs par dn_name.
Résumé des actions manuelles requises
| Version | Action | Type |
|---|---|---|
| v23.12 | Installer ASP.Net Core Runtime 8 (Hosting Bundle) sur le serveur web | Manuelle — OBLIGATOIRE |
| v23.11 | Les vues sont regénérées automatiquement | Automatique |
| v23.12 | Républication des formulaires, vues et tableaux de détails | Automatique |
| v23.13 | Républication des vues avec mise à jour de la référence DevExpress | Automatique |
| v23.16 | Les icônes obsolètes sont remplacées automatiquement | Automatique |
| v23.17 | Le style des icônes est appliqué automatiquement | Automatique |