Mise à jour du code legacy vers les versions actuelles - Trucs et astuces

Il vous faudra inévitablement passer votre code d'une version antérieure d'IRIS ou de Cache à la version la plus récente d'IRIS. Voici quelques étapes à suivre pour réussir cette transition.

Lisez attentivement la documentation

Avant de procéder à la moindre modification, consultez la page de documentation IRIS qui contient de nombreuses ressources utiles sur les changements apportés aux différentes versions d'IRIS. Si vous effectuez une mise à niveau à travers plusieurs versions, consultez la documentation de chacune d'entre elles, et pas seulement celle de la version vers laquelle vous effectuez la mise à niveau. Pour chaque version, cliquez sur le lien Maintenance Release Changes (Modifications apportées à la version de maintenance) pour afficher une liste de contrôle de mise à niveau pour les développeurs. Cette liste est très utile pour vous guider dans les modifications à apporter. Nous vous recommandons également de consulter les notes de mise à jour. Elles contiennent une liste des nouvelles fonctionnalités qui pourraient vous être utiles, ainsi qu'une liste des fonctionnalités désormais obsolètes. Nous vous recommandons également de consulter la page Actualités et alertes sur les produits pour connaître les dernières informations urgentes. En fait, il est recommandé de consulter cette page régulièrement ou de vous abonner aux alertes pour rester informé des modifications, même lorsque vous n'effectuez pas de mise à jour!

Les alternatives à découvrir

D'après ce que vous avez lu dans la documentation, vous vous attendez peut-être à une multitude de problèmes. Avant de vous lancer dans leur résolution, prenez toutefois le temps de découvrir les alternatives qui s'offrent à vous. Si une classe ObjectScript spécifique que vous aimez utiliser a été dépréciée ou supprimée, ne vous contentez pas de chercher un remplacement ObjectScript si vous disposez de Python intégré. Si vous utilisiez Zen Reports, sachez qu'InterSystems Reports est l'outil qui le remplace. $ZF -100 a remplacé $ZF -1. De nombreux autres éléments supprimés ont été remplacés par des versions plus récentes, et vous devriez les rechercher avant de réinventer la roue.

Analysez, dépréciez, analysez

Familiarisez-vous avec la classe %SYSTEM.CodeScanner Cette classe comprend des requêtes de classe (ou des méthodes de classe dans les versions antérieures) qui détectent l'utilisation d'éléments dépréciés et quelques autres problèmes courants tels que l'utilisation de $ZF -1 ou $ZF -2, l'utilisation de %this pour référencer l'objet actuel, l'utilisation d'anciens mots-clés de classe, etc. 

Une fois que vous avez scanné votre code, vous devrez faire certains choix quant à la manière de traiter ces problèmes. Certains d'entre eux seront très simples à corriger en modifiant votre code pour utiliser de nouveaux outils et méthodes. D'autres nécessiteront plus d'efforts. Au cours de ce processus décisionnel, n'oubliez pas que vous pouvez déprécier votre propre code ! Le mot-clé Deprecated peut être appliqué à des paramètres, des propriétés, des méthodes et même des classes entières. Ceci est souvent négligé par les programmeurs. Si vous décidez de déprécier certains éléments, vous pouvez alors utiliser la classe de scanner de code à nouveau to find out where all of those things are used, then address those pour trouver où tous ces éléments sont utilisés, puis résoudre ces problèmes, et ainsi de suite. Selon la profondeur du problème, plusieurs passages peuvent être nécessaires pour tout régler. Cela peut représenter beaucoup de travail pour l'instant, mais cela peut vous éviter bien des maux de tête plus tard.

Réglez à nouveau vos tables

Le réglage des tables existe depuis un certain temps déjà et a subi quelques modifications. Ce processus a été considérablement amélioré, même dans la version 2025.2. Si vous utilisez un code obsolète et que vous n'avez pas réglé à nouveau vos tables, vous passez peut-être à côté d'améliorations importantes apportées à cet outil. En tirant parti de ces améliorations, vous pourriez gagner en efficacité sans toucher à une seule ligne de code!

Testez minutieusement

Aucune préparation ni aucun outil ne peut remplacer les bons vieux tests. Si votre mécanisme de test préféré est le test unitaire, Postman, ou simplement Teresa du support client qui sait exactement comment vos utilisateurs ont tendance à casser les choses, assurez-vous qu'ils sont engagés et actifs dans les tests approfondis de votre code sur votre nouvelle version. Ne tenez rien pour acquis.

Faites appel à la communauté

Beaucoup d'entre nous ici ont déjà parcouru ce chemin plusieurs fois. Je ne citerai pas de noms et je ne mentionnerai certainement pas d'âges, mais à tout moment au cours de ce processus, le site Web communautaire sur lequel vous vous trouvez actuellement est une excellente ressource. Si vous avez besoin de remplacer un code obsolète par un autre, vous pouvez demander si quelqu'un en possède un et comment il a effectué la transition entre les deux. C'est un endroit très utile dans toutes les situations. 

Si vous avez une idée pour améliorer le processus de mise à niveau à l'avenir, veuillez la publier dans le portail d'idées - Ideas Portal. InterSystems et les utilisateurs de la communauté consultent régulièrement ce portail pour trouver des idées sur la façon d'améliorer les choses, et vous pourriez finir par vous épargner du travail à l'avenir.

Si vous rencontrez un problème que vous ne pouvez résoudre seul ou avec l'aide de la communauté, vous pouvez toujours vous adresser au centre d'assistance mondial - Worldwide Response Center où vous obtiendrez une aide plus approfondie directement auprès d'InterSystems.

Écoutons maintenant les autres membres de la communauté. Racontez-nous comment vous avez géré de telles mises à jour auparavant. Qu'est-ce qui a fonctionné, qu'est-ce qui n'a pas fonctionné et que ferez-vous différemment la prochaine fois?