Breaking Changes
Ce tableau recense les breaking changes, les points de sécurité et les impacts techniques à prendre en compte lors d'une mise à jour vers une version mineure de la branche v23 d'Avanteam Process Studio.
warning
Les breaking changes nécessitent une action de votre part avant ou après la mise à jour. Vérifiez chaque ligne applicable à votre environnement.
| Version | Catégorie | Ticket | Description | Action requise |
|---|---|---|---|---|
| v23.0 | Breaking | — | Internet Explorer supprimé : IE n'est plus supporté | Migrer les utilisateurs vers Edge, Chrome ou Firefox |
| v23.0 | Breaking | — | Authentification Windows : la configuration n'est plus dans programs.ini mais dans un IdP dédié | Créer une configuration IdP de type Windows dans l'interface |
| v23.0 | Breaking | — | NLog v2 → v5 : la nouvelle version introduit des breaking changes sur la syntaxe de configuration | Vérifier et mettre à jour les fichiers de configuration NLog custom |
| v23.0 | Breaking | — | Driver Oracle .Net Standard 2.1 : le driver .Net Framework 4 est remplacé | Recompiler le code custom qui référençait l'ancienne DLL Oracle |
| v23.0 | Breaking | — | Code obsolète supprimé : classes, énumérations, méthodes et propriétés supprimées (UserDataSource, Email_Send, etc.) | Consulter la liste exhaustive en note de version et adapter le code custom |
| v23.1 | Breaking | APS-4580 | Table DirectoryResourceLocks : colonne lock_date supprimée ; colonne locked accepte uniquement les valeurs 0 ou 2 | Mettre à jour tout accès direct à cette table |
| v23.2 | Breaking | APS-3042 | Modèles mail de délégation renommés : « Permanent » et « Temporary » deviennent « Without dates » et « With dates » | Reporter les personnalisations des anciens modèles vers les nouveaux |
| v23.3 | Breaking | APS-4664 | Attribut viewheight supprimé des balises <aps:EmbeddedView> | Supprimer cet attribut dans les fichiers .ascx custom concernés |
| v23.4 | Breaking | APS-4663 | SetTabTitle() devient asynchrone (retourne une Promise) | Adapter le code custom : ajouter await ou chaîner le .then() |
| v23.4 | Breaking | APS-4663 | GetQueryStringAction() retourne une énumération DocumentAccessMode au lieu d'une chaîne de caractères | Adapter le code custom qui comparait la valeur à une chaîne |
| v23.4 | Breaking | APS-4663 | HttpNameValueCollection remplacé par NameValueCollection ; méthode SerializeToUrlQueryString() ajoutée | Adapter le code custom utilisant l'ancien type |
| v23.5 | Breaking | APS-3644 | GetSubstitutesOf() / GetDelegateesOf() obsolètes → remplacer par GetDelegates() | Migrer le code custom avant la version v25 (suppression prévue) |
| v23.7 | Breaking | APS-4959 | ORDER BY interdite en fin de requête pour les vues utilisées dans des widgets indicateurs | Supprimer les clauses ORDER BY dans les requêtes concernées ; utiliser l'option de tri dans le widget |
| v23.9 | Breaking | APS-4900 | DirectoryPicker : paramètres DisplayField, DisplayFieldValue, df, sf supprimés | Supprimer ces paramètres du code custom |
| v23.9 | Breaking | APS-4829 | Renommage des favoris supprimé | Informer les utilisateurs ; cette fonctionnalité n'est plus disponible |
| v23.9 | Breaking | APS-3206 | Icône fa-tripadvisor supprimée (demande de marque) | Remplacer l'icône dans les formulaires ou paramètres concernés |
| v23.9 | Breaking | APS-3948 | Surlignage des mots recherchés dans les documents supprimé | Informer les utilisateurs de la suppression de cette fonctionnalité |
| v23.11 | Breaking | APS-5145 | Colonne id supprimée des tables DelegationTargets et DelegationDelegates | Mettre à jour tout accès direct à ces tables |
| v23.11 | Breaking | APS-5145 | ViewDataSource et 9 types associés supprimés (LogViewDataSource, ViewDataHelper, ViewDataHolder, ViewDataRow, ViewColumnDesc, ViewDataSourceBinder, ViewDataSourceBinderPager, ViewDataSourcePager, ViewDataSourceCustomPage) | Migrer le code custom utilisant ces types |
| v23.11 | Annonce | — | Migration .Net 8 prévue en v23.12 | Préparer l'environnement : vérifier la compatibilité, anticiper l'installation du runtime |
| v23.12 | Breaking | APS-5164 | Migration .Net 8 obligatoire : fin du support .Net 6 par Microsoft | Installer ASP.NET Core 8 Runtime (Hosting Bundle) sur le serveur |
| v23.12 | Breaking | APS-5164 | EF Core 8 : fin du support d'Oracle 18c et antérieures | Mettre à jour Oracle vers la version 19c minimum |
| v23.12 | Breaking | APS-5016 | Colonnes id supprimées de ProcessInstanceExecutorProp et ProcessInstanceProperties ; suppression d'un formulaire entraîne la suppression en cascade des documents | Mettre à jour le code accédant directement à ces tables ; vérifier les processus de suppression |
| v23.12 | Breaking | APS-5193 | Classe Avanteam.Kernel.ObjectByteArrayConverter supprimée ; la sérialisation binaire des objets est à proscrire | Supprimer tout usage de la sérialisation binaire dans le code custom |
| v23.12 | Technique | APS-4653 | Installateur utilise EF Core (plus de scripts SQL directs) | Aucune action requise ; impact sur les installations personnalisées uniquement |
| v23.13 | Breaking | APS-4434 | 13 tables SQL obsolètes supprimées : ApplicationACL, ApplicationProperties, Formulas, LogColumns, LogDocuments, LogReport, LogReportItems, LogStatus, Procedures, ResourceFicheHistory, Scripts, Status, StatusParameters | Vérifier qu'aucun code custom ou rapport n'accède à ces tables |
| v23.13 | Breaking | APS-5015 | BDD annuaire : colonne id supprimée de DirectoryRelations et DirectoryResourceAttributes ; signatures des méthodes DirectoryManagerWrapper modifiées (InsertRelations, UpdateRelations, DeleteRelations, InsertResourceAttribute, UpdateResourceAttribute, DeleteResourceAttribute) | Adapter le code custom utilisant ces méthodes |
| v23.14 | Breaking | APS-5284 | Table DocumentObjects : colonnes object_name, object_type, size, creation_date, modification_date, visibility devenues NOT NULL | Vérifier les insertions directes en base de données |
| v23.14 | Sécurité | APS-5302 | HSTS configurable via HstsSettings:Preload, HstsSettings:IncludeSubDomains, HstsSettings:MaxAge dans programs.ini | Configurer selon la politique de sécurité de l'environnement |
| v23.15 | Breaking | APS-5527 | IRawDbDataSource : erreur si deux requêtes utilisent la même connexion sans matérialisation intermédiaire | Ajouter .ToList() ou .ToArray() sur les SQL_ExecuteScalarCollection appelées en boucle |
| v23.15 | Sécurité | APS-5065 | Droits vérifiés côté serveur sur GetFieldValue, SetFieldValue, DeleteDoc, BuildReference, ArchiveRestore... | Vérifier que le code custom dispose des droits appropriés avant d'invoquer ces méthodes |
| v23.16 | Breaking | APS-5668 | Tables renommées : Trash → TrashedItems, TrashDocument → TrashedItemDocument ; options CLI aps trash modifiées | Mettre à jour les scripts et intégrations utilisant ces tables ou la CLI |
| v23.16 | Breaking | APS-5629 | AgentBase.Log() obsolète → remplacé par LogTrace, LogDebug, LogInfo, LogWarn, LogError, LogFatal | Migrer les agents custom vers les nouvelles méthodes de log |
| v23.17 | Breaking | APS-5712 | 6 icônes dupliquées supprimées (fa-user-large, fa-headphones-simple, fa-vector-square, etc.) ; 14 fichiers CSS supprimés (Portal.css, StdNavigator.css, etc.) | Remplacer par les icônes équivalentes (migration automatisée à la mise à jour) ; supprimer les références aux CSS supprimés |
| v23.17 | Breaking | APS-5814 | Boutons Import/Export de formulaire supprimés de Process Studio | Utiliser SyncTool à la place pour synchroniser les formulaires |
| v23.17 | Breaking | APS-5845 | URL des photos de profil changée : ~/Workflow/WorkflowHandler.ashx?action=GUP&name={0} → ~/PStudioActions.ashx?action=UserPicture&user={0} | Mettre à jour les liens vers les photos de profil dans le code custom |
| v23.17 | Breaking | APS-5472 | Énumération DatabaseTypes supprimée → remplacée par ArchiveDatabaseType | Adapter le code custom utilisant l'ancienne énumération |
| v23.17 | Sécurité | APS-3864 | Redirections externes restreintes : seules les URL listées dans Security.Redirection.AllowedUrls sont autorisées | Configurer cette liste si des redirections vers des URL externes sont nécessaires |
| v23.18 | Breaking | APS-5897 | Lecteurs vidéo VLC et WMP non livrés (remplacés par le lecteur HTML5 natif) | Vérifier que les vidéos hébergées s'affichent correctement avec le lecteur HTML5 |