Mises à jour majeures

0. Stopper les différents containers (docker-compose down), puis effectuer une sauvegarde de la base de données.
1. Mettre à jour le container MariaDB vers la version 10.6.
2. Redémarrer le container (docker-compose up -d sainet_db) et appliquer le script de migration des données à l’intérieur du container:

docker ps
docker exec -ti <container_id> /bin/bash
mariadb-upgrade --user=root --password=<pwd>

3. Mettre à jour le container de SAINet vers la version saierp/sainet:4.10.
4. Si utilisée, renommer la variable d’environnement SAINET_MOBILE_ENABLED en SAINET_WEBAPP_ENABLED dans docker-compose.yml.
5. Mettre à jour les versions des autres services si nécessaire (traefik, redis, …).
6. Relancer les containers (docker-compose up -d).

0. Stopper les services SAINet et MariaDB, puis effecuter une sauvegarde de la base de données.
1. Mettre à jour MariaDB vers la version 10.6.
2. Redémarrer le service MariaDB et appliquer le script de migration: mariadb-upgrade --user=root --password=<pwd>.
3. Mettre à jour le JDK vers la version 17.
4. Si utilisée, renommer la variable d’environnement SAINET_MOBILE_ENABLED en SAINET_WEBAPP_ENABLED dans <runtime>/services/widnows/sainet-vars.bat.
5. Télécharger la version 4.10 désirée et remplacer le fichier sainet.jar existant.
6. Appliquer la mise à jour manuellement: java -Djdk.jar.maxSignatureFileSize=32000000 -jar sainet.jar --runtime <runtime> --update.
7. Démarrer le service SAINet.

Il est important de tester l’accès mobile (via navigateur et/ou tablette) afin de s’assurer que la migration de la variable SAINET_MOBILE_ENABLED a bien été effectuée. Dans le cas contraire, une page indiquera que cette fonctionnalité n’est pas disponible.

A des fins de sécurités, le support du formatter legacy (<format><array>...</array></format>) est restreint. Notamment, plusieurs types de noeuds permettant l’utilisation du JavaScript ont été supprimées (voir ici et là). Par conséquent, il se peut que certaines listes personnalisées stockées en UNI94 ne soient plus fonctionnelles (notamment dans les tâches ADRS2/ADRL2 ou SALEL).

Ces listes devront être refaites en utilisant un formatter BlueIron.

Nashorn était le moteur JavaScript intégré au JDK jusqu’au JDK 14 après quoi, celui-ci a été complètement supprimé, raison pour laquelle il est nécessaire de migrer sur le nouveau moteur GraalJS. Celui-ci est plus performant et implémente les derniers standards ECMAScript.

Le moteur GraalJS est également beaucoup plus strict. Ainsi, certaines constructions qui fonctionnaient auparavant ne sont plus tolérées. Quelques exemples sont mentionnés dans les chapitres suivants.

Les tâches impactées sont UNI20,UNI23,UNI25 et GTP02.

Nashorn permettait certaines opérations plus ou moins valide et ne remontait pas d’exception en cas d’erreur, mais ajustait son comportement. Bien que pratique, cela pouvait cacher certains problèmes de fond, ce qui donnait l’impression de fonctionner alors que le traitement n’était pas correct.

Les chapitres suivants montrent quelques exemples de constructions invalides qui passaient avec Nashorn mais qui provoquent désormais une erreur avec GraalJS.

• Embedded BigDecimal

Il était possible de passer un BigDecimal en paramètre à un autre. Ce constructeur n’existant pas, désormais un message d’erreur sera affiché.

var a = new BigDecimal(100);
var b = new BigDecimal(a); //erreur

• Division par zéro

Une division par zéro “fonctionnait”:

var a = new BigDecimal(100);
var b = a.divide(BigDecimal.ZERO, MathContext.DECIMAL64); //pas d'erreur

GraalJS sortira clairement une erreur comme quoi la division est indéterminée. Il est donc nécessaire de vérifier le paramètre.

if(divisor.compareTo(BigDecimal.ZERO) != 0) {
  var b = value.divide(a, MathContext.DECIMAL64);
}

• Opérateurs

Nashorn tolérait le mixage entre BigDecimal et Number.

var a = 5;
var b = new BigDecimal(10);
var c = a + b; //15

Cela n’est plus possible avec GraalJS, il est nécessaire d’avoir des objets du même type afin d’utiliser les opérateurs numériques.

var a = 5;
var b = new BigDecimal(10);
var c = a + b.intValue(); //15

Autre solution:

var a = new BigDecimal(5);
var b = new BigDecimal(10);
var c = a.add(b); //new BigDecmial(15)

• Constantes invalides

Les erreurs relatives à une constante invalides étaient cachées.

var a = new BigDecimal("123.456");
var b = a.setScale(2, BigDecimal.HALF_DOWN); //BigDecimal.HALF_DOWN n'existe pas

Désormais ce genre de cas sortira une erreur car BigDecimal.HALF_DOWN vaudra null (remplacer par MathContext.HALF_DOWN).

• Utilisation des fonctions de String Java/JavaScript

L’intégration des chaînes de caractères se fait au format JavaScript et il n’est plus possible d’utiliser certaines méthodes de String Java.

var x = myString.isEmpty(); //erreur 'isEmpty' is not defined
var y = "a".compareTo("c"); //erreur 'compareTo' is not defined, utiliser la méthode localeCompare

Il faut donc se limiter aux fonctions de String JavaScript.

Ce chapitre décrit les changements principaux par rapport à la version 4.8.

La gestion des configurations de l’HistoryViewer (GTP) a été refaite avec un nouveau format. Il se peut que certaines configurations pré-existantes ne s’affichent plus (ce qui indique qu’elles avait déjà un problème de cohérence au préalable).

Dans ce cas, il faudra recréer la configuration.

La listes des variables système est désormais explicite (visible via la tâche SYSSV). Les variables indiquées en rouge dans SYS22 sont inconnues du système et elles peuvent donc être supprimées.