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

1 PERSONNALISER LES DOCUMENTS Pour faciliter la compréhension de ce fonctionnement, les personnalisations possibles vont d abord être présentées pour un document, avant d être généralisées à un document type. Les points suivants sont abordés ici : "Présentation des fonctions de personnalisation des documents", page 22 "Créer ou modifier un document", page 27 "Créer un document type", page 33 "Modifier un document type", page 35 "Mettre un document type à disposition des utilisateurs", page 39 "Gérer les documents types automatiques", page 41 "Personnaliser l envoi de documents", page 45 Il n'est pas nécessaire de disposer du module technique MEGA Publisher - Documentation pour pouvoir mettre en oeuvre les fonctionnalités décrites ici. 21

1 PRÉSENTATION DES FONCTIONS DE PERSONNALISATION DES DOCUMENTS L utilisation de la fonction d édition avec MEGA permet de produire des documents en bénéficiant de la puissance de Microsoft Word pour Windows (par la suite, ce logiciel est désigné sous le terme "MS-Word"). Les documents MEGA sont créés à partir des documents types MEGA, de la même façon que les documents MS-Word sont créés à partir de modèles de document MS-Word. Ces documents types sont stockés dans la base système de MEGA. Cette base système contient toutes les fournitures standard qui permettent le fonctionnement de MEGA, telles que les documents types, les requêtes, les sites web types, etc. Vous allez voir ici comment créer et personnaliser des documents types, afin d adapter les documents obtenus par les utilisateurs aux standards de l entreprise. L utilisation de documents MEGA destinés à être édités ne requiert pas de connaissances approfondies de MS-Word. Cette utilisation est décrite dans les guides utilisateur. En revanche, la modification du contenu ou de la mise en forme des documents et documents types implique la maîtrise, entre autres, des notions de style, de modèle de document et de champ, utilisées par MS-Word. Ce guide n est pas destiné à l apprentissage de MS-Word : il contient uniquement quelques rappels sur ce logiciel. L'utilisation de MEGA avec un logiciel de traitement de texte autre que Word 2000 ou XP est possible, mais dans ce cas les possibilités d'édition sont limitées à l'exécution de descriptions au format RTF (voir "Personnaliser les descriptions rtf", page 53). 22 MEGA Publisher

Personnaliser les documents Présentation des fonctions de personnalisation des documents Composition des documents générés Les documents générés sont constitués de deux parties : Des textes que vous pouvez modifier directement dans le document. Des descriptions des objets contenus dans la base MEGA. L insertion des descriptions des objets issus de la base MEGA se fait en deux phases : Sélection des objets à insérer dans le document. Choix du format de description de chacun de ces objets. Dans l exemple ci-dessus, les objets sélectionnés sont les différents acteurs qui interviennent dans le projet "Gestion des commandes". Chacun des acteurs obtenus est décrit par son nom affiché en gras, et son commentaire qui est aligné sur le nom. La mise en forme des textes est faite à l aide de styles MS-Word. 23

1 La description d un objet peut faire appel à d autres objets. Dans l exemple ci-dessus, la description d un acteur contient, en plus de son nom et de son commentaire, la liste des messages qu il émet et qu il reçoit. Dans ce cas, la description d un objet est représentée par une structure arborescente comprenant un texte pour décrire chacun des objets pris en compte. 24 MEGA Publisher

Personnaliser les documents Présentation des fonctions de personnalisation des documents La description d un objet peut également contenir des dessins. Etapes de la génération d un document Pour chacun des principaux types d objets dans MEGA (processus métier, processus organisationnel, application, base de données, etc.), un ou plusieurs documents types sont disponibles. Par exemple, pour un processus, il existe un document type général, un document type spécifique pour l étude des risques, un document type spécifique à la simulation de processus. Voici les différentes étapes de génération d un document dans MEGA. 1. MEGA recherche les documents types à proposer en fonction du type de l objet à décrire et des produits disponibles pour l utilisateur. 2. S il y en a plusieurs, MEGA demande à l utilisateur de choisir le document type approprié. 3. Le document MS-Word est créé automatiquement en partant d une copie du document type choisi. 4. MEGA parcourt le document pour rechercher les requêtes qui étaient spécifiées dans le document type. 5. Pour chaque requête trouvée, le programme recherche sa définition dans la base système, puis l exécute dans la base MEGA. 6. MEGA met en forme chacun des objets résultat de la requête à l aide de la description qui était spécifiée dans le document type. Cette description se trouve dans la base système. 7. Le texte mis en forme est alors inséré dans le document. 8. Le programme traite la requête suivante. 25

1 9. Quand toutes les requêtes ont été traitées, le programme met à jour la table des matière et la table d index s il y en a une. 26 MEGA Publisher

Personnaliser les documents Créer ou modifier un document CRÉER OU MODIFIER UN DOCUMENT Pour illustrer les modifications que l on peut faire sur un document, nous allons créer un document pour présenter les acteurs de la base. Pour créer un document : 1. Dans la fenêtre de navigation Documentation, cliquez avec le bouton droit de la souris sur le dossier correspondant à "Documents" et dans son menu contextuel sélectionnez Nouveau > Document. La fenêtre de navigation Documentation est accessible par la commande Affichage > Fenêtres de navigation > Documentation. L assistant de Création d un document apparaît. 2. Sélectionnez le Type d objet documenté "Acteur" et choisissez un Objet documenté, par exemple "Groupe HBC". 3. Cliquez sur Suivant. 4. Modifiez le nom du document si nécessaire et sélectionnez un document type. 5. Cliquez sur Suivant. Les documents sont conservés hors de la base, dans un dossier partagé commun à tous les utilisateurs (sous le répertoire de la base). 6. Cliquez sur Terminer. 27

1 7. Ouvrez le document créé dans le navigateur. MS-Word s ouvre et affiche un document vide. Vous pouvez modifier la mise en page, les en-têtes et pieds de page, ou les textes d accompagnement saisis sous MS-Word : ces modifications se font comme lors de l utilisation standard de ce logiciel. Dans cet exemple, vous allez ajouter le titre du document "Les Acteurs de la base" dans le style "Document Title" proposé par MS-Word. 28 MEGA Publisher

Personnaliser les documents Créer ou modifier un document Vous allez ensuite insérer, dans un document, un rapport, pour lister les acteurs de la base avec leur commentaire. Insérer un rapport Pour insérer un rapport dans un document : 1. Dans le document, positionnez le curseur où vous souhaitez insérer le rapport. 2. Activez le bouton de la barre d'outils d'édition de document (disponible à côté des barres d outils Word). La commande Insertion d un rapport est également disponible dans le menu MEGA de MS-Word. La fenêtre Insertion d'un rapport apparaît. Pour définir un rapport : 1. Indiquez le type d'objet sur lequel porte le rapport. Ici, il s'agit d' "Acteur". 2. Précisez le critère de recherche permettant de lancer la Requête désirée. Ici, choisissez la requête "Nom" qui va vous permettre d indiquer le nom de l acteur dont vous souhaitez la 29

1 description (celui que vous avez spécifié à la création du document). 3. Définissez la Mise en forme des objets, à l'aide d'une description choisie parmi celles proposées par MEGA. Ici, choisissez "Détails (Acteur)". Une description permet d éditer sous forme de document une partie du contenu de la base. La description d un objet comprend des caractéristiques propres à cet objet auxquelles peuvent être ajoutées des caractéristiques des objets qui lui sont reliés directement ou indirectement. Une mise en forme est saisie pour chacun des objets rencontrés sous forme de texte à l aide de MS-Word. Une description peut être utilisée telle quelle pour produire des rapports, ou être insérée dans des documents ou des documents types. Il est possible d'en créer ou modifier avec le module technique MEGA Publisher - Documentation. 4. Dans la fenêtre Insertion d'un rapport, cliquez sur OK. 5. Dans la fenêtre Paramètres de la requête, sélectionnez un acteur à l aide de la flèche et cliquez sur OK. La description du rapport insérer apparaît dans le document. 30 MEGA Publisher

Personnaliser les documents Créer ou modifier un document 6. Sélectionnez la description du rapport et cliquez sur Après un temps de mise à jour, le résultat s affiche dans le document. Mettre à jour un rapport Si vous voyez des symboles bizarres à la place du résultat, vérifiez dans Word si l'option Codes de champ n'est pas sélectionnée (onglet Affichage ouvert avec la commande Outils > Options). La combinaison de touches <Maj + F9> vous fera passer alternativement de ce mode d'affichage au mode normal. Pour mettre à jour en une seule fois tous les rapports insérés dans un document : 1. Sélectionnez l ensemble du document 2. Mettez à jour le contenu du document en appuyant sur la touche <F9> ou en activant le bouton de la barre d outils d édition de document. Cette manipulation est à faire lorsque les différents rapports interagissent, afin d assurer leur cohérence. Quand plusieurs rapports sont insérés dans un document, il est également possible de mettre à jour le résultat de chaque rapport indépendamment des autres. Le rapport s'exécute de nouveau, pour prendre en compte les mises à jour effectuées dans la base MEGA. 31

1 Les rapports Les rapports interrogent la base. Ils sont constitués : d une requête, gérée par la fonctionnalité de recherche (voir "Rechercher les objets", page 225) d une description, gérée par la fonctionnalité de personnalisation des descriptions (voir "Personnaliser les descriptions rtf", page 53). Pour faire apparaître le code du rapport : Demandez l affichage des codes de champs depuis le menu Outils > Options de MS-Word ou à l aide du raccourci <Majuscules> + <F9>. La suppression d un rapport se fait en supprimant le champ correspondant. La modification ou l ajout de rapports MEGA se fait à partir de MS-Word, mais utilise des commandes et des fonctionnalités de MEGA. Vous pouvez maintenant fermer votre document. 32 MEGA Publisher

Personnaliser les documents Créer un document type CRÉER UN DOCUMENT TYPE Vous pouvez créer ou modifier un document autant de fois que nécessaire ; cependant, si vous voulez produire plusieurs documents du même type, il est préférable de réutiliser un même document type lors de la création de chaque document. Un document type MEGA constitue le squelette du document : ce squelette sera étoffé, lors de la création d un document, avec les données contenues dans la base. Il contient des textes et rapports types, qui permettent ainsi d obtenir rapidement des documents associés à un objet. Vous pouvez créer un document type même si vous ne disposez pas du module technique MEGA Publisher - Documentation. Les documents types proposés en standard sont protégés. Vous devez les dupliquer si vous souhaitez les modifier ou en créer à partir de ceux proposés. Dans l exemple qui suit, vous allez créer un nouveau document type décrivant la liste des acteurs d un projet avec leurs commentaires. Pour créer un document type à partir d un document type existant : 1. Sélectionnez la fenêtre de navigation Utilitaires. La fenêtre Utilitaires est accessible par la commande Affichage > Fenêtres de navigation > Utilitaires de l espace de travail. 2. Dans le dossier correspondant à "Document types", sélectionnez le document type à partir duquel vous voulez créer le vôtre, par exemple "Standard". Le document type "Standard" contient uniquement les définitions de styles et des macros, permet de créer un document type vierge. L'utilisation d'un autre document type permet de créer, à partir du travail déjà effectué sur celui-ci, un document type plus complet ou plus réduit : il suffira de modifier la structure reprise pour rendre le nouveau document type rapidement opérationnel. 3. Dans le menu contextuel du document type, cliquez sur Dupliquer. La fenêtre Dupliquer un objet (Document type) apparaît. 4. Modifiez le Nom du document type à créer, par exemple "Acteurs d'un Projet". 33

1 5. Dans le champ Stratégie, sélectionnez Réutiliser les descriptions et requêtes. Pour plus de détails sur la duplication des documents types, voir "Dupliquer une description", page 70. 6. Cliquez sur OK. Une fois la duplication terminée, l'élément correspondant au nouveau document type est créé. Il est alors possible de l'ouvrir en utilisant son menu contextuel. L application MS-Word passe alors au premier plan. 34 MEGA Publisher

Personnaliser les documents Modifier un document type MODIFIER UN DOCUMENT TYPE Les modifications d un document type peuvent s appliquer à la mise en page, aux en-têtes et pieds de page, ou aux textes d accompagnement saisis sous MS-Word : dans ce cas, elles concernent uniquement MS-Word, et se font comme lors de l utilisation standard de ce logiciel. Vous allez, comme précédemment, ajouter le titre du document "Les Acteurs d un Projet" dans le style "Document title" proposé par MS-Word. Pour afficher le nom du projet dans le document type, nom qui devra être instancié dans chacun des documents que vous créerez à partir de ce document type, vous allez insérer un rapport type. Rapports et rapports types Les rapports interrogent la base ; ils sont constitués : d une description (voir "Personnaliser les descriptions rtf", page 53) d une requête (voir "Rechercher les objets", page 225). Les rapports types peuvent être insérés dans les documents types : ils sont transformés en rapports lors de la création d un document. 35

1 Insérer un rapport type Pour insérer un rapport type dans un document type : 1. Positionnez le curseur là où vous souhaitez insérer le rapport. 2. Cliquez sur le bouton de la barre d'outils d édition de document. La fenêtre Insertion d'un rapport type s ouvre. 3. Comme pour un rapport, précisez le type d'objet sur lequel porte le rapport type. Il s'agit ici de "Projet". 4. Ensuite, précisez le critère de recherche permettant d'effectuer la Requête du projet désiré. Ici, choisissez la requête "Nom", qui va rechercher le projet dont le nom sera passé en paramètre. 5. Enfin, il faut définir la Mise en forme du résultat avec une description. La description "Nom Projet" permet d'afficher le nom du projet. Après activation du bouton OK, une fenêtre intermédiaire apparaît lorsque des paramètres doivent être résolus. 6. Renseignez le nom de la variable dont la valeur sera demandée lors de la création d'un document. Ici, il s'agit de "Nom du Projet". Si la case v est inactivée, la valeur saisie sera prise directement comme valeur de la variable lors de la création du document. 7. Cliquez sur le bouton OK. 36 MEGA Publisher

Personnaliser les documents Modifier un document type 8. Après l'insertion de ce premier rapport type, saisissez, dans MS-Word, le titre du paragraphe suivant, "Liste des Acteurs", et affectez à ce titre le style "Titre 1". 9. Dans le document type, insérez ensuite un deuxième rapport type, pour présenter les "Acteurs d'un Projet" avec la description "Détails (Acteur)". 10. Renseignez les champs de la fenêtre et cliquez sur OK. 11. Indiquez le nom de la variable qui sera demandée lors de la résolution de ce rapport. Plusieurs rapports peuvent utiliser la même variable. Il suffit pour cela de donner le même nom aux variables associées à chacun de ces rapports. Dans cet exemple, saisissez "Nom du Projet". L'insertion d'un rapport type se traduit par l'insertion d'un rapport MEGA dans MS-Word, suivi du nom de la description utilisée (ici, 37

1 "Détails (Acteur)"), puis de la requête et du nom de la variable (ici, "Acteurs d'un Projet", "Nom du Projet") : Rapport type 'Détails (Acteur) : Acteurs d'un Projet, Nom du Projet' La suppression d'un rapport type se fait en supprimant la ligne correspondante. Vous pouvez maintenant créer des documents à partir de votre nouveau document type. Ils ressembleront à l exemple suivant : 38 MEGA Publisher

Personnaliser les documents Mettre un document type à disposition des utilisateurs METTRE UN DOCUMENT TYPE À DISPOSITION DES UTILISATEURS Extraire un document type Pour disposer d une sauvegarde que vous pourrez réutiliser dans un autre environnement, il est nécessaire d extraire le document type, avec les requêtes et descriptions qu il utilise. Pour extraire un document type : 1. Dans le navigateur, sélectionnez le document type "Acteurs d'un Projet" et choisissez la commande Propriétés de son menu contextuel. 2. Dans la fenêtre qui s'affiche, sélectionnez l'onglet Objet documenté. Le bouton Rafraîchir permet de mettre à jour les liens entre le document type et ses constituants (qui sont les requêtes et descriptions). 3. Assurez-vous que le type d objet documenté apparaît. Dans notre exemple, il s agit de "Projet". Il est conseillé, si des requêtes ou des descriptions ont été modifiées ou renommées, d'activer le bouton Rafraîchir avant l'extraction. En cas de doute, activez systématiquement ce bouton avant l'extraction. 4. Précisez éventuellement la catégorie à laquelle est rattaché le type d'objet. Une catégorie est un groupe d'objets du même type. Par exemple, "Organigramme" est une catégorie du type "Diagramme". Un type peut comporter plusieurs catégories. 5. A partir du menu contextuel du document type, activez la commande Administrer > Exporter. La fenêtre Exporter des objets MEGA apparaît. 6. Cliquez enfin sur le bouton Exporter. 39

1 Modifier la configuration par défaut des documents types Vous pouvez proposer par défaut le document type que vous venez de créer pour un type d objet donné (ici, "Projet"). Pour modifier la configuration par défaut des documents types : Dans l'onglet Objet documenté de la fenêtre de propriétés du document type, cochez la case Document type par défaut. Lorsque vous générerez un document sur le type d objet concerné, ce document type servira de modèle à la création du document. Si, par la suite, vous souhaitez lancer par défaut un autre document type, décochez cette case et cochez la case dans la fenêtre de propriétés de l'autre document type. Si vous souhaitez qu'aucun document type ne soit systématiquement lancé par défaut, ne cochez pas ces cases. Les divers documents types rattachés au type d'objet à partir duquel vous souhaitez générer un document vous seront alors proposés. 40 MEGA Publisher

Personnaliser les documents Gérer les documents types automatiques GÉRER LES DOCUMENTS TYPES AUTOMATIQUES La création de documents avec l assistant engendre la création de documents types automatiques qu il est nécessaire d administrer. Généralités Un nouveau document type est automatiquement créé lorsque vous construisez un nouveau document avec l assistant. Pour plus de détails cet assistant, voir "Gérer les documents word" dans MEGA Common Features. Lors de sa création ce nouveau document type est privé, il est donc visible uniquement par son créateur. Ce document type peut être rendu public afin qu il puisse être utilisé par tous les utilisateurs. Pour plus de détails voir "Rendre public un document type privé", page 42. Pour accéder à ces documents types : 1. Dans l espace de travail MEGA, sélectionnez la fenêtre de navigation Utilitaires. 2. Dépliez successivement les dossiers Document type et Privé. Le dossier Privé contient tous les documents types privés de l utilisateur courant. Le dossier Automatique contient tous les documents types créés par l assistant (privés ou publics). Un document type privé est détenu par l utilisateur qui l a créé. Vous pouvez le constater en explorant le document type. L explorateur n est pas visible par défaut. Pour l afficher : 1. Cliquez sur le menu Outils > Options de l espace de travail MEGA. 2. Cliquez sur le dossier Espace de travail. 3. Cochez la case Activer l explorateur. Pour explorer le document type : 1. Faites un clic droit sur le document et cliquez sur Explorer. 2. Dans la fenêtre qui apparaît sélectionnez le dossier Utilisateur. 41

1 L utilisateur est affiché dans le volet droit de la fenêtre. Pour voir apparaître ce dossier, vous devez accéder au métamodèle en mode "Avancé". Rendre public un document type privé Pour rendre public un document type privé : 1. Dans la fenêtre de navigation Utilitaires, dépliez successivement les dossiers Document type et Privé. 2. Faites un clic droit sur le document type désiré et sélectionnez Administrer > Rendre public. Le document type est déplacé dans la liste globale des documents types. Un document type rendu public peut être de nouveau classé comme privé. Pour cela : Sélectionnez le document type et glissez-le dans le dossier Privé. Lorsqu un document type automatique a été rendu public, les autres utilisateurs de l environnement pourront réutiliser ou modifier ce document type. 42 MEGA Publisher

Personnaliser les documents Gérer les documents types automatiques Structure d un document type automatique La création d un document à partir de l assistant entraîne également la création : d un document type automatique d un lien vers la description "Document Name" livrée par MEGA d une ou plusieurs descriptions Ces descriptions peuvent contenir des requêtes embarquées. Elles peuvent être modifiées de la même façon que des descriptions ordinaires. Attention : Lorsqu un document type automatique est modifié avec l assistant de création de documents, les descriptions contenues dans le document type sont écrasées. Supprimer les documents types privés Les documents types et les descriptions privés peuvent être supprimés lors du nettoyage de la base. Pour supprimer tous les documents types et les descriptions privés : 1. Sélectionnez le menu Fichier > Propriétés dans l espace de travail MEGA. 43

1 2. Dans la fenêtre qui apparaît cliquez sur Nettoyage de base. La fenêtre de nettoyage de la base présente les groupes d éléments qui peuvent être supprimés. Les documents types et les descriptions privés proposés sont ceux de l utilisateur courant. Pour voir la liste des descriptions ou documents types privés cliquez sur le bouton Visualiser. 3. Cliquez sur OK. Les éléments sélectionnés sont supprimés. Pour ne supprimer qu un seul document type privé à la fois : 1. Faites un clic droit sur le document type et sélectionnez Supprimer. Une fenêtre vous demande de confirmer la suppression. 2. Cliquez sur Supprimer. Le document type est supprimé. 44 MEGA Publisher

Personnaliser les documents Personnaliser l envoi de documents PERSONNALISER L ENVOI DE DOCUMENTS MEGA permet d envoyer des documents pour revue ou validation. Cette fontionnalité est accessible via les commandes Envoi pour revue et Envoi pour validation de la fenêtre de propriétés d un document. Les informations concernant les destinataires sont basées sur le contenu de l onglet Diffusion de la fenêtre de propriétés du document. Les règles concernant la liste des destinataires sont décrites dans le guide MEGA Common Features, chapitre "Générer la documentation", paragraphe "Diffuser un document pour revue ou validation". Si vous souhaitez personnaliser cette fonctionnalité (par exemple, paramétrer le contenu de l objet, les destinataires, etc), vous devez surcharger le code C++ dans MEGA. Pour être en mesure d intervenir à ce niveau vous devez accéder au métamodèle en mode "Avancé". Pour cela, vous devez : 1. Cliquez sur le menu Outils > Options. 2. Dans la fenêtre qui apparaît, cliquez sur le dossier Référentiel. 3. Dans l option Accès au métamodèle, sélectionnez le mode "Avancé". 4. Cliquez sur OK. Pour personnaliser l envoi des documents : 1. Explorez la MétaClasse "Document". 2. Sélectionnez par exemple le MetaCommand "Envoi pour validation" et ouvrez sa boite de propriétés. 3. Dans l onglet Paramétrage de la fenêtre de propriétés du MetaCommand, vous pouvez accéder aux macros. La macro "MEGADocSendForValidation" appelle du code C++ qui exécute du code standard. 45

1 4. Créez une nouvelle macro, par exemple MyDocSendForValidation. 5. Ouvrez la fenêtre de propriétés de cette nouvelle macro. 46 MEGA Publisher

Personnaliser les documents Personnaliser l envoi de documents 6. Copiez votre script dans l onglet VB Script de la fenêtre de propriétés de la macro et cliquez sur OK. Pour faire appel à un VB script de ce type, vous devez utiliser une.dll (cdo.dll) et la déployer sur tous les postes. L utillisateur doit disposer de droits d administration suffisants pour qu un script puisse être exécuté automatiquement sur son poste. 47

1 L exemple ci-dessous peut constituer le script de la macro DocSendForValidation. Option Explicit 'MetaAttributes Const cmaemail = "106F1C6C3CA31620" 'EMail adress Const cmadistributionrole = "60B562F3336F0127" 'Distribution role for person and org-unit Const cmaorgunitdistributionrole = "60B562F3336F0127" 'Distribution role for an org-unit Const cmapersondistributionrole = "85BB860131510030" 'Distribution role for a person 'MetaAssociationEnd Const cmaerecipientorgunit = "E9C4EA59396501B6" ' Recipient Org-unit Const cmaerecipientperson = "E9C4EAF6396501D2" ' Recipient Person Sub CmdInvoke( odocument, number) ' 1 - Detach Document Dim ofso Dim ofolder Dim strdocument '---- Set ofso = CreateObject("Scripting.FileSystemObject") ' Retrieve Temporary directory Set ofolder = ofso.getspecialfolder(2) strdocument = ofolder.path & "\" & odocument.name ' Detach current document in the temporary directory odocument.detachdocument( strdocument ) Set ofso = Nothing Set ofolder = Nothing ' 2 - Lauch Exchange server 48 MEGA Publisher

Personnaliser les documents Personnaliser l envoi de documents Dim osession Dim omessages Dim omessage '---- Set osession = CreateObject("MAPI.Session") ' Logon to the Mail server osession.logon 'Retrieve Messages and add message to be sent Set omessages = osession.outbox.messages Set omessage = omessages.add omessage.subject = "Document Validation : " & odocument.name omessage.text = "Document to be validated sent by MEGA." 'Add Recipients 'Add org-unit Dim oorgunit Dim oorgunitrecipients '--- Set oorgunitrecipients = odocument.getcollection( odocument.getroot.getobjectfromid(cmaerecipientorgunit).get ID ) For Each oorgunit in oorgunitrecipients AddRecipient omessage, oorgunit, cmaorgunitdistributionrole Next Set oorgunit = Nothing Set oorgunitrecipients = Nothing 'Add persons Dim operson Dim opersonrecipients '--- Set opersonrecipients = odocument.getcollection( odocument.getroot.getobjectfromid(cmaerecipientperson).geti D ) For Each operson in opersonrecipients AddRecipient omessage, operson, cmapersondistributionrole 49

1 Next Set operson = Nothing Set opersonrecipients = Nothing 'Add Attachment Dim oattachments Dim oattachment '----- Set oattachments = omessage.attachments Set oattachment = oattachments.add oattachment.name = strdocument oattachment.source = strdocument 'Send Mail omessage.send True, True 'logout osession.logoff Set oattachments = Nothing Set oattachment = Nothing Set osession = Nothing Set omessages = Nothing Set omessage = Nothing End Sub Sub AddRecipient( omessage, opeople, strattribute) Dim stremail Dim orecipients '----- Set orecipients = omessage.recipients stremail = opeople.getprop( opeople.getroot.getobjectfromid(cmaemail).getid) 'Only people with an email address can receive the document If stremail <> "" Then Dim strrole Dim nmode 50 MEGA Publisher

Personnaliser les documents Personnaliser l envoi de documents '---- strrole = opeople.getrelationship.getprop(opeople.getroot().getobject FromID(strAttribute).GetID, "internal") ' People with "Validation" role are direct recipients of the email If strrole = "RA" Or strrole = "AV" Or strrole = "A" Then nmode = 1 Else ' People with "Information" or "Checker" role are recipients by copy of the email If strrole = "RV" Or strrole = "I" Then nmode = 2 Else nmode = 0 End If End If If nmode <> 0 Then Dim orecipient '----- 'Add recipients Set orecipient = orecipients.add orecipient.name = stremail orecipient.type = nmode 'Set orecipient = Nothing End If End If 'Set orecipients = Nothing End Sub 51

1 52 MEGA Publisher

2 PERSONNALISER LES DESCRIPTIONS RTF Les descriptions fournies à l installation peuvent être adaptées aux besoins spécifiques de votre entreprise si vous disposez du module technique MEGA Publisher - Documentation. Vous pouvez créer de nouvelles descriptions : Les points suivants sont abordés ici : Afin de les utiliser seules pour obtenir des fichiers utilisables par la plupart des traitements de texte (format RTF). Pour les insérer dans des rapports ou des rapports types utilisés dans vos documents et documents types. "Créer une description RTF", page 54 "Ajouter un texte", page 56 "Créer un groupe", page 59 "Exécuter la description", page 63 "Remplacer un rapport type", page 66 "Aller plus loin avec les descriptions rtf", page 69 Pour plus de détails sur les descriptions utilisés pour la génération de code, voir "Descriptions de génération de code", page 25. 53

2 CRÉER UNE DESCRIPTION RTF Les descriptions ne sont pas affichées par défaut et requièrent un accès au métamodèle en mode "Avancé". Pour afficher le métamodèle en mode "Avancé" : 1. Dans l espace de travail, cliquez sur le menu Outils > Options. 2. Dans la fenêtre qui apparaît, cliquez sur Référentiel. 3. Dans l option Accès au métamodèle, sélectionnez le mode "Avancé". 4. Cliquez sur OK. L exemple qui suit vous indique comment créer une nouvelle description et la modifier. Cette description va éditer un acteur et les messages qu il échange avec d autres acteurs. Elle pourra être insérée dans le document type créé dans "Personnaliser les documents", page 21, à la place de la description "Détails(Acteur)", ou être exécutée seule. 1. Dans l espace de travail, sélectionnez la fenêtre Utilitaires. La fenêtre Utilitaires est accessible par la commande Affichage > Fenêtres de navigation > Utilitaires. 2. Sélectionnez le dossier Descriptions > Rtf > Personnel et dans le menu contextuel cliquez sur Nouveau > Description. La fenêtre Création d une description apparaît. Les descriptions de type "Contextuel" ont été conçues pour être utilisées dans un document type. Les descriptions de type "Elémentaire" peuvent être utilisées dans un document type, mais peuvent avoir un intérêt en tant que telles quand elles sont exécutées seules. Les descriptions de type "Personnel" sont celles que vous créez vousmême. 3. Indiquez le Nom de la description ("Acteurs et leurs échanges" dans l exemple). 54 MEGA Publisher

Personnaliser les descriptions rtf Créer une description RTF 4. Sélectionnez l Objet décrit ("Acteur"). La description peut également porter sur une métaclasse abstraite. Si le nom indiqué est déjà utilisé pour une autre description, le bouton OK reste grisé. 5. Cliquez sur OK. Pour définir la structure de votre descripteur, double-cliquez sur la description créée. La fenêtre du descripteur s ouvre. Il est également possible de créer une description à partir d une description existante. Pour cela, dans l arborescence de la fenêtre Utilitaires, cliquez sur votre description et sélectionnez la commande Dupliquer dans son menu contextuel. Pour plus de détails, voir "Dupliquer une description", page 70. 55

2 AJOUTER UN TEXTE Un texte est l élément de base permettant de définir ce qui sera affiché pour chacun des objets présents dans le document généré. Nous allons ajouter un texte sur l objet "Acteur" pour éditer son nom et son commentaire. Pour ajouter un texte dans une description : 1. Cliquez avec le bouton droit sur le dossier représentant l objet décrit et sélectionnez, dans le menu contextuel, la commande Nouveau > Texte. Le texte se pose dans la fenêtre de l éditeur de descriptions. La fenêtre qui s affiche permet d éditer votre texte dans Word (partie supérieure) en y indiquant différents champs (partie inférieure). L icône indique quel texte est en cours d édition. 56 MEGA Publisher

Personnaliser les descriptions rtf Ajouter un texte Pour insérer, par exemple, le champ Nom dans la zone texte : Cliquez sur le champ Nom de la liste des "Caractéristiques de l objet" et déplacez-vous jusqu à l endroit désiré tout en maintenant le bouton gauche de la souris enfoncé. Pour insérer, par exemple, le champ Commentaire dans la zone texte : Cliquez sur le champ Commentaire de la liste des "Caractéristiques de l objet" et déplacez-vous jusqu à l endroit désiré tout en maintenant le bouton gauche de la souris enfoncé. Mettre en forme le texte Vous pouvez modifier la mise en forme en utilisant les styles proposés par MS-Word. Les styles M-... sont basés sur M - Normal, semblables au style Normal de Word, avec des caractères bleus. 57

2 En appliquant le style "Titre 2" au Nom et le style "M-Comment" au Commentaire, vous obtenez le texte suivant : Les champs "Caractéristiques de l objet " ne peuvent être édités manuellement. Vous devez les insérer dans le texte par glisser-déplacer comme expliqué ci-dessus, ou par copier-coller. Quand vous avez terminé, fermez ce texte en activant la commande Fermer du menu contextuel de "Texte". Le texte est automatiquement enregistré. L icône reprend alors sa forme initiale. Remarques concernant les textes d introduction et de conclusion Vous pouvez procéder de la même manière pour insérer un texte en Introduction ou en Conclusion. Un texte d introduction est traité avant tous les textes reliés à l objet, un texte de conclusion est traité après. Il faut cependant noter que les textes Introduction (Avant) et Conclusion (Après) ne sont pas exécutés si la description est appelée depuis une autre description. 58 MEGA Publisher

Personnaliser les descriptions rtf Créer un groupe CRÉER UN GROUPE L arbre de description d un objet est constitué de plusieurs groupes qui s enchaînent. Chaque groupe porte sur un objet et précise la requête ou le lien qui permet de passer de l objet précédent à cet objet. Pour créer un groupe et, par exemple, voir apparaître les messages émis par chaque acteur : 1. Ajoutez un groupe en cliquant avec le bouton droit sur l icône du type d objet (Acteur) et en sélectionnant la commande Groupe. La fenêtre Propriétés d un groupe s ouvre. 2. Sélectionnez l objet "Message" et la requête. 3. Dans la zone Requête ou MetaAssociationEnd, choisissez "Message- Emis". Il n est généralement pas utile d indiquer le Titre du groupe à créer, car le nom de l objet et celui de la requête associée suffisent à identifier le groupe. Le nouveau groupe est dessiné sur le plan de travail. 59

2 A propos de la MetaAssociationEnd Une MetaAssociationEnd (ou patte) est l'extrémité d'une metaassociation qui relie la metaassociation à une metaclasse. Sont proposés dans la liste des MetaAssociationEnd les liens concrets ainsi que les liens génériques. En recherchant par exemple les processus organisationnels liés à une opération, vous voyez apparaître l ensemble des liens qui relient ces deux types d objet, dont le lien générique "Comportement" qui permet de retrouver le processus organisationnel décrivant le comportement de l opération. A propos du choix de la requête Dans la fenêtre Propriétés d un groupe, vous pouvez : choisir une requête cataloguée (c est-à-dire fournie par défaut dans le référentiel) ou embarquer une requête que vous ne souhaitez pas enregistrer dans le référentiel. En effet, si vous avez ponctuellement besoin d écrire une requête qui ne sera jamais réutilisée ailleurs, cochez l option Requête Embarquée. Vous pouvez écrire le code de votre requête directement dans le cadre correspondant. Pour plus de détails sur les requêtes, voir "Rechercher les objets", page 225. Ajouter un texte au groupe Pour ajouter un texte au groupe : 1. Cliquez avec le bouton droit sur l icône "Avant" du nouveau groupe. Un menu contextuel s ouvre. 2. Activez la commande Texte, pour ajouter un texte au début de la liste des messages émis par un acteur. 3. Dans la fenêtre MS-Word, saisissez le texte "Message(s) émis", qui sera édité avant la liste des messages. 4. Attribuez-lui par exemple le style "M-List". Voir "Gérer les mises en forme et les styles", page 101, pour plus de détails sur les styles proposés. 5. Fermez ensuite la fenêtre d édition des textes en activant la commande Fermer du menu contextuel de l icône "Texte". 60 MEGA Publisher

Personnaliser les descriptions rtf Créer un groupe 6. Ajoutez de la même manière un texte sur l objet "Message émis" pour éditer son nom et son commentaire. Une icône "Texte" est de nouveau insérée dans l arborescence. 7. Sélectionnez le Nom dans la liste des Caractéristiques et faites-le glisser dans la fenêtre Word. Le texte "<Nom/>" apparaît. 8. Ajoutez de même le "Commentaire" du message. 9. Modifiez la mise en forme en utilisant les styles proposés par MEGA et MS-Word. 10. Fermez votre texte. Vous pouvez créer un deuxième groupe similaire pour afficher les messages reçus par un acteur. N oubliez pas d enregistrer régulièrement votre travail à l aide de la commande MEGA > Enregistrer. Préciser les conditions d exécution d un texte L éditeur de descriptions vous permet de préciser les conditions d un texte lorsqu il s agit d un texte "Avant". Ainsi, vous pouvez faire varier le texte selon le nombre d objets résultant de l exécution de la requête. Pour préciser les conditions d exécution du texte : 1. Activez le menu contextuel du texte et choisissez la commande Propriétés. 2. Sélectionnez l onglet Exécution de la fenêtre qui apparaît. 61

2 Le texte est édité en fonction du nombre d objets trouvés lors de l exécution de la requête (donc du nombre de messages émis par l acteur, dans cet exemple). Condition d exécution : Aucun objet : Le texte sera affiché quand il n y a aucun objet (ex: "Pas de message émis"). Un seul objet : Le texte sera affiché quand il y a un seul objet (ex: "Message émis"). Un objet ou plus : Le texte sera affiché quand il y a un ou plusieurs objets (ex : "Message(s) émis"). Plus d un objet : Le texte sera affiché quand il y a plusieurs objets (ex : "Messages émis"). Votre description doit avoir l aspect suivant : Si l ordre est différent, vous pouvez réordonner les textes et les groupes. Voir "Modifier l ordre des objets dans le document", page 81, pour réordonner une description. 62 MEGA Publisher

Personnaliser les descriptions rtf Exécuter la description EXÉCUTER LA DESCRIPTION Pour exécuter la description : 1. Dans l éditeur de descriptions, sélectionnez MEGA > Exécuter. La fenêtre de recherche apparaît. 2. Cliquez sur 3. Dans la fenêtre qui s affiche, sélectionnez les objets (acteurs) qui vous intéressent et cliquez sur OK. Une fenêtre d avancement apparaît lors de l exécution de la description. 63

2 Vous obtenez le résultat suivant : Si vous obtenez quelque chose de différent, vous pouvez changer le contenu des textes de la description ou les réordonner. Re-exécuter la description à partir des objets mémorisés MEGA conserve en mémoire les objets qui ont servi à la dernière exécution de la requête. Ils apparaissent dans l onglet Eléments mémorisés. Vous pouvez supprimer un objet de la liste en cliquant avec le bouton droit sur l objet en en sélectionnant Enlever. Cet ensemble d objets permet un gain de temps au moment d exécuter et de tester la description. 64 MEGA Publisher

Personnaliser les descriptions rtf Exécuter la description Pour ré-exécuter la description à l aide des objets mémorisés : Cliquez sur le bouton et dans le menu contextuel qui apparaît, sélectionnez Exécuter sur l ensemble mémorisé. Les rapports s exécutent et le document au format.rtf est re-généré. Changer de feuille de style La feuille de style utilisée est indiquée dans une liste déroulante. Lors de l exécution de la description, c est la feuille de style courante qui est utilisée. Vous pouvez si nécessaire changer la feuille de style utilisée par défaut. 65

2 REMPLACER UN RAPPORT TYPE Il est possible de remplacer le rapport type contenant la description "Détails (Acteur)" dans le document type "Acteurs d un Projet" par un nouveau rapport type contenant la description "Acteurs et leurs échanges". Les documents types fournis en standard sont protégés. Il vous faut donc les dupliquer avant d y apporter des modifications. Il en est de même pour les descriptions. Pour supprimer l ancien rapport type, puis insérer le nouveau : 1. Ouvrez le document type. 2. Supprimez le rapport type en effaçant son code. 3. Activez le bouton de la barre d outils d édition de document. La fenêtre Insertion d un rapport type s ouvre. 4. Sélectionnez l Objet "Acteur", la Requête "Acteurs d un Projet" et la description "Acteurs et leurs Echanges" pour la Mise en forme. 66 MEGA Publisher

Personnaliser les descriptions rtf Remplacer un rapport type 5. Renseignez le nom de la variable "Nom du Projet". Le nouveau rapport type est inséré dans le document. 6. Fermez le document en enregistrant les modifications. 7. Créez un document à partir de ce document type. 8. Indiquez un nom de projet relié à des diagrammes présentant des acteurs. Le document obtenu a l aspect suivant : 67

2 68 MEGA Publisher

3 ALLER PLUS LOIN AVEC LES DESCRIPTIONS RTF Vous avez, au cours des deux premiers chapitres, découvert les principes de base de la personnalisation des documents et descriptions rtf. Vous allez maintenant découvrir des fonctionnalités plus avancées, qui vous seront utiles notamment pour affiner vos descriptions. Les points suivants sont abordés ici : Les fonctionnalités concernant la personnalisation des descriptions ne sont disponibles qu avec le module technique MEGA Publisher - Documentation. "Modifier une description", page 70 "Utiliser différents types de blocs", page 72 "Modifier l ordre des objets dans le document", page 81 "Modifier les textes", page 83 "Vérifier la validité des descriptions", page 100 69

3 MODIFIER UNE DESCRIPTION Dupliquer une description Les descriptions qui sont créées à l installation sont protégées, pour éviter tout conflit lors d installation de versions ultérieures. Si vous voulez modifier une description de ce type, il est nécessaire de la dupliquer. Pour dupliquer une description : 1. Dans la fenêtre Utilitaires de l espace de travail, sélectionnez la description que vous souhaitez dupliquer. 2. Dans le menu contextuel de la description, sélectionnez Dupliquer. La fenêtre Dupliquer un objet s affiche. 3. Indiquez un Préfixe/Suffixe qui servira à créer le nom des descriptions dupliquées. 4. Modifiez le Nom de la description créée en duplication. 70 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier une description Modifier l ordre des groupes et textes dans la description Pour déplacer les groupes et textes à l intérieur de l arborescence : 1. Positionnez le curseur sur le groupe à réordonner, ici "Acteur", et activez la commande Réordonner de son menu contextuel. La fenêtre Modification de l ordre apparaît. 2. Sélectionnez l élément à déplacer, par exemple "Texte". 3. Déplacez l élément sélectionné à l aide des flèches situées à droite du cadre Eléments. Positionnez le pointeur à l endroit voulu. 4. Cliquez sur OK. L ordre de la structure est alors modifié. 71

3 UTILISER DIFFÉRENTS TYPES DE BLOCS Utiliser les macros MEGA permet d ajouter des macros dans les descriptions. Vous pouvez ainsi communiquer avec Word via VB et utiliser les API pour accéder au référentiel. Ajouter une macro Pour ajouter une macro : 1. Dans le menu contextuel d un groupe, sélectionnez Nouveau > Macro. La a fenêtre Création d une macro s ouvre. 2. Saisissez le nom de la macro et cliquez sur OK. Une fenêtre permettant d écrire du VB Script s ouvre à gauche. 72 MEGA Publisher

Aller plus loin avec les descriptions rtf Utiliser différents types de blocs Principe de la macro La macro est appelée par la méthode suivante : Option Explicit Sub Generate(oObject, ocontext, suserdata, sresult) End Sub ocontext : contexte d exécution de la macro qui supporte cinq propriétés : StyleSheet : adresse de la feuille de style du document Current : objet courant sur lequel la macro s exécute Parent : objet parent Root : objet point d entrée de la description GenerationMode : mode de génération rtf IsConfidential : retourne un booléen. sresult : chaîne dans laquelle on écrit le RTF généré par la macro Disponibilité des macros Exemple de macros Une macro peut porter sur une, plusieurs ou toutes les MetaClasses. La MetaClasse sur laquelle porte la macro doit apparaître dans l onglet Caractéristiques de la fenêtre de propriétés de la macro. Si aucune MetaClasse n est indiquée dans la fenêtre de propriétés de la macro, cela signifie que la macro porte sur toutes les MetaClasses. Deux macros sont fournies en standard. Vous pouvez les paramétrer en les dupliquant au préalable. External Reference Content : gère l'insertion du contenu des références externes dans le document. Différents formats sont proposés :.txt,.ini,.log,.xml : les fichiers sont lus au format texte..rtf,.wri,.doc,.xls,.bmp,.gif,.jpg,.png,.tif : dans ce cas, les fichiers sont lus / convertis au format.rtf ou image. Business process hypothesis achievement matrix : permet de réaliser un tableau de type matrice. Structure d une macro Le code suivant donne la structure permettant d ouvrir une session de Word en VB, créer un document vide en mémoire et enregistrer son contenu en RTF. Les API de Word permettront ensuite d'écrire du texte, des tableaux, etc. 73

3 Sub RTFGenerate(mgoContext, strresultrtf) Dim owordapplication Set owordapplication = CreateObject("Word.Application") Dim oworddocument Set oworddocument = owordapplication.documents.add ' Enter your code here mgocontext.getroot.saveworddocumentasrtf oworddocument, strresultrtf owordapplication.quit End Sub SaveWordDocumentAsRtf est un _Operator qui permet de sauvegarder en RTF le contenu d'un Word.Document. Ajouter un diagramme Pour ajouter un diagramme : 1. Ajoutez un nouveau groupe décrivant un diagramme. 74 MEGA Publisher

Aller plus loin avec les descriptions rtf Utiliser différents types de blocs 2. Cliquez sur le groupe et dans son menu contextuel, cliquez sur Insérer > Diagramme. L icône représentant un diagramme apparaît dans l arborescence. Propriétés d un diagramme Pour spécifier les propriétés d un diagramme : 1. Activez la commande Propriétés du menu contextuel de l icône "Diagramme". Des options de mise en page du diagramme dans le document sont proposées. Pour que les pages non utilisées soient insérées dans le diagramme : Activez l option Impression des pages blanches en mode page à page. 75

3 Présentation du diagramme dans le document Vous pouvez préciser si vous souhaitez faire apparaître le diagramme sur une ou plusieurs pages dans le document généré : Par défaut, les diagrammes sont présentés Page par page s ils font plus de deux pages. Vous pouvez modifier le nombre de pages à partir duquel vous souhaitez activer cette option. Vous pouvez sélectionner l option Toujours sur une seule page. En ce cas, la taille est réduite automatiquement. Orientation du diagramme dans le document Vous pouvez préciser l orientation du diagramme lors de la génération. Portrait Le diagramme est orienté vericalement. Paysage Le diagramme est orienté horizontalement. Orientation définie dans le diagramme. Le diagramme est orienté de la même façon que ce ce qui a été précisé dans l éditeur de diagrammes (Diagramme -> Mise en page). 76 MEGA Publisher

Aller plus loin avec les descriptions rtf Utiliser différents types de blocs Utiliser les descriptions Ajouter une description existante Pour ajouter une description dans celle que vous êtes en train de construire : 1. Sélectionnez la commande Insérer > Description du menu contextuel du groupe qui va contenir la description. Une fenêtre vous propose toutes les descriptions qui portent sur le même type d objet. Si par exemple, vous voulez ajouter une description existante à partir du groupe "Acteur", toutes les descriptions ayant comme point d entrée "Acteur" peuvent être sélectionnées. 2. Sélectionnez par exemple la description "Détails (Acteur)" et cliquez sur OK. La description reliée apparaît alors dans l arborescence de votre description. Dans notre exemple, nous avons ajouté une description directement sous "Acteur". Si vous souhaitez voir apparaître des descriptions correspondant à un autre type d objet, par exemple à "Message", vous devez d abord créer un groupe correspondant à ce type d objet puis ajouter une description sous ce groupe. 77

3 Vous pouvez la délier de votre description en activant la commande correspondante de son menu contextuel. Les textes Introduction (Avant) et Conclusion (Après) d une description ne sont pas exécutés si la description est appelée depuis une autre description. Créer une description Vous pouvez créer une description directement dans l arborescence de l éditeur de descriptions. Pour créer une description : Sur le type d objet racine de la description ou sur un groupe, faites apparaître le menu contextuel et cliquez sur Nouveau > Description. La fenêtre Création d une description apparaît. La description peut porter sur le type d objet racine, ici Acteur, ou sur la métaclasse abstraite dont est dérivé l objet racine. Pour plus de détails, voir "Créer une description RTF", page 54. Utiliser les groupes Réutiliser un groupe existant Vous pouvez réutiliser un groupe déjà défini dans votre description si ce groupe porte sur le même type d objet. 78 MEGA Publisher

Aller plus loin avec les descriptions rtf Utiliser différents types de blocs Pour réutiliser un groupe existant : 1. Positionnez-vous sur le groupe qui porte sur le même type d objet que le groupe que vous voudriez ajouter. 2. Dans son menu contextuel, sélectionnez Insérer > Un groupe existant puis le nom du groupe que vous souhaitez ajouter. Les groupes portant sur le même type d objet vous sont proposés. Le groupe ainsi relié reste lié au groupe de référence. Une icône est ajoutée dans l arborescence ; vous ne pouvez pas intervenir sur ses éléments (bien entendu, vous pouvez toujours modifier le groupe là où il a été initialement créé). Supprimer un groupe Pour supprimer un groupe : Activez la commande Supprimer du menu contextuel du groupe sélectionné. Tous les éléments dépendants sont supprimés, sauf les groupes et descriptions reliés, qui sont conservés dans leur emplacement d origine. Si vous avez un doute, vous pouvez d abord supprimer les textes et constater le résultat obtenu avant de supprimer le groupe tout entier. 79

3 Modifier les propriétés d un groupe Pour changer les propriétés d un groupe : 1. Activez la commande Propriétés du menu contextuel du groupe sélectionné. La fenêtre de propriétés apparaît ; elle vous permet de changer de requête. 2. Vous pouvez restreindre la liste des objets sélectionnés par la requête en choisissant un test à partir du champs Metatest. 3. Cliquez sur OK. La modification apparaît dans l arborescence de votre description. 4. Procédez de même pour changer la requête du second groupe. 80 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier l ordre des objets dans le document MODIFIER L ORDRE DES OBJETS DANS LE DOCUMENT Pour trier les objets à l intérieur d un groupe dans le document généré : Dans la fenêtre de propriétés du groupe, cliquez sur le bouton Trier. Vous obtenez la fenêtre de propriétés du groupe. Les critères proposés par défaut sont l ordre du référentiel et le nom. Pour ajouter ou enlever un critère de tri dans la partie droite de la fenêtre : Sélectionnez une caractéristique dans la liste située à gauche et cliquez sur le bouton Ajouter, ou sélectionnez une caractéristique dans la liste de droite et cliquez sur le bouton Enlever. Pour ordonner les critères dans la liste située à droite : Cliquez sur un critère avec le bouton droit de la souris et activez la commande Monter ou Descendre selon le cas. Exemples Si vous souhaitez trier les objets du groupe par ordre alphabétique, placez le critère "Nom" en première position dans la liste située à droite et sélectionnez le sens "Ascendant". Si vous souhaitez que les objets apparaissent groupés par créateur, vous devez ajouter la caractéristique "Nom du créateur" et la placer en première position. Prendre en compte l ordre spécifié dans un diagramme Pour pouvoir modifier l ordre des objets dans le document à l aide de la commande Outils > Ordonner du diagramme, vous devez au préalable vérifier que la description utilisée dans votre document type comporte des groupes portant sur une 81

3 patte et non pas sur une requête. Le groupe doit être de couleur verte (et non pas bleue). Si vous souhaitez reproduire l ordre défini au préalable dans un diagramme, vous devez conserver le critère "Ordre" en première position. L ordre peut être conservé uniquement pour les groupes de couleur verte reposant sur une patte (il ne peut pas être conservé pour les groupes de couleur bleue reposant sur une requête). Pour plus d informations sur la modification de l ordre des objets dans un diagramme, voir le guide MEGA Common Features, chapitre "Manipuler les objets dans MEGA". 82 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes MODIFIER LES TEXTES Ajouter l image d un objet La caractéristique "Image de l objet" permet d obtenir l image de l objet dans le document généré. Cette caractéristique est disponible pour chaque objet. Dans l éditeur de descriptions, la balise <Image de l'objet/> est utilisée à cet effet. L utilisation de cette balise facilite la gestion du multilinguisme, en rendant facultative l indication du nom du type d objet. Faire apparaître les noms du métamodèle Vous pouvez faire apparaitre le nom des caractéristiques et liens du métamodèle dans les différentes langues, ainsi que le nom des types d objets. Faire apparaître le nom d une caractéristique Pour faire apparaître le nom d une caractéristique : 1. Dans l arborescence, sélectionnez l icône correspondant à la caractéristique de l objet et appuyez simultanément la touche <Ctrl>. 83

3 2. Tout en maintenant la touche <Ctrl> enfoncée, faites un glisser déplacer du nom de la caractéristique jusqu à la zone texte. <Nom.MetaClassName> apparaît dans la zone texte. Dans le document, "Nom" apparaîtra dans la langue courante. Faire apparaître le nom du type d objet Pour faire apparaître le nom du type d objet : 1. Dans le dossier "Caractéristiques de l objet", cliquez sur "Object MetaClasse Name" et appuyez simultanément sur la touche <Ctrl>. 2. Tout en maintenant la touche <Ctrl> enfoncée, faites un glisser déplacer de "Object MetaClass Name" jusqu à la zone texte. <Object MetaClass Name/> apparaît dans la zone texte. Dans le document, le nom du type d objet apparaîtra dans la langue courante. Récapitulatif concernant les noms du métamodèle <Nom> <Nom.MetaClassName> <MetaClassName> renvoie le nom de l objet renvoie "Nom" dans la langue courante renvoie le nom du type d objet (MetaClasse) dans la langue courante. L utilisation des noms issus du métamodèle facilite la gestion du multilinguisme. Cela évite de multiplier les textes, ce qui facilite la maintenance et réduit la taille du référentiel. Glisser-déplacer des constituants L éditeur de descriptions permet de glisser-déplacer les constituants de l objet de manière à obtenir des sous-textes portant le nom de la patte. Pour créer des sous-textes : 84 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes 1. Procédez à un glisser-déplacer des constituants "Message-Emis" et "Message-reçu" dans le corps du texte du groupe "Acteur". 2. Dans chacun des sous-textes, faites glisser-déplacer la caractéristique "Nom". Vous pouvez ensuite mettre en forme le texte situé en-dessous du groupe, comme ci-dessous : Dans la fenêtre de propriétés des textes constituants ainsi créés, sélectionnez l onglet Format puis l option Nouvelle ligne. Le résultat suivant est obtenu après exécution de la description : Cette façon de procéder peut s avérer plus simple que lorsqu on ajoute des groupes, mais elle comporte des limites. Il n est par exemple pas possible de préciser les conditions d exécution d un texte. Définir un format de texte Pour définir le format d un texte : 1. Activez la commande Propriétés du menu contextuel du texte. La fenêtre de propriétés du texte apparaît. 85

3 2. Cliquez sur l onglet Format. 3. Spécifiez le mode approprié d enchaînement des textes : Même ligne pour que le texte se situe sur la même ligne que le précédent. Nouvelle ligne pour passer à la ligne sans changer de paragraphe, si vous ne souhaitez pas qu il y ait d espacement entre ce texte et le précédent. Nouveau paragraphe (activée par défaut) pour passer à un nouveau paragraphe, si vous souhaitez qu il y ait un espacement entre le texte et le précédent. Spécifier la langue du texte (utilisation multilingue de MEGA) MEGA vous permet d éditer des textes en plusieurs langues. Conditions d édition du texte Pour préciser dans quelle langue sera édité un texte : Dans la fenêtre de propriétés du texte, sélectionnez l onglet Langue. Par défaut, un texte est exécuté dans toutes les langues. 86 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes Il est possible de sélectionner ou d enlever une ou plusieurs langues parmi les langues de l environnement. Pour restreindre ou étendre le choix des langues, vous pouvez : Spécifier les langues souhaitées (option Uniquement les langues sélectionnées). Exclure les langues non souhaitées (option Toutes les langues sauf les langues sélectionnées). Vous pouvez également cliquer sur les boutons Toutes ou Aucune pour sélectionner ou désélectionner l ensemble des langues. Dans l arborescence de la description, les langues appliquées au texte sont indiquées à côté de son icône. Le caractère * signifie que toutes les langues sont sélectionnées. Données provenant exclusivement de MEGA Si vous éditez le même texte en plusieurs langues, il peut être utile de prévoir un texte avec la propriété "Toutes les langues sauf...". Si vous ajoutez des langues a posteriori, toutes les langues pourront être ainsi traitées sans prendre le risque d en oublier. Lorsque vous éditez un texte qui contient exclusivement des données de MEGA (et non pas du texte que vous avez saisi vous-même comme souvent dans les textes d introduction), il n est pas utile de dupliquer les textes pour chaque langue. 87

3 Si, par exemple, vous insérez la variable "<Nom/>", le nom sera édité dans la langue courante (cela ne sera pas le cas si vous avez choisi la variable "&Name (English)&"). Voir aussi "Faire apparaître les noms du métamodèle", page 83. Insérer un tableau dans un texte Pour présenter votre description sous forme de tableau, vous devez insérer un tableau dans chacun des textes de la description. Vous allez ici reprendre le premier groupe de la description "Acteurs et leurs échanges" et modifier la présentation des textes. Pour cela : 1. Editez le texte du groupe "Message-Reçu". 2. Disposez les champs renseignés sous forme de tableau, à l aide de la commande de Word Tableau > Insérer Tableau. 3. Affectez à ce texte le style "M-Table". 88 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes 4. Editez le texte "Avant" situé juste au dessus. Insérez un tableau d une ligne et tapez un texte décrivant le contenu du tableau, par exemple "Message(s) reçu(s) par l acteur :" et affectez-lui le style "M- Table". 5. Activez la commande Propriétés du menu contextuel du texte précédemment modifié, pour paramétrer le mode d enchaînement des textes. 6. Dans l onglet Format de la fenêtre de propriétés du texte qui s affiche, sélectionnez l option Même ligne, pour que les deux tableaux soient solidaires. 7. Procédez de la même façon pour le groupe "Message par la patte Message-Emis" en copiant les tableaux que vous venez de créer, de manière à obtenir une présentation homogène. 89

3 Après avoir exécuté la description, vous obtenez un résultat de ce type : Par défaut, Word 2000 ajuste les colonnes du tableau à leur contenu. Pour une meilleure lisibilité des tableaux générés avec MEGA, créez une première ligne de tableau dans l éditeur de descriptions, puis décochez la case Redimensionner automatiquement pour ajuster au contenu dans les options du tableau (dans Word, menu Tableau > Propriétés du tableau, onglet Tableau, bouton Options). Ajouter des références externes dans une description Si vous avez créé des références externes pour certains objets de la base, vous pouvez inclure des champs correspondant à ces références externes dans vos descriptions, pour les mentionner dans les documents générés. Dans la description "Acteurs et leurs échanges" que vous avez créée précédemment, vous allez ajouter un groupe permettant de créer un lien vers les références externes associées aux messages envoyés. Pour cela : 1. Ajoutez un nouveau groupe à l intérieur du groupe "Message-émis". La fenêtre Propriétés d un groupe apparaît. 90 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes 2. Choisissez pour objet décrit "Référence externe". Après avoir cliqué sur le bouton OK, vous obtenez l arborescence suivante. 3. Ajoutez un texte sur ce groupe, comme décrit dans "Ajouter un texte", page 56. Un document Word vide apparaît. Dans la partie inférieure droite de la fenêtre, vous voyez apparaître certaines caractéristiques des références externes. 4. Ajoutez les champs "Nom" et "Hyperlien" d un simple glisser-déplacer. 91

3 Dans le document obtenu après exécution de la description : Le champ "Nom" fait apparaître le nom que vous avez donné à la référence externe. Le champ "Hyperlien" permet d indiquer soit le chemin du fichier soit l adresse URL selon le type de référence externe. Il n est pas possible de faire apparaître le contenu de la référence externe en utilisant cette méthode. Pour cela, vous devez utiliser une macro. Pour plus de détails, voir "Utiliser les macros", page 72. Utiliser les variables dans les en-têtes et pieds de pages Si vous utilisez une version antérieure à MEGA 2005, les informations provenant du référentiel doivent être placées dans le corps de la page : en effet, les rapports placés dans les en-têtes et les pieds de page ne sont pas pris en compte par MS- Word pour les versions antérieures à MEGA 2005. Pour contourner cette difficulté, il est possible d utiliser le champ MS-Word "RéfStyle", qui répète le texte auquel ce style est appliqué. Si vous utilisez MEGA 2005, vous pouvez insérer des rapports dans les en-têtes et pieds de page, ce qui vous évite d utiliser les "RéfStyles". Les informations provenant de la base sont insérées dans le corps du texte, dans un style qui n est utilisé qu à cet endroit. Dans l exemple qui suit, le style "Variable1" a été appliqué au texte "texte repris dans l en-tête", et un champ faisant référence à ce style a été inséré dans l en-tête (l image de gauche présente le document avec l option d affichage des codes de champ, l image de droite présente le résultat du champ) : Vous allez apprendre à : Définir une nouvelle variable ("Définir une variable", page 93). Dans la feuille de style, ajouter de nouveaux styles ("Créer un style", page 94). Dans le texte d une description, insérer cette variable et un champ et leur appliquer le nom du style ("Insérer la variable dans un texte", page 96). Insérer dans le document type les champs faisant référence à ce style ("Insérer la référence au style", page 96). 92 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes Définir une variable Une variable est définie dans la base : elle est remplacée par sa valeur lors de l exécution de la description. Ceci permet d insérer, dans la description, le nom de la variable au lieu de sa valeur. Ceci s avère utile, par exemple, lorsque plusieurs environnements veulent utiliser les mêmes descriptions, mais ont besoin de valeurs différentes pour leurs documents, comme l adresse, le nom du site, etc. Vous pouvez utiliser les variables standard de MS-Word telles que sujet, titre, etc. La valeur de ces variables est définie dans l onglet Résumé des propriétés des documents et des documents types. Vous pouvez également utiliser les variables MEGA telles que Entreprise, Service, etc. La définition de nouvelles variables se fait avec l éditeur de descriptions. Pour définir une nouvelle variable, dans l éditeur de descriptions : 1. Sélectionnez le menu MEGA > Outils > Variables. La fenêtre de Gestion des variables apparaît. 2. Cliquez sur le bouton Créer, et, dans la fenêtre présentée, saisissez son nom. Dans cet exemple, la variable créée est "Copyright", qui permettra de faire évoluer l année du copyright sans avoir à ouvrir toutes les descriptions où il se trouve. Après avoir cliqué sur le bouton OK, vous revenez à la fenêtre de Gestion des variables. 93

3 3. Sélectionnez la variable "Copyright" si elle ne l est pas déjà et, dans le cadre Valeur, saisissez la valeur de la variable. Pour saisir le, maintenez la touche <Alt> enfoncée et saisissez la valeur "0169" avec le pavé numérique. 4. Cliquez sur le bouton Modifier pour enregistrer la nouvelle valeur. La nouvelle variable "Copyright" apparaît dans la liste des variables. Il est désormais possible de l ajouter dans des textes. Vous pouvez commenter la variable de la même façon que les autres objets. Vous pouvez supprimer une variable, mais si elle est encore utilisée dans des textes, son code apparaîtra dans les documents où ces textes se trouvent. Créer un style Avant d insérer cette variable dans un texte, vous allez créer un style spécifique dans les feuilles de styles. Pour cela : 1. Sous Word, ouvrez la feuille de style "Megastyl620.dot". La feuille de style standard ("Megastyl620.dot") qui se trouve dans MEGA_STD est protégée. Avant de la modifier, copiez-la dans MEGA_USR, et, dans ses propriétés (gestionnaire de fichiers de Windows), désactivez l attribut lecture seule. 94 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes 2. Saisissez un texte quelconque, et appliquez le style "M-Normal" à ce texte. 3. Ensuite, sélectionnez le menu Format > Style et, dans la fenêtre Style, cliquez sur Nouveau. 4. Dans la fenêtre Nouveau style, saisissez le nom du style, sélectionnez le Type de style "Caractère" et cliquez sur OK. Les styles s appliquent normalement aux paragraphes. Les styles de type "Caractère" s appliquent uniquement au texte sélectionné, et concernent uniquement la mise en forme des caractères. Définir ce style de cette façon permet de mettre la variable dans un tableau sans altérer la mise en forme de la cellule. 5. Après avoir activé le bouton Appliquer dans la fenêtre Style, copiez le texte que vous venez de mettre en forme avec ce style. 6. Enregistrez la feuille de style, effacez le texte et fermez-la en enregistrant à nouveau. Vous disposez maintenant de ce style dans les documents et les descriptions. Le double enregistrement permet de s assurer que le style est bien défini, ce qui n est pas certain lorsque le texte est effacé avant un premier enregistrement. 95

3 Insérer la variable dans un texte Pour insérer la variable dans un texte : 1. Dans l éditeur de descriptions, ouvrez une description que vous utilisez dans le document type où vous souhaitez faire apparaître la variable. Ici, nous ouvrons "Acteurs et leurs échanges" que nous avons créé dans "Personnaliser les descriptions rtf", page 53. 2. Insérez la variable "Copyright" dans le texte par glisser-déplacer. 3. Appliquez au code le style que vous venez de définir ("VarCopyright" dans l exemple). Si vous voulez que ce texte n apparaisse pas, changez la couleur des caractères et mettez-les en blanc. Nous pouvons maintenant ouvrir le document type pour y ajouter la référence à ce style. Insérer la référence au style Pour insérer la référence au style : 1. Dans le document type, ouvrez le pied de page (dans Word, menu Affichage > En-tête et Pied de page). Si le document type ne présente qu une page, vous ne pouvez accéder qu à l en-tête et au pied de page de la première page, qui sont le plus souvent vides. En ce cas, ajoutez des paragraphes pour que le document type fasse plus d une page ; vous supprimerez ces paragraphes superflus après avoir modifié le pied de page des pages suivantes. Si la mise en page indique "Première page différente" (menu MEGA > Mise en Page, onglet Disposition), lorsque vous êtes sur le 96 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes premier en-tête, le libellé du cadre qui entoure l en-tête indique "Premier en-tête" au lieu de "En-tête". 2. Cliquez sur le bouton de la barre " En-tête et pied de page ", pour accéder au pied de page et positionnez le curseur à l emplacement où doit apparaître le copyright. 3. Sélectionnez Insertion > Champ. 4. Dans la fenêtre Champ, sélectionnez la catégorie "Liaisons et renvois" puis, dans la liste champs, sélectionnez "StyleRef". 5. Cliquez sur le bouton Options et sélectionnez l onglet Styles. 97

3 6. Dans la liste, sélectionnez le style que vous avez créé ("VarCopyright" dans l exemple), et cliquez sur le bouton Ajouter au champ. Si le style que vous avez créé n apparaît pas dans le document type, sélectionnez un autre style : vous pouvez modifier manuellement le nom du style dans le champ. 7. Insérez le champ en cliquant sur les boutons OK des deux fenêtres, et le champ apparaît dans le pied de page. Si vous voyez apparaître le message "Erreur! Il n y a pas de texte répondant à ce style dans ce document.", c est que l option d affichage des codes de champ n est pas sélectionnée. Ce résultat est normal, 98 MEGA Publisher

Aller plus loin avec les descriptions rtf Modifier les textes puisque la description qui insérera la variable avec le style voulu n est pas résolue. Si vous n avez pas trouvé le style que vous avez défini, vous devez afficher les codes de champ pour remplacer le nom de style par le bon nom. Lorsque vous créerez des documents en utilisant ce document type, la variable sera résolue dans le pied de page : Si vous voyez apparaître le message "Erreur! Il n y a pas de texte répondant à ce style dans ce document.", vérifiez que dans la description, vous avez bien appliqué le style "VarCopyright" à la variable. 99

3 VÉRIFIER LA VALIDITÉ DES DESCRIPTIONS MEGA permet de vérifier la validité de vos descriptions. Pour cela : Dans le menu de l éditeur de descriptions, cliquez sur MEGA > Outils > Vérifier. Un certain nombre de règles sont vérifiées. Les erreurs sont signalées. Le champ incorrect est signalé pour chaque texte concerné. Le menu Vérifier est disponible sur les descriptions, documents types et documents. 100 MEGA Publisher

4 GÉRER LES MISES EN FORME ET LES STYLES "Restituer les mises en formes des textes RTF", page 102 Les tableaux figurant dans cette rubrique indiquent comment sont restituées les mises en forme des textes (commentaires) saisis dans l éditeur de texte RTF. "Personnaliser les styles", page 106 Les styles MS-Word sont utilisés pour la mise en forme des descriptions d objets et des documents. Les noms de styles indiqués dans la description d un objet sont repris lors de l insertion de cette description dans un document ou dans un document type. La structure des styles présentée dans ce chapitre est utile aux utilisateurs disposant de le module technique MEGA Publisher - Documentation. 101

4 RESTITUER LES MISES EN FORMES DES TEXTES RTF Il est rappelé que les textes RTF MEGA permettent de mettre en forme les caractères (gras, souligné, couleur...) et les paragraphes (puces, mise en retrait, etc.) Lorsque vous générez un document ou un site Web, vous souhaitez le plus souvent obtenir un résultat uniforme (même police, même taille de caractères, même justification, etc., dans tout le document ou toute la page HTML, ou entre documents). De même, vous souhaitez généralement uniformiser la mise en forme des commentaires saisis par des utilisateurs différents. Vous pouvez néanmoins vouloir reproduire les textes tels que les utilisateurs les ont saisis dans l éditeur de texte RTF. Deux politiques : permissive et restrictive Pour répondre à cette problématique, MEGA propose deux politiques : Une politique restrictive, qui permet d uniformiser les mises en forme. Pour plus de détails, voir "Uniformiser les mises en formes", page 103. L objectif est de conserver une cohérence dans la documentation. En résumé, les styles priment sur les mises en forme introduites dans l éditeur de texte RTF. Une politique permissive, qui permet de conserver les mises en formes spécifiées dans l éditeur de texte RTF lors de la saisie des commentaires. Pour plus de détails, voir "Conserver les mises en formes introduites dans l éditeur de texte", page 104. Recommandations Nous recommandons d uniformiser les mises en formes (politique restrictive), c est pourquoi ce mode est séléctionné par défaut. Pour plus d informations sur la façon de paramétrer la restitution des mises en forme, voir "Comment uniformiser les mises en forme", page 104 et "Comment conserver les mises en forme des textes RTF", page 105. Restitution des mises en forme des textes RTF Les tableaux ci-dessous indiquent comment sont restituées les mises en forme des textes : dans le cas où les extrants sont uniformisés dans le cas où les mises en formes des textes RTF sont conservées. 102 MEGA Publisher

Gérer les mises en forme et les styles Restituer les mises en formes des textes RTF Uniformiser les mises en formes Restitution des mises en forme de caractères Le tableau ci-dessous indique pour chaque mise en forme comment elle est restituée lors de la génération d un document Word ou d un site Web. Mise en forme Restitution dans un document Word Restitution dans un site Web Gras Oui Oui Italique Oui Oui Souligné Oui Oui Barré Oui Oui Police Non Non Taille de la police Non Non Champs MEGA Le nom de l objet apparaît en gras. Si les objets donnent lieu à des pages, les champs sont restitués sous forme de liens. Dans le cas contraire, seul le nom de l objet est restitué. Uniformiser les mises en formes - caractères Restitution des mises en forme de paragraphes Les mises en forme des textes générés dans des tableaux sont ignorées dans les documents Word. La mise en forme des paragraphes s applique à l ensemble du texte RTF, contrairement à la mise en forme des caractères. Mise en forme Restitution dans un document Word Restitution dans un site Web Alignement Non Non Mise en retrait Le retrait se cumule avec celui du style Le retrait se cumule avec celui du style Puces Oui Oui Uniformiser les mises en forme - paragraphes Les mises en forme des textes générés dans des tableaux sont ignorées dans les documents Word. 103

4 Comment uniformiser les mises en forme Vous devez indiquer le mode de génération choisi pour chaque site Web type et document type. Pour uniformiser les mises en forme dans les documents Word : Dans la fenêtre de propriétés d un document type, dans le champ Mode de génération des textes, sélectionnez "Politique restrictive". Pour uniformiser les mises en forme dans les sites Web : Dans l onglet Génération de la fenêtre de propriétés d un site Web type, décochez la case Police RTF autorisée. Conserver les mises en formes introduites dans l éditeur de texte Il est possible de conserver les mises en forme appliquées dans l éditeur de texte RTF lors de la saisie des commentaires par l utilisateur. Il s agit des mises en forme appliquées via la barre d outils de la fenêtre de commentaire des objets (gras, italique, souligné, etc.) Ce choix n est cependant pas conseillé. En effet, des distorsions peuvent apparaître dans l ergonomie des extrants lorsque ces mises en forme viennent se rajouter aux styles définis dans le formateur. Le tableau ci-dessous indique si les mises en forme des textes RTF sont restituées. Restitution des mises en forme de caractères Mise en forme Restitution dans un document Word Restitution dans un site Web Gras Oui Oui Italique Oui Oui Souligné Oui Oui Barré Oui Oui Police Oui Oui Taille de la police Oui Non Champs MEGA Le nom de l objet apparaît en gras. Les champs sont restitués sous forme de liens si les objets donnent lieu à des pages. Conserver les mises en forme - caractères Les mises en forme des textes générés dans des tableaux sont ignorées dans les documents Word. 104 MEGA Publisher

Gérer les mises en forme et les styles Restituer les mises en formes des textes RTF Restitution des mises en forme de paragraphes Mise en forme Restitutution dans un document Word Restitution dans un site Web Alignement Oui Oui Mise en retrait Le retrait se cumule avec celui du style Le retrait se cumule avec celui du style Puces Oui Oui Conserver les mises en forme - paragraphes Les mises en forme des textes générés dans des tableaux sont ignorées dans les documents Word. Comment conserver les mises en forme des textes RTF Vous devez indiquer le mode de génération choisi pour chaque site Web type et document type. Pour conserver les mises en forme des textes RTF dans les documents Word : Dans la fenêtre de propriétés d un document type, dans le champ Mode de génération des textes, sélectionnez "Politique permissive". Pour conserver les mises en forme des textes RTF dans les sites Web : Dans l onglet Génération de la fenêtre de propriétés d un site Web type, cochez la case Police RTF autorisée. Mises en forme et objets non supportés par MEGA Certaines mises en forme ne sont pas supportées par MEGA, que ce soit dans les descriptions RTF exécutées, les documents Word ou les sites Web. Ils s agit des : Tableaux Images Styles Word (obtenus par copier-coller d un document Word) 105

4 PERSONNALISER LES STYLES Présentation des styles Un style est une mise en forme particulière que l on peut appliquer à un paragraphe d un texte édité avec un logiciel de traitement de texte. Il permet d appliquer de manière systématique des caractéristiques telles que le choix de la police de caractères, les marges ou l indentation, etc. Des styles sont proposés pour le paramétrage des documents MEGA. Leurs noms sont préfixés par "M-". Ces styles sont basés sur "M - Normal", identique au style "Normal" de MS-Word, sauf pour la couleur des caractères, qui est bleue. Pour modifier la police de caractères de tous les styles "M -", il suffit de modifier la police de "M - Normal". La définition des styles (format des caractères, des paragraphes, etc.) est gérée dans des feuilles de style (c est un modèle pour MS-Word). Par défaut, la feuille de style utilisée par les documents types et les descriptions d objets est "Megastyl620.dot". Elle se trouve dans le dossier MEGA_STD. Il est possible de changer la feuille de style proposée par défaut en activant, dans le menu Outils de l espace de travail, la commande Options. Dans le paramétrage de la fonctionnalité Documentation, sélectionnez l icône Documents Word et indiquez le nom du modèle de document à utiliser comme valeur de la variable "Feuille de style". Structure des styles proposés Les styles proposés dans les descriptions d objets sont le plus souvent structurés de façon logique : leur nom indique leur utilisation, indépendamment de la mise en forme. Par exemple, les diagrammes ont le style "M-Drawing". Vous pouvez imprimer la description des styles : dans Word, ouvrez le modèle de document utilisé (par défaut, "Megastyl600.dot" dans le dossier MEGA_STD ). Activez la commande Imprimer et, dans la fenêtre d impression, sélectionnez, dans la liste intitulée Imprimer, la valeur Styles au lieu de la valeur Document qui est sélectionnée par défaut. Créer ou modifier des styles Si une mise en forme ne vous convient pas, n appliquez pas un autre style, mais modifiez plutôt le style proposé : cela vous évitera d ouvrir les descriptions de chacun des objets pour modifier le nom du style. 106 MEGA Publisher

Gérer les mises en forme et les styles Personnaliser les styles Modifier un style Pour modifier un style : 1. Ouvrez la feuille de style ("xx.dot", par défaut "Megastyl620.dot"). 2. Enregistrez-la dans le dossier "MEGA_USR" de l environnement. 3. Modifiez le style. Remarques concernant la modification des styles La feuille de style fournie par défaut "Megastyl620.dot" dans le dossier MEGA_STD est protégée en écriture. Vous pouvez enregistrer une autre feuille de style sous le même nom ou en créer une nouvelle dans le dossier MEGA_USR de l environnement. Vous pouvez, uniquement lorsque vous voulez partager une même feuille de style entre plusieurs environnements, la copier dans le dossier MEGA_STD. Les styles sont basés les uns sur les autres : par exemple, "M-Sublevel 2" est basé sur "M-Sublevel 1" ; c est pourquoi des modifications effectuées sur un style peuvent avoir un impact sur d autres styles. Vous pouvez modifier un style sans avoir besoin de retoucher les descriptions des objets. Toutes les descriptions d objets dont les textes utilisent un style modifié sont concernées. Il faut pour que la modification soit prise en compte, qu elle soit reportée dans les feuilles de style utilisées par les documents types. La présentation de tous les documents construits avec les documents types ou descriptions basés sur cette feuille de style sera modifiée. Pour modifier l orientation portrait/paysage ou les marges des documents générés, modifiez directement le modèle de document. Le paramétrage des documents types permet de définir la feuille de style qui sera utilisée lors de la création d un document basé sur ce document type. L utilisateur pourra modifier cette feuille de style en utilisant les possibilités de gestion des styles et des modèles de MS-Word. Il est déconseillé d utiliser les cadres dans la définition des styles. Créer un nouveau style Il est possible d ajouter un nouveau style pour en disposer dans les textes des descriptions d objets. Il faut l ajouter dans la feuille de style "Megastyl620.dot". Vous pourrez alors l utiliser dans les descriptions des objets. N ajoutez pas le style directement dans la description. Pour qu il soit pris en compte dans les documents générés, il faut le reporter dans la feuille de style associée aux documents types. Evitez d utiliser le même style dans le corps du texte et dans un tableau : si vous réduisez ultérieurement la largeur du style, les cellules qui utilisent ce style peuvent devenir illisibles en répercutant cette réduction. 107

4 Associer une feuille de style Vous pouvez associer une feuille de style à un environnement, à un utilisateur, à un document, à un document type ou à une description. La feuille de style associée à un environnement sera proposée comme feuille de style par défaut pour chaque utilisateur nouvellement créé. La feuille de style associée à un utilisateur sera proposée par défaut lorsque cet utilisateur créera un nouveau document type ou une nouvelle description. La feuille de style associée à un document type sera associée automatiquement à chaque nouveau document créé à partir de ce document type. A partir de ce moment, le document aura une vie autonome et les changements de feuille de style du document type ne seront pas reportés automatiquement dans le document. Il est cependant possible de mettre à jour les styles à partir du menu de MS-Word Outils > Modèles et compléments en cochant "Mise à jour automatique des styles de document". Les caractéristiques de la feuille de style associée à une description ne sont prises en compte que lorsque cette description est utilisée seule et ce, après avoir coché la mise à jour automatique des styles de document. Les styles pris en compte dans un document créé à partir d un document type sont ceux contenus dans ce document type. Seul le nom des styles définis dans une description est pris en compte dans le document. Les détails des styles définis dans la description sont remplacés par ceux hérités du document type. Si un style utilisé lors de la définition d une description ne se trouve pas dans le document type utilisé, il sera remplacé par le style "Normal". C est pourquoi il est conseillé de définir les feuilles de style à partir de "Megastyl600.dot", et de créer les styles dans toutes les feuilles, afin d assurer la compatibilité des documents types en cas de changement de feuille de style. Vous pouvez mettre au point un style en l essayant dans une description. Mais pour qu un nouveau style ou la modification d un style existant soit pris en compte dans les nouveaux documents produits, il faut qu il soit présent dans la feuille de style associée au document type qui utilise cette description. Créer une feuille de style Pour créer une feuille de style : 1. Copiez la feuille de style de référence ("Megastyl620.dot") dans le dossier MEGA_USR de votre environnement de travail. 2. Renommez-la, par exemple en "MesStyles.dot". Notez que si vous renommez la feuille de style, il faudra associer la nouvelle feuille de style à chacun des documents types auxquels vous voulez qu elle s applique. 3. Ouvrez-la avec MS-Word hors de MEGA. 4. Modifiez un style existant ou créez un nouveau style. 5. Dans la configuration de MEGA, associez la feuille de style à l utilisateur pour disposer des styles dans les descriptions. 6. Associez la feuille de style aux documents types ou aux documents auxquels vous voulez qu elle s applique. 108 MEGA Publisher

Gérer les mises en forme et les styles Personnaliser les styles Description des styles proposés Feuille de style MegaStyl620.dot Titres Titre 1 Titre 0 Titre 2 Titre 3 M - Document Title M - Document Title 2 M - Sublevel M - Sublevel 2 M - Sublevel 3 Destiné au titre des chapitres, il est numéroté et insère automatiquement un saut de page avant. Identique au titre 1, mais il ne contient ni numéro ni saut de page. Il sert pour le sommaire et la liste de diffusion. Il définit les différents sous-chapitres. Il est centré et ne contient pas de numérotation. Il est en italique et ne contient pas de numérotation. Il est utilisé sur la page de garde. Il est centré, en Police 26. Il reprend le titre du document. Il est utilisé sur la page de garde. Il est centré, en Police 22. Il sert à compléter le titre si nécessaire. Ils permettent de créer des titres de paragraphe supplémentaires, mais qui n'apparaîtront pas dans le sommaire. Textes M - Comment M - Comment Bold M - Liste M - Remark C'est le format par défaut utilisé pour du texte. Ce style sert à ajouter du gras sur M - Comment. C'est le style utilisé pour les listes. Une puce précède le début de la ligne. Ce style est utilisé pour un commentaire précédé d'une puce spéciale. Il peut servir à indiquer des remarques dans un document. Tableaux M - Table M - Table Center M - TableHeading Format par défaut à utiliser pour une cellule. Format à utiliser pour obtenir du texte centré dans les cellules. Format des cellules Titres, centré et avec un fond grisé. 109

4 Dessin M - Drawing Style destiné aux diagrammes. Table des matières TM1 Style des lignes de la table des matières renvoyant aux " Titre 1 ". TM2 Style des lignes de la table des matières renvoyant aux " Titre 2 ". Index Titre Index Index 1 Style du titre de l'index. Style des données de l'index généré. Références aux styles Il est inderdit d utiliser des rapports types dans les en-têtes et pieds de page.il est recommandé d utiliser les champs de référence aux styles ci-dessous. M - RefStyl DocumentName M - RefStyl Company M - RefStyl Department M - RefStyl DocumentWriter M - RefStyl ObjectCode M - RefStyl Version M - RefStyl Version date Titre du document Nom de l'entreprise Service concerné Rédacteur Code de l'objet Version du document Date de révision Feuilles de styles antérieures à Megastyl620.dot Les styles présentés ici le sont à titre indicatif. Ces styles viennent en complément des styles fournis par MS-Word. Les styles Titre, Titre 0, 1,... de MS-Word sont par défaut automatiquement reportés dans le sommaire du document. 110 MEGA Publisher

Gérer les mises en forme et les styles Personnaliser les styles Style Titre du document Les styles "M-Titre Document" et "M-Titre Marge" permettent de définir le titre du document. Style Page de garde Les styles "M-PAGE DE GARDE" et "M-Page de garde Bordure" sont utilisés pour définir la page de garde d un document avec ou sans bordure. Ils sont complétés par les styles "M-Normal Page" et "M-Normal Page Gauche". Style Introduction Les styles "M-Introduction Titre Marge" et "M-Introduction" sont utilisés dans les introductions des chapitres où un commentaire est inséré dans un document type. Style Nom et commentaire d un objet Les styles "M-NOM 1" et "M-Nom 1 Retrait" permettent de présenter les noms des objets du niveau le plus important. Le style "M-LIBELLE 1" permet de présenter son commentaire. Les styles "M-NOM 2" et "M-NOM 3" présentent les noms des objets du deuxième niveau d importance et du troisième niveau. Les styles "M-LIBELLE 2" et "M-LIBELLE 3" permettent de présenter leur commentaire. Cette présentation hiérarchique par niveau est importante car son respect vous permettra de réutiliser plus facilement les descriptions d un document à un autre. 111

4 Les styles "M-Retrait Nom Libellé 2", "M-NOM LIBELLE 2" et "M-NOM LIBELLE 3" permettent de présenter les objets de deuxième et troisième niveau d importance et leur commentaire sur la même ligne. Style Liens Les styles "M-Sous-titre Page", "M-LIEN 1" et "M-LIEN 2" sont utilisés pour introduire une liste d objets obtenus en parcourant un lien. Exemple : le texte "Messages émis :" pour introduire les messages émis par un acteur (dans le cadre du produit MEGA Designer - Development, le signal remplace le message). Le style "M-LIEN 1" pourra être utilisé pour introduire la liste affichée avec le style "M-NOM LIBELLE 2". De même, le style "M-LIEN 2" s intercalera entre les styles "M- NOM LIBELLE 2" et "M-NOM LIBELLE 3". Style Normal Les styles "M-NORMAL", "M-Normal 8", "M-NORMAL GRAS", etc. sont diverses présentations que l on peut utiliser dans un texte courant. 112 MEGA Publisher

Gérer les mises en forme et les styles Personnaliser les styles Style Dessin Les styles "M-DESSIN", "M-Dessin Cadre", "M-Dessin Page" et "M-GRILLE" sont utilisés pour présenter des dessins. Style Tableaux Les styles "M-TABLEAU En-tête" et "M-TABLEAU" sont utilisés pour présenter des tableaux. Le style "M-Nom 1 Page" est utilisé pour insérer les noms des objets du niveau le plus important dans les tableaux. Style Remarques Les styles "M-Remarque" et "M-Remarque Suite" permettent de présenter des remarques dans un cadre. Référence au style pour les en-têtes et les pieds de pages Ces styles sont conçus pour servir de référence sur des champs que l on veut faire apparaître dans les en-têtes et les pieds de pages. 113

4 Style Aide Les styles "M-Aide Nom" et "M-Aide" sont utilisés dans les descriptions générant de l aide. 114 MEGA Publisher

Deuxième Partie : Personnalisation des sites Web 115

116 MEGA Publisher

5 CRÉER UN SITE WEB Vous pouvez générer des pages HTML à partir du référentiel et constituer un site Web vous permettant de diffuser des informations, par exemple vos processus, sur un Intranet. Le générateur de site Web construit les pages du site en fonction des données de la base et des objets que vous avez choisi de décrire. Les pages sont générées indépendamment les unes des autres, les liens entre les objets de la base définissant automatiquement les hyperliens. Les points suivants sont abordés ici : "Créer un site Web", page 119 "Définir la composition du site Web", page 120 "Générer un site Web", page 126 "Utiliser un site Web type", page 134 Exemple de page d un site Web 117

5 A PROPOS DE LA CRÉATION DE SITES WEB Pour créer un site Web, vous pouvez procéder de deux manières : Créer un site Web sans modèle (vous devez pour cela disposer du module technique MEGA Publisher - Web). Créer un site Web en utilisant un site Web type servant de modèle. Si des sites Web types sont proposés en standard ou ont été créés par votre administrateur, il est souhaitable de les utiliser. Cela vous facilitera la tâche. Des sites Web types spécifiques sont proposés en standard pour les différents produits de MEGA. 118 MEGA Publisher

Créer un site Web Créer un site Web CRÉER UN SITE WEB Pour créer un site Web : 1. Dans l espace de travail, sélectionnez la fenêtre Documentation. La fenêtre Documentation est accessible par la commande Affichage > Fenêtres de navigation > Documentation. 2. Dans le navigateur, sélectionnez le dossier correspondant à "Site Web" et dans son menu contextuel, sélectionnez Nouveau > Site Web. Dans la fenêtre Création d'un site Web : 3. Saisissez le nom du site. Par défaut, le site Web est généré dans le dossier "Intranet". Vous pouvez en choisir un autre en cliquant sur le bouton. Il est conseillé de créer un sous-dossier par site Web généré, en créant par exemple sous le dossier "Intranet" des dossiers portant le même nom que votre site Web. Le contenu du dossier "Intranet" est détruit à chaque génération. Une fois que vous avez obtenu un site satisfaisant, pensez à copier le contenu du dossier là où il sera conservé. Si vous souhaitez générer un site Web à partir d'un site Web type, vous pouvez renseigner le champ A partir du site Web type. Sélectionnez celui qui va vous servir de modèle en cliquant sur le bouton. Pour restreindre la liste des sites Web types proposés, cliquez sur la flèche et sélectionnez le type d'objet décrit qui vous intéresse. Les sites Web types correspondants apparaissent alors dans la liste. Pour de plus amples informations, voir "Créer un site Web à partir d'un site Web type", page 135. 4. Lorsque ces champs sont renseignés, cliquez sur le bouton Terminer. Le site Web apparaît dans le navigateur. 119

5 DÉFINIR LA COMPOSITION DU SITE WEB Avant de générer un site Web, vous devez définir sa composition et sa mise en page en renseignant certaines de ses propriétés. Pour cela : Activez la commande Propriétés du menu contextuel du site Web. Dans la fenêtre de propriétés qui apparaît, vous devez indiquer la composition de votre site Web et sa mise en page. Principe de composition d un site Web Vous devez d abord indiquer l objet principal ou la liste des objets principaux que vous souhaitez décrire dans votre site Web. Vous pouvez par exemple ajouter des projets, des processus, etc., qui regroupent des objets élémentaires. Si, par exemple, vous choisissez de décrire un projet, tous les objets qu il contient apparaîtront dans le site dès que vous créez les pages correspondantes. Mécanisme de l extraction L extraction effectuée à partir d un projet inclut les différents diagrammes de ce projet, avec pour chacun, les objets qui y sont représentés comme les acteurs, les messages, etc. Pour plus de renseignements sur ce mécanisme, voir le guide MEGA Administration. 120 MEGA Publisher

Créer un site Web Définir la composition du site Web Si vous ne souhaitez pas que les objets qui dépendent de l objet principal apparaissent dans le site Web, il suffit de désactiver la mécanisme de l extraction. Pour cela, décochez la case Propagation de l onglet Objets. Sélectionner des objets Vous devez indiquer l objet qui servira à construire la liste des objets qui apparaîtront dans le site. Exemple : Vous pouvez choisir de construire votre site à partir d'un projet. Ajouter un objet Pour ajouter un objet : 1. Sélectionnez l'onglet Objets de la fenêtre de propriétés d'un site Web. 2. Dans le menu contextuel de la racine de l'arborescence, activez la commande Ajouter un objet. Vous pouvez également cliquer sur Ajouter > Objet. 3. Dans la fenêtre Ajouter un objet, sélectionnez le Type d'objet que vous souhaitez ajouter puis activez la commande Lister du champ Nom pour sélectionner l objet qui vous intéresse. Vous obtenez une arborescence de ce type : Vous pouvez ajouter d autres projets ou objets dans cet onglet. Vous pouvez également ouvrir la fenêtre de propriétés des objets pour avoir des informations ou faire des modifications avant génération. Ajouter une liste d objets Pour ajouter une liste d'objets : 1. Activez la commande Ajouter/Une requête. 2. Sélectionnez la requête "*" si vous voulez ajouter tous les objets de la base correspondant au type d'objet choisi ou une collection d'objets grâce à la fenêtre de recherche standard, qui vous permet de sélectionner certains objets d'un type donné. 121

5 Ajouter des pages Après avoir indiqué l objet ou les objets principaux décrits par votre site Web, vous devez ajouter des pages pour chacun des objets qui doivent donner lieu à une page. Les pages sont des documents hypertextes qui composent un site Web. Pour ajouter les pages de votre site Web : 1. Sélectionnez l'onglet Pages de la fenêtre de propriétés d'un site Web. 2. Dans le menu contextuel de l icône "Pages", activez la commande Ajouter. La fenêtre Ajouter une page s ouvre. Fenêtre Ajouter une page La fenêtre Ajout d'une page apparaît, dans laquelle vous pouvez sélectionner : Le type d'objet décrit Une Requête Une Mise en forme (pour l en-tête et pour le corps) Sélection des pages Vous pouvez choisir une Requête pour restreindre la liste des objets qui donneront lieu à une page, le cas échéant (par exemple, les processus organisationnels Assurance Qualité). Il n'est pas possible d'utiliser les requêtes qui contiennent des variables. C'est pourquoi elles ne sont pas proposées dans la liste. Si aucune requête n'apparaît, cliquez sur le bouton Vous obtenez une fenêtre qui vous permet de créer une requête sans variable (bouton Nouveau). 122 MEGA Publisher

Créer un site Web Définir la composition du site Web Mise en forme des pages Les pages HTML sont divisées en deux parties : l en-tête (HEAD) le corps (BODY) En-tête <HEAD> L en-tête d une page HTML contient le titre de la page (visible par l utilisateur), des informations META qui définissent des mots-clés pouvant être utilisés par les moteurs de recherche, la feuille de style etc. Dans MEGA, trois types d en-têtes sont proposés : l en-tête standard MEGA propose un en-tête standard. Il spécifie automatiquement la feuille de style, le titre de la page (nom de l objet), les mots-clés associés à l objet. Si vous avez des mots-clés MEGA associés à un objet (fenêtre de navigation Mots-clés), ces mots-clés sont repris dans l en-tête de la page décrivant l objet. Exemple : <META NAME="keywords" CONTENT="Commande, Livraison">. Pour plus de détails sur l onglet Mots-clés, voir le chapitre "Espace de travail" du guide MEGA Common Features. l en-tête défini par une description HTML MEGA offre la possibilité de créer des descriptions HTML <HEAD> permettant de définir les informations contenues dans l en-tête de la page HTML. Vous pouvez ainsi ajouter des mots-clés (keywords), le titre de la page ou la feuille de style à l aide de balises HTML standard. Si vous avez créé un en-tête spécifique, vous pouvez le sélectionner dans la liste déroulante du champ En-tête <HEAD>. La description ne doit pas contenir les balises <HEAD>... </ HEAD>. l en-tête défini par un formateur script Vous pouvez décrire un en-tête en utilisant un formateur script relié à une macro VB. Voir "Niveau 3 : Paramétrage des formateurs scripts", page 142. Corps <BODY> Le corps constitue le contenu visuel de la page HTML. On distingue différents types de mise en forme : Mise en forme standard : Objet décrit Cette mise en forme est proposée par défaut pour les objets qui peuvent être décrits par un diagramme. Elle a l'avantage de faire apparaître le diagramme et la description de l'objet sur la même page. Lorsqu un objet est décrit par plusieurs diagrammes, une section "Liste des diagrammes" apparaît dans la page principale (cadre de contenu) et dans le menu (cadre de menu). Sous cette section 123

5 apparaissent les liens correspondant à chaque diagramme. Si vous cliquez sur un lien, vous obtenez la page d un des diagrammes. Mise en forme à l aide des descriptions HTML. Pour plus d informations, voir "Utiliser les descriptions HTML", page 181. Mise en forme à l aide de formateurs scripts. Voir "Niveau 3 : Paramétrage des formateurs scripts", page 142. D autres descriptions peuvent être fournies avec le produit. Elles sont utilisées dans des contextes particuliers. Les mises en forme proposées concernent le type d objet décrit ainsi que la métaclasse abstraite dont dérive l objet. Ainsi, pour une page portant sur une opération s affiche parmi les mises en formes proposées celle d une "Action (BPMN)", une opération étant dérivée d une Action BPMN. Modifier les pages Une fois la page d objet créée, vous pouvez modifier le nom, la requête et les mises en forme (HEAD et BODY) dans la fenêtre de propriétés de la page. Ajouter des pages d'index Les pages d index facilitent l accès aux pages de votre site Web. Les index donnent la liste des objets qui apparaissent dans le site Web. Vous pouvez créer des pages d index à partir d objets faisant déjà l objet d une page. Dans ce cas, les formats standard proposés sont : Index alphabétique Index par caractéristiques Références croisées Si l'index n'est créé à partir d'aucune page d'objet, vous pouvez le personnaliser à l aide d une description HTML ou d un script VB. La description doit être de catégorie HTML Web Site Specific Page et le formateur script doit être relié au _Type Index HtmlFormatter. 124 MEGA Publisher

Créer un site Web Définir la composition du site Web Pour créer une page d index à partir d un objet : 1. Dans l'onglet Pages, activez la commande Ajouter dans le menu contextuel de l'icône "Index". 2. Dans la fenêtre Ajouter une page d'index, sélectionnez le type d'objet qui doit faire l'objet de l'index. 3. Sélectionnez ensuite le Type d'index souhaité. Le type d index permet de déterminer la mise en forme de votre index. La mise en forme proposée en standard est de type alphabétique. D autres mises en forme sont disponibles. Elles permettent de bénéficier d un critère de tri autre qu alphabétique (sur un lien du référentiel, une caractéristique, etc.). Voir "Paramétrer un site Web", page 141. Une fois les pages et index créés, vous obtenez une fenêtre de ce type. Lorsque vous définissez les pages d'un site Web, veillez à ne pas spécifier deux mises en formes différentes pour un même type d'objet : lors de la génération, seule la dernière sera prise en compte. 4. Cliquez sur le bouton OK. Les propriétés de votre site Web sont renseignées. Vous pouvez lancer la génération. 125

5 GÉNÉRER UN SITE WEB Pour générer un site Web, après avoir défini les objets principaux qu il décrit et la mise en page : Activez la commande Générer de son menu contextuel. Des fenêtres vous indiquent la progression de la génération du site Web. A la fin de la génération, un message vous propose d ouvrir le site Web. Vous pouvez également consulter le site Web généré en activant la commande Ouvrir de son menu contextuel. Reprise de génération Si vous stoppez la génération d un site Web avant qu elle ne soit terminée, vous pouvez reprendre par la suite la génération là où vous l avez arrêtée. Lorsque vous relancez la génération du site, un message vous demande si vous souhaitez reprendre la génération là où vous l avez stoppée. Si vous cliquez sur Non, le site est totalement régénéré. Compiler un site Web Si Microsoft HTML Help Workshop est installé sur votre poste et que l option correspondante dans MEGA est activée, vous verrez apparaître la commande Aide HTML dans le menu contextuel du site Web. Vous pouvez alors Compiler puis Ouvrir le site Web pour le visualiser sous forme d aide HTML (MS HTML Help). Cette fonctionnalité permet de réduire le nombre de fichiers à distribuer et d effectuer des recherches dans les pages générées. La ressource sur laquelle se trouve le site Web à compiler doit être connectée via un lecteur réseau (par exemple, M:). Le compilateur Microsoft ne permet pas de gérer les adresses UNC (Universal Naming 126 MEGA Publisher

Créer un site Web Générer un site Web Code), c est-à-dire les adresses du type \\Nom_Serveur\Nom_Ressource. Pour activer l option permettant de compiler un site Web : 1. Assurez-vous que Microsoft HTML Help Workshop est installé sur votre poste. 2. Dans l espace de travail, sélectionnez Outils > Options. 3. Sélectionnez le dossier Documentation puis le groupe d options Sites Web. 4. Dans la partie droite de la fenêtre, sélectionnez une valeur dans le champ Mode de compilation du site ("CHM" ou "CHM-CHI"). Contenu d'un site Web généré Un site Web généré comporte plusieurs types de pages : La carte du site Les pages d index Les pages spécifiques à chaque objet du référentiel. A l'intérieur des pages, les hyperliens permettent d'accéder aux pages voisines. Ces pages sont décomposées en plusieurs parties ou cadres. Les pages de diagrammes qui comportent des zones sensibles Page d'accueil La présentation des pages peut être paramétrée. Pour plus de détails, voir "Paramétrer un site Web", page 141. Dans les sites Web basés sur les sites Web types suffixés par "Exemple", un onglet Impacts apparaît. Il donne des informations relatives à analyse d impact : les objets liés à l objet sur lequel vous vous positionnez sont listés. La page d accueil est la page principale d un site Web, à partir de laquelle vous accédez aux autres pages. Elle indique l objet principal décrit par le site. Elle comporte également le commentaire du site Web, si vous en avez saisi un dans sa fenêtre de propriétés. 127

5 Pour revenir à la page d accueil lorsque vous vous trouvez sur une autre page, cliquez sur l icône La page d accueil permet d accéder à l URL parent (matérialisée dans la page d accueil par le lien "Site entreprise"). Cette adresse URL peut être indiquée lors de la création de votre site Web, dans l onglet Caractéristiques de la fenêtre de propriétés. Vous pouvez, par exemple, indiquer l adresse URL du site Web de votre société. Si le nom de l objet (ou des objets) que vous avez indiqué(s) dans l onglet Objets de la fenêtre de propriétés du site Web ne se présente pas sous forme d hyperlien, c est parce que vous n avez pas défini de page correspondante. Les sites Web générés avec les sites Web types "Projet d'organisation", "Projet d'architecture" et "Paquetage" n'ont pas de page d'accueil. Vous accédez directement à la carte du site. 128 MEGA Publisher

Créer un site Web Générer un site Web Carte du site La carte du site donne un résumé du contenu du site Web. Elle comporte un renvoi sur les pages d index et sur les pages décrivant les objets du site. 129

5 Pages d'index Les pages d index proposent des listes d objets classées par type d objet. Les objets sont soit triés par ordre alphabétique soit selon un autre critère qu il vous appartient de déterminer (voir "Personnaliser les index", page 154). Pages spécifiques à chaque objet Les pages décrivant un objet du référentiel sont découpées en deux parties ou cadres : La partie gauche, qui joue le rôle de menu, fournit un instrument de navigation à travers les principaux paragraphes de la page. La partie droite, qui expose le contenu de l'objet, est composée de plusieurs parties : le nom de l'objet qui donne lieu à la page. les caractéristiques de l'objet. ses différents constituants, qui sont les objets qui le décrivent et qui lui sont reliés. 130 MEGA Publisher

Créer un site Web Générer un site Web Exemple : Un processus peut avoir pour constituants des acteurs, des notes, un diagramme, des chapitres, des références externes auxquelles vous pouvez accéder en cliquant sur le lien correspondant. Pages de diagrammes Il est également possible de faire apparaître les parents de l'objet concerné, c'est-à-dire les objets qui lui sont reliés et de niveau supérieur, par exemple le(s) projet(s) contenant le processus organisationnel. Cette possibilité n'est cependant pas proposée par défaut, de manière à assurer une meilleure lisibilité de vos pages. Nous verrons comment faire apparaître ces objets parents dans "Paramétrer un site Web", page 141. Les pages du site Web qui présentent des diagrammes comportent des zones sensibles. En effet, lorsque vous passez avec la souris sur un objet du diagramme, le curseur se transforme en Le commentaire de l objet apparaît. 131

5 La transformation du curseur indique que vous pouvez cliquer pour obtenir des informations sur l objet concerné. Ces informations apparaissent sur la même page dans le cadre inférieur ou dans une autre page. Pour obtenir le diagramme dans la page décrivant un objet, vous devez sélectionner la mise en forme "Objet décrit". Dossiers et fichiers du site Web Les fichiers livrés en standard et ceux résultant de la génération se trouvent dans le dossier "Intranet" du dossier de l environnement. On appelle souvent "Site" le dossier dans lequel MEGA a été installé. Veillez à ne pas confondre celui-ci avec le "Site Web". Un sous-dossier spécifique est créé pour chaque site Web (sauf s il n a pas été spécifié dans le champ Dossier de génération à la création du site Web). 132 MEGA Publisher

Créer un site Web Générer un site Web Dans le répertoire "Intranet" de l environnement ou dans le sous-dossier correspondant au site Web, vous trouvez : Le dossier "STANDARD" qui contient les images fournies en standard utilisées lors de la génération du site Web. Le dossier "PAGES" qui contient les fichiers générés (extension ".htm"). Le dossier "IMAGES" qui contient les diagrammes générés. Les fichiers correspondant à la page d accueil et à la carte du site. Les fichiers d aide.hhk,.hhp et.hhc à compiler (pour produire une aide en ligne au format Microsoft HTML help). Vous pouvez également générer un fichier.chi pour Visual.Net. Pour cela, depuis l espace de travail, sélectionnez Outils > Options, dépliez le dossier Documentation puis cliquez sur Site Web et dans le champ Mode de compilation du site, sélectionnez "CHM-CHI". Regénérez ensuite le site Web. Précisions concernant la page d accueil et la carte du site Le nom des fichiers de page d accueil et de carte du site peut varier en fonction de ce que vous avez spécifié. Si un des noms n est pas présent dans l onglet Caractéristiques de la fenêtre de propriétés du site Web, la page correspondante n est pas générée. La page d'accueil et la carte du site ont par défaut le menu de navigation à gauche. Si vous souhaitez le placer en haut, vous devez changer de modèle de page d'accueil et de carte du site. Vous pouvez aussi les personnaliser en copiant les modèles dans le dossier MEGA_USR. Pour de plus amples informations, voir "Modifier les fichiers de page d accueil et de carte du site", page 177. 133

5 UTILISER UN SITE WEB TYPE Un site Web peut être créé à partir d un site Web type (de la même manière qu un document peut être créé à partir d un document type). Le site Web type n a pas pour objet d être généré. Il sert de modèle à la construction du site Web. Créer un site Web type Ajouter des pages Dans un site Web type, vous indiquez le(s) type(s) d objets à décrire dans le site ainsi que les pages générées. Ceci vous évitera de le spécifier à nouveau à chaque création de site Web. Pour créer un site Web type : 1. Dans l espace de travail, cliquez dans la fenêtre Utilitaires (accessible par la commande Affichage > Fenêtres de navigation > Utilitaires). 2. Cliquez sur le dossier correspondant à Site Web type et dans son menu contextuel, sélectionnez Nouveau. 3. Dans la fenêtre Création d un site Web type, indiquez son Nom et cliquez sur OK. Vous pouvez baser un site Web type sur un autre site Web type. Pour cela, vous devez dupliquer le site Web type existant. Voir "Dupliquer un site Web type", page 138. Dans la fenêtre de propriétés du site Web type, vous devez définir des objets décrits et des pages comme nous l avons fait pour un site Web. Pour ajouter des pages : 1. Dans la fenêtre de propriétés du site Web type, sélectionnez l onglet Pages. 2. Ajoutez une page et/ou une page d'index pour tous les types d'objets qui doivent donner lieu à une page, comme décrit dans le paragraphe correspondant au site Web "Ajouter des pages", page 122. Sélectionner des objets Pour sélectionner des objets : 1. Dans la fenêtre de propriétés du site Web type, sélectionnez l'onglet Objets. 2. Ajoutez une sélection de types d'objets qui permettront de constituer une liste d'objets apparaissant dans le site Web. 134 MEGA Publisher

Créer un site Web Utiliser un site Web type La fenêtre Ajouter une requête apparaît. Après avoir cliqué sur OK, la fenêtre Paramétrage de la requête apparaît lorsque des paramètres doivent être résolus. 3. Renseignez la variable dont la valeur sera demandée lors de la création d'un site Web à partir du site Web type. Ici, il s'agit de "Nom". Si la case v est désactivée, la valeur saisie sera prise en compte directement comme valeur du paramètre lors de la création du site Web. 4. Cliquez sur OK. Vous pouvez maintenant créer un site Web à partir de ce site Web type. Le site Web type peut être paramétré de la même façon qu'un site Web. Des sites Web types sont proposés en standard avec tous les produits MEGA. Ils ne peuvent être modifiés mais peuvent servir à la création d autres sites Web types. Créer un site Web à partir d'un site Web type Pour créer un site Web à partir d un site Web type : 1. Dans l espace de travail MEGA, sélectionnez la fenêtre Documentation. Pour accéder à la fenêtre Documentation, dans l espace de travail, cliquez sur Affichage > Fenêtres de navigation > Documentation. 135

5 2. Dans l arborescence, cliquez sur le dossier "Sites Web" et dans son menu contextuel, sélectionnez Nouveau > Site Web. La fenêtre Création d un site Web apparaît. Par défaut, le site Web est généré dans le dossier "Intranet". Vous pouvez en choisir un autre en cliquant sur le bouton. Il est conseillé de créer un sous-dossier par site Web généré, en créant par exemple sous le dossier "Intranet" des dossiers portant le même nom que votre site Web. Le contenu du dossier "Intranet" est détruit à chaque génération. Une fois que vous avez obtenu un site satisfaisant, pensez à copier le contenu du dossier là où il sera conservé. 3. Dans le champ A partir du site Web type, cliquez sur le bouton 4. Sélectionnez un site Web type, par exemple "Portail Entreprise". 5. Lorsque ces champs sont renseignés, cliquez sur le bouton Terminer. 6. Activez le menu contextuel du site Web et cliquez sur Propriétés. 7. Dans la fenêtre de propriétés qui apparaît, cliquez sur l onglet Objets. 136 MEGA Publisher

Créer un site Web Utiliser un site Web type Le site Web type "Portail Entreprise (Exemple)" génère l ensemble de la base, ce qui prend du temps. Vous pouvez donc restreindre le champ des objets à générer en choisissant de générer un projet seulement. Pour restreindre les objets générés : Cliquez sur chaque type d objet et supprimez- les à l aide du bouton Supprimer. Conservez seulement les types d objets "Site Web type" et "Généralité". Nous allons maintenant rajouter un objet de type "Projet". Pour cela : Activez la commande Ajouter > Un objet. Dans la fenêtre qui apparaît, sélectionnez le projet "HBC" puis cliquez sur OK. Vous obtenez la fenêtre suivante : Fermez cette fenêtre et dans le menu contextuel du site cliquez sur Générer. Vous obtenez alors un site Web dans lequel vous pouvez visualiser les processus, procédures, acteurs et métiers du projet. 137

5 Créer un site Web type à partir d un site Web Lorsque vous avez créé votre site web, il est possible de l enregistrer comme un site Web type pour le réutiliser. Pour créer un site Web type à partir d un site Web : Dans le menu contextuel du site Web, sélectionnez Administrer > Enregistrer sous un site Web type. Dupliquer un site Web type La duplication d un site Web type permet de créer un site Web type en se basant sur un site Web type existant. Pour dupliquer un site Web type : Dans le menu contextuel d un site Web type, cliquez sur Dupliquer. 138 MEGA Publisher

Créer un site Web Utiliser un site Web type Deux stratégies de duplication sont proposées. Duplication partielle (Réutiliser les descriptions, requêtes et macros) Seul le site Web type est dupliqué. Les descriptions, requêtes et macros sont les mêmes que celles du site Web type source. C est cette stratégie que vous utilisez lorsque vous voulez créer un site Web type à partir d un autre site Web type. Duplication totale (Dupliquer les descriptions, requêtes et macros) La duplication totale duplique le site Web type, les descriptions, les requêtes et macros. 139

5 140 MEGA Publisher

6 PARAMÉTRER UN SITE WEB Vous allez découvrir comment paramétrer votre site Web si le résultat obtenu dans un premier temps et par défaut ne vous convient pas. Ce paramétrage peut être effectué de plusieurs façons : Les points suivants sont abordés ici : Globalement, en modifiant les options générales du site Web. Pour chaque type d'objet, en modifiant les paramètres des pages à générer et en utilisant les feuilles de style. Nous expliquons ici comment paramétrer un site Web. Ces explications sont valables pour le paramétrage des sites Web types. "A propos du paramétrage des sites Web", page 142 "Modifier les caractéristiques générales d un site Web", page 145 "Paramétrer les pages du site Web", page 153 "Personnaliser les index", page 154 141

6 A PROPOS DU PARAMÉTRAGE DES SITES WEB La mise en forme des pages Web se fait grâce à des formateurs HTML. Ces formateurs sont de trois types ; les formateurs standard, les descriptions HTML et les formateurs scripts. Ces trois types de formateurs se situent à des niveaux de compétence différents. Niveau 1 : Paramétrage des formateurs standard Il s agit des formateurs : Objet décrit Diagramme Standard Voir "Mise en forme des pages", page 123. Technologies utilisées MEGA : Formateurs (mises en forme) standard Web : CSS Niveau 2 : Paramétrage des descriptions HTML Voir "Utiliser les descriptions HTML", page 181, et "Fonctions avancées des sites Web", page 159 Technologies utilisées MEGA : Descriptions HTML, connaissance du métamodèle Web : HTML et CSS Niveau 3 : Paramétrage des formateurs scripts Il s agit de formateurs HTML reliés à une macro VB. Le formateur HTML est relié d une part : à un ou plusieurs _Type, suivant les pages dans lesquelles vous voulez le voir apparaître : Object HtmlFormatter (formateur de page d'objet) Index HtmlFormatter (formateur de page d'index) HomePage HtmlFormatter (formateur de page d'accueil) SiteMap HtmlFormatter (formateur de carte du site) à une macro VB. La macro doit implémenter la méthode suivante : Public Sub Generate(oObject, owebcontext, struserdata, strresult) End Sub 142 MEGA Publisher

Paramétrer un site Web A propos du paramétrage des sites Web Technologies utilisées MEGA : API Script, Connaissance métamodèle Web : HTML, CSS, VB Script Créer un formateur script La création d un formateur script suppose que l accès au métamodèle soit en mode "Expert". 1. Ouvrez le menu Outils > Options. 2. Sélectionnez le dossier Référentiel 3. Dans le champ Accès au métamodèle, sélectionnez "Expert". Pour créer un formateur script : 1. Depuis le menu Outils de MEGA, ouvrez l éditeur de scripts. 2. Créez un formateur HTML et cliquez sur le bouton Exécuter 3. Dans l explorateur qui apparaît, reliez le formateur à un _Type. 4. Sélectionnez le type de formateur, par exemple Object HtmlFormatter (formateur de page d'objet). 5. Depuis l explorateur du formateur, créez une macro. Par défaut, la nouvelle macro est de type "script". 143

6 6. Dans le menu contextuel de la macro, sélectionnez Editer. 7. Saisissez la macro. Le formateur créé est maintenant disponible dans les champs de mise en forme des pages du Site Web. 144 MEGA Publisher

Paramétrer un site Web Modifier les caractéristiques générales d un site Web MODIFIER LES CARACTÉRISTIQUES GÉNÉRALES D UN SITE WEB Dans l onglet Caractéristiques de la fenêtre de propriétés du site Web, vous pouvez indiquer ou modifier les valeurs proposées par défaut pour : Le Dossier du site (dossier temporaire utilisé pour la génération). Les noms de la Page d'accueil et de la Carte du site. Vous pouvez modifier les noms par défaut de la page d accueil et de la carte du site. Vous pouvez également laisser un des champs vide. Dans ce cas, la page correspondante ne sera pas générée dans le dossier de génération. L'URL parent, si le site est généré pour ensuite être inséré dans un Intranet. Par défaut, l'url parent (qui correspond au lien "Site Entreprise" de la page d'accueil du site Web) est "www.mega.com". La Feuille de style utilisée (par défaut "NewLook.css"). Une feuille de style regroupe des règles de présentation qui peuvent être appliquées à des éléments d'une page Web. Ces règles sont exprimées dans le langage Cascading Style Sheet (CSS). Pour de plus amples informations, se référer aux recommandations du W3C, World Wide Web Consortium (http://www.w3.org). Vous pouvez choisir une feuille de style différente de celle proposée par défaut si cette dernière ne vous convient pas. Vous pouvez personnaliser les feuilles de style fournies, qui se trouvent dans le dossier "Mega_Std". Pour cela, vous devez les copier dans le sous- 145

6 dossier "Mega_Usr" de l environnement, où vous pouvez les modifier et les renommer. Vous pouvez également en créer de nouvelles et les placer dans ce même dossier. Les modèles de page d accueil et de carte du site La page d accueil et la carte du site peuvent être générées : A partir de fichiers ayant l extension.mth, qui se trouvent dans le dossier "MEGA_Std" du dossier dans lequel MEGA a été installé : "Index.mth" pour la page d'accueil, "Indexsite.mth" pour la carte du site avec menu de navigation à gauche. Si vous souhaitez personnaliser ces fichiers, copiez-les dans le sous-dossier "Mega_Usr" de l environnement et reportez-vous au paragraphe "Modifier les fichiers de page d accueil et de carte du site", page 177. A partir de Formateurs de type Description ou Script. Paramétrer la mise en page Pour renseigner les options générales du site Web : Dans l'onglet Caractéristiques de la fenêtre de propriétés, cliquez sur le bouton Options. Le bouton Options est actif uniquement avec le module technique MEGA Publisher - Web. 146 MEGA Publisher

Paramétrer un site Web Modifier les caractéristiques générales d un site Web La fenêtre Options apparaît. Elle vous permet de paramétrer certains éléments de mise en page et de renseigner les caractéristiques des objets que vous souhaitez faire apparaître. Présentation des caractéristiques Fenêtre de propriétés du site Web, onglet Caractéristiques, bouton Options Le chemin à suivre pour obtenir la fenêtre de propriétés décrite est rappelé en dessous de celle-ci. Vous pouvez : Editer les Caractéristiques non renseignées des objets. Cette option peut être utile si vous souhaitez visualiser toutes les caractéristiques des objets (qu'elles soient renseignées ou non). Paramétrer l'édition des caractéristiques des objets : faire apparaître les caractéristiques Générales des objets (date de création, de modification, nom du créateur, etc.) et les caractéristiques Etendues (qui sont des caractéristiques techniques d'administration). Choisir de faire apparaître ou non les Références externes. Si vous choisissez d inclure les références externes lors de la génération et que vos références externes ont des adresses prédéfinies, vous pouvez choisir de les traiter comme étant relatives au site Web. Pour plus de détails, voir "Intégrer les références externes", page 173. 147

6 Présentation des titres de section Modifier l'image des hyperliens si celle proposée en standard ne vous convient pas (flèche jaune située à côté d'un titre s'il y a un lien vers une autre page). Modifier l'image de retour en haut de la page si celle proposée en standard ne vous convient pas dans le cas d'une génération sans cadre. Présentation des menus Afficher ou non le Menu. Vous pouvez également personnaliser l affichage du menu sur chaque page du site Web. L option définie au niveau d une page prime sur celle du site Web. Voir "Paramétrer les pages du site Web", page 153. Indiquer la Présentation du menu de navigation (avec cadre ou sans cadre) ainsi que sa Position (à gauche ou en haut de l'écran). La position du menu de navigation dans la page d'accueil et dans la carte du site est définie par le fichier ".mth". Pour de plus amples explications, voir "Modifier les fichiers de page d accueil et de carte du site", page 177. Indiquer, en pourcentage de la largeur globale de la fenêtre, la Largeur du menu de navigation situé à gauche ou en haut. Préciser si vous souhaitez générer une Bordure. Faire apparaître ou non dans ce menu les Images représentant les divers types d'objets apparaissant dans les pages. 148 MEGA Publisher

Paramétrer un site Web Modifier les caractéristiques générales d un site Web Hébergement du site Web Préciser le nom du Cadre dans lequel figure le site Web généré, lorsque celui-ci fait partie d un site Web plus large. Le nom du cadre correspond à la référence donnée au cadre cible au sein de la balise FRAME. Exemple : <FRAME NAME="Nom"> Exemple de site Web avec menu de navigation en haut et sans cadre Modifier le logo, les puces et la police Pour modifier le logo et les puces des pages de votre site Web : 1. Dans l onglet Caractéristiques de la fenêtre de propriétés d un site Web, cliquez sur le bouton Options. Dans la fenêtre Options : 2. Cliquez sur le bouton Options étendues. 149

6 Dans la fenêtre Options étendues : L'onglet Cadre de menu permet de personnaliser l'apparence du menu de navigation situé à gauche de votre écran : logo, puces des titres et sous-titres. L'onglet Cadre de contenu permet de personnaliser l'apparence des éléments qui apparaissent dans la partie principale de la page : logo, puces des titres et sous-titres. Vous pouvez également préciser si vous souhaitez faire un zoom dans vos dessins de diagramme (champ Zoom Image (Internet Explorer)). En choisissant cette possibilité, vous pourrez choisir une échelle en % dans un menu disponible en bas des diagrammes du site Web ou dans le menu contextuel du diagramme (pour le format SVG). Cette fonctionnalité n est disponible que si le diagramme est dans un cadre à part de la description du diagramme. Fenêtre de propriétés du site Web, onglet Caractéristiques, bouton Options, bouton Options étendues Les images du logo et des puces se trouvent dans le dossier "Mega_Std" du site d installation. Vous pouvez les copier et les modifier dans le sous-dossier "Mega_Usr" de l environnement. Si vous ne souhaitez pas voir apparaître de logo dans vos pages générées, sélectionnez le fichier "Neutral.gif" dans le champ Logo. Précisions concernant images de fond, couleurs, police, liens Les images de fond, la couleur des liens et la police sont à paramétrer dans une feuille de style. Pour plus de détails, voir "Modifier la feuille de style.css", page 168. Si vous souhaitez conserver les polices utilisées dans les commentaires 150 MEGA Publisher

Paramétrer un site Web Modifier les caractéristiques générales d un site Web RTF des objets, vous devez cocher la case Police RTF autorisée dans l onglet Génération de la fenêtre de propriétés du site Web. Pour les sites Web basés sur les site Web types "MOKA (Exemple)" et "Projet (Exemple)", l image de la page d acceuil peut être modifiée facilement. Pour cela, sélectionnez une image (référence externe) dans l onglet Génération de la fenêtre de propriétés du site Web. Modifier le format des images Pour modifier le format par défaut des images générées : 1. Dans l espace de travail, cliquez sur Outils > Options. 2. Sous le dossier Documentation, cliquez sur l icône Site Web. 3. Dans le champ Format des images générées, sélectionnez le format désiré. 4. Cliquez sur OK. Format SVG Les images générées au format SVG (Scalable Vector Graphics) sont de meilleure qualité que celles générées dans un autre format, notamment lors d un zoom (déformation). Pour visualiser les images générées dans ce format, vous devez installer une visionneuse spécifique. Le champ Editeur SVG indique l adresse URL d une visionneuse SVG. Elle sera automatiquement téléchargée lors de la visualisation de l'image. Si vous désirez utiliser une autre visionneuse, modifiez l adresse URL. Utilisation du format SVG dans les pages générées Vous pouvez faire un zoom dans un diagramme du site Web en activant une des commandes du menu contextuel. 151

6 Pour faire un zoom avant : Cliquez sur Zoom in. Pour faire un zoom arrière : Cliquez sur Zoom out. Le zoom est réalisé à partir du point central du dessin. Pour faire un zoom sur une partie du dessin : 1. Positionnez le curseur sur la partie du dessin qui vous intéresse et appuyez sur la touche <Ctrl>. Le curseur prend la forme suivante : 2. Cliquez avec le bouton droit de la souris et sélectionnez le type de zoom qui vous intéresse. 152 MEGA Publisher

Paramétrer un site Web Paramétrer les pages du site Web PARAMÉTRER LES PAGES DU SITE WEB Pour paramétrer la présentation et le contenu des pages correspondant à chaque type d objet : 1. Sélectionnez l onglet Pages de la fenêtre de propriétés d un site Web. 2. Sélectionnez la commande Propriétés d'une des pages que vous avez créées. Exemple : Vous pouvez choisir de paramétrer différemment les pages décrivant les processus et les pages décrivant les acteurs. Page de site Web - Onglet Caractéristiques Dans l onglet Caractéristiques de la fenêtre de propriétés d une page, vous pouvez consulter et modifier : Le nom de la page (par défaut, il s'agit du type d'objet) La requête appliquée La mise en forme de la page En-tête <HEAD> Corps <BODY> Pour plus de détails sur les mises en forme, voir "Mise en forme des pages", page 123. Page de site Web - Onglet Menu & Cadre Vous pouvez définir les options d affichage du menu et des cadres au niveau du site Web. Dans ce cas, les options valent pour toutes les pages générées. Voir "Présentation des menus", page 148. Vous pouvez également modifier ces options d affichage au niveau d une page, dans l onglet Menu & Cadre de sa fenêtre de propriétés. 153

6 PERSONNALISER LES INDEX Vous avez vu au cours du chapitre précédent comment créer des index simples, de type alphabétique, vous permettant d accéder aux pages de votre site Web. Il est possible de créer des index élaborés par références croisées ou par caractéristique. Créer un index par références croisées MEGA Publisher - Web permet d ajouter des pages d index ayant un critère autre qu alphabétique (sur un lien du référentiel, par exemple). On appelle ces index personnalisés "Références croisées". Vous pouvez, par exemple, choisir de créer un index qui regroupe les opérations par acteur. Pour ajouter un index de type "Références croisées" : 1. Sélectionnez l'onglet Pages de la fenêtre de propriétés d'un site Web. 2. Ajoutez une page d'index. 3. Dans la fenêtre Ajouter une page d'index, sélectionnez le type d'objet que vous voulez indexer, par exemple "Processus métier". 4. Dans le cadre Type d index, champ Corps <Body>, sélectionnez "Références croisées". 5. Cliquez sur le bouton Suivant pour préciser votre critère de tri. Pour préciser le critère de tri de l index de type "Références croisées" : 1. Choisissez, par exemple, de regrouper les processus par "Acteur" (dans le champ situé sous l'intitulé A partir de). 2. Opérez si nécessaire une sélection plus fine du critère de tri dans la liste du champ Requête, si des requêtes spécifiques sont disponibles. 154 MEGA Publisher

Paramétrer un site Web Personnaliser les index 3. Effectuez si nécessaire le regroupement en fonction d'un second critère, par exemple le rôle que joue l'acteur dans un processus. Le tri peut également être effectué en fonction de l'ordre du référentiel ou par ordre alphabétique. 4. Cliquez sur le bouton Terminer pour créer l'index. Une fois la page d index créée, vous pouvez modifier les critères de tri dans la fenêtre de propriétés de la page. Vous obtenez un résultat de ce type après avoir régénéré le site Web : 155

6 Créer un index en fonction de caractéristiques Pour ajouter des pages d index ayant pour critère de tri une caractéristique de l objet : 1. Ajoutez une page d'index ayant pour Type d'index "Index par caractéristique" puis cliquez sur Suivant. 2. Dans la fenêtre qui apparaît, sélectionnez, dans la liste du champ Trié par, la caractéristique qui servira de critère de tri à votre index. Exemple : Si vous avez choisi l'objet Acteur, vous pouvez, choisir la caractéristique "Interne/Externe", qui permettra de distinguer les acteurs internes et externes. Une fois la page d index créée, vous pouvez modifier les critères de tri dans la fenêtre de propriétés de la page. Vous obtenez un résultat de ce type après avoir régénéré le site Web : 156 MEGA Publisher

Paramétrer un site Web Personnaliser les index Modifier le nom des pages d'index Par défaut, lorsque vous créez une page ou une page d index, le nom qui lui est attribué est le nom du type d objet que vous avez sélectionné. Pour modifier le nom de la page d index qui apparaît dans la carte du site et les pages d index : Activez la commande Propriétés de la page que vous avez créée et modifiez le nom de la page dans le champ Nom. Le nouveau nom apparaîtra lors de la prochaine génération du site Web. 157

6 158 MEGA Publisher

7 FONCTIONS AVANCÉES DES SITES WEB Ici sont expliquées des notions techniques, qui sont utiles uniquement si vous voulez comprendre le code HTML généré, utiliser les cadres ou modifier la présentation de votre site Web en utilisant une feuille de style. La dernière partie explique comment gérer les adresses des éléments générés, afin d établir des liens intersites, personnaliser les noms d objets etc. Nous aborderons ici les points suivants : "Notions de HTML", page 160 "Utiliser les cadres", page 163 "Feuilles de style", page 164 "Gérer les fichiers du site Web", page 170 "Personnaliser les noms d'objets et de liens", page 176 "Modifier les fichiers de page d accueil et de carte du site", page 177 "Contrôler la génération du site Web", page 179 "Compte rendu de génération", page 179 159

7 NOTIONS DE HTML Le but de cette présentation du langage HTML est de décrire des notions de base sur HTML (HyperText Markup Language). Il ne s agit évidemment pas d une description exhaustive de HTML, mais les éléments décrits ici peuvent être utiles pour mieux comprendre le code qui constitue le site généré. Pour une description plus approfondie de HTML, il existe de nombreux ouvrages plus ou moins détaillés, ainsi que de nombreux sites accessibles en ligne. Le site http:// www.w3.org/, du World Wide Web Consortium, permet d accéder aux spécifications de HTML, et propose de nombreux liens vers des sites qui traitent de HTML et de sujets connexes. Présentation générale de HTML Utilisation Le but initial de HTML est de diffuser des informations sur Internet, mais cette technique est désormais largement utilisée dans des Intranets, internes à une entreprise. HTML permet de décrire des documents qui peuvent contenir, entre autres, du texte, des images, et des liens vers d autres pages, les hyperliens. Les informations présentes dans le document sont utilisées par un navigateur, tel que Netscape Navigator ou Microsoft Internet Explorer, pour afficher son contenu, avec une mise en forme qui peut être complexe. Les hyperliens permettent d accéder à un autre document. Quand l utilisateur clique sur un hyperlien, le document qu il référence est présenté, dans une nouvelle fenêtre ou dans un cadre, lorsque la fenêtre est partitionnée en plusieurs cadres. Balises Le principe de base de HTML est l utilisation de balises (tags), qui sont plus ou moins complexes. Comme balise simple, il est possible de citer <B>, pour mettre le texte en gras (bold) : <B>Ce texte est affiché en gras</b> donne le résultat suivant : Ce texte est affiché en gras Avec les versions de navigateurs compatibles avec la norme 4.0, l utilisation de balises de mise en forme, telles que <font>, est déconseillée. Cette norme préconise l usage de styles, soit internes à la page, soit appelées dans l en-tête (voir ci-après). Cependant, ces balises sont toujours reconnues, et permettent d appliquer rapidement une mise en forme ponctuelle. La recommandation courante est le remplacement de ces balises par des balises de type <SPAN style :bold> appariées par des balises </SPAN>. Cependant, l évolution des normes préconisées, le fait que le traitement des codes HTML varie en fonction du navigateur, ainsi que la compatibilité requise avec les normes 160 MEGA Publisher

Fonctions avancées des sites Web Notions de HTML précédentes, laisse aux créateurs de sites Web un libre choix pour leur traitement du code HTML. Les balises sont placées entre < et >, et sont le plus souvent appariées, comme dans l exemple qui précède; la balise de fin est identique à celle de début, et précédée d une barre de fraction. Pour certaines balises, seule la balise de début est nécessaire, mais une balise de fin superflue ne cause généralement aucun problème. Il est possible d imbriquer les balises : <B>Ce texte est en gras, <I>puis en gras italique,</b> puis plus gras mais toujours italique, </I> puis en normal. donne le résultat suivant : Ce texte est en gras, puis en gras italique, puis plus gras mais toujours italique, puis en normal. Structure des documents HTML La structure de base des documents HTML est la suivante : <HTML> <HEAD> <TITLE>Document HTML Simple</TITLE> </HEAD> <BODY> <P>Ceci est un document très simple. </BODY> </HTML> La balise <HTML>, qui commence tous les documents HTML, indique au navigateur qu'il doit interpréter les balises HTML. La balise appariée </ HTML> indique la fin du document. La balise <HEAD> définit l'en-tête du document, qui contient : Entre les balises <META>, des mots-clés utilisés entre autres par les moteurs de recherche. Le titre (balises <TITLE>), qui sera le titre de la fenêtre du navigateur. La feuille de style (balises <SHEET>), qui permet de définir rapidement le format d'affichage des divers éléments de la page. Pour plus d informations, voir "Feuilles de style", page 164. Ensuite, la balise <BODY> indique le début du corps du document, composé de textes, d'images, et d'objets multimédia. La balise <P>, qui permet de créer un nouveau paragraphe, est fréquemment utilisée dans le corps du document. Hyperliens Les hyperliens vers d autres emplacements sont indiqués par des balises <A HREF>, qui indiquent l adresse du texte, de l image ou de tout autre objet qu elles référencent. Lorsque l utilisateur clique sur l hyperlien, son contenu est alors affiché, 161

7 soit en remplacement du contenu précédent de la fenêtre de l explorateur, soit dans un cadre (frame) de la fenêtre principale. L élément référencé peut également correspondre à une autre partie du même document. Les hyperliens sont en général présentés dans une couleur différente de celle du texte ordinaire. De plus, lorsque le pointeur est placé sur un hyperlien, sa forme change. La définition d un hyperlien se fait comme suit : Cliquez <A HREF="//www.mega.com/">ici</A> pour visiter notre site. Dans l exemple qui précède, "ici" sera souligné pour montrer qu il s agit d un lien, mais ceci peut varier en fonction du paramétrage du navigateur. L adresse est entre guillemets droits. Ceux-ci peuvent être omis si l adresse ne contient pas de blancs. Les caractères spéciaux, tels que les guillemets droits, sont codés pour que le navigateur ne les interprète pas comme des signes de séparation. Par exemple, """ remplace les guillemets droits, < remplace <, > remplace > (le point-virgule fait partie du code). Les lettres accentuées sont théoriquement codées, mais la plupart des navigateurs récents les reconnaissent telles quelles. Il est possible de créer plusieurs adresses dans un même document, ce qui permet un saut vers un endroit précis du document. Lorsque l'emplacement indiqué pour le saut apparaît déjà à l'écran, il peut sembler que le saut ne fonctionne pas. La balise de définition d une adresse est : <A NAME="Complinfor"> Un saut vers cette adresse sera indiqué de la façon suivante : Pour plus d'informations, voir <A HREF="Info.htm#Complinfor">Autres Informations</A> Il est également possible d indiquer un chemin relatif (../xxx.htm). (C est une barre de fraction normale qui est utilisée, et non la barre inversée usuelle.) Le nom de la page peut être omis si le lien renvoie à autre emplacement dans le même document. Par exemple : HREF="#Complinfor". Autres balises HTML Plusieurs balises permettent de définir la couleur de l élément qu elles concernent. Cette couleur peut être indiquée par l intermédiaire des couleurs prédéfinies en HTML ("black", "purple"), ou par leur valeur hexadécimale Rouge/Vert/Bleu (#FF0000=rouge, #00FF00=bleu, #0000FF=vert, #000000=noir ; le # peut être omis avec certains navigateurs). D autres balises permettent de définir le format du texte, de créer des listes, des tableaux, etc., ainsi que de structurer le document avec des niveaux de titre (<H1>, <H2>, ). 162 MEGA Publisher

Fonctions avancées des sites Web Utiliser les cadres UTILISER LES CADRES Les cadres (frames) permettent de partitionner la fenêtre de l explorateur, pour y présenter plusieurs documents simultanément. De plus, les cadres permettent, lorsqu un lien du cadre est activé, de modifier soit leur contenu (de la même façon que lorsque la fenêtre n est pas partitionnée), ou le contenu d un autre cadre. Les cadres sont définis dans un document HTML principal. Ce document se présente souvent comme un contenant, qui ne fait qu appeler d autres documents en indiquant où ils doivent être présentés. Par exemple, dans l exemple qui suit, la page est divisée en deux cadres, et appelle les deux documents présentés dans chaque page. <FRAMESET COLS="20%, *"> <FRAME SRC="1a831e8430fe0067_m.htm" NAME="menuframe"> </FRAME> <FRAME SRC="1a831e8430fe0067_c.htm" NAME="contentframe"> </FRAME> </FRAMESET> Les pages appelées peuvent elles-mêmes définir de nouveaux cadres, imbriqués dans le cadre où elles sont présentées. 163

7 FEUILLES DE STYLE Présentation des feuilles de style Les feuilles de style permettent de modifier rapidement l aspect des pages sans avoir à les paramétrer individuellement. Une feuille de style permet, en effet, de définir l aspect de chaque élément des pages, en fonction, d une part des balises HTML, et, d autre part, des styles indiqués en paramètres dans le corps de la page. Les options d affichage d un élément peuvent être définies de plusieurs façons : Soit en indiquant explicitement le formatage (ex: <B>texte en gras</ B>). Soit en définissant le style dans la balise HTML (ex:<table BORDER=1 style="font: 10pt Arial">). Soit en liant le document HTML à une feuille de style externe, ce qui permet de modifier l'aspect de toutes les pages d'un site Web qui utilisent la feuille de style, en intervenant uniquement sur la feuille de style elle-même. Cette dernière méthode est utilisée dans la génération des pages : la feuille de style du site Web (définie dans ses propriétés) est citée dans l en-tête (<HEAD>) de chaque page : <LINK REL=stylesheet href="stylsh.css"> Les styles des divers éléments sont ensuite précisés. Par exemple, le tableau est défini avec le style "StdConstLayTabProp" : <TABLE CLASS="StdConstLayTabProp"> Il faut noter que le mot-clé qui indique le style à utiliser est CLASS, et que le motclé STYLE sert à définir localement le formatage de la balise. Les paramètres indiqués dans la page HTML s ajoutent à ceux indiqués dans la feuille de style et remplacent ceux qui sont déjà définis. La hiérarchie des définitions indiquées dans les feuilles de styles varie en fonction du navigateur utilisé. Certains navigateurs ne les reconnaissent pas. Une redéfinition de style dans la page a la priorité sur la définition de la feuille de style. Définition des styles Les styles peuvent être définis dans une page, ce qui évite de répéter la mise en forme des éléments à chaque fois qu ils sont utilisés, dans l en-tête de la page. <HEAD> <STYLE> H1{font: 22pt Arial, Helvetica, sans-serif} </STYLE> 164 MEGA Publisher

Fonctions avancées des sites Web Feuilles de style Dans l exemple qui précède, les titres de niveau H1 seront en 22 points, avec la police "Arial" si cette police est installée sur l ordinateur de la personne qui consulte la page, sinon en "Helvetica", et, si aucune de ces polices n est trouvée, dans une police de la famille "sans-serif". Cette possibilité peut être utilisée dans toutes les balises qui définissent la police utilisée pour l'affichage. Dans l exemple ci-dessous, lorsqu il est indiqué, dans la balise H1, que son style est "Style1Plus" (<H1 class=style1plus>), il faut, à la mise en forme précédente, ajouter la couleur rouge à la place de la couleur utilisée par défaut. <STYLE> H1 {font: 22pt Arial, Helvetica, sans-serif} H1.Style1Plus {color: red} </STYLE> Il est possible de définir un style qui s appliquera à toutes les balises, en le déclarant comme suit :.NomDuStyle{mise en forme} Ce style peut être utilisé sous la forme H1.NomDuStyle, TR.NomDuStyle, etc. Lors de l affichage des pages, la priorité est donnée à la mise en forme qui est la plus proche de l élément concerné : si un style est défini dans la feuille de style, puis redéfini dans l en-tête, et une troisième fois dans le corps du texte, c est cette dernière définition qui sera prise en compte. Les différentes définitions s'ajoutent lorsqu'elles ne sont pas contradictoires : un style définissant une couleur dans la feuille de style restera valide si la redéfinition concerne, par exemple, uniquement la taille de caractères. 165

7 Les feuilles de style sont, comme les pages HTML, des fichiers textes. Elles ont en général l extension CSS, pour Cascading Style Sheet. Elles sont indiquées dans le paragraphe META : <LINK REL=STYLESHEET TYPE="text/css" HREF="../STANDARD/ NEUTRAL.CSS"> Eléments définis Police Taille Couleur Feuille de style Arial 12 Bleu En-tête (HEAD) 18 Résultat Arial 18 Bleu Exemple de fonctionnement de style en cascade Eléments définis Police Taille Couleur Feuille de style Arial En-tête (HEAD) 18 Balise size:20 color=red Résultat Arial 20 rouge Autre exemple de fonctionnement de style en cascade De même qu il existe des éditeurs de HTML, des logiciels permettent de modifier les feuilles de style, et évitent d avoir à connaître précisément les codes de mise en forme. Ces codes sont documentés dans de nombreux sites Web (entre autres, le site http://www.w3.org/, du World Wide Web Consortium). Dans les pages générées avec le générateur HTML, des styles sont indiqués par défaut, et indiquent quel objet est traité. Styles proposés dans "Neutral.Css" La feuille de style "Neutral.Css" qui se trouve dans MEGA_STD contient la définition de ces styles, sans mise en forme. Ces styles sont les suivants (les styles préfixés 166 MEGA Publisher

Fonctions avancées des sites Web Feuilles de style par "Model" sont utilisés dans la mise en forme "Diagramme", ceux préfixés par "Std" dans la mise en forme "Standard") :.ModelConstLayLinePropLine.ModelConstLayLinePropTable.ModelConstLayLineText.ModelConstLayTabNameComment.ModelConstLayTabProp.ModelDescribedObj.ModelObjPropByLine.ModelObjPropByTable.ModelObjTableNameComment.ModelObjText.ModelParentLayLinePropLine.ModelParentLayLinePropTable.ModelParentLayLineText.ModelParentLayTabNameComment.ModelParentLayTabProp.ModelProperties.StdConstLayLinePropLine.StdConstLayLinePropTable.StdConstLayLineText.StdConstLayTabNameComment.StdConstLayTabProp Caractéristiques des constituants du diagramme présentées en ligne Caractéristiques des constituants du diagramme présentées en tableau Commentaires des constituants du diagramme présentés en tableau Constituants du diagramme présentés en tableau avec leurs commentaires Constituants du diagramme présentés en tableau avec leurs caractéristiques Objet décrit par le diagramme Caractéristiques des objets du diagramme présentées en ligne Caractéristiques des objets du diagramme présentées en tableau Nom et commentaire des objets du diagramme Commentaire des objets du diagramme Caractéristiques des parents du diagramme présentées en ligne Caractéristiques des parents du diagramme présentées en tableau Commentaires des parents du diagramme présentés en tableau Parents du diagramme présentés en tableau avec leurs commentaires Parents du diagramme présentés en tableau avec leurs caractéristiques Propriétés du diagramme Caractéristiques des constituants présentées en ligne Caractéristiques des constituants présentées en tableau Commentaires des constituants Constituants présentés en tableau avec leurs commentaires Constituants présentés en tableau avec leurs caractéristiques 167

7.StdParentLayLinePropLine.StdParentLayLinePropTable.StdParentLayLineText.StdParentLayTabNameComment.StdParentLayTabProp.StdPropLine.StdPropTable.StdText Caractéristiques des parents présentées en ligne Caractéristiques des parents présentées en tableau Commentaires des parents Parents présentés en tableau avec leurs commentaires Parents présentés en tableau avec leurs caractéristiques Caractéristique présentée en ligne Caractéristique présentée en tableau Commentaire Modifier la feuille de style.css Plusieurs paramètres peuvent être définis dans la feuille de style.css : Couleur du fond, Couleur des liens Couleur des liens visités Couleur du texte Police par défaut Modifier les paramètres de la page de contenu Pour modifier : Image de fond Couleur du fond Couleur des liens Couleur de liens visités Couleur du texte Police par défaut Style et paramètre à modifer : Style 'BODY.Content' ou 'BODY', paramètre 'BACKGROUND- IMAGE' Style 'BODY.Content' ou 'BODY', paramètre 'BACKGROUND- COLOR' Style 'A', paramètre 'COLOR' Style 'A:visited', paramètre 'COLOR' Style 'BODY.Content' ou 'BODY', paramètre 'COLOR' Style 'BODY.Content' ou 'BODY', paramètre 'FONT-FAMILY Le style BODY s applique à toutes les pages HTML sauf si un autre style l emporte sur celui-ci. Le style BODY.Content s applique uniquement à la page de contenu. 168 MEGA Publisher

Fonctions avancées des sites Web Feuilles de style Modifier les paramètres du menu Pour modifier : Paramètre à modifer : Couleur du fond Couleur des liens Couleur de liens visités Couleur du texte Police par défaut Style 'BODY.Menu' paramètre 'BACKGROUND-COLOR' Style 'Menu A' paramètre 'COLOR' Style 'Menu A:visited' paramètre 'COLOR' Style 'BODY.Menu' paramètre 'COLOR' Style 'BODY.Menu' paramètre 'FONT-FAMILY' Exemples de paramétrage des.css Exemple: image (répertoire courant) sans couleur de fond BODY.Menu { MARGIN-TOP: 10px; FONT-SIZE: 10px; BACKGROUND-IMAGE:url(..\standard\HOMEPICTURE.JPG); MARGIN-LEFT: 5px; } Exemple: couleur de fond sans image BODY.Menu { MARGIN-TOP: 10px; FONT-SIZE: 10px; BACKGROUND-IMAGE: none; MARGIN-LEFT: 5px; BACKGROUND-COLOR: #f5f4ee } 169

7 GÉRER LES FICHIERS DU SITE WEB Structure des fichiers et des dossiers générés Le site Web est généré dans un dossier indiqué dans les propriétés de chaque site Web. Pour chaque site, la structure suivante est générée : La structure décrite est celle générée par les sites proposés en standard. Une structure différente peut être obtenue en cas de personnalisations de la génération. Le dossier de l environnement inclut les fichiers d'images telles que les puces, le logo de l'entreprise, qui sont indépendantes du contenu du référentiel, ainsi que la feuille de style du site Web (xxx.css). Le dossier "Images" contient les diagrammes générés à partir du contenu du référentiel. Le dossier "Pages" contient les fichiers HTML qui décrivent, d'une part, les objets du référentiel décrits dans le site, et d'autre part, les fichiers qui permettent de naviguer dans le site. Pour chaque objet, il peut y avoir plusieurs fichiers HTML : par exemple, celui qui dans la fenêtre principale, définit les deux cadres (menu, à gauche, et description de l'objet, à droite), et les deux fichiers qui définissent le contenu des deux cadres. Il peut y avoir, en fonction du type de l'objet, des fichiers supplémentaires : par exemple, un objet décrit par un diagramme donnera lieu à des fichiers HTML supplémentaires, qui permettront d'afficher son dessin, etc. Pour déplacer un site, il suffit de sélectionner son dossier racine, et de le copier à un autre emplacement : les adresses HTML générées sont relatives (par exemple, pour le fond, BACKGROUND="../Standard/Bkground") et restent valides quel que soit l emplacement du site. Configurer les options de l'utilisateur Pour configurer les options de l utilisateur : 1. Depuis l espace de travail, sélectionnez Outils > Options. 2. Dans le dossier Documentation, faites un double-clic sur l'icône "Site Web". 170 MEGA Publisher

Fonctions avancées des sites Web Gérer les fichiers du site Web Vous pouvez : Préciser le Format des images générées (JPEG, Bitmap, PNG, SVG). Modifier l'adresse URL parent par défaut ( http://www.mega.com). Préciser les modèles de pages utilisés pour la page d'accueil et la carte du site. La page d'accueil et la carte du site sont générées à partir de fichiers qui se trouvent dans le dossier "MEGA_Std" du dossier dans lequel MEGA a été installé. Ces fichiers ont l'extension ".mth" : "HomeLeft_fr.mth" pour la page d'accueil, "SiteMap_fr.mth" pour la carte du site avec menu de navigation à gauche. Si vous souhaitez personnaliser ces fichiers, copiezles dans le sous-dossier "Mega_Usr" et reportez-vous au paragraphe "Modifier les fichiers de page d accueil et de carte du site", page 177. Modifier le dossier dans lequel se trouvent les fichiers standards (par exemple, les images correspondant aux divers types d'objets) ainsi que les images et pages générées. Choisir de traiter les références externes comme étant relatives au site Web. MEGA Publisher - Web vous offre la possibilité d' "embarquer" les références externes dans le site MEGA. Pour de plus amples explications, voir "Intégrer les références externes", page 173. Préciser la casse des noms de fichiers générés (première lettre en majuscule ou en minuscule). Choisir de supprimer les pages d une génération antérieure avant toute nouvelle génération. La modification de ces paramètres est valable pour tous les sites Web générés. Contrôler les noms de fichiers Identifiant de l objet Le fichier "Sitedef.ini" situé sous la racine du dossier où le site est généré (Intranet par défaut) référence, pour chaque objet, la correspondance entre son identifiant absolu et le nom du fichier qui décrit la page principale permettant de l afficher. Pour chaque objet du site, un paragraphe de ce type est créé: [245D261330A3002D] PageName = 245D261330A3002D Available = Yes Object = Acteur Direction Commerciale MetaClass = Acteur L identifiant de l objet est présenté entre crochets. (Cet identifiant ne varie jamais après la création de l objet, ce qui permet, lorsqu il est renommé, de conserver ses liens et ses propriétés.) Règles de nommage des fichiers La valeur PageName indique le nom de la page principale. Cette mention permet de savoir que lors d une nouvelle génération du site, pour l objet qui porte cet 171

7 identifiant absolu, les noms des fichiers HTML commenceront par cette chaîne de caractères, suivie d une lettre (suivie de l extension ".htm"), qui sera utilisé, même si le nom de l objet a été modifié. Ceci permet, lorsqu un site fait référence à un autre site, d assurer la pérennité des liens (l adresse indiquée reste constante). page principale de l'objet page de menu de l'objet page de contenu de l'objet page de diagramme associée à l'objet (affichée dans la page de l objet) autre page de diagramme (indépendante de la page de l objet) HexaIdAbs de l'occurence HexaIdAbs de l'occurence suivi de "_M" HexaIdAbs de l'occurence suivi de "_C" HexaIdAbs de l'occurence suivi de l HexaIdAbs du diagramme suivi de "_D" HexaIdAbs de l'occurence suivi de l HexaIdAbs du diagramme Respect de règles de nommage spécifiques Les pages HTML générées sont composées de plusieurs cadres, ou frames, qui sont appelées par la page principale. Un fichier HTM correspond au contenu de chaque cadre. Par exemple, pour l'objet "Acteur Direction Commerciale", les fichiers générés pourront être "245D261330A3002D.htm", qui est le nom de la page principale décrivant l'objet, et qui est fixe, complété, par exemple, par "245D261330A3002D_M.htm", "245D261330A3002D_D", etc. Lorsque des règles spécifiques doivent être respectées pour nommer les pages, il suffit d effectuer une première génération, de modifier les noms de fichiers pour se conformer à ces règles, et de régénérer le site pour que les noms des fichiers générés soient conformes aux règles appliquées. Il suffit, par exemple, de modifier le paragraphe cité précédemment comme ci-dessous, pour que les fichiers HTML portent le préfixe A1_DR. [245D261330A3002D] PageName = A1_DR Available = Yes Object = Acteur Direction Commerciale MetaClass = Acteur La ligne "Available = Yes" indique que l objet est toujours présent dans le site. Si l objet a été inclus lors d une génération antérieure, mais ne fait plus partie du site (par exemple, un processus organisationnel a été délié du projet), cette ligne devient "Available = No". Dans la mesure où le fichier "Sitedef.ini" est destiné à assurer la conservation des noms de fichiers au cours des générations successives, lorsqu'un objet n'est plus référencé dans le site, il est cependant conservé dans le fichier : s'il est à nouveau inclus lors d'une génération ultérieure, les noms de pages resteront identiques. Le type et le nom de l objet sont ensuite indiqués dans la ligne "Object" (dans l exemple, "Object = Acteur Direction Commerciale"). 172 MEGA Publisher

Fonctions avancées des sites Web Gérer les fichiers du site Web Règles de nommage des pages d index Une page d index se compose d une page de menu (_M) et d une page de contenu (_C). Page de menu Règle de nommage Sans règle de nommage (sans SiteDef.ini) Avec règle de nommage spécifique (avec Sitedef.ini) Nom de la page d index NomPageParente_M.htm IdentifiantPage d Index_M.htm Page de contenu Règle de nommage Sans règle de nommage (sans SiteDef.ini) Avec règle de nommage spécifique (avec Sitedef.ini) Nom de la page d index NomPageParente_C.htm IdentifiantPage d Index_C.htm Règles de nommage des images Lorsque plusieurs pages d index sont spécifiées pour un même type d objet (index alphabétique, index par caractéristiques, etc.), les pages d index sont suffixées par un numéro d ordre (par exemple, xxxxx_c_pidx1.htm, xxxx_c_pidx2.htm). Les images sont nommées comme ci-dessous : HexaIdAbs de l objet décrit _HexaIdAbs du diagramme_i.png (ou.bmp,.svg,.jpg selon le format de l image) Intégrer les références externes MEGA Publisher - Web offre la possibilité d intégrer les références externes dans le site MEGA. Pour cela, vous devez au préalable créer des références externes avec dossier prédéfini (voir le guide MEGA Common Features pour de plus amples explications à ce sujet). Mode standard d intégration des références externes Pour intégrer les références externes dans le site MEGA : 1. Assurez-vous que les références externes sont spécifiées à l aide d un dossier prédéfini. 173

7 2. Indiquez que l adresse des référénces externes est relative au site Web. Depuis l espace de travail, sélectionnez Outils > Options, dans le dossier "Documentation", faites un double clic sur l icône Site Web puis cochez la case Référénces externes relatives au site. 3. Générez le site Web. 4. Lancez le fichier "XRefCopy.vbs" dans le dossier "Intranet" pour copier les références externes dans un sous-dossier du site. Par défaut, ce sous-dossier s appelle REFEXT. Vous pouvez le modifier dans la configuration de l utilisateur (dans l espace de travail, cliquez sur Options > Outils puis dans le dossier "Documentation", faites un doubleclic sur l icône Site Web). Les références externes sont désormais accessibles depuis le site Web. Paramétrer la gestion des références externes La génération des chemins des références externes peut être paramétrée si la manière standard décrite ci-dessus ne vous convient pas. Vous pouvez effectuer ce paramétrage à l aide d une macro en la reliant au site Web ou au site Web type par le lien "Gestionnaire des références externes". Dans le menu contextuel d un site Web, cliquez sur Explorer. Dans le dossier vide "Gestionnaire des références externes", cliquez sur Relier. La fenêtre de recherche apparaît. Vous pouvez alors choisir la macro qui vous convient. Contenu de la macro Si aucune macro n est reliée au site Web, la macro "ExternalReferenceManager" fournie par défaut est prise en compte. Cette macro fait le traitement décrit au paragraphe "Mode standard d intégration des références externes", page 173. Vous pouvez créer vos propres macros. La macro doit contenir les méthodes suivantes : Début de la génération Cette méthode signale le début de la génération. Sub StartExternalReference(oWebGenCtx) End Sub 174 MEGA Publisher

Fonctions avancées des sites Web Gérer les fichiers du site Web Méthode appelée pour les références externes Sub ExternalReferencePathGet(oExternalReference, owebgenctx,enfilter, strresultpath) Cette méthode est appelée pour chaque référence externe. Elle récupère le chemin de la référence externe à afficher dans strresultpath et gère la copie. oexternalreference owebgenctx enfilter Objet référence externe Contexte de génération enfilter = 1, chemin relatif enfilter = 0, chemin absolu Fin de la génération Sub StopExternalReference() End Sub 175

7 PERSONNALISER LES NOMS D'OBJETS ET DE LIENS Il est possible de modifier le nom des types d objets et des liens présentés dans le site Web par l intermédiaire d un fichier d initialisation. Pour personnaliser ces noms : 1. Copiez le fichier de personnalisation standard, "CustName.ini", qui se trouve dans le dossier "Mega_Std" du site, et placez la copie dans le dossier "Mega_Usr". 2. Editez le fichier avec un éditeur de texte et modifiez son contenu. Le fichier de personnalisation des noms a la structure suivante : [Class] TypeObjet = Nom dans le site généré Attribut = Nom dans le site généré [Leg] Lien = Nom dans le site généré Par exemple : [Class] Acteur = Intervenant Cardinal= Nombre d éléments [Leg] Acteur.Message-Emis = Les Messages envoyés par les intervenants 176 MEGA Publisher

Fonctions avancées des sites Web Modifier les fichiers de page d accueil et de carte du site MODIFIER LES FICHIERS DE PAGE D ACCUEIL ET DE CARTE DU SITE Vous pouvez définir la mise en forme des pages d accueil et de carte du site par le biais d un formateur ou d un fichier.mth. Fenêtre de propriétés d un site Web Formateur Vous pouvez définir la page d accueil et la carte du site à l aide d une description ou d un script VB. La description doit être de catégorie HTML Web Site Specific Page. Le formateur script doit avoir pour _type Homepage ou SiteMap selon qu il s applique à la page d accueil ou à la carte du site. Voir "A propos du paramétrage des sites Web", page 142. Fichier.mth Il est possible de personnaliser les fichiers.mth (modèles) utilisés pour la génération de la page d accueil et de la carte du site. Ces fichiers se trouvent dans le dossier MEGA_STD. Ils contiennent la structure de base de présentation de la page d accueil et de la carte du site. Il est possible d indiquer le nom des fichiers utilisés dans les options de l environnement et de chaque utilisateur. Pour modifier ces fichiers, il est nécessaire de les recopier dans le dossier "Mega_Usr", comme lors de toute personnalisation des éléments proposés en standard. De même, les nouveaux fichiers de ce type devront être placés dans ce dossier. Pour modifier la mise en forme proposée, il est conseillé de copier les fichiers existants, et de remanier ensuite leur contenu, soit avec un éditeur HTML, soit dans le code HTML. Paramètres utilisés dans les fichiers de génération Ces paramètres correspondent soit aux valeurs indiquées dans la configuration, soit, en particulier pour les adresses de pages, aux valeurs obtenues lors de la génération. 177

7 Les adresses indiquées sont des adresses relatives (..//) et non des adresses absolues (X:Chemin//nomfichier). COMPLETESITEMAP COMPLETEHOMEPAGE CONTENTBULLET1 CONTENTBULLET2 CONTENTLOGO DESCRIBEDOBJECTLIST HIGHTURL HOMEPAGE INDEXPAGELIST INDEXPAGELISTTITLE INDEXTITLELIST MENUBULLET1 MENUBULLET2 MENULOGO OBJECTPAGELIST SITECOMMENT SITEMAP SITENAME STYLESHEET Nom de la carte du site pointant vers l adresse de la carte du site Nom de la page d accueil pointant vers l Adresse de la page d accueil Puce des listes de niveau 1 du cadre du contenu Puce des listes de niveau 2 du cadre du contenu Image utilisée comme logo du cadre du contenu Affiche la liste des objets décrits : objets que l on retrouve dans l onglet Objet URL parent du site Adresse de la page d'accueil Liste des pages d'index Affiche les pages d index ( + liens vers les pages) et le nom des métaclasses associées Affiche les pages d index ( + liens vers les pages) Puce des listes de niveau 1 du cadre du menu Puce des listes de niveau 2 du cadre du menu Image utilisée comme logo du cadre du menu Affiche la liste de tous les objets qui donnent lieu à une page Texte de commentaire du site Adresse de la page contenant la carte du site Nom du site Feuille de style utilisée dans les pages du site PAGES Exemple de syntaxe : [MEGA param=pages object=7fce816c457d008a] -> Récupère l url de la page de l objet 7fce816c457d008a STANDARD IMAGE [MEGA param=standard file=myfile.png] -> Récupère l url du fichier MyFile.png qui se trouve dans le répertoire standard [MEGA param=image file=myfile.png] - > Récupère l url du fichier MyFile.png qui se trouve dans le répertoire image 178 MEGA Publisher

Fonctions avancées des sites Web Contrôler la génération du site Web CONTRÔLER LA GÉNÉRATION DU SITE WEB Compte rendu de génération Si la génération s est effectuée correctement, un fichier.wri est disponible dans le sous-dossier correspondant à l utilisateur dans "\SysDb\USER". Ce fichier de compte-rendu contient : Des informations relatives à la génération Site Web généré Définition de la liste des objets donnant lieu à une page Des informations sur la génération de chaque page Page d accueil Carte du site Pages d objets sous la forme Page generated =, MetaClass =, Object =, Date = Si la génération ne s est pas correctement effectuée, le compte rendu est stocké dans un fichier temporaire commençant par CRD dans le dossier temporaire du poste de travail. Vous y trouverez des informations concernant l objet incriminé. Contrôler la validité du site Web Vous pouvez contrôler la validité de votre site Web : Avant de procéder à sa génération. Après une migation ou l import de données relatives au site Web. Pour cela : Dans le menu contextuel du site Web, cliquez sur Contrôler > Règlement avec propagation. 179

7 Les contrôles suivants sont effectués : Existence des modèles de page.mth Paramétrage des pages Présence d au moins un objet dans l onglet Objets du site Web Paramétrage des scripts post-génération Le résulat du contrôle s affiche : Pour plus de détails sur les règlements par propagation, voir le guide MEGA Common Features, "Générer le documentation", "Contrôle ponctuel d un règlement". 180 MEGA Publisher

8 UTILISER LES DESCRIPTIONS HTML MEGA vous permet de créer des descriptions HTML que vous utiliserez à la place des mises en forme proposées en standard. Les points suivants sont abordés ici : "Présentation des descriptions HTML", page 182 "Syntaxe des sources HTML", page 188 "Balises spécifiques aux descriptions HTML", page 189 "Utiliser les variables", page 200 "Conditionner l'édition des balises HTML", page 203 "Mettre en forme le texte HTML source", page 205 "Constituer un buffer", page 207 "Utilisations spécifiques des descriptions HTML", page 206 "Descriptions HTML pour les sites Web dynamiques", page 211 Les descriptions HTML ne peuvent pas être éditées lorsque la langue courante est le japonais. Pour utiliser les descriptions HTML lorsque vous travaillez avec une version japonaise de MEGA, vous devez au préalable changer de langue courante (Outils>Langues). Une fois dans une langue courante occidentale, vous pouvez éditer les textes des descriptions HTML. Vous ne devez cependant pas saisir de texte en caractères japonais car ceux-ci ne sont pas supportés par l éditeur HTML. Vous pouvez saisir des caractères d échappement pour remplacer les caractères japonais ou chercher le commentaire d un objet MEGA comme c est le cas dans les descriptions de contrôle HTML. 181

8 PRÉSENTATION DES DESCRIPTIONS HTML Accéder aux descriptions HTML Les descriptions ne sont pas affichées par défaut et requièrent un accès au métamodèle en mode "Avancé". Pour afficher le métamodèle en mode "Avancé" : 1. Dans l espace de travail, cliquez sur le menu Outils > Options. 2. Dans la fenêtre qui apparaît, cliquez sur Référentiel. 3. Dans l option Accès au métamodèle, sélectionnez le mode "Avancé". Pour accéder aux descriptions HTML : 1. Dans l espace de travail, sélectionnez la fenêtre Utilitaires. La fenêtre Utilitaires est accessible par la commande Affichage > Fenêtres de navigation > Utilitaires. 2. Dépliez le dossier "Description" puis le sous-dossier "HTML". Vous pouvez accéder aux descriptions des pages d objets ou à celles des pages spécifiques (index, pages d accueil, carte du site). 3. Pour accéder aux descriptions des pages d objets, dépliez le sous-dossier "HTML Object Page". 4. Sélectionnez HTML <Body> ou HTML <HEAD> selon le type de description que vous voulez créer (corps ou en-tête). Vous pouvez par exemple créer votre description dans le sous-dossier "HTML Personnel". Le corps (BODY) constitue le contenu visuel de la page HTML. L entête (HEAD) contient le titre de la page, des informations META qui définissent des mots-clés pouvant être utilisés par les moteurs de recherche, la feuille de style etc. Pour de plus amples explications sur HTML <Body> et HTML <HEAD>, voir "Mise en forme des pages", page 123. 182 MEGA Publisher

Utiliser les descriptions HTML Présentation des descriptions HTML Présentation de l éditeur de descriptions HTML Dans le cas des descriptions HTML, l éditeur de descriptions fonctionne de manière similaire à celle décrite dans les chapitres concernant l édition RTF (voir "Personnaliser les descriptions rtf", page 53). Des différences importantes doivent être cependant notées : Les textes, intitulés "Source HTML" sont édités dans un éditeur spécifique, similaire à Wordpad. Les codes correspondant aux informations du référentiel sont différents de ceux utilisés dans les descriptions RTF. Exemple de description HTML Les mises en forme sont effectuées avec des balises HTML ou les styles des feuilles "CSS". MEGA fournit par défaut un ensemble de feuilles de styles. Vous pouvez appliquer un style au contenu de la description en sélectionnant le contenu en question et en sélectionnant la feuille de style dans le champ situé en haut de la fenêtre d édition. De même que pour les descriptions RTF, les éléments provenant du référentiel sont insérés dans le texte par sélection dans la partie Champs, puis par glisser-déplacer dans le texte. 183

8 Il est possible d inclure dans le contenu de la description des balises HTML standard (par exemple <BR> pour ajouter un saut de ligne), du texte, ainsi que de compléter les éléments, en utilisant une syntaxe appropriée. Pour la description de la syntaxe, voir : "Syntaxe des sources HTML", page 188 "Balises spécifiques aux descriptions HTML", page 189. Icône spécifique à l éditeur de description HTML L icône permet de se déplacer vers une ligne donnée. Structure des descriptions HTML Utiliser plusieurs groupes et textes Utiliser un seul texte Les descriptions HTML peuvent être structurées de la même façon que les descriptions RTF. Une arborescence à plusieurs niveaux est utilisée pour éditer les composants de l objet principal de la description. La description peut être complétée par des textes placés avant et après les textes décrivant les objets. Il est possible de conditionner l édition de ces textes par l existence et le nombre d objets édités. L arborescence à plusieurs niveaux fonctionne dans de nombreux cas. Mais il est parfois souhaitable de structurer plus simplement les descriptions HTML, car elles sont incluses dans un ensemble de pages standard et de descriptions qui constituent le site. Pour cela, utiliser un seul texte, qui inclut les références aux composants de l objet, ainsi que les conditions d édition, facilite la maintenance de ces descriptions et la traçabilité des résultats. Visualiser le résultat de l exécution des descriptions HTML Exécuter la description de manière autonome Il est possible d exécuter une description de façon autonome pour contrôler sa validité et avoir un aperçu du résultat. Mais il ne s agit que d un moyen rapide de visualisation car les hyperliens ne sont pas visibles et aucune feuille de style n est associée. Pour exécuter la description : Dans l éditeur de descriptions, sélectionnez MEGA > Exécuter ou cliquez sur le bouton 184 MEGA Publisher

Utiliser les descriptions HTML Présentation des descriptions HTML Intégrer la description HTML dans un site Web Pour voir le résultat qui sera obtenu par les utilisateurs lors de la génération d un site, il est nécessaire de l inclure dans un site de test : en effet, la génération autonome d une description ne permet pas, par exemple, de tester les hyperliens générés, puisque seule la page correspondant à la description a été créée. Vous pouvez accéder à la description HTML sur une page d objet correspondant au point d entrée défini dans votre description. Elle sera utilisée à la place d un formateur standard. Editer les descriptions HTML à partir du site Web Lorsqu'une description HTML est utilisée dans un site Web ou un site Web type, le menu contextuel de celle-ci permet, à partir de l'onglet "Pages" du site ou du site type, de la consulter avec l'éditeur de descriptions. 185

8 Editer l en-tête et le corps de la description HTML Les commandes Editer l en-tête et/ou Editer le corps apparaissent selon que la page est basée sur une description HTML <BODY> et/ou <HEAD>. Page de processus organisationnel avec description HTML <BODY> et mise en forme <HEAD> standard Page de processus organisationnel avec descriptions HTML <BODY> et <HEAD> Page de processus organisationnel avec description HTML <HEAD> et mise en forme <BODY> standard Les options générales du site Web accessibles par l onglet Caractéristiques de la fenêtre de propriétés du site Web (voir "Paramétrer la mise en page", page 146) ne sont pas applicables aux pages mises en forme à l aide des descriptions HTML. Définir une description avec génération complète de la page Vous pouvez définir une description HTML permettant de générer la page complète, c est-à-dire comprenant : l'en-tête, délimité par les balises <HEAD> et </HEAD>. le corps, délimité par les balises <BODY> et </BODY>. Les balises d ouverture et de fermeture <HTML> </HTML> ne sont toutefois pas générées. 186 MEGA Publisher

Utiliser les descriptions HTML Présentation des descriptions HTML Pour que la description HTML prenne en charge la page complète : 1. Dans la fenêtre de propriétés d une description HTML, sélectionnez l onglet HTML. 2. Dans le champ Format de la génération de la page, sélectionnez la valeur "la page complète". Par défaut, seul le corps de la page est généré (valeur "uniquement le corps de la page"). 187

8 SYNTAXE DES SOURCES HTML Les éléments provenant du référentiel sont insérés, dans les textes de type "Source HTML", sous forme de balises placées entre deux crochets ("[ ]"). Deux formes sont possibles : une forme réduite une forme étendue Forme réduite Forme étendue Remarques La forme réduite est obtenue par glisser-déplacer dans l'éditeur de descriptions, du type [P="Propriété"/] En une seule opération, la balise est ouverte puis fermée. Il n est pas toujours possible de faire un glisser-déplacer. Certaines balises (CL) doivent être saisies à la main en modifiant par exemple une balise existante. La forme étendue est du type [P="Propriété"]texte [Value/][/P] Elle permet, entre autres, de conditionner l insertion du texte libre saisi entre les deux balises de début et de fin. Comme dans XML, l emplacement du caractère " / " est à la fin dans la forme réduite. Dans la forme étendue, où les balises sont appariées, ce caractère est placé au début de la balise finale. Les double apostrophes ("Propriété") sont facultatives lorsque la chaîne de caractères qu elles entourent ne contient pas de blancs. A la fermeture d un texte, lorsqu une erreur s est glissée dans votre code, un message vous en avertit. 188 MEGA Publisher

Utiliser les descriptions HTML Balises spécifiques aux descriptions HTML BALISES SPÉCIFIQUES AUX DESCRIPTIONS HTML Des balises permettent d obtenir, lors de l exécution de la description, des éléments provenant du référentiel. Il en existe plusieurs types. Elles permettent d accéder : aux propriétés de l objet aux constituants de l objet (c'est-à-dire les objets qu'il est possible d'atteindre par un lien ou une requête) aux propriétés des constituants au cardinal des constituants (nombre de constituants) Pour chaque balise, des paramètres supplémentaires permettent de sélectionner le type d information ou de propriété affichée. Vous pouvez également consulter "Descriptions de génération de code", page 25, pour plus de détails sur les balises. Vous pouvez également consulter le chapitre "Descripteurs de génération de code" du guide MEGA Exchange - Generation pour plus de détails sur les balises. Forme abrégée des balises "Balise Propriété (P)", page 190 "Balise Constituant (C)", page 192 "Propriétés du constituant (CP)", page 194 "Nombre de constituants (CL et CLP)", page 194 "Balise Dessin (Draw)", page 195 "Constituants imbriqués", page 196 "Balise WebObjectCollection (WOC)", page 196 "Balise Workflow (WF)", page 197 "Balise Context", page 198 "Balise ObjectPicture", page 199 "Balise Variable (V)", page 200 Lorsque vous construisez votre description, vous pouvez utiliser la notation abrégée. Lorsque vous enregistrez la description, les balises sont automatiquement converties au format long. 189

8 Balise Propriété (P) La balise [Propriété] permet d éditer les caractéristiques de l objet (notamment les informations présentes dans l onglet Caractéristiques de la fenêtre de propriétés de l objet). Elle peut être insérée dans un texte de description sous deux formes : [P= "Propriété"/] Cette forme est obtenue par glisser-déplacer d une caractéristique vers le corps du texte. [P="Propriété"]texte [Value/][/P] Cette forme permet de conditionner l apparition d un texte en fonction de l existence d une propriété. Il faut noter que le nom de l objet est considéré comme une caractéristique ([P="Nom"/]). [Value/], entre les balises P - /P, indique l emplacement où la valeur de la propriété sera insérée lors de la création des pages HTML. Exemple : Appliqué à l acteur "Entreprise", [Property=Nom/] retourne la valeur "Entreprise" dans la page HTML générée. La balise [Propriété] peut être complétée par les attributs ci-dessous. Ces attributs sont aussi valables pour la balise "Propriétés du constituant (CP)", page 194. Pour conditionner l édition des propriétés, voir "Conditionner l'édition des balises HTML", page 203. Layout (LY) Lorsque plusieurs présentations sont possibles pour une caractéristique, cet attribut permet de préciser la présentation retenue. Cet attribut est utilisé pour les commentaires (textes) et les caractéristiques qui ont des valeurs tabulées. Commentaire [P="Commentaire" LY="TITLE"/] [P="Commentaire" LY="COMPLETE"/] Premier paragraphe de commentaire Commentaire complet Par défaut, c est le commentaire complet qui est ramené. [P="Commentaire" LY="Complete"/] équivaut à [P="Commentaire"/] Valeurs contenues dans une table Dans l exemple, Type-xx [P="Type-xx" LY="External"/] [P="Type-xx" LY="Internal"/] Valeur externe de la valeur Valeur interne de la valeur Par défaut, c est la valeur externe qui est ramenée. 190 MEGA Publisher

Utiliser les descriptions HTML Balises spécifiques aux descriptions HTML Bookmark (BMK) Cet attribut permet de créer une adresse (ou signet) dans la page. L objectif est de pouvoir l appeler par l intermédiaire de l attribut Link="In", dans un diagramme comportant des zones sensibles par exemple. [P="Nom" BMK="1"/] Adresse (<A NAME="xxx"> ) dans la page. Link (LNK) Cet attribut permet de créer un lien : soit vers la page de l objet soit dans la même page à l aide de l attribut Bookmark (voir plus haut) [P="Nom" LNK="Out"/] [P="Nom" LNK="In"/] Lien vers la page de l objet si elle existe. Lien vers une adresse définie dans la page avec la balise BMK Le lien est créé uniquement si une page ou une adresse est définie pour l objet. Sinon, la balise est ignorée. C est pourquoi, lorsque la description est générée de façon isolée, les liens vers d autres pages n apparaissent pas dans le résultat. Menu (MNU) Cet attribut indique que le nom de l objet doit être référencé dans le cadre de menu, avec un lien vers son adresse. [P="Nom" MNU="n"/] Lien vers une autre page, n représentant le niveau du lien dans la partie menu, de 1 à 9 Target Cet attribut permet de définir la fenêtre cible dans laquelle s ouvre la page référencée. Valeur La cible s affiche... _top _parent _self _blank Dans le cadre principal Dans le cadre parent Dans le cadre courant (celui dans lequel vous avez cliqué) Dans une nouvelle fenêtre Vous pouvez spécifier une autre valeur. Par exemple, si vous spécifiez la valeur "MonCadre", la page s ouvrira dans le cadre appelé "MonCadre". 191

8 Exemples contenant l attribut Target [Component="Opération"] [ComponentProperty=Nom Target="_blank" Link=Out/]<br> [/Component] Pour chaque opération du processus organisationnel, si vous cliquez sur son nom, la page concernant l opération s ouvrira dans une nouvelle fenêtre. PictureFormat L attribut PictureFormat permet de récupérer l'adresse de l'image de la valeur de l attribut. L attribut peut prendre les valeurs : GIF, BMP ou ICO. Exemple sur un risque : <img src="[property="risque absolu" PictureFormat="GIF"/]"/ > [Property="Risque absolu"/] Affiche l'image de la valeur de l attribut : risque absolu et la valeur de risque absolu Si l'image n'existe pas, par exemple sur l'attribut nom : on renvoie l'adresse d'une image transparente : empty.gif Cet attribut est valable également avec la balise Propriétés du Constituant [CP]. Balise Constituant (C) La balise Constituant est insérée sous la forme : [C= "Lien"/] ou [C="Lien"]texte[/ C]. "Lien" représente le lien parcouru (par exemple, "Composant") pour atteindre les constituants, c est-à-dire les objets reliés à l objet principal. Il est également possible d utiliser ces balises pour les requêtes. Avec [C="Lien"]texte[/C], le texte est inséré pour chaque objet atteint par le lien. Ceci permet, par exemple, d insérer une image spécifique avant chaque entrée d une liste (exemple [C="Composant"]<IMG SRC="CMP.JPG">[/C]. En revanche, il est conseillé d utiliser soit les textes "Avant", soit des textes conditionnés (voir ciaprès) pour définir un titre précédant une liste d objets. Cette balise est le plus souvent insérée avec la balise Propriétés du constituant [CP], qui permet d éditer les propriétés du constituant, en particulier son nom. [C="Lien"/] [C="Requête"/] Propriétés des objets atteints par le lien Propriétés des objets sélectionnés Syntaxe utilisée : [C=lien" ou "requête"][cp=nom Link=Out/][/C] L usage de l attribut LINK est facultatif si on ne veut pas rendre les objets sensibles. 192 MEGA Publisher

Utiliser les descriptions HTML Balises spécifiques aux descriptions HTML Saisir la requête dans la balise Il est possible de saisir le code de la requête directement dans la balise [C] à la place du nom de la requête. Ceci peut s avérer pratique si la requête n est utilisée qu à cet endroit. Exemple [C="SELECT Opération WHERE [Type Opération] = Contrôle and Acteur=&name"][CP=Nom/]<br>[/C] Ceci renvoie la liste des opérations de type "Contrôle" effectuées par l acteur sur lequel vous êtes positionné. Dans ce cas, le nom de la variable utilisée doit nécessairement être "name". Lorsque votre requête comporte des guillemets, vous devez les remplacer par des guillemets simples à l intérieur d une balise ( Contrôle et non pas "Contrôle"). Une requête est enregistrée via son identifiant absolu. En cas de modification du nom de la requête, vous n avez pas à modifier vos descriptions. Trier une liste fonction d un attribut La balise [Component] permet d'afficher une liste d'objets soit dans l'ordre alphabétique, soit dans l'ordre du lien si on passe par une patte. Or, il arrive que l'on ait besoin de trier les objets en fonction d'un attribut. Pour Cela, vous pouvez utliser l'attribut "Sorter" en précisant si le tri doit être ascendant ("A") ou descendant ("D"). [C="lien ou requête" Sorter="Attribut:A"] Exemple : trier les processus organisationnels d'un projet en fonction de leur code [C="Processus organisationnel" Sorter="Code Processus organisationnel:a"] [CP=nom link=out/]<br>[/c] ("A") employé seul trie par défaut par valeur interne. La valeur interne est immuable tandis que la valeur externe est la valeur affichée traduite dans les différentes langues. Pour trier par valeur externe, vous devez ajouter ":E". Exemple : trier les diagrammes en fonction de leur nature externe [Component= "Select Diagramme" Sorter="nature :A :E"] [/Component] 193

8 Afficher les objets qui donnent lieu à des pages L attribut "WithPages" permet, quand on parcourt une liste d objets associés à un objet courant, de retourner uniquement les objets qui donnent lieu à une page. WithPages = "Yes" La collection d objets contient uniquement les objets qui donnent lieu à une page. WithPages = "No" La distinction n est pas faite entre les objets donnant lieu et ne donnant pas lieu à une page. Tous les objets sont retournés. Propriétés du constituant (CP) La balise Propriétés du constituant [CP], permet d éditer les propriétés des constituants de l objet relié à l objet principal, avec le lien déterminé par la balise Constituant [C]. Elle permet également, d éditer les propriétés du lien. Cette balise doit être placée entre les balises [C="Lien"] de début d analyse des constituants, et la balise [/C] de fin (de même que pour la balise Constituant, il est possible d utiliser une requête). Exemple : [C="Lien ou requête"][cp="nom" LNK="Out"][/C] Lien vers une autre page Pour connaître les attributs disponibles avec la balise CP, voir "Balise Propriété (P)", page 190. Nombre de constituants (CL et CLP) Deux balises permettent de traiter le nombre de constituants trouvés par le parcours d un lien ou avec une requête, [CL] et [CLP]. Dans la mesure où le traitement des balises [CL] et [CLP] est plus rapide que la consultation des constituants par la balise [C], il peut être avantageux d utiliser ces balises pour, par exemple, ajouter un texte conditionné par le nombre d éléments trouvés. La balise [CL] permet d effectuer un test sur le nombre de constituants (voir "Conditionner l'édition des balises HTML", page 203). La balise [CL] ne peut être obtenue par glisser-déplacer. Vous devez la saisir à la main, en modifiant par exemple une balise [C]. 194 MEGA Publisher

Utiliser les descriptions HTML Balises spécifiques aux descriptions HTML Exemple : [CL="Message" if="cardinal >1"]Messages : [/CL] Le texte "Messages :" est édité lorsqu'il y a plus d'un message. La balise [CLP] permet d obtenir des informations sur le nombre de constituants. Il est possible d effectuer des calculs sur le résultat obtenu avec cette balise. [C="Lien ou requête"] texte [CLP="ordinal"/][/C] Rang de l'objet atteint Exemple : [CLP="Cardinal-Ordinal+1"] Les objets sont présentés en commençant par le dernier, avec l'indication de leur rang (" Le numéro 3, le numéro 2, le numéro 1 ") Balise Dessin (Draw) La balise dessin [DRAW] permet d insérer un diagramme (logigramme, etc.). Pour l utiliser, vous devez être positionné sur "Diagramme" soit via un groupe dans la description soit via une balise [C]. [DRAW/] Affichage du diagramme décrivant l'objet Cette balise peut être complétée avec les attributs Link, Target et SvgBubble. Link Cet attribut crée un lien vers les objets inclus dans le dessin. Une carte (map) hypergraphique est associée au dessin. [DRAW Link="Out"/] [DRAW Link="In"/] [DRAW Link="InOut"/] Si une page décrivant l objet présent dans le diagramme existe, un lien est créé vers cette page. Si une référence pour l objet existe dans la page (utilisation de l attribut BMK), le lien est créé vers cette référence. Si une page décrivant l objet présent dans le diagramme existe, un lien est créé vers cette page. Sinon, si une référence pour l objet existe dans la page, le lien est créé vers cette référence. 195

8 Dans les constituants de l objet, la propriété "Dessin" de l élément "Description" permet d insérer rapidement cette balise, avec ses paramètres, par glisserdéplacer. SvgBubble L attribut SvgBubble est utilisé lorsque les images sont générées au format SVG. Il permet de paramétrer le commentaire apparaissant dans les info-bulles. Il existe trois valeurs par défaut pour cet attribut : "Complete" : afficher le commentaire complet, "Title" : afficher le commentaire titre, c-à-d la première ligne du commentaire, "None" : n afficher aucun commentaire. Constituants imbriqués Lors du traitement de plusieurs niveaux de constituants imbriqués, il peut être utile d'identifier explicitement chacun des constituants pour pouvoir accéder à ses caractéristiques. A cet effet, l'attribut Id permet de donner un identifiant à un constituant. Par la suite, les caractéristiques de ce constituant seront accessibles en précisant son identifiant à l'aide de l'attribut ParentId. Lorsque parentid=root, c est la racine qui est référencée. Exemple dans un texte qui porte sur "Processus Organisationnel" : [C=Acteur id=xxxx] [CL="Opération" If="cardinal=0"] L acteur [CP=Nom parentid=xxxx/] n effectue aucune opération.<br> [/CL] [/C] Balise WebObjectCollection (WOC) La balise WebObjectCollection (WOC) est disponible sur les descriptions ayant pour point d entrée un site Web. Elle permet de récupérer la liste des objets qui donnent lieu à une page dans le site Web. 196 MEGA Publisher

Utiliser les descriptions HTML Balises spécifiques aux descriptions HTML Pour définir la balise, vous pouvez : ne rien préciser : la balise renvoie tous les objets du site Web. indiquer une MetaClasse (par exemple, Procedure) : la balise renvoie tous les objets de la Metaclasse utiliser une requête (par exemple, qui liste tous les processus organisationnels dont le nom commence par "a"). Exemple dans un texte qui porte sur les acteurs : [WebObjectCollection="Select Acteur"] WebObjectCollectionProperty=Name Link="Out"/] [/WebObjectCollection] Vous avez la possibilité de trier les objets par ordre alphabétique à l aide de l attribut "Sorter", en précisant si le tri doit être ascendant ("A") ou descendant ("D") : [WebObjectCollection="Procedure" Sorter = "Name:A"] Balise Workflow (WF) Dans MEGA, il existe l option "Adresse de notification du workflow". Elle est disponible dans la fenêtre des options de l utilisateur, sous le dossier Documentation > Sites Web. La valeur a pour variables : %UserEmail% : adresse e-mail du dernier modificateur de l objet %ObjectName% : nom de l objet %ObjectId% : HexaIdAbs de l objet %UserName% : nom du dernier modificateur de l objet %UserId% : HexaIdAbs du dernier modificateur de l'objet La balise Workflow (WF) génère un hyperlien qui pointe vers la valeur de l'option "Adresse de notification du workflow" et qui a pour nom la valeur du _CodeTemplate "Workflow". Cet hyperlien, lorsque vous cliquez dessus, ouvre un message à l adresse e-mail du dernier utilisateur, contenant le nom et HexaIdAbs de l objet modifié, ainsi que le nom du dernier utilisateur. Le but est de notifier au dernier utilisateur de l objet un problème ou une demande de modification sur l objet en question. Par défaut, le lien a pour nom "Modifier", valeur qui correspond à la valeur du _CodeTemplate "Workflow". Vous pouvez changer le nom de l hyperlien à l aide de l attribut "Name" : [Workflow Name="Mon lien"/] -> génère un hyperlien qui pointe vers la valeur de l'option "Adresse de notification du workflow" et qui a pour nom "Mon lien". 197

8 Avec l attribut "Link", vous pouvez modifier la valeur de "Adresse de notification du workflow" et faire en sorte que le lien renvoie par exemple sur une page Web contenant un formulaire prérempli avec les valeurs que vous indiquez dans le lien. [Workflow Link="http://www.monsiteweb.fr..."/] -> génère un hyperlien qui pointe vers "http:// www.monsiteweb.fr..." et qui a pour nom la valeur du _CodeTemplate : Workflow Vous pouvez d'ailleurs utiliser dans l'attribut link les mêmes variables que dans l'option : %UserEmail, %ObjectName%... http://monsiteweb.fr/ formulaire?email=%useremail%&object=%objectname%&id=%object Id% La valeur définie sur l attribut "Link" surcharge la valeur de l option [Workflow Name="Mon lien" Link="http:// www.monsiteweb.fr..."/] -> génère un hyperlien qui pointe vers "http:// www.monsiteweb.fr..." et qui a pour nom "Mon lien" Balise Context [Context=WebSiteHexaIdAbs/] La balise Context n est utilisée que dans le cas de l exécution d une description dans un site Web. [Context=WebSiteHexaIdAbs/] renvoie l'hexaidabs du site web qui exécute la description. [Context=GlobalWebSiteDescriptor/] Soit une description "MaDescription" ayant comme point d entrée un site Web. Reliez cette description au site Web via le lien "Description globale au site web". La balise [Context=GlobalWebSiteDescriptor/] exécute la description ci-dessus et insère le résultat dans la description qui l'appelle. Dans ce cas, les textes "Introduction" et "Conclusion" de la description ne sont pas exécutés. 198 MEGA Publisher

Utiliser les descriptions HTML Balises spécifiques aux descriptions HTML Balise ObjectPicture La balise ObjectPicture retourne l icône de la MétaClasse de l objet. Vous pouvez insérer ce tag en glissant l'image de l'objet dans la description. A l'exécution, cette balise permet de copier le fichier de l'image et renvoie l'adresse du fichier copié. Si vous voulez voir apparaître l'image dans la page générée, vous devez ajouter la balise IMG : <IMG SRC="[ObjectPicture/]"/> Cette balise peut contenir l attribut optionnel PictureFormat qui permet de choisir le format de l'image entre : "GIF" (par défaut), "BMP" et "ICO". Exemple : [ObjectPicture PictureFormat="ICO"/] Dans les API VB, la fonction GetObjectPicture permet de faire la même chose. Elle prend en paramètre le contexte de génération Web. Vous pouvez ajouter un paramètre optionel indiquant le format de l'image : "GIF", "BMP", "ICO". Exemple : stringpicturefilename = oobject.getobjectpicture(owebcontext) -> renvoie l'adresse du fichier au format gif stringpicturefilename = oobject.getobjectpicture(owebcontext, "BMP") -> renvoie l'adresse du fichier au format bmp 199

8 UTILISER LES VARIABLES De même que dans les descriptions RTF, les variables permettent d insérer des informations qui proviennent du référentiel (par exemple Nom de la base), et de la configuration de chaque utilisateur (par exemple Auteur). Ces variables sont insérées entre les balises [V] et [/V]. Exemple [V="Time"/] Insertion de l'heure Pour plus d informations sur la création et la modification des variables, voir "Utiliser les variables dans les en-têtes et pieds de pages", page 92. Paramétrer la barre de menus La variable "Menu" permet de créer, dans le cadre de menu, un texte reprenant le texte indiqué avec cette variable, avec un hyperlien vers son emplacement dans la page. [V=MNU]texte[/V] Insère "Texte" dans la partie principale ainsi que dans la barre de menu. Un lien est créé entre les deux textes. Modifier le style du titre Il est possible d utiliser l attribut HEAD pour modifier le style de titre (de H1 à H6). [V=MENU Head=3]Texte[/V] Insère "texte" avec le style H3 avec un décalage dans la barre de menu Insérer une puce devant un titre [V=MNU Bullet="Toto.gif"]Texte[/V] Insère la puce "Toto.gif" présente dans le dossier "MEGA_USR" ou "Mega_Std", puis "Texte" dans le style H1 Insérer du code HTML Vous pouvez insérer du code HTML dans la barre de menu pour rendre celle-ci plus attrayante, sans faire apparaître ce code dans le cadre principal. Vous pouvez, par 200 MEGA Publisher

Utiliser les descriptions HTML Utiliser les variables exemple, donner la possibilité aux utilisateurs d envoyer un e-mail à l administrateur du site Web. Pour cela vous devez utiliser le paramètre "VISIBLE", qui permet d indiquer : si le contenu de la balise doit être visible dans la barre de menu et dans le cadre principal ou si ce texte n est que du code HTML permettant la mise en forme de la barre de menu, sans renvoi dans le cadre principal [V=MNU Visible=YES] Texte [/V] Insère "Texte" dans la partie principale et dans la barre de menu. Un lien est créé entre les deux. [V=MNU Visible=No] Code HTML [/V] Insère le code HTML dans la barre de menu, sans renvoi dans le cadre principal. Exemple [V=MNU Visible=No] <a href="mailto:xxx@mega.com">ecrire à xxx</a> [/V] Récupérer la souche d un _Code Template Un _Code Template contient du code réutilisable. La variable "CodeTemplate" permet de récupérer la souche ou la souche traduisible du _Code Template, grâce à l'attribut Template qui peut prendre les valeurs "Code" ou "Translatable". [Variable=CodeTemplate Id="HexaIdAbs" Template="Translatable"/] renvoie la souche traduisible [Variable=CodeTemplate Id="HexaIdAbs" Template="Code"/] -> renvoie la souche [Variable=CodeTemplate Id="HexaIdAbs"/] renvoie la souche si elle n est pas vide, sinon renvoie la souche traduisible. La variable Id est égale à l'hexaidabs d'un _CodeTemplate. Accéder aux pages d objets, d accueil et de carte du site Vous pouvez accéder aux pages d objets, d accueil et de carte du site en utilisant respectivement les variables "ObjectPage", "HomePage" et "SiteMapPage". [Variable=ObjectPage File=293829654227017D/] : récupère la page de l'objet qui a pour hexaidabs "293829654227017D". [Variable=HomePage/] : récupère la page d'accueil [Variable=SiteMapPage/] : récupère la page de la carte du site 201

8 Exemples Lien vers un processus : <a href='[variable=objectpage File=293829654227017D/ ]'>Achat de biens et service</a><br/> Lien vers la page d'accueil : <a href='[variable=homepage/]'>home</a><br/> Lien vers la carte du site : <a href='[variable=sitemappage/]'>site Map</a><br/> Vérifier la disponibilité d un objet La balise [Variable=IsAvailable Id=XXX] permet de savoir si l'objet qui a pour hexaidabs XXX est disponible ou pas. Exemple 1 : [Variable=IsAvailable Id=4EA5565E466900BF If="Value='true'"]L'objet qui a pour hexaidabs "4EA5565E466900BF" existe<br>[/variable] [Variable=IsAvailable Id=4EA5565E466900BF If="Value='false'"]L'objet qui a pour hexaidabs "4EA5565E466900BF" n'existe pas ou n'est pas disponible[/ Variable] Ex 2 : Liste des métaclasses disponibles [Component="select metaclass" Sorter="name:A"] [Buffer=metahexid] [Buffer=metahexid Set][ComponentProperty="_HexaIdAbs"/][/ Buffer] [Variable=IsAvailable Id=Buffer(metahexid) If="Value='true'"] [ComponentProperty=Name/]<br/> [/Variable] [/Buffer] [/Component] 202 MEGA Publisher

Utiliser les descriptions HTML Conditionner l'édition des balises HTML CONDITIONNER L'ÉDITION DES BALISES HTML Il est possible d indiquer, dans les balises d édition, des conditions d exécution : lorsque la condition est remplie, les balises sont résolues et apparaissent dans le résultat final, sinon elles sont ignorées. [C="Opération" if="last"]</table><br>[/c] Cette condition permet de fermer un tableau après la dernière opération trouvée. Les conditions sont introduites dans la balise, par "if=". Elles sont placées entre deux double-apostrophes ("). Les comparaisons sont effectuées avec les opérateurs "=", "<>", "<", ">". L opérateur de négation "!" peut être placé avant ces opérateurs. Les éléments qu il est possible de tester sont : First Last Ordinal Cardinal Empty Value Internal value Premier élément d'un ensemble. Peut être utilisé avec la balise [C]. Dernier élément d'un ensemble. Peut être utilisé avec la balise [C]. Emplacement de l'élément dans un ensemble. Peut être utilisé avec la balise [C]. Nombre d'éléments d'un ensemble. Peut être utilisé avec les balises [C] et [CLP]. Indique que la caractéristique n'est pas renseignée. Peut être utilisé avec les balises [CL], [P] et [CP]. Permet de tester la valeur d une caractéristique. Peut être utilisé avec les balises [P] et [CP]. Permet de tester la valeur interne d'une caractéristique tabulée. Peut être utilisé avec les balises [P] et [CP]. Exemple d'utilisation [CL="acteur"] [If="empty"]Pas d'acteur[/if] [If="Cardinal=1"]Acteur : [/If] [If="Cardinal>1"]Acteurs : <br>[/if] [/CL] [C=Acteur] [CP=nom/]<br> [/C] Avec ces conditions, "Acteur :" suivi du nom de l acteur apparaît sur une ligne lorsqu il n y a qu un acteur. Lorsqu il y a plusieurs acteurs, le texte est "Acteurs :", 203

8 suivi d un saut de ligne, et des noms des acteurs. Lorsqu il n y a pas d acteur, c est le texte "Pas d acteur" qui apparaît. Autre exemple [CL="Projet" if="cardinal>0"]<h2>les projets du processus organisationnel :</H2>[/CL] Le texte "Les projets du processus organisationnel" apparaîtra s il existe au moins un projet rattaché au processus organisationnel. Utiliser la balise [If] La balise [If] permet de créer une suite de conditions sans réécrire la balise n fois. Exemple [P="Propriété"] [If="value=Valeur1"]Texte 1[/If] [If="Value=Valeur2"]Texte 2[/If] [/P] Exemple [C="Lien ou requête"] [If="First"] Texte 1 [CP=nom/][/If] [If="!First and!last"]texte 2[CP=nom/][/If] [If="Last"]Texte 3[CP=nom/][/If] [/C] La balise "Else" n existe pas. 204 MEGA Publisher

Utiliser les descriptions HTML Mettre en forme le texte HTML source METTRE EN FORME LE TEXTE HTML SOURCE Pour rendre plus lisible le source généré, il est possible d insérer, dans le texte, des balises de mise en forme : \n Nouvelle ligne \c Insère un commentaire dans le texte \i Indentation (décalage de 2 caractères vers la droite) \u Fin de l'indentation (annulation du décalage de deux caractères vers la droite) \t Tabulation (en fonction de l'indentation définie) \autoindent \noautoindent Indique que les futurs appels à \n sont un raccourci pour \n\t Annule le raccourci positionné par autoindent Ces balises servent uniquement à la mise en forme du code généré. Elles n apparaissent pas lorsque le résultat est consulté par l utilisateur final, à l aide d un navigateur tel qu Internet Explorer ou Netscape. 205

8 UTILISATIONS SPÉCIFIQUES DES DESCRIPTIONS HTML Descriptions HTML et multilinguisme Variables Syntaxe La variable "CodeTemplate" permet de récupérer la souche ou la souche traduisible du _Code Template. Dans le cadre des descriptions HTML et code, la syntaxe suivante renvoie la souche si elle n est pas vide, sinon renvoie la souche traduisible : [Variable=CodeTemplate Id="HexaIdAbs"/] 206 MEGA Publisher

Utiliser les descriptions HTML Utilisations spécifiques des descriptions HTML Insérer une adresse email dans un site Web Vous pouvez intégrer l e-mail d une personne ou d un service dont le nom apparaît dans un site Web. Pour cela : Positionnez-vous sur acteur ou personne à l aide de la balise [CP]. Tapez le code suivant : <A HREF="mailto: [ComponentProperty="E-mail"/]" > [ComponentProperty="Email"/] </A> Constituer un buffer La balise [Buffer] permet de constituer un buffer (c est-à-dire une variable) en lui affectant comme valeur une chaîne de caractère quelconque ou des valeurs d attributs. Déclarer le buffer Il est nécessaire de déclarer un buffer avant de l utiliser. Un buffer est déclaré par son nom. [Buffer= "MonBuffer1, MonBuffer2"] Il est possible de déclarer plusieurs buffers dans la même balise. Affecter la valeur Sa valeur lui est affectée à l'aide de l'attribut Set. [Buffer="MonBuffer1,MonBuffer2] [Buffer="MonBuffer1" Set="Texte"/] [Buffer="MonBuffer2" Set][P=Nom/][/Buffer] Restituer la valeur La valeur du buffer est restituée à l'aide de l'attribut Get. [Buffer="MonBuffer" Get/] Tester le contenu Il est possible de tester le contenu d un buffer. [If="Buffer(MonBuffer)=0"]texte[/If] Récupérer le résultat d un calcul ll est également possible de récupérer le résultat d un calcul entre plusieurs valeurs de buffers (lorsqu il s agit de valeurs numériques). [Buffer="cpt" set] [Value Expression="buffer(b1)+buffer(b2)"/] [/Buffer] 207

8 Copier une image dans le dossier de génération La balise [Variable] permet de copier une image dans le dossier "/Standard" du site. Elle est utile dans le cas où le dossier de génération du site Web est déplacé et que vous voulez conserver les images relatives à celui-ci. [Variable=StdFile File="MonImage.GIF" source="nomdossiersource" target = "NomDossierCible"/] Ceci permet de copier le fichier "MonImage.GIF" (qui se trouve dans le dossier "Mega_Std/NomDossierSource") dans le dossier "/Standard/NomDossierCible". File Source Target Fichier à copier Adresse relative (par rapport à "Mega_std/ Mega_usr") du dossier dans lequel le fichier à copier se trouve. Adresse relative (par rapport à "Standard") du répertoire dans lequel le fichier va être copié. Concevoir des outils de contrôle MEGA propose en standard des outils de contrôle pour un certain nombre de types d objets. Un outil de contrôle est une description HTML de catégorie "Contrôle". Vous pouvez réaliser vous-même une description HTML de contrôle en vous inspirant de celles existant. 208 MEGA Publisher

Utiliser les descriptions HTML Utilisations spécifiques des descriptions HTML Vous les trouverez dans la fenêtre Utilitaires, dossier "Description -> HTML -> HTML Contrôle". Pour plus de détails sur les descriptions HTML en général, voir"utiliser les descriptions HTML", page 181. Accéder aux propriétés d un _Code Template Dans une description, vous pouvez afficher les propriétés d un _Code Template ou d un autre objet afin de consulter ou de modifier ses caractéristiques. Pour afficher les propriétés d un _Code Template : 1. Dans le code de la description, sélectionnez et copiez l identifiant du _Code Template. 2. Collez l identifiant dans le champ situé en haut à droite de la fenêtre d édition. 3. Cliquez sur le bouton à droite du champ. La fenêtre de propriétés du _Code Template apparaît. 209

8 Définir un même en-tête pour tous les sites Web Le formateur à en-tête est un formateur HTML (HTML formatter) qui peut être mis en oeuvre par : Une macro Le formateur est relié à la macro par la patte "Macro" Une description Le formateur est relié à la description par la patte "Head Descriptor". Cet en-tête apparaît dans toutes les pages entre les balises <head></head>, en mode dynamique (Advisor) ou en mode statique (génération dans le bureau). 210 MEGA Publisher

Utiliser les descriptions HTML Descriptions HTML pour les sites Web dynamiques DESCRIPTIONS HTML POUR LES SITES WEB DYNAMIQUES Afficher un Metatree MEGA sous forme d arbre Web La balise Metatree n est disponible qu en mode dynamique (Advisor Enterprise et Professional Edition). [MetaTree=HexaIdAbsDuMetaTree/] affiche un Metatree MEGA sous forme d arbre Web. Exemple [MetaTree=446A8C004B2734F3/] Trois attributs sont disponibles : Si ContainerVisible = 1, la partie droite est visible = 0, la partie droite n est pas visible La valeur par défaut est 1 Si ContainerCollapsible = 1, la partie droite peut être ouverte ou refermée Si ContainerCollapsed = 1, la partie droite est refermée = 0, la partie droite est ouverte La valeur par défaut est 0 Ajouter l accès à l url de la page des favoris [Variable= FavoritesPage/] permet d afficher les favoris. Cette balise n est disponible qu en mode dynamique. Code pour définir l url dans les menus <li> <b><a HREF="[Variable=FavoritesPage/]">Favorites</a></b> </li> Vous devez aujouter au site web une page d index avec le formateur "MWA Favorites Page" fourni en standard. 211

8 Ajouter l accès à l url de la page du Rechercher [Variable= SearchPage /] permet d afficher l outil de recherche. Cette balise n est disponible qu en mode dynamique. Code exemple pour définir l url dans les menus <li> <b><a HREF="[Variable=SearchPage/]">Search</a></b> </li> Vous devez ajouter au site web une page d index avec le formateur "MWA Search index" fourni en standard. Ajouter l accès à l url de la page des RFCs [Variable= RFCPage /] permet d afficher la page des RFCs. Cette balise n est disponible qu en mode dynamique. Code exemple pour définir l url dans les menus <li> <b><a HREF="[Variable=RFCPage/]">RFC</a></b> </li> Vous devez ajouter au site web une page d index avec le formateur "MWA RFC Page" fourni en standard. Ajouter l accès à l url de la page de déconnexion [Variable= Logout /] permet d afficher à l utilisateur courant de se déconnecter en mode dynamique. Cette balise n est disponible qu en mode dynamique. Code exemple pour définir l url dans nos menus : <li class="last"> <b><a HREF="[Variable=Logout/]">logout</a></b> </li> 212 MEGA Publisher

Utiliser les descriptions HTML Descriptions HTML pour les sites Web dynamiques Ajouter un attribut sur les balises Property et ComponentProperty ContextMenu = On ContextMenu = Off Le menu contextuel est affiché sur l objet courant en mode dynamique uniquement Le menu contextuel n est pas affiché sur l objet courant, en mode dynamique uniquement Ajouter un attribut sur les balises Property et ComponentProperty Quand on est sur une référence externe de type autre que url et fichier (par exemple, swf) : ExtRefStatus = Complete ContextMenu = Embed on affiche le HTML complet qui englobe le SWF on affiche uniquement le HTML nécessaire pour voir le SWF et pour l imbriquer dans du code existant. 213

8 214 MEGA Publisher

9 MEGA WEB ACCESS MEGA propose un nouveau moyen de générer des sites Web. Il s agit de générer dynamiquement les pages Web correspondant aux objets qu on veut consulter. Ce chapitre traite les points suivants : "Les limites des sites Web statiques", page 216 "Le composant MEGA WEB Access", page 217 "Principes de fonctionnement", page 218 "Session MEGA WEB Access", page 219 "MEGA Web Access - Restitution", page 221 215

9 LES LIMITES DES SITES WEB STATIQUES Jusqu'à présent, les sites Web MEGA étaient générés dans l espace de travail MEGA et restituaient une vue du référentiel à un instant donné. Ce mode de génération apporte des avantages mais aussi quelques contraintes. Tout d'abord, la génération est complète. Cela permet d'avoir une vue cohérente du référentiel mais le temps de génération peut être relativement important. Il est parfois nécessaire de générer le site avec des utilisateurs différents (pour avoir des vues différentes du site Web ou certains objets filtrés pour certains profils d'utilisateur - par exemple, pour une prise en compte de la confidentialité). Si le site doit gérer le multilinguisme, il faut également générer le site Web dans les différentes langues concernées. Cette combinaison de générations entraîne un temps total de génération relativement long et une organisation par répertoire pour accéder aux données qui correspondent à celles de l'utilisateur consultant le site. Les sites existants ne s'intègrent pas toujours facilement dans des portails existants et il est difficile d'y intégrer des données externes. 216 MEGA Publisher

MEGA Web Access Le composant MEGA WEB Access LE COMPOSANT MEGA WEB ACCESS Afin de s affranchir des contraintes liées à la génération statique des sites Web, MEGA a développé un nouveau composant appelé MEGA WEB Access. Ce composant permet la génération de pages à la demande. Il se base sur les mêmes formateurs que ceux existants actuellement dans MEGA (site Web, descripteurs, macros). Lorsqu'on demande la génération d'une page d'un site Web, les liens contenus dans la page sont calculés en fonction de la définition des pages du site Web. Lorsqu'on demande la génération d'une page d'un descripteur, les liens contenus dans la page sont générés pour tous les objets du référentiel (l'apparition de ces liens peut être paramétrée par un contexte de génération ou d'exécution). Lorsqu'on demande la génération d'une page de macro, la restitution des liens est à la charge du créateur de la macro. Ce composant permet notamment de résoudre facilement les problématiques suivantes : Gestion des vues par profil dans le site Web Gestion de la confidentialité Gestion du multilinguisme Intégration dans les sites web existants Intégration de données externes Rafraîchissement des pages dont le contenu est modifié 217

9 PRINCIPES DE FONCTIONNEMENT MEGA WEB Access est un composant COM qui gère essentiellement les sessions vers MEGA et la restitution des pages Web ou autres contenus. Ce composant permet de se connecter au référentiel MEGA et de récupérer des données MEGA dans différents formats : HTML, XML, Diagramme, etc. Pour utiliser MEGA WEB Access il faut d'abord ouvrir une session, puis demander la génération des pages Web. 218 MEGA Publisher

MEGA Web Access Session MEGA WEB Access SESSION MEGA WEB ACCESS Une session est caractérisée de manière unique par : Un utilisateur MEGA : cet utilisateur permet de gérer notamment la confidentialité dans le site Web ainsi que les éventuels filtres qui lui sont appliqués Un environnement : il s'agit de l'environnement que l'on désire consulter Une base : il s'agit de la base que l'on désire consulter Une langue : il s'agit de la langue dans laquelle on consulte le site Web Le principe est donc, dans un premier temps, d'ouvrir une session associée à un utilisateur Web. Pour cela il faut associer les utilisateurs Web aux utilisateurs MEGA. Lors de l'ouverture de la session, le composant MEGA WEB Access vérifie si la session existe (on peut imaginer qu'une session avec les mêmes paramètres a déjà pu être ouverte). Si la session existe, on retourne l'identifiant de session existant. 219

9 Si la session n'existe pas, on ouvre une session dans MEGA et on l'associe à un identifiant unique. Cette session sera réutilisée pour chaque génération de page. Pour plus de détails sur MEGA Web Access et le fonctionnement des sites Web dynamiques, reportez-vous aux articles techniques correspondants. 220 MEGA Publisher

MEGA Web Access MEGA Web Access - Restitution MEGA WEB ACCESS - RESTITUTION Lorsque le serveur Web exécute la requête HTTP, l'application Web transmet un certain nombre d'informations au composant MEGA WEB Access. Ces informations spécifient notamment quel est le générateur utilisé et quel est l'objet pour lequel on désire restituer une page. La combinaison de ces informations forme une URL unique sur laquelle s'appuie le composant pour vérifier si la page associée a déjà été restituée ou pas. MEGA WEB Access vérifie si la page générée existe déjà dans son cache interne. Si la page a déjà été restituée, son contenu est restitué à partir du cache et renvoyé à l'application Web. Si la page n'est pas dans le cache, on demande à MEGA de générer la page en question. Une fois la page générée, elle est retournée au composant qui la stocke dans son cache et qui la retourne à l'application Web. Pour plus de détails sur MEGA Web Access et le fonctionnement des sites Web dynamiques, reportez-vous aux articles techniques correspondants. 221

9 222 MEGA Publisher

Troisième Partie : Personnalisation des outils standards 223

224 MEGA Publisher

10 RECHERCHER LES OBJETS La fonctionnalité de recherche permet de constituer un ensemble d objets à partir de paramètres tels que leurs liens avec les objets d autres types, la valeur de leurs caractéristiques ou de ceux de leurs liens, etc. L objet sur lequel porte la recherche est appelé objet cible. "Présentation de l outil de recherche", page 226 "Utiliser la barre de recherche", page 227 "Lancer l outil de recherche", page 232 "Utiliser l assistant d édition de requêtes", page 234 "Utiliser les requêtes récentes", page 241 "Editer les requêtes", page 243 "Résultats de la recherche", page 247 "Manipuler les objets candidats", page 255 "Paramétrer les options de l outil de recherche", page 256 225

10 PRÉSENTATION DE L OUTIL DE RECHERCHE Cette fonctionnalité permet de rechercher les objets dans le référentiel. Il est possible d indiquer des paramètres de recherche sur : Les liens autour de l objet sur lequel porte la recherche. Les objets touchés par ces liens. Les liens qui en découlent. Les nouveaux objets touchés, et ainsi de suite. Une recherche est effectuée par une requête, qui définit : Les objets et les liens par lesquels passe la recherche. Des conditions sur les liens et objets composant le parcours de la base. Cette requête peux être écrite au moyen d un assistant ou directement dans un langage d interrogation du référentiel (ERQL) : Le langage ERQL (Entity-Relationship Query Language) permettant de définir des recherches est basé sur le formalisme Entité/Relation. La syntaxe de ce langage est décrite dans "Syntaxe générale des requêtes : Select", page 260. Une requête est un dispositif permettant de sélectionner un ensemble d objets d un type donné à l aide d un ou plusieurs de critères de recherche. Les ensembles ainsi constitués peuvent être manipulés par la plupart des fonctionnalités du logiciel. On peut par exemple utiliser une requête pour trouver l ensemble des acteurs de l entreprise intervenant dans un projet. Le métamodèle est la structure de mémorisation des données gérées dans une base. Le métamodèle est enregistré dans la base système de l environnement. Le métamodèle regroupe l ensemble des types d objets permettant de modéliser un système, ainsi que leurs caractéristiques et les liens possibles entre ces types d objets. Il permet ainsi de construire des modèles décrivant l organisation ou le système d information d une entreprise ou d une administration. Il est possible de faire des extensions au métamodèle pour gérer de nouveaux types d objets. Les bases qui échangent des données (exportation, importation, extraction, etc.), doivent avoir un métamodèle identique sous peine de ne pouvoir accéder à certaines données. Les types d objets contenus dans le métamodèle sont aussi appelés MetaClasses ; leurs caractéristiques sont appelées attributs. Des raccourcis clavier peuvent être utilisés dans l outil de recherche. Pour plus de détails, voir le guide MEGA Common Features, chapitre "Questions fréquentes". 226 MEGA Publisher

Rechercher les objets Utiliser la barre de recherche UTILISER LA BARRE DE RECHERCHE MEGA offre la possibilité d effectuer des recherches simples depuis l espace de travail. Une barre de recherche dans la partie supérieure de l espace de travail permet d effectuer les recherches les plus courantes. Pour effectuer des recherches plus complexes, ouvrez la fenêtre standard de l outil de recherche à l aide du bouton Objets recherchés Rechercher sur un type d objet Vous pouvez effectuer une recherche portant sur un seul type d objet (par exemple les acteurs du référentiel). Pour cela : Sélectionnez un type d objet dans la liste déroulante du premier champ de la barre de recherche. Pour lister tous les objets correspondant à un même type d objet : 1. Sélectionnez le type d objet cible comme présenté ci-dessus. 227

10 2. Cliquez sur ou appuyez sur <Entrée> pour lancer la recherche. Les objets listés apparaissent dans la fenêtre de résultat. Rechercher sur tous les types d objets Vous pouvez effectuer une recherche portant sur tous les types d objets du référentiel. Pour cela : Sélectionnez "*Tous*" dans le premier champ de la barre de recherche, en haut de la liste déroulante. Rechercher à partir de plusieurs types d objets Pour effectuer une recherche sur un nombre limité de types d objets : 1. Dans la barre de recherche, cliquez sur la commande Sélection des cibles ouverte par la seconde flèche. 228 MEGA Publisher

Rechercher les objets Utiliser la barre de recherche 2. Dans la fenêtre Sélection des cibles de recherche, sélectionnez les types d objets sur lesquels vous souhaitez lancer une recherche puis cliquez sur Ajouter. La barre de recherche fait apparaître le terme "Sélection" dans le cadre destiné à l indication du type d objet. 3. Saisissez ensuite votre recherche et indiquez si vous souhaitez rechercher une chaîne de caractère dans le nom ou dans le commentaire. 4. Cliquez ensuite sur ou appuyez sur <Entrée> pour lancer la recherche. La fenêtre de résultat obtenue est hétérogène (multicible). Nature de la recherche Vous pouvez effectuer des recherches en fonction de caractéristiques communes à tous les types d objets. 229

10 Recherche dans le commentaire des objets Vous pouvez, par exemple, rechercher une chaîne de caractères dans le commentaire des objets (des projets dans l exemple ci-dessous). Saisissez une chaîne dans le second champ de la barre de recherche. Sélectionnez la commande Commentaire contenant... dans le menu déroulant. Cliquez sur Recherche dans le nom des objets Vous pouvez rechercher les objets dont le nom court : commence par, finit par, ou contient une chaîne de caractères. Recherche en fonction du statut de l objet Vous pouvez effectuer une recherche en prenant le statut ("modifiable" ou "protégé") comme critère de recherche. Ce critère peut être combiné avec un autre. Par exemple, vous pouvez rechercher les projets modifiables dont le nom commence par une chaîne donnée. Dans ce cas, 230 MEGA Publisher

Rechercher les objets Utiliser la barre de recherche les deux critères sont signalés graphiquement, ce qui permet de voir imméditament sur quel(s) critère(s) est basée la recherche. Recherche par date Vous pouvez effectuer une recherche par Date de création ou Date de modification. Cette date peut être : postérieure à égale à antérieure à Recherche par l identifiant absolu Lorsque vous êtes en métamodèle étendu (Outils > Options, groupe Référentiel, Accès au métamodèle > Expert), vous pouvez effectuer une recherche à partir de l identifiant absolu. Cette commande est disponible en métamodèle étendu seulement. 231

10 LANCER L OUTIL DE RECHERCHE L outil de recherche est disponible : à partir de l espace de travail, via la barre de recherche ou. dans d autres outils MEGA comme dans les diagrammes, l explorateur, etc. Différents modes - qui correspondent chacun à un onglet - sont disponibles en fonction de la manière de lancer l outil de recherche (depuis l espace de travail ou depuis un autre outil). Rechercher depuis l espace de travail Vous pouvez utiliser l outil de recherche depuis l espace de travail : via la barre de recherche pour effectuer une recherche simple et rapide, comme décrit au paragraphe "Utiliser la barre de recherche", page 227 en lançant l outil de recherche complet (qui propose plusieurs modes de recherche) en cliquant sur le bouton Modes de recherche disponibles Lors du lancement depuis l espace de travail, l outil de recherche propose les modes de recherche principaux : Assistant (voir "Utiliser l assistant d édition de requêtes", page 234) Requêtes récentes (voir "Utiliser les requêtes récentes", page 241) Requêtes (voir "Editer les requêtes", page 243) 232 MEGA Publisher

Rechercher les objets Lancer l outil de recherche Rechercher depuis un autre outil MEGA L outil de recherche est appelé depuis de nombreuses fenêtres ou outils MEGA (explorateur, diagramme, etc.). Il est par exemple appelé depuis un diagramme, lorsque vous souhaitez ajouter un objet. Modes de recherche disponibles Lors du lancement depuis un autre outil MEGA, l outil de recherche propose les onglets suivants en plus des trois modes standards: Candidats (voir "Manipuler les objets candidats", page 255) Résultat (voir "Résultats de la recherche", page 247) Pour plus de détails sur les différents modes de recherche, voir "Utiliser l assistant d édition de requêtes", page 234. 233

10 UTILISER L ASSISTANT D ÉDITION DE REQUÊTES L onglet Assistant permet de créer des requêtes multi-paramètres sans avoir besoin de connaître le langage ERQL. Une barre de recherche similaire à celle présentée dans la rubrique "Utiliser la barre de recherche", page 227, permet de sélectionner le type d objet cible de la recherche. La barre de recherche présente dans l outil de recherche ne permet cependant pas de faire des recherches à partir d une sélection de types d objet, comme c est le cas pour la barre de recherche de l espace de travail. Vous pouvez effectuer une recherche simple avec cette barre ou effectuer une recherche avec les paramètres apparaissant dans l arborescence. Utiliser l arborescence de l assistant de recherche Pour chaque type d objet cible, l assistant de recherche vous propose : Ses Propriétés Les Liens vers les types d objets qui peuvent lui être reliés. 234 MEGA Publisher

Rechercher les objets Utiliser l assistant d édition de requêtes Propriétés du type d objet cible Vous pouvez passer en paramètre les caractéristiques du type d objet cible (par exemple, nom et commentaire, qui sont des caractéristiques valables pour tous les types d objets). Liens Vous pouvez également passer en paramètre les caractéristiques d un lien. Les types d objets qui peuvent être reliés au type d objet cible apparaissent sous la dénomination "Source") Vous pouvez trier les liens par type d objet en cliquant sur cette colonne Source. Chaque lien regroupe les caractéristiques du lien et des objets associés. Le dossier "Liens par type" présente les liens triés par le type d objet concerné. 235

10 Dans l exemple ci-dessous, "Implication", "Règle de suivi," "Responsabilité", "Statut d exécutant" sont des propriétés du lien entre Acteur et Processus Organisationnel. Saisir les paramètres de la requête La colonne Paramètres contient les noms des paramètres de recherche (caractéristiques, liens, objets associés). Elle est munie d'une case à cocher permettant d'indiquer quels paramètres définissent la requête. Cochez ou décochez les paramètres que vous souhaitez prendre en compte pour construire votre requête. Les liens ou propriétés sélectionnés apparaissent alors surlignés de manière à faciliter la construction et lecture de la requête. Pour réinitialiser l ensemble des paramètres, cliquez sur le bouton (Effacer tous les critères de recherche). 236 MEGA Publisher

Rechercher les objets Utiliser l assistant d édition de requêtes Lorsque dans la barre de recherche de l assistant vous saisissez un nom à côté du type d objet cible, le paramètre Nom est initialisé avec cette valeur. Assurez-vous que vous avez bien coché l une des options proposées par la flèche du deuxième champ (Nom commençant par, Nom contenant, etc...). Etendre la liste des paramètres proposés L arborescence présentée dans cet onglet comprend par défaut les principaux paramètres de recherche. Pour afficher tous les paramètres de recherche : Cliquez dans le menu suivant sur Voir les propriétés d administration. Si vous travaillez dans un environnement multilingue, activez également Voir les propriétés de traduction. Opérateurs de la requête Une fois que vous avez coché la case correspondant au paramètre de recherche, sélectionnez un Opérateur dans la colonne correspondante. Les opérateurs sont définis en fonction du paramètre sélectionné. 237

10 Opérateurs And, Or et Not Le bouton permet d utiliser les opérateurs "And", "Or" et "Not". Ces opérateurs concernent tous les paramètres sélectionnés dans l assistant. Les paramètres concernés par ces opérateurs sont surlignés d une couleur qui varie en fonction de l opérateur (bleu pour "And", vert pour "Or", et orange pour "Not"). And L opérateur And signifie que toutes les conditions doivent être remplies. Select [Projet] Where [Pourcentage d'avancement] ="100%" And [Noms des chefs de projet] ="M. Dupont" And [Diagramme de projet] Is Not Null Or L opérateur Or signifie que au moins une condition doit être remplie. Select [Acteur] Where [Message-Emis] Or [Message-Reçu] Or [Message-Collecté] Not L opérateur Not signifie que aucune condition ne doit être remplie. Select [Acteur] Where Not [Message-Emis] And Not [Message-Reçu] And Not [Message-Collecté] Valeur des paramètres Saisissez ou recherchez la valeur du paramètre. En fonction de la nature du paramètre, différents outils vous aident à saisir sa valeur. 238 MEGA Publisher

Rechercher les objets Utiliser l assistant d édition de requêtes Utiliser les outils d aide à la saisie Pour saisir une date, par exemple la date de début d un projet, on vous propose un calendrier. Parfois, on vous propose une liste de valeurs. Afficher le code de la requête Le code de la requête se construit au fur et à mesure que vous cochez les cases et remplissez les champs. Les valeurs saisies dans les champs sont conservées lorsque vous décochez la case (de manière à enlever le paramètre correspondant du code de la recherche - vous pouvez ainsi le réintégrer rapidement en cochant à nouveau la case). Par défaut, le code de la recherche n est pas visible dans le mode Assistant. Pour visualiser le code de la requête sélectionnée : Dans le menu Affichage, sélectionnez Code de la requête. 239

10 Le code de la requête apparaît en grisé en bas de l onglet Assistant. Vous ne pouvez pas modifier ce code. En revanche, vous pouvez copier (<Ctrl>+<C>) le code de la requête pour l utiliser ailleurs ou l enregistrer pour créer une nouvelle requête. Mémoriser une requête à partir de l assistant Lorsque la commande Affichage > Code de la requête est sélectionnée, le code de la requête apparaît en bas de l assistant. Vous pouvez l enregistrer en créant une requête. Pour créer une requête à partir du code obtenu dans l assistant : 1. Cliquez sur le bouton Enregistrer sous. La fenêtre de création d une requête apparaît. 2. Saisissez son nom puis sur Créer. La requête que vous venez de créer apparaît maintenant dans l onglet Requêtes. 240 MEGA Publisher

Rechercher les objets Utiliser les requêtes récentes UTILISER LES REQUÊTES RÉCENTES Le mode Mes requêtes Récentes fournit un accès rapide aux dernières requêtes que vous avez exécutées. Sélectionnez un type d objet dans la liste déroulante. Lorsque vous sélectionnez une requête dans la liste, les paramètres de la requête et ses valeurs sont affichés. Définition des requêtes récentes Le mode Mes requêtes récentes fait appel au type d objet (ou MétaClasse) "Requête temporaire" pour mémoriser temporairement vos requêtes. Elles contiennent le code qui a permis d obtenir les objets apparaissant dans la fenêtre de résultat. Elles sont propres à chaque utilisateur. Une requête récente n a pas pour vocation d être conservée indéfiniment. Si vous voulez la conserver, vous devez l enregistrer à l aide du bouton. Mémoriser les requêtes récentes Pour chaque utilisateur, un nombre défini de requêtes récentes sont mémorisées. Lorsque ce nombre est atteint, les requêtes récentes les plus anciennes sont supprimés, sauf si elles font partie de vos favoris. Paramétrer le nombre de requêtes récentes Pour paramétrer le nombre de requêtes récentes mémorisées : 1. Depuis l espace de travail, cliquez sur Outils > Options. 2. Sélectionnez le dossier Requêtes. 241

10 3. Dans la partie droite de la fenêtre, sélectionnez une valeur pour le champ Nombre de requêtes récentes conservées. Exemples de requêtes récentes Une requête récente est une requête résolue et directement exécutable. Si la requête comporte des paramètres, la requête récente contient les valeurs de ces paramètres. Requête Valeur des paramètres Mémorisation du code de la requête temporaire Select [Projet] Where [Nom court] ="&[Nom court] HBC pour &[Nom court] SELECT [Projet] WHERE [Nom court] ="HBC" Select [Projet] Where [Date de début] = "&Projet.Date de début" And [Noms des chefs de projet] = "&Projet.Noms des chefs de projet" Select [Processus Organisationnel] Where [Nom] Like "Com#" "15/02/2004" pour "&Projet. Date de début" et "Dupont" pour &Projet.Noms des chefs de projet" Select [Projet] Where [Date de début] = ""15/02/2004"" And [Noms des chefs de projet] = ""Dupont"" Select [Processus Organisationnel] Where [Nom] Like "Com#" 242 MEGA Publisher

Rechercher les objets Editer les requêtes EDITER LES REQUÊTES Le mode Requêtes cataloguées facilite l'accès aux requêtes par type d objet cible et leur mise à jour. Vous pouvez également créer vos propres requêtes depuis ce mode. Utiliser une requête du référentiel Vous pouvez accéder aux requêtes du référentiel en sélectionnant un type d objet dans la liste déroulante. Les requêtes peuvent être de deux types : Interne : comprend les requêtes "techniques" utilisées dans les fournitures standard (descriptions, documents types, matrices, etc.), "Nom" et "*". Usuel : comprend les requêtes programmées par les utilisateurs (c est le type proposé par défaut), ainsi que les requêtes "*" et "Nom". Vous pouvez filtrer les requêtes en fonction de leur type. Pour cela : 1. Cliquez sur le bouton puis sur Type de requêtes. La fenêtre Affichage des requêtes s affiche. 2. Cochez la case correspondant au type de requête que vous souhaitez afficher : "Interne", "Usuel", ou "Non spécifié". 3. Cliquez sur OK. La liste des requêtes cataloguées est mise à jour en fonction du type choisi. 243

10 Créer une requête Pour créer une requête : 1. Dans la liste, sélectionnez le type d objet pour lequel vous souhaitez créer une requête. 2. Cliquez sur le bouton Votre requête apparaît alors dans la fenêtre. Vous pouvez maintenant saisir son code. Le champ est initialisé avec le code "Select xx where", où "xx" est le nom de l objet cible. MEGA vous propose une aide lorsque vous avez un doute sur les possibilités offertes par la syntaxe ERQL. Pour plus de détails, voir "Utiliser l aide lors de la saisie des requêtes", page 244. Vous pouvez analyser le code de votre requête avant de l exécuter en cliquant sur le bouton Utiliser l aide lors de la saisie des requêtes Il est possible d appeler une aide au cours de l élaboration du code de recherche en appuyant sur <Ctrl> + <Espace>. Une liste déroulante vous propose diverses possibilités pour compléter votre code. Comme dans le mode Assistant, les propriétés proposées dans cette liste déroulante sont les plus courantes. Vous pouvez néanmoins ajouter toutes les autres propriétés en modifiant les paramètres d affichage, comme décrit ci-dessous. 244 MEGA Publisher

Rechercher les objets Editer les requêtes Afficher les propriétés d administration Pour accéder aux propriétés d administration : Cliquez sur le bouton et sélectionnez Voir les propriétés d administration. Afficher la traduction des propriétés Pour accéder aux propriétés dépendant de la langue : Cliquez sur le bouton et sélectionnez Voir les propriétés de traduction. La liste déroulante est rafraîchie et comporte désormais les traductions de chaque caractéristique dans les différentes langues. Coller le nom d un objet dans une requête Le nom d un objet peut être inséré dans une requête sous forme de champ. Ainsi, lorsque vous saisissez une requête du type : Select [Acteur] Where name = xxx 245

10 vous pouvez copier le nom d un objet et le coller dans la requête. Ainsi, lorsque vous modifierez le nom de l objet que vous venez de copier, la requête sera automatiquement mise à jour. Pour copier le nom d un objet, sélectionnez l objet (dans un diagramme ou dans le navigateur) et dans son menu contextuel, cliquez sur Copier. 246 MEGA Publisher

Rechercher les objets Résultats de la recherche RÉSULTATS DE LA RECHERCHE Après avoir exécuté une requête en cliquant sur le bouton de Résultat apparaît. Pour sélectionner l ensemble des objets de la fenêtre de résultat : Appuyez simultanément sur les touches <Ctrl> et <A>. Deux modes d affichage sont proposés : le mode Réinitialisé le mode Cumulé, la fenêtre Constituer le résultat Réinitialiser les résultats Par défaut le contenu de la fenêtre de résultat est réinitialisé à chaque exécution de requête. Autrement dit, la fenêtre de résultat se vide et se remplit à chaque exécution de requête. Le mode Réinitialisé est le seul possible lorsqu on exécute une requête à partir de la barre de recherche Cumuler les résultats Vous pouvez néanmoins choisir de cumuler les résultats de plusieurs recherches dans la même fenêtre. La barre d outil de recherche de l espace de travail ne permet pas de cumuler les résultats. Le contenu est systématiquement réinitialisé. Pour obtenir le mode Cumulé : Dans l outil de recherche, cliquez sur le bouton suivant puis sur Cumulé. Pour obtenir un résultat cumulé, veillez à ne pas fermer la fenêtre de résultat après exécution des requêtes. 247

10 Dans le mode Cumulé, la fenêtre de résultat peut alors lister des objets de type hétérogène (par exemple, à la fois des processus et des acteurs). Afficher les objets communs à plusieurs ensembles de résultat Lorsque le mode Cumulé est sélectionné, vous pouvez afficher les objets communs à plusieurs ensembles de résultats en cliquant sur le bouton (il s agit du symbole mathématique représentant l intersection de deux ensembles). Ce bouton n apparaît que lorsque le mode Cumulé est sélectionné. Afficher les résultats Constituer un nouvel onglet dans la fenêtre de résultat Vous pouvez créer un nouvel onglet de manière à ne pas mélanger les résultats. Pour créer un nouvel onglet dans la fenêtre de résultat : Dans la fenêtre de résultat, cliquez sur le bouton. Votre résultat apparaît alors dans un onglet à part, ce qui permet de le conserver en cas de ré-exécution d une requête. Personnaliser le contenu des colonnes de la fenêtre de résultat Par défaut, la fenêtre de résultat présente en colonnes et pour chaque objet : le nom court le nom long de l objet Vous pouvez personnaliser ces colonnes. Chaque colonne correspond à une propriété de l objet. 248 MEGA Publisher

Rechercher les objets Résultats de la recherche Pour personnaliser les colonnes de la fenêtre de résultat : Cliquez sur Affichage > Personnaliser les colonnes. La fenêtre Personnalisation de l affichage des colonnes vous permet d ajouter ou d enlever des colonnes pour une MétaClasse donnée. Chaque nouvelle colonne correspond à une caractéristique de la MétaClasse. Si vous souhaitez classer les résultats de la fenêtre de résultat par type d objet, ajoutez la colonne MetaClasse. Pour les types d objets qui sont dans un espace de nommage, le nom court est également indiqué par défaut. Mémoriser les colonnes Vous pouvez garder en mémoire les colonnes à afficher lors de l exécution de requêtes futures. Pour cela : Dans la fenêtre des options de l utilisateur, groupe "Requête", activez l option Résultat : conserver les colonnes affichées. Pour afficher les options de l utilisateur, depuis l espace de travail, cliquez sur Outils > Options. La prochaine fois qu une requête sera exécutée, la fenêtre de résultat proposera les mêmes colonnes que celles définies précédemment. 249

10 Réinitialiser les colonnes La liste des colonnes affichées peut varier en fonction des types d objets faisant l objet de la recherche. Ainsi, lorsque cette option est activée, après chaque exécution de requête, les colonnes qui correspondent à des caractéristiques non reliées aux cibles recherchées sont enlevées. Afficher les résultats sous forme de liste Par défaut, les résultats apparaissent sous forme de liste. Lorsque le bouton Afficher les objets résultats sous forme d une liste est activé, les doublons (c est-à-dire les objets qui apparaissent dans plusieurs requêtes récentes) sont éliminés. Si, par exemple, le Processus Organisationnel "Commande urgente" apparaît dans plusieurs requêtes récentes (c est-à-dire qu elle apparaît plusieurs fois dans l arbre des requêtes), elle n apparaît qu une fois dans la liste. Ainsi, le bouton Afficher les objets résultats sous forme d une liste équivaut au bouton de la fenêtre de résultat (symbole mathématique correspondant à l union de deux ensembles). Afficher les requêtes à l origine du résultat Vous pouvez également afficher les résultats sous forme d un arbre qui permet de visualiser les requêtes récentes qui ont donné lieu aux collections d objets résultats. Pour afficher les résultats sous forme d un arbre : 1. Cliquez sur le bouton Afficher l arbre des requêtes récentes et les objets résultats. 250 MEGA Publisher

Rechercher les objets Résultats de la recherche 2. Faites un double-clic sur les requêtes récentes pour voir apparaître les objets résultats. Vous obtenez ainsi un arbre permettant de distinguer les différentes requêtes exécutées avec leur ensemble résultat. Afficher les objets communs à plusieurs ensembles de résultat Le bouton permet de restreindre la visualisation aux objets communs à toutes les requêtes récentes. Les boutons et n apparaissent que lorsque le mode Cumulé est sélectionné. Rafraîchir le contenu de la fenêtre de résultat Vous pouvez relancer l exécution des requêtes ayant constitué la liste d objets de la fenêtre de résultat. Pour rafraîchir les résultats : Cliquez sur le bouton Modifier les objets dans la fenêtre de résultat Vous pouvez utiliser la fenêtre de résultat d une recherche pour mettre à jour les caractéristiques des objets y figurant. 251

10 Modifier un objet Pour modifier un objet à partir de la fenêtre de résultat : Sélectionnez un objet dans la fenêtre de résultat et dans son menu contextuel, cliquez sur Modifier. Vous pouvez ensuite modifier la caractéristique sélectionnée, par exemple le nom de l objet. Modifier une sélection d objets Vous pouvez également modifier les caractéristiques d une sélection d objets (par exemple, attribuer la même valeur de caractéristique à une sélection d objets). Pour afficher les colonnes correspondant aux différentes caractéristiques des objets, voir "Personnaliser le contenu des colonnes de la fenêtre de résultat", page 248. Pour modifier une sélection d objets à partir de la fenêtre de résultat : 1. Sélectionnez les objets que vous voulez modifier. 252 MEGA Publisher

Rechercher les objets Résultats de la recherche 2. Cliquez sur la caractéristique de l objet que vous souhaitez modifier et dans le menu contextuel de la sélection, sélectionnez Modifier. 3. Modifiez alors la valeur de la caractéristique. 4. Une fois la caractéristique modifiée, validez en appuyant sur la touche <Entrée>. Les données sont alors mises à jour pour l ensemble de la sélection d objets. Générer un rapport HTML Pour générer un rapport à partir des objets que vous avez séléctionnés : Dans la fenêtre de résultat, cliquez sur le bouton 253

10 Les colonnes du tableau sont les mêmes que celles de la liste au moment de la génération du rapport (voir "Personnaliser le contenu des colonnes de la fenêtre de résultat", page 248). Cette fenêtre vous permet de visualiser rapidement la liste des MetaClasses présentes dans la fenêtre de résultat et le nombre d objets correspondant. Pour envoyer par email le rapport que vous venez de générer : Cliquez sur le bouton L e-mail contient le fichier.html généré. Si vous souhaitez modifier la feuille de style.css du rapport de recherche, cliquez sur Outils > Options puis sur Requêtes. La feuille de style est indiquée dans le champ "Rapport : emplacement de la feuille de style". 254 MEGA Publisher

Rechercher les objets Manipuler les objets candidats MANIPULER LES OBJETS CANDIDATS L onglet Candidats apparaît lorsque l outil de recherche est lancé depuis un autre outil tel que l explorateur, un diagramme, etc. Il présente, par type d objet : les objets issus de l Historique les objets issus des Favoris les objets contenus dans le Presse-papier MEGA. Il s agit des objets récemment ou couramment utilisés. Ce mode permet donc d accéder rapidement aux objets manipulés. Il est utile lorsque vous appelez l outil de recherche depuis une fonctionnalité qui ne permet pas d utiliser le navigateur. Cet onglet n apparaît pas lorsque vous lancez l outil de recherche depuis l espace de travail (vous disposez alors du navigateur, ce qui vous permet de manipuler facilement les objets du reférentiel notamment vos favoris et l historique). Les commandes du bouton permettent de faire apparaître alternativement ces objets. 255

10 PARAMÉTRER LES OPTIONS DE L OUTIL DE RECHERCHE Pour paramétrer l outil de recherche : 1. Cliquez sur ou sur Outils > Options depuis l espace de travail. La fenêtre Options de l utilisateur apparaît. 2. Sélectionnez le dossier Requêtes. Cette fenêtre permet de paramétrer l affichage des onglets constituant l outil de recherche : Requêtes Requêtes récentes Candidats Pour plus de détails sur les différents modes et onglets de l outil de recherche, voir "Utiliser l assistant d édition de requêtes", page 234. Requêtes récentes Une case permet d indiquer le Nombre de requêtes récentes que vous souhaitez conserver temporairement dans le référentiel. 256 MEGA Publisher

Rechercher les objets Paramétrer les options de l outil de recherche Synchronisation de la cible de recherche L option Synchronisation de la cible de recherche permet d activer ou de désactiver la synchronisation de la cible recherchée entre la barre de recherche et l outil de recherche. Toujours Cette valeur permet de synchroniser la barre et l outil de recherche en permanence : si une cible est sélectionnée dans un des dispositifs, elle le sera automatiquement dans l autre. Occasionel (si l outil n es pas masqué) La barre de recherche et l outil de recherche sont synchronisés sauf si l outil de recherche est masqué (commande Masqué automatiquement). Jamais Cette valeur désactive toute synchronisation entre la barre de recherche et l outil de recherche. 257

10 258 MEGA Publisher

11 SYNTAXE DES RECHERCHES Cette rubrique décrit la syntaxe utilisée par le langage ERQL (Entity-Relationship Query Language). La connaissance de ce langage est utile si vous souhaitez éditer les requêtes du référentiel ou créer vos propres requêtes dans l onglet Requêtes de l outil de recherche. Les points suivants sont abordés ici : "Syntaxe générale des requêtes : Select", page 260 "Liste alphabétique des commandes", page 262 "Contrôle de la syntaxe et assistance", page 264 "Résultat : Into", page 265 "Condition : Where", page 266 "Ensembles : From", page 272 "Conseils et exemples de requêtes", page 274 259

11 SYNTAXE GÉNÉRALE DES REQUÊTES : SELECT Notation utilisée pour les requêtes Dans la description de la syntaxe, la notation suivante est utilisée : Une expression entre crochets [ ] est facultative. Une expression entre parenthèses ( ) peut être répétée. Les expressions entre accolades { } sont alternatives. Les opérateurs du langage sont indiqués en caractères gras. Structure des requêtes La syntaxe d une requête a la structure suivante : Select type-objet from @ensemble Into @Résultat Where Condition Les opérateurs "From", "Into" et "Where" doivent être placés dans l ordre indiqué ci-dessus. Les majuscules et les minuscules sont traitées de la même façon. Les types d objets et les caractéristiques peuvent être saisis avec ou sans accent. Les types d objets comprenant des blancs doivent être saisis entre crochets ([ ]). Commentaires dans les requêtes Il est possible d insérer des commentaires dans les commandes en les faisant précéder de /* et en les faisant suivre de */. Exemple : select Message /*Recherche des messages*/ Variables dans les requêtes Il est possible d utiliser des variables pour conditionner une requête. A l exécution, une fenêtre demandera la saisie de ces variables, en présentant un champ par variable définie dans la requête. Les noms de variables sont préfixés par le caractère &. Le nom de la variable sert de titre au champ présenté lors de l exécution. Dans la description de la syntaxe, "&variable" indique qu il est possible de définir une variable. select Message where type-message = &Type Lors de l exécution, un champ précédé du titre "Type" devra être renseigné. Le nom d une variable peut contenir n importe quel caractère s il est mis entre " ". "&Nom de l Acteur" Requêtes comprenant plusieurs Select Il est possible d utiliser plusieurs clauses "Select" dans une requête. Les clauses "Select" suivent les mêmes règles que dans le cas de requêtes comprenant une 260 MEGA Publisher

Syntaxe des recherches Syntaxe générale des requêtes : Select clause unique, la seule différence étant que le nom précisé après l opérateur "From" peut correspondre au résultat ("Into") d une clause "Select" précédente. Ceci permet, entre autres, d utiliser des résultats intermédiaires sans avoir à conserver le résultat. Il faut noter que les résultats intermédiaires ne sont pas conservés : seul le dernier résultat est présenté à la fin de l exécution. Les clauses "Select" peuvent être ou non placées sur différentes lignes. Dans le champ de saisie de la requête, le passage à la ligne est obtenu par la combinaison <Ctrl>+<Entrée>. Exemples : Recherche des flux de matière d un projet : Select Message into @FluxMatière where Type-Flux = "Flux de Matière" Select from @FluxMatière where Diagramme.Projet = &projet Recherche des messages des diagrammes d un projet décrivant un acteur : Select Diagramme into @DiagrammeActeur where Acteur-décrit and Projet = &projet Select Message where Diagramme in @DiagrammeActeur 261

11 LISTE ALPHABÉTIQUE DES COMMANDES And : Permet de prendre en compte simultanément deux critères de requête. Select Message where Type-Message = "External Data" and Type-Flux = "Flux financier" Between : Permet de préciser qu une valeur doit être comprise entre deux autres valeurs. Select Message where Name between "A" and "M" Deeply : Permet de faire une recherche récursive de tous les objets concernés par un lien de décomposition. Select Acteur where composé deeply = &Acteur Default : Permet de sélectionner un (des) objet(s) dont la valeur d un attribut est celle donnée par défaut. Select Message where Type-Flux = "Default" Delete : Détruit un ensemble conservé auparavant. Delete @ActeursPrincipaux From : Permet de restreindre la recherche au contenu d un ensemble défini auparavant. Select Message from @MessagesCommerciaux where Type-Flux = "Flux de Matière" Having count : Permet de restreindre la requête en précisant le nombre d objets reliés. Select Acteur where Message-émis having count > 3 In : Permet d indiquer que l on va chercher des valeurs comprises dans un ensemble ou dans une sous-requête. Select Diagramme where Acteur in @ActeursPrincipaux Into : Permet de mettre le résultat de la requête dans un ensemble que l on pourra réutiliser ensuite. Select Acteur into @ActeursPrincipaux where not composé Keep : Permet de conserver un ensemble pour toute la durée d une session ou jusqu à ce qu il soit détruit à l aide de la commande Delete. Keep @ActeursPrincipaux Like : Permet de préciser que l on recherche des objets dont le nom est semblable à un texte composé avec des caractères jokers tels que # et!. Select Acteur where nom like "!!!!!!Commerc#" Not : Permet d indiquer la négation d un critère de requête. Select Message where Type-Flux not = "Flux financier" Null : Indique que l on recherche les objets non reliés à d autres objets par ce lien. Select Acteur where Message-émis null 262 MEGA Publisher

Syntaxe des recherches Liste alphabétique des commandes Or : Permet de prendre en compte l un ou l autre critère parmi plusieurs critères de requête. Select Message where Type-Message = "Flux de Matière" or Type-Flux = "Flux financier" Select : Commande de requête. Select Message where Type-Flux = "Flux financier" Unique : Indique que l on recherche des objets reliés à un seul autre objet par le lien. Select Acteur where Message-émis unique Where : Permet de préciser un ou plusieurs critères de requête. Select Message where Type-Flux = "Flux financier" # : Caractère joker signifiant : n importe quel nombre de caractères quelconques. Select Acteur where nom like "Agent#"! : Caractère joker représentant un caractère quelconque. Select Acteur where nom like "!!!!!!Commercial" & : Indique que la chaîne de caractères qui suit est un nom de variable. Select Diagramme where Acteur = &Acteur @ : Indique que la chaîne de caractères qui suit est un nom d ensemble. Select Diagramme where Acteur in @ActeursPrincipaux :: Caractère de séparation permettant de préciser le type d objet cible lors du parcours d un lien générique. select Message where [Destinataire de message]:[operation] = &Operation < > = : Critères de comparaison. Select Message where Nom > "A" and Nom < "M" and Type-Flux = "Flux financier" "": Caractères permettant d encadrer une valeur, un nom de variable ou un nom d ensemble quand ils contiennent des caractères tels que des blancs. []: Caractères permettant d encadrer les types d objet, les noms de liens ou de caractéristique quand ils contiennent des caractères tels que des blancs. Select [Document type] where Nom = &Nom /* */ : Caractères encadrant un commentaire. /* Les Acteurs principaux sont ceux qui ne sont composant d aucun autre acteur */ 263

11 CONTRÔLE DE LA SYNTAXE ET ASSISTANCE Lors de l écriture d une requête, il est possible : De contrôler la validité de la requête sans l exécuter, en activant le bouton Analyser. D obtenir une assistance sur le métamodèle. Pour obtenir l assistance sur le métamodèle, afin de retrouver le nom d un type d objet, d un lien, d une patte ou d une caractéristique : Insérez un point d interrogation (?) à l emplacement de l élément du métamodèle recherché. Une fenêtre propose alors les liens, les pattes, les caractéristiques ou les types d objets qui peuvent être atteints à cet endroit de la requête, en fonction du parcours précédemment défini dans la requête. Un double-clic sur l élément retenu provoque le remplacement du point d interrogation par le nom de cet élément. 264 MEGA Publisher

Syntaxe des recherches Résultat : Into RÉSULTAT : INTO L opérateur "Into" permet d attribuer un nom au résultat. Ce nom sera utilisé comme titre de la fenêtre présentant les objets trouvés. Select type-objet Into @ensemble L opérateur Into est facultatif : s il est absent, le résultat porte le nom du type d objet cible ("select Message where " est équivalent à "select Message into @Message where "). Le nom de l ensemble doit être précédé du caractère @. Le résultat peut être conservé par l intermédiaire des commandes du menu Requête de la fenêtre présentant le résultat d une requête, afin d être utilisé avec l opérateur "From". 265

11 CONDITION : WHERE Les conditions définissant les critères de requête peuvent porter sur les valeurs des caractéristiques des objets ou des liens, ainsi que sur l existence ou la non-existence d un lien. Ces conditions peuvent être groupées. Une condition indique le(s) critère(s) de requête. Elle est facultative : s il n y a pas de condition, le résultat est constitué de l ensemble ou de la combinaison d ensembles indiqués après l opérateur From. Si aucun ensemble n était précisé, le résultat contient tous les objets du type indiqué. Une condition peut être composée de conditions élémentaires reliées par les opérateurs or, and et not. L utilisation de parenthèses est possible et suit les règles indiquées pour les combinaisons d ensembles. La forme générale d une condition est la suivante : Parcours désignant un lien ou une caractéristique, suivi d un opérateur de requête, suivi des paramètres de la requête. La requête est ainsi restreinte aux objets répondant à l opération de requête. Sous-requête : In L opérateur "in" permet d indiquer une condition sur les objets appartenant à un ensemble conservé, ou d indiquer des conditions successives. Parcours [not] in @Ensemble,objet-type where Condition Il faut noter que les conditions groupées permettent également d indiquer des conditions successives (voir "Conditions groupées", page 270). Exemples : select Message where Diagramme in @Mod select Message where Acteur-émetteur in @Acteur where nom like "Service#" Parcours du métamodèle La concaténation de pattes successives permet de parcourir le métamodèle. 266 MEGA Publisher

Syntaxe des recherches Condition : Where Rappel sur la désignation des pattes Dans le métamodèle, les objets sont reliés selon le schéma qui suit : Les noms des pattes respectent la règle suivante : vu d un objet, le lien est désigné par le nom de la patte qui lui est opposée (dans le schéma, vu de Objet 1, le lien porte le nom de Patte 2). Lorsque le lien est explicite (par exemple, Emission-Message entre Acteur et Message), les deux pattes sont nommées (Acteur-émetteur et Message-émis). Lorsque le lien est implicite (par exemple, entre Message et Diagramme), les pattes ont le même nom que le type d objet sur lequel elles portent. Lorsque le lien est générique, c est à dire qu il permet d atteindre plusieurs types d objets différents, il est possible de préciser un type d objet particulier en le séparant par le caractère :. select Message where [Destinataire de message]:[operation] = &Operation Les pattes des nomenclatures sont nommées (par exemple, Composant et Composé pour les compositions, Précédent et Suivant pour les séquences). L objet atteint par la dernière patte est appelé "objet source". Exemple : La liste des Messages Emis par les Acteurs des Diagrammes d un Projet peut être obtenue par la requête : select Message where Acteur-émetteur.Diagramme.Projet = &PROJ La requête suivante donnera le même résultat (voir "Conditions sur les caractéristiques des objets", page 268) : select Message where Acteur-émetteur in Acteur where Diagramme in Diagramme where Projet = &PROJ 267

11 Conditions sur les caractéristiques des objets Null signifie que la caractéristique n est pas renseignée. Les comparaisons effectuées sont toujours alphanumériques : "2" est supérieur à "10" ainsi qu à "02". Caractères génériques Dans une condition "like", le symbole "#" représente un nombre quelconque de caractères quelconques. Le symbole "!" représente un seul caractère quelconque, et peut être répété. Par exemple : "x#" désigne toutes les valeurs qui commencent par "x" "#x" désigne toutes les valeurs qui finissent par "x" "#x#" désigne toutes les valeurs qui comportent "x" "!x#" désigne toutes les valeurs qui comportent "x" comme deuxième caractère "x#x" désigne toutes les valeurs qui commencent et finissent par "x" "!!" désigne toutes les valeurs qui comportent deux caractères Exemples : select Acteur where Nom = "Agent Commercial" select Acteur where Name = &ManagerName select Acteur where Name between "A" and "M" select Acteur where Name between &min and &max select Acteur where Nom like "#com#" select Acteur where Nom like "!!!!!!com#" select Acteur where Nom like "agent#" select Diagramme where Nature null Condition sur les liens Les conditions sur les liens peuvent contrôler l existence du lien et la valeur des caractéristiques du lien. 268 MEGA Publisher

Syntaxe des recherches Condition : Where Condition sur l existence du lien : Null, Unique et Having count Null signifie que le lien n existe pas. Dans le cas de pattes concaténées, c est le lien atteint par la dernière patte qui est testé. Par exemple, "select Projet where Diagramme.Acteur.Message.émis null" sélectionne les projets où des diagrammes incluent des acteurs qui n émettent aucun message ; les diagrammes qui ne comprennent pas d acteurs sont ignorés. Unique indique que le lien doit exister une seule fois. Dans le cas de pattes concaténées, c est le lien atteint par la dernière patte qui est compté. (N.B. : "not unique" indique qu il existe plus d un lien.) Having count indique le nombre de fois où le lien doit exister. Dans le cas de pattes concaténées, c est le lien atteint par la première patte qui est compté. Exemples : select Acteur where Diagramme null select Acteur into @ActeursPrincipaux where Composant not null select Diagramme where Acteur.Message-émis not null having count > 2 Dans ce dernier exemple, on recherche les diagrammes qui contiennent au moins deux acteurs qui émettent des messages. Condition sur les caractéristiques de lien Une condition sur une caractéristique de lien s exprime de la même manière qu une condition sur la caractéristique d un objet. Le nom de la caractéristique de lien est concaténé au nom qui désigne le lien. Ce nom et le nom de la caractéristique sont séparés par un point (.). Exemple : Recherche des Acteurs qui émettent toujours au moins un Message : select Acteur where Message-émis.Prédicat = "toujours" 269

11 Condition sur les caractéristiques de l objet source Une condition sur une caractéristique de l objet source peut être indiquée de la même façon que sur les caractéristiques portées par le lien : select Acteur where Message-émis.Prédicat = "toujours" or Message-émis.Type-Flux = "Flux d Information" Si la caractéristique n est pas précisée, la recherche porte sur le nom ("Diagramme.Nom ="zzz" " est équivalent à "Diagramme ="zzz" ") : select Diagramme where Acteur = "Agent commercial" select Diagramme where Acteur = &Act Parcours des nomenclatures : Deeply Lorsque le type d objet cible de la recherche est identique au type d objet source, et que le lien parcouru est une nomenclature (par exemple, Composition), il est possible d effectuer la recherche sur tous les niveaux de la décomposition, avec l opérateur "deeply". Patte deeply Condition Exemples : select Acteur into @composants where composé deeply = &Acteur select [Message] where [Acteur-Récepteur].[Message-Emis] deeply in [Message] where [Acteur-Emetteur] = &"Acteur" Le premier exemple permet de rechercher tous les acteurs composants d un acteur donné, que ce soit directement ou par l intermédiaire d autres acteurs. Le second exemple permet de rechercher tous les messages produits par la réception des messages émis par un acteur. Conditions groupées Lorsqu une condition porte sur plusieurs caractéristiques de l objet source, il est nécessaire de l exprimer par une condition groupée. En effet, les opérateurs "and", "or" et "not" portent chacun sur un objet source quelconque satisfaisant à la condition indiquée. Si on veut que l objet source pris en compte soit le même pour différents critères, il faut regrouper ces critères avec des parenthèses. Ainsi, la requête : select Acteur where Message-émis.Type-Message = "Données externes" and Message-émis.Type-flux = "Flux d information" permettra de trouver les acteurs qui sont émetteurs d au moins un message de type "Données externes" et d au moins un message de type "Flux d information". Rien 270 MEGA Publisher

Syntaxe des recherches Condition : Where n indique dans cette requête que les acteurs trouvés doivent être reliés à au moins un message de type "Flux d information" et de type "Données externes". Pour effectuer cette requête, il est nécessaire d écrire la requête comme suit : select Acteur where Message-émis.(Type-Message = "Données externes" and Type-flux = "Flux d information") (le point doit être placé avant les parenthèses), ou comme suit, avec une sousrequête : select Acteur where Message-émis in Message where (Message- Type = "External Data" and Type-flux = "Flux d information") La première requête donnera A1 et A2, alors que le second ne donnera que A2. Pour regrouper des conditions sur les caractéristiques d un objet et les caractéristiques d un lien, il est également nécessaire d utiliser des conditions groupées. Par exemple, pour effectuer une recherche sur les messages toujours émis par un acteur donné, c est-à-dire une recherche sur le nom d un acteur et la valeur de la caractéristique prédicat entre le message et l acteur, il faudra écrire la requête comme suit : select Message where Acteur-émetteur.(prédicat = "toujours" and nom = &Acteur) 271

11 ENSEMBLES : FROM Les noms des ensembles utilisés doivent être préfixés, dans la requête, par le caractère @. Le type d objet précédant l opérateur From est facultatif : en effet, un ensemble étant défini pour un type d objet, ce type d objet est repris par défaut. Le résultat trouvé par une requête peut être conservé, en tant qu ensemble, pendant la durée de la recherche, pour être utilisé par d autres requêtes. Les ensembles permettent notamment de restreindre la population visée de l objet cible. Ceci est utile pour optimiser les temps de réponse en n exécutant qu une fois une requête longue. Seuls les ensembles conservés peuvent être utilisés par d autres requêtes (à l exception des ensembles utilisés dans les requêtes utilisant plusieurs clauses Select ; voir la description de ces requêtes ci-après). Exemple : La requête suivante permet de rechercher les messages d un diagramme qui satisfont à une condition (opérateur "Where") à partir de l ensemble de messages "Messages_mod". select Message from @Messages_mod where condition Les ensembles sont conservés et nommés avec la commande Keep dont la syntaxe est keep @ensemble Les ensembles peuvent être supprimés avec la commande Delete. Les ensembles sont également supprimés lorsque l utilisateur ferme sa session de travail. Exemple : select Acteur into @ActeursPrincipaux where not Composé keep @ActeursPrincipaux Dans cette première requête, on fabrique l ensemble des principaux acteurs, c està-dire ceux qui ne font pas partie de la décomposition d un autre acteur, et on le conserve. Dans une autre requête, on réutilise cet ensemble et on le détruit si on n en a plus besoin. select Acteur from @ActeursPrincipaux where Diagramme.Projet = &Projet delete @ActeursPrincipaux On obtient ainsi les acteurs principaux du projet passé en paramètre. 272 MEGA Publisher

Syntaxe des recherches Ensembles : From Opérations sur les ensembles L ensemble utilisé après l opérateur "From" peut être constitué d une combinaison d ensembles conservés. Il est possible d utiliser des parenthèses ; les règles de distribution et de priorité sont les suivantes : (A or B) or C = A or (B or C) = A or B or C (A and B) and C = A and (B and C) = A and B and C (A or (B and C) = A or B and C = (A or B) and (A or C) (A and (B or C) = A and B or A and C = (A and B) or (A and C) not (A or B) = (not A) and (not B) = not A and not B not (A and B) = (not A) or (not B) = not A or not B Exemple : select Acteur from @ActeursPrincipaux and not @ActeursQualité 273

11 CONSEILS ET EXEMPLES DE REQUÊTES Conseils d utilisation à propos des requêtes Il est possible d obtenir le même résultat par des requêtes différentes. Exemples : Recherche des diagrammes d un projet décrivant un acteur : And entre deux conditions : Select Diagramme where Acteur-décrit and Projet = &Projet Requête dans un ensemble intermédiaire et restriction sur cet ensemble : Select Diagramme into @DiagrammeActeur where Acteur-décrit Select Diagramme from @DiagrammeActeur where Projet = &Projet Requête dans deux ensembles et intersection des deux ensembles : Select Diagramme into @DiagrammeActeur where Acteur-décrit Select Diagramme into @DiagrammeProjet where Projet = &Projet Select Diagramme from @DiagrammeActeur and @DiagrammeProjet Recherche des messages d un projet : Forme étendue utilisant une sous-requête Select Message where Diagramme in Diagramme where Projet = &Projet Parcours des liens Select Message where Diagramme.Projet = &Projet Requête des acteurs sans messages émis : Select Acteur where Message-émis null Select Acteur where not Message-émis Requête des diagrammes reliés à un acteur sans message reçu : Select Diagramme where Acteur.(not Message-reçu) Select Diagramme where Acteur.Message-reçu null Il est important de s assurer que la requête correspond bien à la demande souhaitée, en particulier lors de l utilisation des opérateurs "and", "not" et "or". En effet, la requête suivante : Select Acteur where not Message-reçu = "Commande" donnera tous les acteurs à l exception de ceux qui reçoivent le message "Commande". Les acteurs qui ne reçoivent pas de messages seront également inclus dans le résultat. 274 MEGA Publisher

Syntaxe des recherches Conseils et exemples de requêtes En revanche, la requête suivante : Select Acteur where Message-reçu not = "Commande" sélectionnera uniquement les acteurs récepteurs d un message, à l exception de ceux qui reçoivent le message "Commande". Pour obtenir le même résultat que précédemment, il faudrait écrire : Select Acteur where Message-reçu not = "Commande" or Message-reçu null Exemples : Recherche des messages toujours émis par un acteur : Select Message into @obl where Acteur-émetteur = &Acteur and Acteur-émetteur.Prédicat = "toujours" permet de rechercher les messages émis par l acteur saisi comme variable, et reliés à un acteur (quelconque) avec le prédicat d émission égal à "toujours". Select Message into @obl where Acteur-émetteur.(nom = &Acteur and Prédicat = "toujours") permet de rechercher les messages émis par l acteur saisi comme variable avec le prédicat d émission égal à "toujours". De même, lors du comptage des liens, il est important de s assurer de la validité du lien contrôle : Select Diagramme where Acteur.Message-émis not null having count >= 3 permet de rechercher les diagrammes pour lesquels au moins trois messages sont émis par l ensemble des acteurs qu ils contiennent. La recherche des diagrammes comprenant des acteurs émettant au moins trois messages se fera avec la requête suivante : Select Diagramme where Acteur in Acteur where Message-émis not null having count >= 3 275

11 Autres exemples de requêtes : Requête des diagrammes reliés à au moins un acteur recevant au moins un message ayant un mot-clé : Select Diagramme where Acteur.Message-reçu.Mot-Clé Requête des diagrammes reliés à un acteur ne recevant pas de messages sans mot-clé : Select Diagramme where Acteur.(not Message-reçu.(not Mot- Clé)) ou Select Diagramme where Acteur.(not Message-reçu.Mot-Clé null) Requête des diagrammes reliés à un acteur recevant des messages qui ont tous un mot-clé : Select Diagramme where Acteur.(Message-reçu and not Message-reçu.(not Mot-Clé)) ou Select Diagramme where Acteur.(Message-reçu and not Message-reçu. Mot-Clé null) Requête des diagrammes ne contenant que des acteurs recevant des messages sans mot-clé : Select Diagramme where not Acteur.(not Message-reçu.(not Mot-Clé)) Requête des diagrammes dont les acteurs reçoivent tous des messages qui ont tous un mot-clé : Select Diagramme where Acteur and not Acteur.(not Messagereçu or Message-reçu.(not Mot-Clé)) 276 MEGA Publisher

Syntaxe des recherches Conseils et exemples de requêtes Exemples de requêtes sur les nomenclatures : Requête des acteurs qui font partie du "Service Commercial" (donc qui ont pour composé le "Service Commercial") : Select Acteur where Composé = "Service Commercial" Requête de tous les acteurs qui font partie directement ou non du "Service Commercial" (donc qui ont pour composé le "Service Commercial" ou l un de ses composants) : Select Acteur where Composé deeply = "Service Commercial" Requête des acteurs qui font partie d un acteur autre que le "Service Commercial" : Select Acteur where Composé deeply not = "Service Commercial" Requête des acteurs qui ne font pas partie du "Service Commercial" : Select Acteur where not Composé deeply = "Service Commercial" Requête des acteurs qui ne sont pas composants de quelque chose ou qui font partie du "Service Commercial" : Select Acteur where not Composé deeply not = "Service Commercial" Exemples de requêtes pour MEGA Process Les exemples de requêtes qui suivent sont spécifiques à MEGA Process. Sélection de tous les acteurs d une procédure et de ses sousprocédures : Select Acteur where Diagramme.Procedure-Decrite = &Procédure or Diagramme.Procedure-Decrite.Composée = &Procédure Sélection de l approbateur d un document : Select Personne where [Document diffusé].(diffusionpersonne = "A" and nom = &Document) Sélection du service gestionnaire (acteur) de la procédure : Select Acteur where Procédure.(gestionnaire = "G" and nom = &Procédure) Sélection de tous les acteurs décrits dans les logigrammes d une procédure. Select Acteur where Diagramme.Procedure-Decrite = &Procédure 277

11 Sélection de tous les messages de type "Données Externes" d un logigramme : Select Message where diagramme = &Diagramme and typemessage = "Données Externes" Sélection de toutes les personnes dont le rôle joué pour un document n est ni "Rédacteur" ni "Vérificateur" ni "Approbateur" : Select Personne where [Document diffusé].(nom = &Document and diffusion-personne is null) Sélection de toutes les procédures Assurance Qualité d un projet : Select Projet into @Projets where composé deeply or nom &Projet Select Procédure where( projet in @Projets) and AQ- Procédure = "Assurance Qualité" Sélection des logigrammes décrivant une procédure : Select Diagramme where Procédure-Décrite = &Procédure Recherche de la fonction (acteur) du vérificateur d un document : Select Acteur where Personne.[Document diffusé].(nom=&document and diffusionpersonne="vérificateur") Sélection des organigrammes de la fonction Qualité du projet : Select Diagramme where projet.(nom = &Projet and Emploi = "Qualité") and Nature = "Organigramme" Sélection des Procédures du Projet reliées à un Chapitre de la norme : Select Projet into @Projets where composé deeply or nom = &projet Select Procédure where ( projet in @Projets) and chapitre = &Chapitre Sélection des messages événement d une opération ou reliés à une synchronisation de l opération. Select Message into @E1 where Evénement = &Opération Select Message into @E2 where Synchronisation.Opération = &Opération Select Message from @E1 or @E2 278 MEGA Publisher

Syntaxe des recherches Conseils et exemples de requêtes Sélection des messages résultat d une opération directement ou via une condition. Select Message into @R1 where résultat = &Opération Select Message into @R2 where Condition- Emettrice.Opération-Précédente = &Opération Select Message from @R1 or @R2 Sélection des organigrammes hiérarchiques et fonctionnels du projet. Select Diagramme where projet.(nom = &Projet and Emploi = B ) and Nature = "Organigramme" 279

11 280 MEGA Publisher

12 CRÉER DES CONTRÔLES DE COHÉRENCE La construction d un référentiel est soumise à des règles de modélisation. En fonction du ou des produit(s) dont vous disposez, MEGA fournit un certain nombre de règles que vous pouvez appliquer aux objets que vous créez afin de contrôler leur cohérence. Vous pouvez également en créer de nouvelles. Chaque utilisateur a la possibilité de lancer un contrôle sur un objet. Les fonctions de modification et de création de règles ou de règlements nécessitent quant à elles le module technique MEGA Supervisor ou MEGA Studio. "Rappel : principe de fonctionnement des règles", page 282 "Les règlements", page 283 "Propriétés d une règle", page 286 "Implémentation de la règle", page 289 "Domaine d application de la règle", page 287 "Définir un test d implémentation", page 292 281

12 RAPPEL : PRINCIPE DE FONCTIONNEMENT DES RÈGLES Les règles s appliquent aux objets du référentiel MEGA. Elles définissent des contrôles sur ces objets et sont implémentées par des tests ou par des macros. Voir "Implémentation de la règle", page 289. Les règles fournies par défaut sont disponibles sous la fenêtre de navigation MetaStudio, disponible uniquement avec les modules techniques MEGA Supervisor et MEGA Studio. Vous pouvez visualiser les règles en fonction des règlements ou des objets auxquels elles s appliquent. Chaque règlement permet de classer des règles selon un contexte ou un domaine précis. Vous pouvez appliquer un règlement ou un ensemble de règlements par défaut. Vous pouvez également appliquer ponctuellement un règlement aux objets du référentiel. MEGA offre une liste de règlements qui varient selon les produits que vous détenez. Dans MEGA Process, vous disposez par exemple d un règlement de type organisationnel que vous pouvez appliquer par défaut afin de contrôler le bon enchaînement des objets que vous créez. Les résultats des contrôles s affichent dans la fenêtre de propriétés des objets concernés par les règles en vigueur. Vous pouvez également afficher les résultats dans le dessin des diagrammes que vous souhaitez contrôler. Voir le guide MEGA Common Features, chapitre "Générer la documentation", paragraphe "Les règles de cohérences". Règles et descripteurs de contrôle L'utilisation des règles ne remplace pas le mécanisme de descripteur de contrôle. Ces deux outils cohabitent et se complètent. En effet, il est possible dans un descripteur de contrôle de demander l'insertion du rapport d'application des règles d'un règlement sur l'objet courant. Le descripteur de contrôle détermine l'ensemble des objets à considérer dans le contrôle et définit la mise en forme globale du rapport. Puis, pour chaque objet parcouru, il insère le ou les rapport(s) d'application des règles d'un ou de plusieurs règlement(s). On procède donc à une séparation entre le parcours du référentiel qui reste l'apanage du descripteur de contrôle et la définition des règles de modélisation. 282 MEGA Publisher

Créer des contrôles de cohérence Les règlements LES RÈGLEMENTS Un règlement permet de classer des règles selon un contexte ou un domaine précis. Il peut être constitué d un ensemble de règles mais également de sous-règlements. Afficher les règlements Activer un règlement Pour visualiser les règlements fournis dans MEGA : Sélectionnez la fenêtre de navigation MetaStudio. Cette fenêtre est disponible avec le module technique MEGA Supervisor. Dépliez le dossier "Cohérence de la base" puis "Règlement de modélisation". La liste des règlements disponibles apparaît. Pour définir un règlement actif : 1. Cliquez sur le menu Outils > Options. 2. Dans la fenêtre qui apparaît, sélectionnez Règlements de modélisation et méthodes. 3. Dans le champ Règlement de modélisation actif, cliquez sur le bouton 4. Dans la fenêtre qui s ouvre, sélectionnez le règlement voulu et cliquez sur OK. Si vous voulez appliquer plusieurs règlements, vous devez les rassembler sous un même règlement. Créer un règlement complexe Pour créer un règlement complexe : 1. Dans la fenêtre de navigation MetaStudio, ouvrez le dossier "Cohérence de la base". 2. Cliquez avec le bouton droit sur le dossier "Règlement de modélisation" et cliquez sur Nouveau > Règlement de modélisation. 3. Nommez le nouveau règlement et cliquez sur OK. Celui-ci apparaît dans le navigateur. 283

12 4. Glissez-déplacez les règlements voulus sur ce règlement. 5. Pour prendre en compte ce nouveau règlement, sélectionnez-le dans la fenêtre des options comme indiqué précédemment. Définir les règles d un règlement Les règles fournies par défaut sont disponibles sous la fenêtre de navigation MetaStudio. Vous pouvez les visualiser en fonction des règlements ou des objets auxquels elles s appliquent. Vous pouvez également afficher l ensemble des règles existantes. Elles sont précédées de l icône suivante : Lorsque vous lancez un contrôle sur un objet, vous le faites par l intermédiaire d un règlement. Pour qu une règle puisse être prise en compte dans le contrôle, il faut qu elle soit reliée au règlement appliqué. Pour relier une règle à un règlement : 1. Dépliez le dossier Cohérence de la base. 2. Recherchez la règle voulue dans l ensemble des règles ou parmi les objets auxquels elle s applique. 3. Sélectionnez la règle et glissez-la sur le règlement auquel vous souhaitez la relier. Périmètre d application d un règlement Le domaine d application d un règlement correspond aux métaclasses concernées par le règlement. Définir des métaclasses pour chaque règlement facilite le choix des règlements à appliquer sur un objet. En effet, lorsque vous lancez un contrôle sur un objet, seule la liste des règlements qui concernent l objet apparaît. Vous pouvez étendre le périmètre d application d un règlement. Vous pouvez par exemple relier la métaclasse "Processus Organisationnel" à un règlement concernant les opérations afin que ce règlement puisse s appliquer aux opérations contenues dans un Processus Organisationnel. Pour ajouter une métaclasse au domaine d application d un règlement : 1. Dans la fenêtre de navigation MetaStudio, sélectionnez le règlement en question. 2. Ouvrez sa fenêtre de propriétés. 3. Cliquez sur l onglet Domaine d application. Le premier cadre liste les métaclasses concernées. 4. Dans le second cadre, cliquez sur le bouton Relier. La fenêtre de recherche apparaît. 284 MEGA Publisher

Créer des contrôles de cohérence Les règlements 5. Sélectionnez la métaclasse à relier, par exemple, "Processus Organisationnel" et cliquez sur OK. 285

12 PROPRIÉTÉS D UNE RÈGLE Pour afficher les propriétés d une règle : 1. Dans l espace de travail de MEGA, sélectionnez la fenêtre de navigation MetaStudio. Cette fenêtre n apparaît que si vous disposez du module technique MEGA Supervisor. 2. Sous le dossier "Cohérence de la base", cliquez avec le bouton droit sur la règle en question et sélectionnez Propriétés. 3. Cliquez sur l onglet Caractéristiques. La fenêtre qui s affiche présente le nom de la règle et la ou les métaclasse(s) contrôlées par cette règle. Niveau de la règle Ce champ définit l importance de la règle. Les options possibles sont : Suggestion : règle qu il est préférable d observer mais non obligatoire. Le non-respect de la règle est précisé dans le rapport d application des règles mais n entraîne pas d avertissement. Recommandation : règle importante. Le non-respect de la règle donne lieu à un avertissement. Exigence : règle obligatoire. Le non-respect de cette règle donne lieu à une erreur et est source de blocage. La fenêtre de propriétés affiche également le test ou la macro utilisé(e) pour implémenter la règle. Voir "Domaine d application de la règle", page 287. 286 MEGA Publisher

Créer des contrôles de cohérence Domaine d application de la règle DOMAINE D APPLICATION DE LA RÈGLE Une règle porte sur une méta-classe. Par défaut, elle peut être appliquée à tous les objets de cette métaclasse. Pour autant, il est parfois necessaire de définir plus précisément le domaine d application d une règle. Restreindre le domaine d application Considérons l exemple de la règle suivante : "Un acteur externe ne peut exécuter une opération". Cette règle n a de sens que pour les acteurs externes. Il convient donc de restreindre le domaine d application de cette règle portant sur la méta classe acteur, afin qu elle ne s exécute que pour les acteurs de type externe. Pour cela, vous devez créer un test filtrant le domaine d application de la règle. Par exemple, dans la règle, vous allez définir un filtre afin que la règle ne s applique pas à tous les acteurs mais uniquement à ceux de type externe. Si le test filtrant est avéré, autrement dit s il s agit d un acteur externe, le test d implémentation s exécute. Il est possible d utiliser plusieurs tests filtrants. Dans ce cas, la règle s applique si tous les tests filtrants sont vrais. Voir "Définir un test d implémentation", page 292. Etendre le domaine d application Certaines règles très particulières peuvent s appliquer à plusieurs méta-classes. Prenons l'exemple de la règle "Les objets importants doivent avoir un commentaire". Les méta-classes considérées comme "importantes" sont le processus, l acteur, le Processus Organisationnel, l application, etc. Pour chacune de ces méta-classes, la condition appliquée est : " Le commentaire ne doit pas être vide". Créer une règle pour plusieurs méta-classes n'a de sens que si la condition qu'on applique est valable quelque soit la méta classe. Dans notre exemple, la condition fait référence au commentaire qui est une propriété de toutes les méta-classes, et donc de toutes celles concernées par la règle. 287

12 Conditionner l application d une règle Dans le règlement de modélisation autour des processus, deux règles ont été définies pour la méta-classe "Opération" : Une opération doit être réalisée par un acteur Une opération doit être réalisée par un seul acteur Pour des raisons pédagogiques, ces deux contraintes n'ont pas été regroupées en une seule (une opération doit être réalisée par un et un seul acteur). Cependant, il est évident que si la première règle n'est pas vérifiée, la seconde ne présente aucun intérêt. C est pourquoi on a fait en sorte que l'application de la seconde règle dépende de la vérification de la première. En d'autres termes, la seconde règle ne sera appliquée que si la première a été vérifiée. Ouvrez tour à tour la fenêtre de propriétés de ces deux règles et cliquez sur l onglet Compléments. Vous constatez que : La règle "Une opération doit être réalisée par un seul acteur" est conditionnée par la règle "Une opération doit être réalisée par un acteur". La règle "Une opération doit être réalisée par un acteur" conditionne la règle "Une opération doit être réalisée par un seul acteur". 288 MEGA Publisher

Créer des contrôles de cohérence Implémentation de la règle IMPLÉMENTATION DE LA RÈGLE Une règle peut être implémentée par un test ou par une macro. L utilisation des tests d implémentation est à privilégier, celle des macros intervient généralement dans les cas complexes. Si les règles sont utilisables par tous les utilisateurs, la création d un test d implémentation requiert quant à elle des connaissances avancées et suppose que vous soyez en mode d accès "Avancé". Dans la barre d outils MEGA, cliquez sur le menu Outils > Options. Dans la fenêtre qui apparaît, cliquez sur Référentiel. Dans l option Accès au métamodèle, sélectionnez le mode "Avancé". Implémenter une règle par un ou des tests Un test exprime une condition sous la forme d une expression. Implémenter une règle de modélisation à l'aide d'un test consiste à relier ce test à la règle. Pour un objet donné, la règle de modélisation est vérifiée si l'application du test qui l'implémente retourne la valeur "vrai ". Vous pouvez relier plusieurs tests à une règle. Dans ce cas, le champ Opérateur Logique offre deux options possibles : Et : la règle n est vérifiée que si tous les tests sont positifs. Ou : un test suffit à vérifier la règle. Par exemple, la règle "Un message doit avoir un émetteur et un récepteur" est implémentée par deux tests : Un test pour vérifier l origine du message Un test pour vérifier la destination du message L opérateur logique de la règle est "Et", ce qui indique que les deux tests doivent être positifs pour que la règle puisse être vérifiée. 289

12 Un test est également utilisable dans plusieurs règles. Pour créer un test d implémenation, voir "Définir un test d implémentation", page 292. Implémenter une règle par une macro La macro est écrite en VBScript et utilise les APIs MEGA. Pour définir une macro implémentant une règle : Cliquez avec le bouton droit sur la règle. Sélectionnez Nouveau > Macro d implémentation. Une macro est créée et les fonctions à implémenter sont automatiquement déclarées. Voici le détail de ces fonctions : Sub RuleAppliableIs (otoberuled as MegaObject, orule as MegaObject, sparameter as String, bruleappliableis as Boolean) Sub RuleApply (otoberuled as MegaObject, orule as MegaObject, sparameter as String, bruleresult as Boolean) "orule" est la règle de modélisation implémentée. La fonction RuleAppliableIs devra retourner "vrai" dans la variable "bruleappliableis" si "otoberuled" est un projet racine. Sinon, elle retournera "faux". La fonction RuleApply devra retourner "vrai" dans la variable "bruleresult" si "otoberuled" est relié à un projet type. La fonction "RuleAppliableIs" est optionnelle. Si elle n'est pas définie, la règle est implicitement applicable à toutes les instances de la méta-classe (ce qui est le cas de la majorité des règles). Une autre fonction peut être implémentée si on souhaite maîtriser le contenu du texte qui est inséré dans le rapport détaillé lorsque la règle n'est pas vérifiée : Sub RuleWithReportApply (otoberuled, orule, sparameters, bruleresult, serrorreport) Cette fonction est appelée lors de la construction du rapport détaillé. Le dernier paramètre permet de renvoyer un diagnostic d'erreur précis et adapté au traitement réalisé. Test ou macro d implémentation? Prenons l'exemple de la règle "Un projet racine n'a pas de projet type". 290 MEGA Publisher

Créer des contrôles de cohérence Implémentation de la règle Cette règle porte sur la méta-classe "Projet", plus précisément sur les projets racines. Pour implémenter cette règle il s'agit dans un premier temps de réduire le domaine d'application de la règle. Ensuite, il faudra réaliser le test "ce projet n'est pas relié à un projet type". Si on utilise les tests expressions pour définir cette règle, nous devons créer deux tests expressions : Un pour tester si le projet est racine, permettant de filtrer le domaine d'application de la règle. Un autre pour tester si le projet est relié à un projet type, servant à implémenter la règle. Si on utilise une macro, il nous faut implémenter deux fonctions : RuleAppliableIs => cette fonction permet de restreindre le domaine d'application de la règle. RuleApply => cette fonction permet de définir l'implémentation de la règle. 291

12 DÉFINIR UN TEST D IMPLÉMENTATION Un test peut être implémenté par une expression ou une macro. L utilisation des expressions est privilégiée, celle des macros intervient généralement dans les cas complexes. Si les règles sont utilisables par tous les utilisateurs, la création d un test d implémentation requiert quant à elle des connaissances avancées et suppose que vous soyez en mode d accès "Expert". Dans la barre d outils MEGA, cliquez sur le menu Outils > Options. Dans la fenêtre qui apparaît, cliquez sur Référentiel. Dans l option "Accès au métamodèle", sélectionnez le mode "Expert". Définir un test d implémentation par une expression Dans la page de propriété du test, l onglet Caractéristiques présente l'ensemble des MetaAssociationEnds et des MetaAttributes de la méta-classe testée. Par glisser-déplacer, vous pouvez poser dans l expression du test les informations du référentiel à tester. 292 MEGA Publisher

Créer des contrôles de cohérence Définir un test d implémentation Pour information, la syntaxe de l expression du test est la même que celle qui permet de définir des conditions dans les paramétrages des pages de propriétés. Voir l article technique "Property pages". Vous pouvez décrire un test par des expressions et par les fonctions décrites cidessous. Expression et opérateur logique L expression d un test est composé d'expressions. Ces expressions peuvent être logiquement combinées avec des " () " ainsi que des opérateur logiques. Les opérateurs logiques disponibles sont : And et Xor Xor est le "Or" exclusif, c'est-à-dire "vrai quand une et une seule des expressions combinées est vraie". Il est aussi possible d'utiliser le not pour obtenir la négation d'une expression Exemple : (Expression1 and Expression2) or not Expression3 Attribut et opérateur de comparaison L expression d un test peut être définie à l'aide de différentes fonctions et d opérateurs de comparaison. Les opérateurs de comparaison sont : = <> > < >= <= Ces opérateurs de comparaison peuvent être utilisés pour définir une expression à partir de la valeur d'un des MetaAttributes de la méta-classe testée : Attribute opérateur Value Exemple Pour un acteur, l'expression : Internal/External = "X" Retourne "vraie" si l'attribut Internal/External vaut "X" et faux sinon. (Rappel : on utilise ici un attribut à valeurs tabulées et donc on teste sa valeur interne). Pour une opération, l'expression : Durée >= 40 Retourne "vraie" si l'attribut Durée est supérieur ou égal à 40. Naturellement, les opérateurs >, <, <=, >= n'ont de sens que pour des attributs dont le type permet une comparaison de la sorte. Attention : en procédant de la sorte, on ne peut tester que les attributs de la métaclasse testée. Pour pouvoir manipuler l attribut d'un lien partant de la méta-classe, il faut utiliser les fonctions TrueForEach() et TrueForOne() qui sont présentées par la suite. 293

12 Fonction ItemCount() et opérateur de comparaison Les opérateurs de comparaison peuvent aussi être utilisés pour définir une expression à partir de la fonction ItemCount. Cette fonction retourne le nombre d'objets trouvés au bout de la MetaAssociationEnd ou retournés par le sélecteur : ItemCount(LegSel) Où LegSel est un champ représentant une MetaAssociationEnd ou un Sélecteur. Exemple Pour un acteur, l'expression : ItemCount(Operation)>2 Retourne "vraie" si l'acteur est relié à strictement plus de 2 opérations. Il est possible d'utiliser un raccourci pour tester si un objet au moins est relié par une patte. Ainsi, pour un acteur, l'expression : Operation="" Retourne "vraie" si aucune opération n est reliée. Operation<>"" Retourne "vraie" si au moins une opération est reliée. Naturellement, l'utilisation d'un sélecteur dans la fonction ItemCount() implique que le sélecteur parte de l'objet couramment testé ou que celui-ci n'ai besoin d'aucun objet en entrée. Fonctions TrueForEach() et TrueForOne() Ces fonctions permettent de définir une expression portant sur un ou des objet(s) au bout d'une MetaAssociationEnd ou d'un sélecteur. TrueForEach retourne "vraie" si l'expression est vraie pour tous les objets trouvés au bout de la MetaAssociationEnd ou retournés par le sélecteur. Si aucun objet n'est trouvé ou retourné, cette fonction retourne "vraie". TrueForOne retourne "vraie" si l'expression est vraie pour au moins un des objets trouvés au bout de la MetaAssociationEnd ou retournés par le sélecteur. Si aucun objet n'est trouvé ou retourné, cette fonction retourne "faux". TrueForEach(LegSel, Expression) TrueForOne(LegSel, Expression) Où LegSel est un champ représentant une MetaAssociationEnd ou un Sélecteur. Exemple Pour un acteur, l'expression : TrueForEach (Operation, Durée >= 40) Retourne "vraie" si l'acteur n'est relié qu'à des opérations dont la durée est strictement supérieure à 40 ou si l'acteur n'est relié à aucune opération. 294 MEGA Publisher

Créer des contrôles de cohérence Définir un test d implémentation Pour un Processus Organisationnel, l'expression : TrueForOne (Org-Unit, RACI = "R" or RACI = "E") Retourne "vraie" si le Processus Organisationnel est relié à au moins un acteur, avec l'attribut de lien RACI dont la valeur interne vaut "R" ou "E". Vous remarquez ici que lorsqu'on utilise les fonctions TrueForEach et TrueForOne avec une MetaAssociationEnd, il est possible d'utiliser dans l'expression : Les attributs du lien Et/ou Les attributs de l'objet au bout du lien Naturellement il est possible, dans l'expression utilisée par une fonction TrueForEach ou TrueForOne, d'utiliser à nouveau une de ces deux fonctions afin de parcourir une nouvelle MetaAssociationEnd ou de déclencher un nouveau sélecteur. Dans la page de propriétés du test d implémentation, l'arbre présentant l'ensemble des MetaAssociationEnds et des MetaAttributes permet de naviguer en profondeur sur le méta modèle. Il est ainsi possible de glisser-déplacer un des attributs d'un objet au bout d'une MetaAssociationEnd. Autres fonctions disponibles ItemExist(LegSel, Object) 295

12 Où LegSel est un champ représentant une MetaAssociationEnd ou un Sélecteur. Cette fonction retourne "vraie" si l'objet cité est relié à travers la MetaAssociationEnd identifiée ou fait partie de l'ensemble des objets retournés par le sélecteur. Availabe(Object) Cette fonction retourne "vraie" si l'objet cité existe. Définir un test d implémentation par une macro La macro est écrite en VBScript et utilise les APIs MEGA. Pour définir une macro dans un test : Ouvrez la fenêtre de propriétés du test. Cliquez sur l onglet Avancé. Reliez la macro au test. Cette macro doit exposer la fonction : Sub TestApply(oToBeTested as MegaObject, ometatest as MegaObject, sparameter as string, btestresult as boolean) où : "otobetested" est l objet MEGA. ometatest est le test implémenté. "sparameter" est la valeur de l'attribut chaîne du lien entre le test et la macro. "bruleresult" est le résultat de l'application du test. "sparameter" est un paramètre fourni à la macro. Il s'agit de la valeur de l'attribut "Macro Parameter" qui peut être renseigné sur le lien entre le test et la macro. Ce paramètre peut permettre de définir des macros génériques, utilisables pour implémenter plusieurs tests. 296 MEGA Publisher

13 LES ANALYSES TYPES MEGA fournit des analyses qui permettent d obtenir une vue détaillée d un groupe d objets et de leurs interactions. Chaque analyse est reliée à une analyse type. MEGA fournit des analyses types prédéfinies propres à chaque produit de la suite; analyses des processus, analyses des architectures applicatives, analyse des risques etc. Vous pouvez de même créer vos propres analyses types. Pour plus de détails sur l utilisation des analyses, voir le guide MEGA Common Features, chapitre "Générer la documentation", paragraphe "Générer des rapports d analyse". Les points traités ici sont : "Créer une nouvelle analyse type", page 298 "Règles de modélisation des analyses", page 301 297

13 CRÉER UNE NOUVELLE ANALYSE TYPE Une analyse type spécifie les paramètres sur lesquels se base l'analyse. Une analyse type est caractérisée par des paramètres et des macros définissant les types de rapports à générer. Pour créer une nouvelle analyse type : 1. Dans l'onglet Utilitaires, sélectionnez le dossier correspondant à l analyse type que vous souhaitez créer. Les dossiers correspondent à différents domaines. 2. Dans le menu contextuel du dossier sélectionné, cliquez sur Nouveau > Analyse type. 3. Indiquez le nom de l analyse et éventuellement un commentaire. 4. Cliquez sur Suivant. 5. Sélectionnez le type d analyse : Elémentaire, Propriété, Case à cocher, Intersection. 6. Cliquez sur Suivant. 7. Créez les paramètres de l analyse type. 8. Cliquez sur Suivant. Un éditeur apparaît pour vous permettre de modifier le code de l analyse. Définition des paramètres d'analyse Les paramètres d une analyse définissent les éléments nécessaires à la réalisation de l analyse. Sur chaque paramètre, vous allez indiquer les types d objets qu il est possible d instancier pour l analyse. Par exemple, pour un paramètre nommé "Architecture applicative", vous pouvez relier un dossier d'applications, une application, une requête retournant des applications. Un paramètre qui ne spécifie pas de métaclasse peut être instancié avec n'importe quel objet MEGA. Chaque paramètre d'une analyse type définit une multiplicité indiquant s'il est possible de relier à une analyse donnée plus d'une valeur pour le paramètre en question. Si la multiplicité est 1 ou 0..1, une seule valeur de paramètre peut être reliée. Pour créer un nouveau paramètre : 1. Dans le menu Outils > Options de MEGA, dossier Référentiel, vérifiez que l option Accès au métamodèle est en mode "Expert". 2. Sélectionnez l analyse type. 3. Ouvrez son menu contextuel et cliquez sur Nouveau > Paramètre d analyse. La fenêtre de création de paramètre apparaît. 4. Indiquez le nom du paramètre. 5. Précisez sa Multiplicité. 298 MEGA Publisher

Les analyses types Créer une nouvelle analyse type 6. Dans le cadre Type du paramètre d'analyse, reliez les métaclasses qui peuvent définir le paramètre. Les types de paramètre correspondent à des valeurs d analyse. Aussi les métaclasses assignées doivent-elles hériter de la métaclasse abstraite "Valeur d'analyse". Définition des rapports d'analyse La mise en relation des paramètres s effectue dans un rapport d analyse. Une analyse type doit fournir au moins un rapport. Chaque rapport est défini par une macro d'analyse, reliée à l analyse type par l intermédiaire d un générateur de rapport. Prenons l exemple de l analyse type "Compatibilité des infrastructures". Cette analyse type permet l'analyse des infrastructures techniques impliquées dans un système d'information. Elle sert par exemple à montrer le niveau d'utilisation d'un ensemble de technologies ou la compatibilité d'un ensemble de sous-systèmes d'information avec un groupe d'infrastructure technique. Cette analyse type génère trois rapports : Données analysées Compatibilité des infrastructures Niveau d'utilisation des infrastructures Ces trois rapports sont définis respectivement dans l'analyse type par les macros : Analysis - Set of parameters Analysis - Infrastructure Compliance Analysis - Infrastructure Usage 299

13 Pour la construction de vos rapports, vous pouvez utiliser une macro existante. MEGA fournit notamment la macro " Analysis - Set of parameters" qui décrit les paramètres de l analyse type et la façon dont ils sont interprétés par le rapport. Les macro ont un commentaire disponible sous forme de note système. Vous pouvez également créer de nouvelles macros d'analyse. Créer une macro d analyse Une macro d analyse se crée par l intermédiaire d un générateur de rapport. Pour créer une macro d analyse : 1. Dans le menu Outils > Options de MEGA, dossier Référentiel, vérifiez que l option Accès au métamodèle est en mode "Expert". 2. Sélectionnez l analyse type sur laquelle porte la macro. 3. Ouvrez son menu contextuel et cliquez sur Nouveau > Générateur de rapport d analyse. 4. Sélectionnez le générateur créé. 5. Dans son menu contextuel, cliquez sur Nouveau > Macro d'analyse. La macro apparaît dans le navigateur sous le nom de l analyse type. Vous avez la possibilité de créer des macros en VB/VB Script ou Java. Macros VB/VB SCript Les macros VB/VB Script utilisent le moteur d analyse écrit en VB. Afin de rendre la plateforme plus évolutive, le moteur d analyse a été réécrit en Java et adapté pour répondre à plusieurs cibles de génération (HTML, PDF, RTF ). Il est donc fortement conseillé d écrire toute nouvelle analyse en Java. Cependant, les analyses VB et VB Script continuent de fonctionner et cohabitent avec des rapports écrits en Java. Si vous désirez créer votre rapport en VB Script (VB est fortement déconseillé car non compatible 64 bits), deux fonctions sont nécessaires à l exécution du rapport : La fonction "getanalysistitle" qui indique le nom de l'analyse. La fonction "getanalysisreport" qui retourne un rapport HTML fondé sur l'analyse donnée. Macros JAVA Pour la création de macro Java, voir l article technique "Writing Java analysis reports". Chaque macro doit définir au moins un format de rapport. Une macro qui n'est reliée à aucun format de sortie ne génère pas de rapport. MEGA fournit un ensemble d'api qui permettent de manipuler le moteur d'analyse. Voir les guides des API pour les analyses VBS. Une aide sur les API Java livrées avec le produit MEGA est disponible au format JavaDoc. Pour activer cette aide : 1. Dépliez le dossier "<MEGA Installation>\java\doc". 2. Décompressez le fichier "mj-api.doc.zip" dans le répertoire partagé. 3. Ouvrez la la page "index.html" et le guide Java pour les analyses Java. 300 MEGA Publisher

Les analyses types Règles de modélisation des analyses RÈGLES DE MODÉLISATION DES ANALYSES La définition de nouvelles analyses types nécessite de respecter des règles de modélisation qui garantissent le fonctionnement et la cohérence des analyses issues de ces modèles. Rappel des concepts Une règle s applique à un objet du référentiel MEGA et définit un contrôle sur cet objet. Les règles sont classées dans des règlements en fonction d un contexte ou d un domaine précis. Les règles propres aux analyses sont répertoriées dans le règlement "Règlement des analyses". Vous pouvez accéder à ce règlement dans la fenêtre de navigation MetaStudio, sous le dossier Cohérence de la base. Vous pouvez définir un règlement actif, visible en permanence sur les analyses et analyses types que vous créez. Vous pouvez également appliquer un règlement de façon temporaire sur une analyse afin de vérifier sa conformité. Pour plus de détails sur les règles, voir le guide MEGA Common Features, chapitre "Générer la documentation", paragraphe "Contrôler des objets". Règles de modélisation des analyses Il existe des règles portant sur l utilisation des analyses et des règles portant sur la définition des analyses types. Lorsque vous créez une analyse type vous devez respecter les règles suivantes : Une analyse type doit fournir au moins un rapport : une analyse type doit fournir au moins un générateur de rapport. L analyse type n'a aucune utilité si elle ne fournit pas de générateur de rapport. La macro de rapport doit faire partie des macros proposées : une analyse est liée à des générateurs permettant de créer des rapports basés sur les valeurs des paramètres. Ces générateurs doivent être déclarés comme valides pour l analyse type de l'analyse. Chaque macro de rapport doit fournir au moins un format de rapport : les analyses sont liées à des générateurs de rapport définis dans l'analyse type. Pour chacun de ces générateurs, au moins un format doit être sélectionné. Sinon, le générateur doit être délié. Un générateur qui n'est relié à aucun format de sortie ne génère pas de rapport. Le type de la valeur doit être compatible avec le paramètre : Le type d'une valeur d'analyse doit être défini comme un type valide du 301

13 paramètre correspondant ou doit être compatible avec les types valides du paramètre (dans le cas d'un type abstrait). Le paramètre doit appartenir à l analyse type : une analyse est basée sur une analyse type qui définit un ensemble de paramètres. Les valeurs de paramètres doivent être liées à l'un de ces paramètres. Les requêtes doivent renvoyer les objets appropriés : si la valeur d'un paramètre est une requête, la requête doit renvoyer des objets dont le type correspond aux types disponibles dans l'analyse. 302 MEGA Publisher

Quatrième Partie : Glossaire et Index 303

304 MEGA Publisher

14 GLOSSAIRE administrateur attribut caractéristique description document L administrateur est un utilisateur auquel sont donnés des droits d accès étendus : d une part, le droit d administrer les bases par l intermédiaire de l application d administration ; d autre part, le droit de créer et de modifier des éléments tels que les descriptions et les documents types. Voir caractéristique. Une caractéristique est un attribut décrivant un type d objet ou un lien. Exemples : la caractéristique Type-flux sur Message permet de préciser si ce Message est un flux d information, de matières ou un flux financier ; la caractéristique Prédicat sur le lien Emission entre Message et Acteur permet de préciser la condition d émission du Message. Une caractéristique peut également être appelée Attribut. Une description permet d éditer sous forme de document une partie du contenu de la base. La description d un objet comprend des caractéristiques propres à cet objet auxquelles peuvent être ajoutées des caractéristiques des objets qui lui sont reliés directement ou indirectement. Une mise en forme est saisie pour chacun des objets rencontrés sous forme de texte à l aide de MS- Word. Une description peut être utilisée telle quelle pour produire des rapports, ou être insérée dans des documents ou des documents types. Il est possible d'en créer ou modifier avec le module technique MEGA Publisher - Documentation. Les documents gérés par MEGA sont des objets permettant de transmettre sous forme écrite un ensemble de connaissances extraites des données de conception gérées par le logiciel. 305

14 document type Un document type est une structure formalisée possédant un certain nombre de caractéristiques susceptibles d être reproduites lors de la production de documents. On peut créer ou modifier un document autant de fois que nécessaire ; cependant si on doit produire plusieurs documents du même type, il est préférable d utiliser un document type à la création de chaque document. Un document type constitue le squelette du document, qui sera étoffé, lors de la création d un document, avec les données contenues dans la base. Il contient la mise en page, les en-têtes et pieds de page, des textes d accompagnement saisis sous MS- Word et des rapports types permettant de mettre en forme les données extraites de la base. Il permet ainsi d obtenir rapidement le ou les documents associés aux principaux objets de la base. ensemble feuille de style fonctionnalité groupe Un ensemble est une collection d objets possédant des caractéristiques communes. Par exemple, on peut constituer l ensemble des messages émis ou reçus par un acteur de l entreprise. Ces ensembles sont généralement constitués à l aide de requêtes et peuvent être manipulés par l intermédiaire de la plupart des fonctionnalités du logiciel. Une feuille de style regroupe des règles de présentation qui peuvent être appliquées à des éléments d'une page Web. Ces règles sont exprimées dans le langage Cascading Style Sheet (CSS). Pour de plus amples informations, se référer aux recommandations du W3C, World Wide Web Consortium (http://www.w3.org). Une fonctionnalité est un moyen proposé par le logiciel pour effectuer certaines actions. Parmi les fonctionnalités proposées en standard, se trouvent l éditeur de formes et l éditeur de descriptions. L arbre de description d un objet, disponible avec le module technique MEGA Publisher - Documentation, est constitué de plusieurs groupes qui s enchaînent. Chaque groupe porte sur un objet et précise la requête ou le lien qui permet de passer de l objet précédent à cet objet. A un groupe peuvent être accrochés des textes ainsi que d autres groupes. Il est possible de définir l ordre de parcours des groupes et des textes. 306 MEGA Publisher

Glossaire identifiant absolu lien matrice MetaClasse métamodèle modèle Un identifiant absolu est une chaîne de caractères associée à chacun des objets de la base. Cette chaîne de caractères est calculée à partir de la date d ouverture de la session, du nombre d objets créés depuis le début de la session et de la date de création de l objet (en millisecondes). Elle permet d identifier de manière unique un objet de la base de manière à pouvoir modifier son nom tout en conservant tous ses liens vers d autres objets. Un lien est une association entre deux types d objets. Il peut y avoir plusieurs liens possibles entre deux types d objets (Ex : Emission et Réception entre Acteur et Message). Une matrice est un tableau constitué de lignes et de colonnes contenant des objets issus de la base de données. Elle offre un résumé des liens qui existent entre deux ensembles d objets et permet de créer ou couper des liens sans être obligé d ouvrir des diagrammes proprement dits. Par exemple, il est possible de constituer une matrice présentant les messages émis par les différents acteurs d un projet. voir "type d objet". Le métamodèle est la structure de mémorisation des données gérées dans une base. Le métamodèle est enregistré dans la base système de l environnement. Le métamodèle regroupe l ensemble des types d objets permettant de modéliser un système, ainsi que leurs caractéristiques et les liens possibles entre ces types d objets. Il permet ainsi de construire des modèles décrivant l organisation ou le système d information d une entreprise ou d une administration. Il est possible de faire des extensions au métamodèle pour gérer de nouveaux types d objets. Les bases qui échangent des données (exportation, importation, extraction, etc.), doivent avoir un métamodèle identique sous peine de ne pouvoir accéder à certaines données. Les types d objets contenus dans le métamodèle sont aussi appelés MetaClasses ; leurs caractéristiques sont appelées attributs. Un modèle de conception est une structure formalisée qui permet de représenter l organisation d une entreprise ou de son système d information. Dans une autre acception, un modèle peut être utilisé pour servir de moule pour la reproduction d objets possédant des caractéristiques similaires. C est le cas des documents types, des modèles de matrice et des rapports types. 307

14 nomenclature rapport rapport type référence externe requête style Une nomenclature est un lien entre deux objets de même type comme par exemple le lien de composition entre projets qui permet de définir des sous-projets. Un rapport est une requête effectuée à travers le référentiel pour en extraire un ensemble d objets mis en forme pour un logiciel de traitement de texte. Un rapport est constitué d une requête pour la recherche des objets à décrire, associée à une description pour leur mise en forme. Le texte du rapport sera modifié lors du rafraîchissement du document. On peut faire apparaître le texte de définition du rapport en sélectionnant la commande de Word Affichage, Codes de champs ou <Alt>+ <F9> ou Alt + F9. Un rapport type est une structure formalisée possédant des caractéristiques susceptibles d être reproduites lors de la production de rapports insérés dans un document. Un rapport type, inséré dans un document type, est constitué d une requête pour la recherche des objets à décrire, associée à une description pour leur mise en forme. Il est transformé en rapport lors de la création d un document à partir de ce rapport type. Une référence externe permet d'associer un objet à un document qui provient d'une source extérieure à MEGA. Il peut s agir de réglementations concernant la sécurité ou l'environnement, des textes de loi, etc. L'emplacement de ce document peut être indiqué comme le chemin d'un fichier ou l'adresse d'une page WEB, par l'intermédiaire de son URL (Universal resource Locator). Une requête est un dispositif permettant de sélectionner un ensemble d objets d un type donné à l aide d un ou plusieurs de critères de recherche. Les ensembles ainsi constitués peuvent être manipulés par la plupart des fonctionnalités du logiciel. On peut par exemple utiliser une requête pour trouver l ensemble des acteurs de l entreprise intervenant dans un projet. Un style est une mise en forme particulière que l on peut appliquer à un paragraphe d un texte édité avec un logiciel de traitement de texte. Il permet d appliquer de manière systématique des caractéristiques telles que le choix de la police de caractère, les marges ou l indentation, etc. Un certain nombre de styles sont proposés spécialement pour le paramétrage des documents. Ils sont préfixés par M-... et basés sur M - Normal, semblables au style Normal de Word, avec des caractères bleus. Une feuille de style appelée Megastyl.dot est fournie à cet effet. 308 MEGA Publisher

Glossaire texte type d objet variable Un texte peut être associé à chacun des objets rencontrés lors du parcours d une description d un objet (module technique MEGA Publisher - Documentation). Ce texte est mis en forme pour MS-Word. Il présente ce qui sera affiché pour chacun des objets présents dans le document généré. Dans un texte, on peut insérer le nom de l objet, ses différentes caractéristiques, ainsi que son commentaire. Il est également possible d y insérer les caractéristiques d autres objets reliés à cet objet. Un type d objet (ou MetaClasse) est la portion de la base de données contenant les objets d un type donné. Les objets créés sont regroupés dans la base de données par type. Cette notion est utilisée lors de la recherche d objets dans la base et lors de l extension du métamodèle à un nouveau type d objet. Ex : Message, Acteur, etc. Une variable est un paramètre dont la valeur n est déterminée que lors de l exécution de la fonction à laquelle elle est associée. Il est possible d utiliser des variables pour conditionner une requête (avec le module technique MEGA Publisher - Documentation). A l exécution, une fenêtre demandera la saisie de ces variables, en présentant un champ par variable définie dans la requête. 309

14 310 MEGA Publisher

INDEX *................................ 263!................................. 263 " "................................ 263 #................................. 263 &................................. 263.CHI............................... 133.css............................... 164.mth.......................... 146, 177.SVG.............................. 151 /* */.............................. 263 /C................................ 192 /i................................. 205 /n................................ 205 /t................................. 205 /u................................ 205 < >............................... 263 @................................. 263 [ ]................................ 263 [CL]............................... 194 [CLP].............................. 194 adresse email............................207 relative site Web.......................173 affichage codes de champ..................... 98 règle............................284 aide requêtes..........................244 aide HTML..........................126 ajouter variable.......................... 94 analyse règle de modélisation.................301 type.............................298 And...............................262 and requête...........................238 après texte............................ 58 assistant recherche.........................234 attribut condition..........................268 définition.........................305 objet source.......................270 attribut de lien.......................269 avant groupe........................... 60 texte............................ 58 A B actualiser rapport........................... 31 balise constituant........................192 311

Index context.......................... 198 description HTML................... 189 dessin........................... 195 ObjectPicture...................... 199 propriété......................... 190 WebObjectCollection................. 196 workflow......................... 197 barre menu paramétrer..................... 200 recherche......................... 227 barre d outils édition de document.................. 29 Between........................... 262 bloc description......................... 72 BMK.............................. 191 BODY mise en forme..................... 123 bookmark description HTML................... 184 Bookmark (BMK) attribut de propriété................. 191 bordure menu site Web....................... 148 buffer............................. 207 C cadre cible............................ 149 contenu site Web................... 150 HTML............................ 163 menu........................... 150 candidat recherche objet......................... 255 caractère mise en forme document...................... 102 caractère / description HTML................... 188 caractère générique.................. 268 caractéristique définition......................... 305 modifier sélection....................... 252 non renseignée..................... 147 caractéristiques site Web......................... 147 carte du site indiquer.......................... 145 modèle........................... 146 modifier.......................... 171 personnaliser...................... 177 casse fichiers HTML...................... 171 cataloguée requête.......................... 243 catégorie description HTML.................... 182 objet.............................39 champ référence externe.................... 91 requête.......................... 245 chemin relatif site Web.......................... 173 cible recherche......................... 225 synchroniser recherche...................... 257 code rapport............................ 32 requête afficher........................ 239 code template souche........................... 201 codes de champ affichage..........................98 cohérence contrôle.......................... 281 colonne résultat de recherche................. 249 commandes requête.......................... 262 commentaire conserver mises en forme............. 104 description......................... 57 requête.......................... 260 compiler site Web.......................... 126 complet commentaire....................... 57 complète page HTML......................... 186 composition site Web.......................... 120 compte-rendu site Web.......................... 179 conclusion texte.............................58 condition attribut.......................... 268 attribut d objet source................ 270 attribut de lien..................... 269 312 MEGA Publisher

Index exécution description HTML................. 203 texte........................... 61 existence lien........................... 269 groupée.......................... 270 lien............................. 268 Where........................... 266 configurer document type...................... 40 conserver document.......................... 27 requête récente.................... 241 constituant balise............................ 192 imbriqué......................... 196 propriétés balise......................... 194 contenu cadre site Web....................... 150 Context balise............................ 198 contextuel description RTF...................... 54 contrôle analyse.......................... 301 description HTML document...................... 208 syntaxe.......................... 264 contrôler cohérence........................ 281 nom fichiers HTML.................... 171 copier description......................... 70 références externes.................. 173 corps mise en forme..................... 123 page HTML......................... 186 couleur lien visité......................... 168 site Web.......................... 150 fond.......................... 168 lien........................... 168 texte.......................... 168 courrier électronique site Web...................... 206, 207 CP................................ 194 créer document type...................... 33 site Web sans modèle.................... 117 site Web type...................... 134 style description......................107 insérer variable................... 94 variable.......................... 93 critère ordre texte.......................... 81 recherche assistant.......................234 cumuler résultat...........................247 D Deeply.............................262 définir variable.......................... 93 Delete.............................262 délier description........................ 78 déplacer site Web..........................170 description ajouter........................... 77 blocs............................ 72 créer............................ 54 définition.........................305 délier............................ 78 diagramme........................ 74 dupliquer......................... 70 éditeur........................... 54 exécuter.......................... 63 HTML............................181 impression diagramme..................... 75 macro............................ 72 mémoriser objets......................... 64 personnaliser...................... 53 rapport........................... 35 références externes.................. 90 suffixe et préfixe.................... 70 vérifier...........................100 description HTML balises spécifiques...................189 bookmark.........................184 catégorie.........................182 condition d exécution.................203 email............................207 forme étendue......................188 forme réduite......................188 groupe...........................184 insérer dessin......................195 313

Index multilinguisme..................... 206 numéro de ligne.................... 188 résultat.......................... 184 structure......................... 184 variable.......................... 196 dessin balise........................... 195 diagramme description......................... 74 échelle site Web....................... 150 impression description...................... 75 ordre............................. 81 orientation......................... 76 page............................. 76 page blanche....................... 75 réduction automatique................. 76 disponiblilté objet............................ 202 document actualiser.......................... 31 contrôle personnaliser.................... 208 créer............................. 27 définition......................... 305 éditer............................ 28 envoi personnaliser..................... 45 image objet.......................... 83 modifier........................... 28 nom limite.......................... 27 personnaliser....................... 21 référence externe.................... 73 document type configuration....................... 40 créer............................. 33 définition......................... 306 dupliquer.......................... 66 extraire........................... 39 modifier........................... 35 par défaut......................... 40 sauvegarder........................ 39 document type automatique accéder........................... 41 création........................... 41 gérer............................. 41 rendre privé........................ 42 structure.......................... 43 document type privé................... 41 rendre public....................... 42 supprimer......................... 43 documentation restituer les mises en forme............ 102 dossier contrôle personnaliser.................... 208 fichiers HTML...................... 171 site Web.......................... 145 Draw balise SvgBubble...................... 196 dupliquer description......................... 70 document type......................66 site Web type...................... 138 E échelle diagramme site Web....................... 150 éditer document..........................28 éditeur de descriptions.................54 éditeur de texte conserver mises en forme............. 104 élémentaire description RTF...................... 54 else HTML............................ 204 email site Web...................... 206, 207 embarquée requête........................... 60 enregistrer description......................... 70 requête.......................... 240 ensemble définition......................... 306 From............................ 272 en-tête mise en forme...................... 123 variable........................... 92 envoi document personnaliser.....................45 ERQL langage.......................... 226 espace de travail requêtes.......................... 227 étendue forme............................ 188 exécuter description......................... 63 description HTML.................... 184 314 MEGA Publisher

Index exécution texte condition........................ 61 expression test d implémentation................ 292 extraction mécanisme site Web....................... 120 rafraîchir.......................... 39 extraire document type...................... 39 forme réduite description HTML....................188 frame..............................163 nom.............................149 From..............................262 ensembles........................272 G F F1_Assistance....................... 234 favoris objets recherche...................... 255 fenêtre site Web nouvelle....................... 191 feuille de style....................... 108 créer............................ 108 css............................. 164 définition......................... 306 indiquer.......................... 145 feuille de styles modifier........................... 65 fichier HTML nom.......................... 171 site Web.......................... 170 fichier de génération HTML............. 177 fonctionnalité définition......................... 306 fond site Web couleur........................ 168 format BODY............................ 123 images site Web....................... 151 images générées.................... 171 texte description...................... 85 formateur.......................... 123 formateur script _type............................ 142 créer............................ 143 macro........................... 142 forme étendue description HTML.................... 188 génération complète HTML..........................186 générique lien.............................267 séparateur........................267 groupe avant............................ 60 créer............................ 59 définition.........................306 description HTML....................184 modifier propriétés................... 80 ordonner.......................... 71 réutiliser.......................... 78 supprimer......................... 79 texte............................ 60 titre............................. 59 trier............................. 81 H Having count........................262 existence du lien....................269 HEAD mise en forme......................123 hébergement site Web..........................149 historique objets recherche.......................255 Homeleft.mth........................177 Hometop.mth........................177 homogénéiser mises en forme.....................103 HTML balise propriété.......................190 cadre............................163 315

Index description........................ 181 multilinguisme................... 206 page complète................... 186 exécution description................ 203 notions.......................... 160 source mettre en forme................. 205 variable.......................... 196 HTML Help......................... 126 HTML Help workshop................. 126 hyperlien modifier image..................... 148 I Id................................ 196 identifiant absolu définition......................... 307 If................................. 203 balise HTML....................... 203 image copier descriptions HTML................ 208 document objet.......................... 83 restitution documentation.................. 105 site Web format........................ 151 hyperlien...................... 148 logo.......................... 149 menu......................... 148 nommage...................... 173 retour en haut................... 148 imbriqué constituant........................ 196 impact site Web objets liés...................... 127 impression diagramme description...................... 75 imprimer style............................ 106 In................................ 262 sous-requête...................... 266 index caractéristique..................... 156 modifier nom des pages.................. 157 références croisées.................. 154 site Web.......................... 124 nommage...................... 173 info-bulles dessin balise......................... 196 insérer rapport............................ 29 référence au style.................... 96 référence externe.................... 73 tableau texte........................... 88 variable........................... 96 intégrer références externes.................. 173 intellisense......................... 244 interne requête.......................... 243 intersection résultat recherche...................... 251 Into....................... 260, 262, 265 introduction texte.............................58 IsAvailable.......................... 202 K Keep.............................. 262 L langue données MEGA......................87 texte de description...................86 largeur menu site Web....................... 148 Layout (LY) attribut de propriété................. 190 lien............................... 268 attribut.......................... 269 condition existence....................... 269 couleur........................... 150 définition......................... 307 hypertexte modifier....................... 148 316 MEGA Publisher

Index site Web couleur........................ 168 visité......................... 168 visité............................ 150 ligne même texte........................... 86 nouvelle texte........................... 86 Like............................... 262 limite nom document....................... 27 Link (LNK) attribut...................... 191, 195 liste styles............................ 111 LNK............................... 191 logo site Web.......................... 149 LY................................ 190 M macro description......................... 72 ajouter......................... 72 formateur script.................... 142 références externes................... 73 test d implémentation................ 296 mail site Web...................... 206, 207 Mapleft.mth......................... 177 Maptop.mth......................... 177 matrice définition......................... 307 MEGA Process requêtes.......................... 277 MEGA Web Access fonctionnement..................... 217 génération page Web...................... 221 présentation....................... 217 principes......................... 218 session.......................... 219 sites Web dynamiques................ 215 Megastyl.dot........................ 106 mémoriser objets description...................... 64 requête...................... 240, 241 menu cadre............................150 image site Web.......................148 largeur site Web.......................148 position..........................148 présentation.......................148 site Web modifier paramètres...............169 paramétrer......................200 Menu (MNU) attribut de propriété..................191 menu de navigation...................148 Meta site Web..........................123 MetaClassName...................... 84 métamodèle définition.........................307 description noms.......................... 83 parcourir..........................266 mettre à jour rapport........................... 31 mise en forme description HTML....................124 page............................153 politique permissive..................104 politique restrictive..................103 rapport........................... 30 restituer..........................102 site Web..........................123 mise en page site Web..........................146 MNU...............................191 barre menus.......................200 modèle définition.........................307 page site Web.......................171 modèle de site Web...................134 modes recherche.........................232 modifier document......................... 27 document type..................... 35 propriétés d un groupe................ 80 style.............................107 MTH...............................146 multi-cible recherche.........................228 multilingue descriptions HTML...................206 édition des textes................... 86 317

Index N navigation menu........................... 148 neutral.css......................... 166 nom commençant...................... 230 contenant........................ 230 document limite.......................... 27 fichiers HTML...................... 171 finissant.......................... 230 métamodèle description...................... 83 nombre constituants balise HTML..................... 194 nomenclature définition......................... 308 parcourir......................... 270 nommage images sites Web...................... 173 pages d index...................... 173 normaliser mises en forme..................... 103 Not............................... 262 not requête.......................... 238 Null........................ 262, 268, 269 O ObjectPicture balise........................... 199 objet ajouter dans site Web................... 121 candidat recherche...................... 255 image document....................... 83 site Web type...................... 134 trier............................. 81 objet décrit mise en forme..................... 123 objet source attribut.......................... 270 opérateur recherche......................... 237 options recherche......................... 256 site Web.......................... 146 options étendues site Web.......................... 149 Or................................ 263 or requête.......................... 238 ordonner description......................... 81 groupe............................ 71 ordre diagramme......................... 81 groupes description....................... 71 objets description....................... 81 orientation diagramme......................... 76 P page ajouter dans site Web................ 122 blanche diagramme......................75 complète......................... 186 diagramme......................... 76 HTML corps......................... 186 mise en forme...................... 153 site Web paramétrer..................... 153 site Web type...................... 134 page d accueil indiquer.......................... 145 modèle........................... 146 modifier.......................... 171 personnaliser...................... 177 page d index ajouter dans site Web................ 124 page HTML site Web.......................... 122 PageName.......................... 171 paragraphe mise en forme document...................... 102 nouveau texte........................... 86 paramétrage sites Web niveaux........................ 142 318 MEGA Publisher

Index paramètre recherche......................... 236 renseigner......................... 36 sitedef.ini......................... 177 paramétrer pages site Web....................... 153 site Web.......................... 141 parcourir métamodèle....................... 266 ParentId........................... 196 patte.............................. 267 personnaliser description......................... 53 document Word..................... 21 recherche......................... 226 personnel description RTF...................... 54 PictureFormat....................... 192 pied de page variable........................... 92 police site Web.......................... 150 police RTF autorisée......................... 104 position menu............................ 148 préfixe description......................... 70 presse-papier objets recherche...................... 255 propriété balise HTML....................... 190 règle............................ 286 propriétés constituant balise HTML..................... 194 protection description......................... 70 document type...................... 33 puces site Web.......................... 150 R rafraîchir document.......................... 31 extraction.......................... 39 rapport........................... 31 rapport type........................ 39 requête.......................... 251 rapport code............................. 32 définition.........................308 fonctionnement..................... 35 insérer........................... 29 mettre à jour....................... 31 mise en forme...................... 30 résultat de recherche.................253 sélection.......................... 29 type d objet........................ 29 rapport type définition.........................308 insérer dans document type............ 36 remplacer......................... 66 supprimer......................... 32 récente requête...........................241 recherche...........................257 assistant..........................234 critères........................234 barre............................227 caractères génériques................268 espace de travail....................227 lancer............................232 lien.............................268 multi-cible.........................228 nom.............................230 objet candidat.......................255 options...........................256 paramétrer........................256 personnaliser......................226 résultat...........................247 syntaxe..........................260 variable..........................260 rechercher fenêtre........................... 63 type d objet........................227 réduite forme............................188 référence au style..........................110 style............................. 96 référence externe champ........................... 91 description........................ 90 insérer........................... 73 macro............................ 73 paramétrer intégration......................174 site Web...................... 147, 173 texte............................ 90 Refstyle............................ 96 règle affichage..........................284 analyse...........................301 conditionner.......................288 319

Index implémenter....................... 289 propriétés........................ 286 règlement........................ 283 test............................. 289 test filtrant........................ 287 règlement appliquer......................... 283 cohérence........................ 283 créer............................ 283 réinitialiser colonnes requêtes....................... 250 résultat.......................... 247 remplacer rapport type........................ 66 répertoire fichiers HTML...................... 171 génération HTML.................... 136 site Web caractéristiques.................. 145 structure....................... 170 requête afficher propriétés...................... 245 traduction...................... 245 aide saisie......................... 239 cataloguée........................ 243 champ........................... 245 changer groupe......................... 80 code............................ 239 colonne réinitialiser..................... 250 commande........................ 262 commentaire...................... 260 copier nom d objet.................. 245 créer........................ 243, 244 définition......................... 308 embarquée......................... 60 enregistrer........................ 240 espace de travail................... 227 exemples......................... 274 interne.......................... 243 MEGA Process...................... 277 mémoriser........................ 241 modifier objets......................... 252 paramètres....................... 236 rafraîchir......................... 251 rapport........................... 35 récente.......................... 241 conserver...................... 241 résultat afficher........................ 248 liste.......................... 250 site Web......................... 122 syntaxe.......................... 260 temporaire........................ 241 type filtrer......................... 243 usuel............................ 243 variable.......................... 260 restitution paramétrage....................... 104 résultat cumuler.......................... 247 fenêtre modifier....................... 251 Into............................. 265 recherche......................... 247 arbre,arbre résultat recherche250 intersection..................... 251 personnaliser.................... 248 union......................... 250 réinitialiser........................ 247 requête afficher........................ 248 liste.......................... 250 retour image site Web....................... 148 S saisie aide requêtes....................... 239 sauvegarder document type......................39 segment définition......................... 309 Select......................... 260, 263 plusieurs......................... 260 sélection voir Requête....................... 226 signet description HTML.................... 184 site Web barre de menu..................... 200 bordure menu......................... 148 compiler.......................... 126 compte rendu de génération............ 179 créer sans modèle.................... 117 déplacer.......................... 170 320 MEGA Publisher

Index description HTML.................... 181 dossier........................... 170 dynamique........................ 215 email........................ 206, 207 fichiers........................... 170 format images..................... 171 hébergé.......................... 149 image format........................ 151 hyperlien....................... 148 logo.......................... 149 retour......................... 148 type d objet..................... 148 index personnaliser.................... 154 informations META.................. 123 liste styles......................... 164 modèle de page.................... 171 modifier globalement..................... 145 nom d objet....................... 176 nom de lien....................... 176 objets liés impacts........................ 127 options........................... 146 ouvrir autre fenêtre.................... 191 paramétrer........................ 141 police RTF........................... 150 police RTF autorisée................. 104 référence externe................... 173 supprimer pages.................... 171 validité........................... 179 site web dynamique principes....................... 218 site Web type créer............................ 134 dupliquer......................... 138 objets........................... 134 utiliser........................... 136 variable.......................... 135 sitedef.ini.......................... 171 paramètre........................ 177 souche code template...................... 201 source HTML........................ 183 syntaxe.......................... 188 texte mettre en forme.................. 205 sous-requête In.............................. 266 squelette document.......................... 33 structure description HTML....................184 site Web..........................170 styles............................106 style aide.............................114 cadre............................107 créer description......................107 insérer variable................... 94 css..............................164 définition.........................308 description........................111 dessin...........................113 en-tête et pied de page...............113 feuille de style......................108 imprimer..........................106 introduction.......................111 liens.............................112 MEGA............................110 modifier..........................107 normal...........................112 objet commentaire....................111 nom..........................111 page de garde......................111 personnaliser......................101 présentation.......................106 référence......................... 96 remarques........................113 restitution.........................105 site Web liste...........................164 structure..........................106 tableaux..........................113 variable.......................... 92 suffixe description........................ 70 supprimer groupe........................... 79 rapport type....................... 32 SvgBubble Draw............................196 synchroniser cible.............................257 recherche.......................257 syntaxe contrôle..........................264 recherche.........................260 source HTML.......................188 321

Index T tableau insérer............................ 88 restitution........................ 105 tag constituant........................ 192 context.......................... 198 description HTML................... 189 dessin........................... 195 ObjectPicture...................... 199 propriété......................... 190 WebObjectCollection................. 196 workflow......................... 197 Target attribut de propriété................. 191 temporaire requête.......................... 241 test filtrant........................... 287 règle............................ 289 test d implémentation définition......................... 292 expression........................ 292 macro........................... 296 texte ajouter........................... 56 avant et après...................... 58 conclusion......................... 58 condition d exécution.................. 62 conserver mises en forme............. 104 définition......................... 309 description HTML................... 184 format description...................... 85 groupe............................ 60 insérer variable...................... 96 introduction........................ 58 mise en forme Word.......................... 57 multilingue......................... 86 site Web couleur........................ 168 titre groupe............................ 59 trier description......................... 71 groupe............................ 81 liste d objets....................... 193 objets............................ 81 type analyse.......................... 298 formateur script.................... 142 requête filtrer......................... 243 type d objet image site Web....................... 148 rechercher........................ 227 U UNC............................... 126 uniformiser mises en forme..................... 103 union résultat recherche...................... 250 Unique......................... 263, 269 URL parent......................... 145 usuel requête.......................... 243 V valeur recherche......................... 238 validité description........................ 100 site Web.......................... 179 variable ajouter............................ 94 créer.............................93 définir............................ 93 définition......................... 309 description HTML.................... 196 en-tête............................ 92 insérer............................ 96 pied de page........................92 recherche......................... 260 renseigner......................... 36 requête.......................... 260 site Web type...................... 135 style.............................92 visionneuse SVG............................. 151 322 MEGA Publisher

Index Visual.Net.......................... 133 W WebObjectCollection balise............................ 196 Where......................260, 263, 266 Word document personnaliser..................... 21 personnaliser styles......................... 101 workflow balise............................ 197 Z zoom déformation....................... 151 diagramme site Web....................... 150 323

Index 324 MEGA Publisher