Macro Word de conversion des POS Word en HTML

Principe de fonctionnement

La macro est installée sur le serveur applicatif de SUNe.Team. Elle récupère des documents Word répondant à des spécifications techniques afin de les convertir en documents HTML formatés. La macro est automatiquement lancée à l'issue  de l'"Upload" de document Word.

Technique

Paramètres

La macro récupère en entrée un fichier texte qui contient tous les paramètres nécessaires au bon fonctionnement de celle-ci. Le fichier texte doit être copié dans le répertoire "C:\TEMP" et s'appeler "PARAM.TXT" Les paramètres sont :

doc_id N° interne du document
ver_id N° interne de la version ou du projet
ver_no_valide N° de version
ver_no_projet N° de projet
ver_titre Titre du document
doc_path Chemin du document Word à traiter
dir_out Chemin du répertoire de destination
web_path Racine de l'URL du site
conn_name Nom du DSN ODBC pour se connecter à la base de données

Traitements

Le traitement du fichier Word est décomposé en deux phases :

Phase 1 : Découpage de la SOP (Word) d'origine

Le fichier Word (unique) d'origine est découpé en pages élémentaires en fonction de balises de style Word positionnée dans le texte de la POS. Chaque POS sera découpé en une unique page de généralités et en 0 à n pages de contenu.

Les blocs de texte donnant lieu à des pages doivent être marqués des balises de style :

La balise SOP_procedure_debut doit contenir le titre de la procédure. Ces styles peuvent contenir du texte invisible.

Phase 1.1 : Insertion des pages dans les tables

Les pages sont crées dans les tables système de SUNe.Team (DOCUMENTS_PAGES).

Phase 2 : Conversion des pages en HTML

Chaque page générée est convertie en HTML (ASP) sans se soucier de sa nature et en suivant toujours les mêmes règles de transcodage des styles Word en styles HTML:

Style Word Style HTML
titre P.titre
titre 1 H1
titre 2 H2
titre 3 H3
titre 4 H4
titre 5 H5
B1 LI.B1
B2 LI.B2
B3 LI.B3
normalcentre P ALIGN=center
normaldroite P ALIGN=right
terme P.terme
definition P.definition
tout le reste P.n où n est le niveau de titre : 1 si P suit un titre1, 2 si P suit un titre 2...

Le GRAS et l'ITALIQUE sont récupérés.

Conversion des liens hypertextes :

Les liens hypertexte Word sont retranscrit en liens hypertexte HTML. Le lien créé utilise la page de redirection LANCE.ASP.

Sortie

Fichiers ASP dont le nom est composé comme suit : SOP_dddd_vvv_ppp_rrr.ASP

où dddd = doc_id formaté sur 4 positions (ex : 0023),
vvv = ver_no_valide formaté sur 3 positions,
ppp = ver_no_projet formaté sur 3 positions,
rrr = n° de la page de contenu (0 pour la page généralité et 1,2,3... pour les pages de contenu)

"Customiser" le rendu des POSs.

Il est donné plusieurs moyens pour modifier l'aspect des POS en HTML:

Modification du modèle objet SOP

Il est possible pour le Webmaster de modifier le convenu du fichier "ObjMod_sop_cli.js". Les modifications doivent être apportée avec un éditeur de texte (notepad.exe) par un développeur connaissant le langage JAVASCRIPT. Ce fichier contient un certain nombre de fonctions faites pour être surchargées et permettant d'intégrer du code HTML à divers endroits stratégiques de la POS :

Nom de la fonction Position
SOPWriteHead  Permet de modifier la balise HEAD de la feuille HTML, permet notemment d'appeler une feuille de style particulière
SOPWriteHaut  Haut de la page HTML
SOPWriteFooter  Bas de la page HTML
SOPWriteTitreAvt  Avant le titre
SOPWriteTitreApr Après le titre
SOPWriteTitrenAvt Avant le titre de niveau n
SOPWriteTitrenApr Après le titre de niveau n

Modification de la feuille de style

Dans le cas ou une feuille de style a été intégrée (voir ci dessus), il est possible de modifier les attribut d'affichage de chaque type de balise HTML.