Migration

Vous trouverez ici la documentation nécessaire pour faire passer vos projets, chartes graphiques et configurations de Chainedit 1 vers ChainEdit 2.

1. Précision

Certains outils de compression et décompression de fichiers peuvent poser problème lors de l'intégration dans Chainedit. Nous utilisons quant à nous 7-Zip. Les fichiers compressés via cet outil peuvent être intégrés parfaitement.

2. Migration d'un projet

Il n'y a pas d'intervention particulière à réaliser sur le projet. Pour la migration, il suffit, dans l'ancien ChainEdit, de télécharger le fichier compressé du projet (Onglet Administration / Gestion des Projets).

Dans le nouveau ChainEdit, dans la partie Adminstration / Gestion des Projets, on ajoute un nouveau projet :

Il est impératif de donner le même identifiant (Id) au projet que dans l'ancienne version de ChainEdit. On saisit également le label (qui peut être différent) et on clique sur Valider.

Après enregistrement du projet, il faut déposer le fichier compressé (en cliquant au préalable sur l'icône ). Sur le dossier projet, on sélectionne l'option « Télécharger sur le serveur ».

On renseigne ensuite quel est le schéma du projet, le cas échéant la catégorie à laquelle il appartient, les chartes qui lui sont associées…

Puis, une fois ce fichier téléchargé, il faut le décompresser.

Il est possible de vérifier que la migration s'est bien déroulée dans l'édition du projet. Si le projet s'ouvre sans problème, s'il est possible de le générer, la migration du projet s'est faite correctement.

3. Migration d'une configuration

En ce qui concerne les configurations, si vous possédez une configuration différente de celles d'ores et déjà présentes dans ChainEdit, vous devez procéder aux modifications suivantes avant l'intégration :

Dans le fichier XXXConfig.xml (XXX étant votre configuration), il faut remplacer

par

Ensuite, il faut modifier les balises ayant un attribut type=“typefck”. La valeur de cet attribut vient “typeEditor” et les paramètres changent également.

Par exemple :

devient :

Les paramètres “configEditorToolbar” ne seront précisés dans ce fichier XML, que si les outils qu'ils concernent sont utilisés dans l'élément défini par la balise. Ainsi, dans cet exemple, on définit l'élément PARAGRAPHE. On lui met les 3 paramètres correspondant aux barres d'outils nécessaires. La 3ème barre d'outils qui permet l'utilisation des fonctionnalités telles que la bibliographie, le glossaire, les formules mathématiques, etc. (“configEditorToolbar3”) sera utilisée moins systématiquement que les 2 autres.

Pour intégrer la configuration dans le nouveau ChainEdit, il faut aller dans la partie Administration / Gestion des configurations et cliquer sur l'icône pour modifier la configuration. En se positionnant sur le dossier à la racine, portant le nom de la configuration, il est possible

soit de télécharger les fichiers un par un.

soit de télécharger un fichier compressé contenant tous les fichiers de la configuration, puis de décompresser ce dernier.

4. Migration d'une charte

4.1. Encodage

Dans chaque feuille XSL, il faut remplacer par

4.2. Traitements

Auparavant, il y avait par exemple une charte pour la génération en odt ou pdf, une autre charte pour une génération en html… Par exemple, le fichier charte.xml d'une 1ère charte (génération en Open Office) était construit comme ci-dessous :

Une 2ème charte (génération en html) avait un fichier charte.xml ressemblant à ce qui suit :

Dorénavant, une charte peut correspondre à plusieurs traitements (pdf, html…). Et le fichier charte.xml contient tous les traitements, comme vous pouvez le voir dans l'exemple ci-après :

De ce fait, l'arborescence est modifiée. On a toujours un répertoire portant le nom de la charte, mais ce qui est généré n'est plus directement sous ce répertoire mais dans un sous-répertoire portant le nom du traitement. L'arborescence d'une charte se présente comme ceci :

Il faut corriger la déclaration de la variable $cheminSite dans les fichiers XSL concernés. Ainsi, dans les fichiers où la variable $cheminSite est définie, il faut remplacer : par :

4.3 Traitement Preview

4.4 Intégration

Pour intégrer la charte dans le nouveau ChainEdit, il faut aller dans la partie Administration / Gestion des configurations et cliquer sur l'icône pour gérer les fichiers. En se positionnant sur le dossier à la racine, portant le nom de la charte, il est possible de télécharger le fichier compressé (attention à l'outil utilisé pour la compression) contenant tous les fichiers de la charte, puis de décompresser ce dernier.