Release Notes 1.0 ES1

Nous passons de la version 1.0.0 à la version 1.0.2 de JAXB. Cette version est nécessaire pour ConfEditor et corrige de nombreux bugs.

Copier tous les jars de tous les sous-répertoires \lib\jwsdp-1.3 se trouvant dans le répertoire issu de CVS dans chaque répertoire j2ee\home\application\egxXXX\egxXXX-web-yyy\WEB-INF\lib.

Attention : pas de sous répertoire dans les répertoires lib d'OC4J. Il faut tout mettre à plat.

Supprimer le fichier jaxb-ri.jar de ce même répertoire WEB-INF\lib.

Pour la gestion de la licence, le socle technique utilise un package Java qui n'est pas présent dans la version 1.3 du jdk. Il est nécessaire d'ajouter ce nouveau package au JDK du serveur d'application. Il s'agit du Java TM Cryptography Extension (JCE) 1.2.2.

Copier les fichiers jce1_2_2.jar, US_export_policy.jar, local_policy.jar et sunjce_provider.jar dans le répertoire <java-home >\jre\lib\ext. <java-home> représentant le répertoire racine du jdk ( fixé par la variable d'environnement JAVA_HOME). Vous les trouverez dans le répertoire lib de l'environnement de développement.

Si vous n'executez pas encore votre OC4J avec le JDK 1.3.1, alors c'est le moment de l'installer j2sdk-1_3_1_06-windows-i586.exe"\\alcis\produits\SUN Java\j2sdk-1_3_1_06-windows-i586.exe.

Le socle technique utilise l'implémentation XmlRpc d'apache version 1.1. Un nouveau fichier jar est nécessaire : xmlrpc-1.1.jar

Ce fichier jar est disponible dans le répertoire lib\xmlrpc-1.1 de l'environnement de développement.

Ce fichier jar est à copier dans chaque répertoire lib sous j2ee\home\application\egxXXX\egxXXX-web-yyy\WEB-INF\lib.

Supprimer les librairies suivantes de vos répertoires web-inf\lib (si elles sont absentes, c'est encore mieux) :

• classes12.jar
• jaxb-xjc.jar
• jndi.jar
• nls_charset12.jar
• c4j.jar
• rt.jar
• servlet.jar

Ajouter le fichier xmlparserv2.jar qui se trouve dans le répertoire lib provenant de CVS dans tous les web-inf\lib.

Les infos suivantes sont nécessaires pour la création d’une clé licence « Utilisateurs nommés » interne ACE.

• Global DataBase Name :

Pour obtenir cette information, exécuter l’ordre SQL dans l’instance concernée :

(exemple sur alcis)

SQL> select * from global_name;

GLOBAL_NAME

• ----------------------------------------------

GNX.ALCIS.ACE.FR

SQL>

• Identifiant du client : ACE

La clé est à demander à BTR en lui fournissant les informations suivantes :

(exemple pour alcis)

• Cle de licence 'Utilisateurs nommés'
• De type interne
• Global DataBase Name : GNX.ALCIS.ACE.FR
• Identifiant du client : ACE

Pour alcis, la clé obtenue est : 5V/aGbV1f5SZQBm5jMT1c74tOUBjpCEv

La clé est à stocker dans la base dans la table ut_config.

Insérer les 2 enregistrements dans ut_config :

(exemple pour alcis)

INSERT INTO ut_config (VALEUR, TYP_FIC, NOM_FIC, GNX_SECTION, NOM_CLE, DATMOD, CODSOC, UTIMOD) VALUES ('ACE', ' ', ' ', ' ', 'CLIENT', '20040211', 1, 'PRG');

INSERT INTO ut_config (VALEUR, TYP_FIC, NOM_FIC, GNX_SECTION, NOM_CLE, DATMOD, CODSOC, UTIMOD) VALUES ('5V/aGbV1f5SZQBm5jMT1c74tOUBjpCEv', ' ', ' ', ' ', 'LICENCE_UTILISATEUR', '20040211', 1, 'PRG');

S'assurer que la table mev contient l'enregistrement suivant :

Fin de la procédure de mise à jour des postes de travail développeur.

Un nouveau nœud est défini pour faire le lien avec ACE : config/application/link_to_ACE

<link_to_ACE>

<xmlrpc minInstance= "0" maxInstance= "10" >

<client timeOut= "2000" delay= "20" />

</xmlrpc>

</link_to_ACE>

Le timeout est de 2000 ms avec une période de scrutation de 20 ms.

La chaîne de connexion peut se paramétrer de deux façons différentes :

• Dans la configuration

Selon la méthode précisée en Erreur ! Source du renvoi introuvable..

Ce paramétrage est prioritaire sur le second. En cas d'absence de la chaîne de connexion dans la configuration, le socle prend en considération le paramétrage fait dans le serveur d'application.

• Dans le serveur d'application.

Nous prenons comme exemple Oracle OC4J.

Dans le fichier web.xml de l'application web, il faut définir un nouveau paramètre de contexte comme il en existe déjà pour eGX.. Ce paramètre se nomme egx_xmlrpc_client_connection et se défini de la façon suivante :

<web-app>

…

<context-param>

<param-name> egx_xmlrpc_client_connection </param-name>

<param-value> http://iris:8080 </param-value>

</context-param>

<servlet>

…

Buffer circulaire de RowSet

Pour optimiser les performances, le socle conserve les résultats des requêtes (les RowSet) dans un buffer circulaire. La taille de ce buffer est paramétrable par type de ViewObject, avec une valeur par défaut disponible sur le nœud parent viewObject_def.

Un nouvel attribut est disponible sur les nœuds viewobject et sur viewobject_def en valeur par défaut : rowSetBufferSize.

Partage de ViewObject

A la gestion d'un buffer circulaire s'ajoute le partage des mêmes ViewObject entre les différents utilisateurs. Cette optimisation n'a de sens que pour les ViewObject utilisées "en lecture", comme les tables de codifications.

Un nouvel attribut est disponible sur le nœud viewobject : shared.

Par défaut, la valeur est false (pas de partage de ViewObject)

Remarque : cette optimisation n'est actuellement pas disponible pour la pluspart des ViewObject métier. Une adaptation du code métier est nécessaire pour le rendre compatible avec la gestion du partage de ViewObject.

En terme technique, toute ViewObject qui appelle la méthode getSessionMetier() n'est pas partageable car l'ApplicationModule qui fournit les ViewObject partagées n'est pas l'ApplicationModule SessionMetier mais l'ApplicationModule du socle SharedViewObjectFactory.

Si on veut partager une ViewObject entre les sessions utilisateurs, il faut que cette ViewObject soit indépendante du contexte utilisateur.

Exemple de paramétrage

<viewobject_def minInstance= "1" maxInstance= "50" maxFetchSize= "20" fetchSize= "20" rowSetBufferSize= "5" >

<viewobject name= "UtConfigView" defFullName= "fr.ACE.technicalframework.businesscomponent.viewobject.UtConfigView" rowSetBufferSize= "20" shared= "true" />

…

Un nouvel attribut est disponible sur le nœud view. Deux valeurs sont possibles :

Si rien n'est précisé dans la configuration, la valeur optimize est appliquée par défaut.

Ce qui implique que l'action invalidate() devient utile pour forcer le rechargement des View (mode "optimize") : données potentiellement récupérées dans le cache et pour forcer le rechargement des View (mode "newBusinessView") : données provenant systématiquement de la base.

Exemple de paramétrage

<view nbline= "10" name= "VueUtilisateur" create= "false" type= "VueUtilisateurCourantSociete" executeQuery= "optimize" >

…

</view>

Des nouvelles entrées sont disponibles. Leur usage n'est pas réservé à la table SQL. Elles peuvent être utilisées par les Appender de type texte sans restriction.

remarque :

Le Appender JDBCAppender ne supporte pas les caractères ' (simple quote) et , (virgule). Ils sont automatiquement remplacés par un blanc.

Afin de profiter du nouveau support, il faut modifier le fichier de configuration des traces de la façon suivante :

• Ajout d'un nouvel Appender

<appender name= "JDBC" class= "org.apache.log4j.jdbc.JDBCAppender " >

<param name= "URL" value= "jdbc:oracle:thin:@alcis:1521:gnx" />

<param name= "User" value= "soc1" />

<param name= "Password" value= "xxxxx" />

<layout class= "fr.ACE.technicalframework.log4j.JDBCPatternLayout " >

<param name= "ConversionPattern" value= "INSERT INTO UT_TRACE (datsys,heursys, uuid,username,codsoc,cible,bv_courante,bv_liste,cinematic,chp,sel,trace_ID,url) VALUES ('%X{DATE}','%X{TIME}','%.100X{UUID}','%X{USER}',%X{ENTITY},'%.8X{TARGET}','%.256X{REQUEST_CURRENT_BUSINESSVIEW}','%.256X{REQUEST_BUSINESSVIEW_LIST}','%.256X{REQUEST_CINEMATIC}','%.256X{REQUEST_NAMESPACE_CHP}','%.256X{REQUEST_NAMESPACE_SEL}','%.256X{REQUEST_TRACE_ID}','%.256X{REQUEST_URL}')" />

</layout>

</appender>

remarque

La value du ConversionPattern est écrite de tel manière que les valeurs des chaînes ne peuvent pas dépasser la taille des champs dans la table. Si une valeur est trop grande, elle est tronquée par le Layout.

• Lien avec une Category

Dans cet exemple, le lien entre la Category et le Appender est désactivé. Il ne doit être activé que de façon ponctuel pour un suivi de l'activité limité dans le temps.

<category name= "activite" additivity= "false" >

<priority value= "debug" />

<appender-ref ref= "activite.log" />

< !-- <appender-ref ref="JDBC"/> -->

</category>

Pour cette fonctionnalité, il faut utiliser uniquement le PatternLayout suivant :

fr.ACE.technicalframework.log4j.JDBCPatternLayout.

Le Appender écrit dans une table SQL.

• Description

Nom de la table : ut_trace

Description des champs :

Dans le cas des traces, il est possible de passer un nouveau paramètre dont le contenu est libre. La valeur de cet attribut alimente une clé (MDC) de Log4J. Cette clé est REQUEST_TRACE_ID. Elle peut être utilisée dans la configuration de Log4J dans un Layout.

view=BV1&cinematic=forward(1)&entity=1&trace_id=identifiant-url15

Cet identifiant permet d'associer un code à certaines cinématiques pour assurer un suivi. Cet attribut est aussi valable en dehors de la trace dans une table SQL.