MEGA Publisher. Guide d utilisation

MEGA Publisher Guide d utilisation

MEGA 2009 SP4 1ère édition (juin 2010) Les informations contenues dans ce document pourront faire l objet de modifications sans préavis et ne sauraient en aucune manière constituer un engagement de la société MEGA International. Aucune partie de la présente publication ne peut être reproduite, enregistrée, traduite ou transmise, sous quelque forme et par quelque moyen que ce soit, sans un accord préalable écrit de MEGA International. MEGA International, Paris, 1996-2010 Tous droits réservés. MEGA Publisher et MEGA sont des marques réservées de MEGA International. Windows est une marque réservée de Microsoft. Les autres marques citées appartiennent à leurs propriétaires respectifs.

SOMMAIRE Sommaire...................................................... 3 Introduction................................................... 15 Conventions utilisées dans le guide........................................ 16 Présentation de ce guide................................................ 17 Première partie : Personnalisation de la documentation..........................17 Deuxième partie : Personnalisation des sites Web..............................17 Troisième partie : Personnalisation des outils standard...........................18 Quatrième partie : Glossaire et index.......................................18 PREMIÈRE PARTIE : PERSONNALISATION DE LA DOCUMENTATION Personnaliser les documents...................................... 21 Présentation des fonctions de personnalisation des documents.................. 22 Composition des documents générés.......................................23 Etapes de la génération d un document.....................................25 3

Sommaire Créer ou modifier un document...........................................27 Créer un document type.................................................33 Modifier un document type...............................................35 Mettre un document type à disposition des utilisateurs.........................39 Gérer les documents types automatiques....................................41 Généralités........................................................ 41 Rendre public un document type privé...................................... 42 Structure d un document type automatique.................................. 43 Supprimer les documents types privés..................................... 43 Personnaliser l envoi de documents........................................45 Personnaliser les descriptions rtf.................................. 53 Créer une description RTF................................................54 Ajouter un texte.......................................................56 Mettre en forme le texte............................................. 57 Remarques concernant les textes d introduction et de conclusion................. 58 Créer un groupe.......................................................59 A propos de la MetaAssociationEnd...................................... 60 A propos du choix de la requête........................................ 60 Ajouter un texte au groupe............................................. 60 Préciser les conditions d exécution d un texte............................... 61 Exécuter la description..................................................63 Remplacer un rapport type...............................................66 Aller plus loin avec les descriptions rtf.......................................... 69 Modifier une description.................................................70 Dupliquer une description.............................................. 70 Modifier l ordre des groupes et textes dans la description........................ 71 Utiliser différents types de blocs..........................................72 Utiliser les macros.................................................... 72 Ajouter une macro................................................. 72 Principe de la macro................................................ 73 Disponibilité des macros............................................. 73 Exemple de macros................................................ 73 Ajouter un diagramme................................................. 74 Propriétés d un diagramme........................................... 75 Présentation du diagramme dans le document.............................. 76 Orientation du diagramme dans le document............................... 76 Utiliser les descriptions................................................ 77 Ajouter une description existante....................................... 77 Créer une description............................................... 78 Utiliser les groupes................................................... 78 4 MEGA Publisher

Sommaire Modifier l ordre des objets dans le document................................ 81 Prendre en compte l ordre spécifié dans un diagramme........................81 Modifier les textes..................................................... 83 Ajouter l image d un objet...............................................83 Faire apparaître les noms du métamodèle....................................83 Glisser-déplacer des constituants..........................................84 Définir un format de texte...............................................85 Spécifier la langue du texte (utilisation multilingue de MEGA)......................86 Insérer un tableau dans un texte..........................................88 Ajouter des références externes dans une description...........................90 Utiliser les variables dans les en-têtes et pieds de pages.........................92 Définir une variable.................................................93 Créer un style.....................................................94 Insérer la variable dans un texte........................................96 Insérer la référence au style...........................................96 Vérifier la validité des descriptions....................................... 100 Gérer les mises en forme et les styles.............................. 101 Restituer les mises en formes des textes RTF............................... 102 Uniformiser les mises en formes......................................... 103 Restitution des mises en forme de caractères.............................. 103 Restitution des mises en forme de paragraphes............................. 103 Comment uniformiser les mises en forme................................. 104 Conserver les mises en formes introduites dans l éditeur de texte.................. 104 Restitution des mises en forme de caractères.............................. 104 Restitution des mises en forme de paragraphes............................. 105 Comment conserver les mises en forme des textes RTF....................... 105 Mises en forme et objets non supportés par MEGA............................. 105 Personnaliser les styles................................................ 106 Présentation des styles................................................ 106 Structure des styles proposés........................................... 106 Créer ou modifier des styles............................................ 106 Modifier un style.................................................. 107 Créer un nouveau style............................................. 107 Associer une feuille de style.......................................... 108 Créer une feuille de style............................................ 108 Description des styles proposés.......................................... 109 Feuille de style MegaStyl620.dot....................................... 109 Feuilles de styles antérieures à Megastyl620.dot............................ 110 5

Sommaire DEUXIÈME PARTIE : PERSONNALISATION DES SITES WEB Créer un site Web.............................................. 117 A propos de la création de sites Web......................................118 Créer un site Web.....................................................119 Définir la composition du site Web........................................120 Principe de composition d un site Web.................................... 120 Mécanisme de l extraction........................................... 120 Sélectionner des objets............................................... 121 Ajouter un objet.................................................. 121 Ajouter une liste d objets............................................ 121 Ajouter des pages................................................... 122 Fenêtre Ajouter une page........................................... 122 Sélection des pages............................................... 122 Mise en forme des pages............................................ 123 Modifier les pages................................................. 124 Ajouter des pages d'index............................................. 124 Générer un site Web...................................................126 Compiler un site Web................................................ 126 Contenu d'un site Web généré.......................................... 127 Dossiers et fichiers du site Web......................................... 132 Précisions concernant la page d accueil et la carte du site..................... 133 Utiliser un site Web type................................................134 Créer un site Web type............................................... 134 Créer un site Web à partir d'un site Web type............................... 135 Créer un site Web type à partir d un site Web............................... 138 Dupliquer un site Web type............................................ 138 Paramétrer un site Web......................................... 141 A propos du paramétrage des sites Web...................................142 Niveau 1 : Paramétrage des formateurs standard........................... 142 Niveau 2 : Paramétrage des descriptions HTML............................ 142 Niveau 3 : Paramétrage des formateurs scripts............................ 142 Modifier les caractéristiques générales d un site Web........................................................145 Paramétrer la mise en page............................................ 146 6 MEGA Publisher

Sommaire Modifier le logo, les puces et la police...................................... 149 Précisions concernant images de fond, couleurs, police, liens................... 150 Modifier le format des images........................................... 151 Format SVG..................................................... 151 Paramétrer les pages du site Web........................................ 153 Page de site Web - Onglet Caractéristiques.................................. 153 Page de site Web - Onglet Menu & Cadre................................... 153 Personnaliser les index................................................ 154 Créer un index par références croisées..................................... 154 Créer un index en fonction de caractéristiques................................ 156 Modifier le nom des pages d'index...................................... 157 Fonctions avancées des sites Web................................. 159 Notions de HTML...................................................... 160 Présentation générale de HTML.......................................... 160 Utilisation....................................................... 160 Balises......................................................... 160 Structure des documents HTML.......................................... 161 Hyperliens......................................................... 161 Autres balises HTML.................................................. 162 Utiliser les cadres..................................................... 163 Feuilles de style...................................................... 164 Présentation des feuilles de style......................................... 164 Définition des styles.................................................. 164 Styles proposés dans "Neutral.Css"....................................... 166 Modifier la feuille de style.css........................................... 168 Modifier les paramètres de la page de contenu............................. 168 Modifier les paramètres du menu....................................... 169 Exemples de paramétrage des.css..................................... 169 Gérer les fichiers du site Web............................................ 170 Structure des fichiers et des dossiers générés................................ 170 Configurer les options de l'utilisateur...................................... 170 Contrôler les noms de fichiers........................................... 171 Identifiant de l objet................................................ 171 Règles de nommage des fichiers....................................... 171 Respect de règles de nommage spécifiques................................ 172 Règles de nommage des pages d index.................................. 173 Règles de nommage des images....................................... 173 Intégrer les références externes......................................... 173 Mode standard d intégration des références externes......................... 173 Paramétrer la gestion des références externes............................. 174 Contenu de la macro............................................... 174 Personnaliser les noms d'objets et de liens................................. 176 Modifier les fichiers de page d accueil et de carte du site..................................................... 177 Paramètres utilisés dans les fichiers de génération.......................... 177 7

Sommaire Contrôler la génération du site Web.......................................179 Compte rendu de génération........................................... 179 Contrôler la validité du site Web......................................... 179 Utiliser les descriptions HTML.................................... 181 Présentation des descriptions HTML.......................................182 Accéder aux descriptions HTML....................................... 182 Présentation de l éditeur de descriptions HTML............................. 183 Icône spécifique à l éditeur de description HTML............................ 184 Structure des descriptions HTML......................................... 184 Utiliser plusieurs groupes et textes..................................... 184 Utiliser un seul texte............................................... 184 Visualiser le résultat de l exécution des descriptions HTML....................... 184 Exécuter la description de manière autonome............................. 184 Intégrer la description HTML dans un site Web............................. 185 Editer les descriptions HTML à partir du site Web............................. 185 Editer l en-tête et le corps de la description HTML.......................... 186 Définir une description avec génération complète de la page................... 186 Syntaxe des sources HTML..............................................188 Forme réduite................................................... 188 Forme étendue................................................... 188 Remarques..................................................... 188 Balises spécifiques aux descriptions HTML..................................189 Forme abrégée des balises.......................................... 189 Balise Propriété (P).................................................. 190 Layout (LY)..................................................... 190 Bookmark (BMK)................................................. 191 Link (LNK)...................................................... 191 Menu (MNU).................................................... 191 Target......................................................... 191 PictureFormat................................................... 192 Balise Constituant (C)................................................ 192 Saisir la requête dans la balise........................................ 193 Trier une liste fonction d un attribut.................................... 193 Afficher les objets qui donnent lieu à des pages............................ 194 Propriétés du constituant (CP).......................................... 194 Nombre de constituants (CL et CLP)...................................... 194 Balise Dessin (Draw)................................................. 195 Link.......................................................... 195 SvgBubble...................................................... 196 Constituants imbriqués............................................... 196 Balise WebObjectCollection (WOC)....................................... 196 Balise Workflow (WF)................................................ 197 Balise Context..................................................... 198 [Context=WebSiteHexaIdAbs/]....................................... 198 [Context=GlobalWebSiteDescriptor/]................................... 198 Balise ObjectPicture................................................. 199 8 MEGA Publisher

Sommaire Utiliser les variables................................................... 200 Paramétrer la barre de menus........................................... 200 Modifier le style du titre............................................. 200 Insérer une puce devant un titre....................................... 200 Insérer du code HTML.............................................. 200 Récupérer la souche d un _Code Template.................................. 201 Accéder aux pages d objets, d accueil et de carte du site........................ 201 Exemples....................................................... 202 Vérifier la disponibilité d un objet......................................... 202 Conditionner l'édition des balises HTML.................................... 203 Utiliser la balise [If]................................................ 204 Mettre en forme le texte HTML source..................................... 205 Utilisations spécifiques des descriptions HTML.............................. 206 Descriptions HTML et multilinguisme...................................... 206 Variables....................................................... 206 Syntaxe........................................................ 206 Insérer une adresse email dans un site Web................................. 207 Constituer un buffer.................................................. 207 Copier une image dans le dossier de génération.............................. 208 Concevoir des outils de contrôle.......................................... 208 Accéder aux propriétés d un _Code Template................................ 209 Définir un même en-tête pour tous les sites Web.............................. 210 Descriptions HTML pour les sites Web dynamiques........................... 211 Afficher un Metatree MEGA sous forme d arbre Web............................ 211 Exemple........................................................ 211 Ajouter l accès à l url de la page des favoris................................. 211 Code pour définir l url dans les menus................................... 211 Ajouter l accès à l url de la page du Rechercher............................... 212 Code exemple pour définir l url dans les menus............................. 212 Ajouter l accès à l url de la page des RFCs................................... 212 Code exemple pour définir l url dans les menus............................. 212 Ajouter l accès à l url de la page de déconnexion.............................. 212 Code exemple pour définir l url dans nos menus :........................... 212 Ajouter un attribut sur les balises Property et ComponentProperty.................. 213 Ajouter un attribut sur les balises Property et ComponentProperty.................. 213 9

Sommaire MEGA Web Access............................................. 215 Les limites des sites Web statiques.......................................216 Le composant MEGA WEB Access.........................................217 Principes de fonctionnement............................................218 Session MEGA WEB Access..............................................219 MEGA Web Access - Restitution..........................................221 TROISIÈME PARTIE : PERSONNALISATION DES OUTILS STANDARDS Rechercher les objets........................................... 225 Présentation de l outil de recherche.......................................226 Utiliser la barre de recherche............................................227 Objets recherchés................................................... 227 Nature de la recherche............................................... 229 Lancer l outil de recherche..............................................232 Rechercher depuis l espace de travail................................... 232 Rechercher depuis un autre outil MEGA.................................. 233 Utiliser l assistant d édition de requêtes...................................234 Utiliser l arborescence de l assistant de recherche............................. 234 Propriétés du type d objet cible....................................... 235 Liens.......................................................... 235 Saisir les paramètres de la requête....................................... 236 Etendre la liste des paramètres proposés................................ 237 Opérateurs de la requête.............................................. 237 Opérateurs And, Or et Not........................................... 238 Valeur des paramètres............................................... 238 Utiliser les outils d aide à la saisie...................................... 239 Afficher le code de la requête........................................... 239 Mémoriser une requête à partir de l assistant................................ 240 Utiliser les requêtes récentes............................................241 Editer les requêtes....................................................243 Utiliser une requête du référentiel..................................... 243 Créer une requête................................................ 244 Utiliser l aide lors de la saisie des requêtes............................... 244 Coller le nom d un objet dans une requête................................ 245 10 MEGA Publisher

Sommaire Résultats de la recherche............................................... 247 Constituer le résultat................................................. 247 Réinitialiser les résultats............................................. 247 Cumuler les résultats............................................... 247 Afficher les résultats.................................................. 248 Rafraîchir le contenu de la fenêtre de résultat................................ 251 Modifier les objets dans la fenêtre de résultat................................ 251 Générer un rapport HTML.............................................. 253 Manipuler les objets candidats........................................... 255 Paramétrer les options de l outil de recherche.............................. 256 Requêtes récentes................................................. 256 Synchronisation de la cible de recherche................................. 257 Syntaxe des recherches......................................... 259 Syntaxe générale des requêtes : Select.................................... 260 Notation utilisée pour les requêtes...................................... 260 Structure des requêtes.............................................. 260 Commentaires dans les requêtes....................................... 260 Variables dans les requêtes........................................... 260 Requêtes comprenant plusieurs Select................................... 260 Liste alphabétique des commandes....................................... 262 Contrôle de la syntaxe et assistance...................................... 264 Résultat : Into....................................................... 265 Condition : Where..................................................... 266 Sous-requête : In.................................................... 266 Parcours du métamodèle............................................... 266 Rappel sur la désignation des pattes.................................... 267 Conditions sur les caractéristiques des objets................................ 268 Caractères génériques.............................................. 268 Condition sur les liens................................................. 268 Condition sur l existence du lien : Null, Unique et Having count.................. 269 Condition sur les caractéristiques de lien................................. 269 Condition sur les caractéristiques de l objet source.......................... 270 Parcours des nomenclatures : Deeply.................................... 270 Conditions groupées................................................ 270 Ensembles : From..................................................... 272 Opérations sur les ensembles........................................... 273 Conseils et exemples de requêtes........................................ 274 Conseils d utilisation à propos des requêtes.................................. 274 Exemples de requêtes pour MEGA Process.................................. 277 11

Sommaire Créer des contrôles de cohérence................................. 281 Rappel : principe de fonctionnement des règles..............................282 Règles et descripteurs de contrôle..................................... 282 Les règlements.......................................................283 Afficher les règlements............................................. 283 Activer un règlement.............................................. 283 Définir les règles d un règlement...................................... 284 Périmètre d application d un règlement.................................. 284 Propriétés d une règle..................................................286 Domaine d application de la règle.........................................287 Implémentation de la règle..............................................289 Implémenter une règle par un ou des tests................................. 289 Implémenter une règle par une macro.................................... 290 Test ou macro d implémentation?....................................... 290 Définir un test d implémentation.........................................292 Définir un test d implémentation par une expression........................... 292 Expression et opérateur logique....................................... 293 Attribut et opérateur de comparaison................................... 293 Fonction ItemCount() et opérateur de comparaison......................... 294 Fonctions TrueForEach() et TrueForOne()................................ 294 Autres fonctions disponibles.......................................... 295 Définir un test d implémentation par une macro.............................. 296 Les analyses types............................................. 297 Créer une nouvelle analyse type..........................................298 Définition des paramètres d'analyse...................................... 298 Définition des rapports d'analyse........................................ 299 Créer une macro d analyse.......................................... 300 Règles de modélisation des analyses......................................301 Rappel des concepts................................................. 301 Règles de modélisation des analyses...................................... 301 QUATRIÈME PARTIE : GLOSSAIRE ET INDEX Glossaire.................................................... 305 administrateur..................................................... 305 12 MEGA Publisher

Sommaire attribut........................................................... 305 caractéristique...................................................... 305 description........................................................ 305 document......................................................... 305 document type...................................................... 306 ensemble......................................................... 306 feuille de style...................................................... 306 fonctionnalité....................................................... 306 groupe........................................................... 306 identifiant absolu.................................................... 307 lien..............................................................307 matrice........................................................... 307 MetaClasse........................................................ 307 métamodèle....................................................... 307 modèle........................................................... 307 nomenclature...................................................... 308 rapport........................................................... 308 rapport type....................................................... 308 référence externe.................................................... 308 requête........................................................... 308 style............................................................. 308 texte............................................................ 309 type d objet........................................................ 309 variable.......................................................... 309 Index....................................................... 311 13

Sommaire 14 MEGA Publisher

INTRODUCTION Un ensemble de fonctionnalités permet aux utilisateurs de personnaliser les produits de MEGA afin de les adapter à leurs besoins spécifiques. Ces personnalisations peuvent porter sur les documents ou sites Web générés par les produits de MEGA, sur les types d objets utilisés et sur les outils permettant de les manipuler. Ici sont abordés les points suivants : "Conventions utilisées dans le guide", page 16 "Présentation de ce guide", page 17 15

Introduction CONVENTIONS UTILISÉES DANS LE GUIDE Remarque sur les points qui précèdent. Définition des termes employés. Astuce qui peut faciliter la vie de l utilisateur. Compatibilité avec les versions précédentes. Ce qu il faut éviter de faire. Remarque très importante à prendre en compte pour ne pas commettre d erreurs durant une manipulation. Les commandes sont présentées ainsi : Fichier > Ouvrir. Les noms de produits et de modules techniques sont présentés ainsi : MEGA. 16 MEGA Publisher

Introduction Présentation de ce guide PRÉSENTATION DE CE GUIDE MEGA permet de personnaliser : La structure et la mise en forme des documents générés. Les sites Web, qui permettent de décrire les objets de la base sous forme de pages HTML. Ce guide présente les fonctions de personnalisation de MEGA. Il est divisé en trois parties. Première partie : Personnalisation de la documentation Les fonctionnalités décrites dans ces chapitres sont disponibles avec le module technique MEGA Publisher - Documentation seulement, à l exception de la personnalisation des documents. "Personnaliser les documents", page 21 : Personnalisation et création des documents types MEGA. "Personnaliser les descriptions rtf", page 53 : Utilisation de la fonction permettant de personnaliser les descriptions et d'en créer de nouvelles. "Aller plus loin avec les descriptions rtf", page 69 : Compléments sur la personnalisation des descriptions. "Gérer les mises en forme et les styles", page 101 : Modification des styles proposés, création et utilisation de nouveaux styles. Deuxième partie : Personnalisation des sites Web Les fonctionnalités décrites dans les chapitres "Créer un site Web", page 117, et "Paramétrer un site Web", page 141, sont disponibles avec le module technique MEGA Publisher - Web seulement. "Créer un site Web", page 117 : Utilisation de la fonction qui permet de documenter une partie du référentiel sous forme de pages HTML. "Paramétrer un site Web", page 141 : Paramétrage des pages HTML générées. "Fonctions avancées des sites Web", page 159 : Notions de base sur HTML, feuilles de style, gestion des fichiers, contrôle des noms de fichiers, intégration des références externes, personnalisation des noms d'objets et de liens. "Utiliser les descriptions HTML", page 181 : Utilisation des descriptions HTML. 17

Introduction Troisième partie : Personnalisation des outils standard "Rechercher les objets", page 225, et "Syntaxe des recherches", page 259 : Utilisation de la fonction permettant de personnaliser les requêtes et d'en créer de nouvelles. "Créer des contrôles de cohérence", page 281 : Outils permettant de contrôler la conformité des objets du référentiel avec les règles définies Quatrième partie : Glossaire et index "Glossaire", page 305 : Définition des termes utilisés. "Index", page 311. 18 MEGA Publisher

Première Partie : Personnalisation de la documentation 19

20 MEGA Publisher