5 Requêtes Documenteur Publication intranet Import/Export

Transcription

1 Manuel Utilisateur 5 Requêtes Documenteur Publication intranet Import/Export Date dernière révision : 03/06/2014 La documentation utilisateur de WinDesign se décompose en : U5 manuels généraux 1 Installation Administration Organisation du travail 2 Profil : paramétrage de WinDesign 3 Espace de travail Référentiel Références croisées Dictionnaire externe Consolidation 4 Modes Opératoires Standard 5 Requêtes Documenteur Publication intranet Import/Export U4 Manuels spécifiques Module Database Module Business Process Module Object Module UserInterface REQUETES DOCUMENTEUR PUBLICATION INTRANET 1

2 2 Documentation utilisateur

3 SOMMAIRE 1. REQUETES ARBRE DES REQUETES VERROUILLAGE DU FICHIER DE REQUETE RAFRAICHISSEMENT DES REQUETES ENREGISTREMENT DES REQUETES CREER UNE NOUVELLE REQUETE OPTIONS COMPLEMENTAIRES MODIFIANT LES RESULTATS DE LA REQUETE ENREGISTREMENT DE LA REQUETE DEFINITION D UN CRITERE CHOIX DE LA CARACTERISTIQUE SUR LAQUELLE S APPLIQUERA LE CRITERE CHOIX DE L OPERATEUR CHOIX DU TERME COMBINAISON DE CRITERES CARACTERISTIQUES A AFFICHER DANS LES RESULTATS DE LA REQUETE LIENS AVEC LES AUTRES OBJETS CRITERES SUR DES CARACTERISTIQUES DE LIENS MODIFIER UNE REQUETE EXISTANTE SUPPRIMER UNE REQUETE IMPORTER/EXPORTER DES FICHIERS DE DEFINITION DE REQUETES CONVERTIR UNE REQUETE EN REQUETE D EDITION CREATION D UN GROUPE DE REQUETES OPTIONS D AFFICHAGE EXECUTION D UNE REQUETE OU D UN GROUPE DE REQUETES PRESENTATION DES RESULTATS DE LA REQUETE OU DU GROUPE DE REQUETES PRESENTATION DES RESULTATS DE LA REQUETE SOUS FORME D ARBRE PRESENTATION DES RESULTATS SOUS FORME DE MATRICE EXPORTER LES RESULTATS D UNE REQUETE INSERTION DES REQUETES DANS LES DIAGRAMMES MODES OPERATOIRES CHOIX DE LA REQUETE A INSERER DANS LE DIAGRAMME EXECUTION DE LA REQUETE OPTIONS D AFFICHAGE ET DE MISES A JOUR DE LA REQUETE DOCUMENTEUR : PRINCIPES SELECTION D UNE EDITION EXECUTION D UNE EDITION CONSTRUCTION D UNE REQUETE D EDITION CREATION D UNE REQUETE D EDITION PARTICULARITE DE LA DEFINITION DES REQUETES D EDITIONS PAR RAPPORT AUX REQUETES STANDARD RENOMMAGE DES NŒUDS DE L ARBRE GROUPER DES OBJETS DU MEME NIVEAU REQUETES D EDITION SPECIFIQUES CONVERTIR UNE REQUETE EXISTANTE EN EDITION MAQUETTAGE DE PRESENTATION DES EDITIONS AFFECTATION D UNE MAQUETTE D EDITION A UN NŒUD CONSTRUCTION D UNE MAQUETTE D EDITION CAS PARTICULIER DE LA CONSTRUCTION D UNE MAQUETTE CONTENANT PLUSIEURS NIVEAUX 42 REQUETES DOCUMENTEUR PUBLICATION INTRANET 3

4 3.4.4 COMPILATION DE LA MAQUETTE OPTIONS COMPLEMENTAIRES AVANT EXECUTION DE L EDITION GROUPE «ELEMENTS A INSERER» GROUPE «OPTIONS GENERALES» ENREGISTREMENT DE LA MAQUETTE D EDITION GENERATION DU SITE DOCUMENTAIRE INTRANET APPEL DE LA FONCTION DESCRIPTION DE LA BOITE «DOCUMENTATION INTRANET» ONGLET «GENERAL» ONGLET «OPTIONS» ONGLET «POINTS D ENTREE» ONGLET «APPARENCE» ONGLET «DIVERS» LANCEMENT DE LA GENERATION DU SITE DOCUMENTAIRE INTRANET NAVIGATION DANS LE SITE AFFICHER L IMAGE D UN SOUS MODELE BARRE D OUTILS DE L EXPLORATEUR AFFICHER LA FICHE DESCRIPTIVE D UN OBJET PERSONNALISER LA PRESENTATION DU SITE INTRANET PERSONNALISER LA PAGE D ACCUEIL MODIFIER LA PRESENTATION DES FICHES DESCRIPTIVES MODIFIER LE CONTENU DES FICHES ET DES LISTES MODIFIER LA PRESENTATION DE L ARBRE HIERARCHIQUE MODIFIER LE FICHIER D ENTETE OU DE PIED DE PAGE MODIFIER OU CREER UN THEME DE PRESENTATION AUTRES MODALITES D IMPORT/EXPORT IMPORT XML AVEC FICHIER DE COMMANDES ASSISTANT IMPORT/EXPORT (CSV/XML) CREATION D UN FICHIER DE PARAMETRES D IMPORT/EXPORT SELECTION DU TYPE D OBJET SELECTION DES CARACTERISTIQUES A AFFICHER SELECTION DES OBJETS LIES SAUVEGARDER LES PARAMETRES D IMPORT/EXPORT AIDE A L IMPORT AU FORMAT CSV AIDE A L IMPORT AU FORMAT XML EXPORTER DES OBJETS DU MODELE ACTIF IMPORT XML WINDESIGN IMPORT TEXTE FORMAT CSV PRINCIPES DE L IMPORT PRE REQUIS CONSTITUTION DU TABLEAU IMPORT DES DOCUMENTS ASSOCIES EXECUTION DE L IMPORT IMPORT DE FICHIERS VISIO PRINCIPE IMPORTER UN FICHIER VISIO CHOIX D UN SCENARIO OU D UNE OPERATION DE CONVERSION EXECUTION D UNE OPERATION OU D UN SCENARIO DE CONVERSION ET RESULTAT RESULTAT CONSTRUCTION D UN SCENARIO DE CONVERSION EQUIVALENCE DES CARACTERISTIQUES 87 4 Documentation utilisateur

5 5.5.8 INITIALISATION DE VALEUR DANS L OBJET SOURCE GESTION DES OPERATIONS D UN SCENARIO GESTION DES CARACTERISTIQUES EXTERNES FONCTION DE CONVERSION PAR LE MENU CONTEXTUEL DES OBJETS EXPORT XML WINDESIGN IMPORT/EXPORT AVEC W IMPORT W EXPORT W4 97 REQUETES DOCUMENTEUR PUBLICATION INTRANET 5

6 1. REQUETES WinDesign dispose d un outil de requêtes pour effectuer des recherches sur les objets contenus dans les modèles. Ces requêtes peuvent porter aussi bien sur les caractéristiques des objets que sur les liens entre les objets. Le système de requêtes fonctionne par navigation sur le méta modèle. Nota 1 : le méta modèle descriptif des objets et de leurs liens se trouve matérialisé dans le documenteur, ainsi que dans l outil dictionnaire avec les références croisées. Les résultats de la requête peuvent être exportés au format.csv, XML ou HTML. 1.1 ARBRE DES REQUETES Les requêtes sont présentées sous forme d arbre, accessible à partir de la fenêtre de l espace de travail par l onglet ou par le bouton de la barre d outils. Les icônes de cette barre d outils permettent respectivement d accéder aux fonctions suivantes Ouvrir un fichier de requêtes (.dat) Enregistrer le fichier de requêtes Rafraîchir les requêtes Verrouiller/Déverrouiller le fichier de requêtes Créer une nouvelle requête Editer la requête sélectionnée Supprimer la requête sélectionnée Lancer l exécution de la requête sélectionnée. Créer un groupe de requêtes Importer une requête ou un groupe de requêtes Exporter une requête ou un groupe de requêtes La liste déroulante permet d afficher toutes les requêtes ou de sélectionner un groupe de requêtes Verrouillage du fichier de requête Si vous disposez d une licence fonctionnant en réseau, plusieurs utilisateurs peuvent accéder en même temps à un même fichier de requêtes. 6 Documentation utilisateur

7 Dans ce cas, à l appel de la fonction «Nouvelle requête» ou «Editer la requête», un message vous demande si vous souhaitez verrouiller le fichier requête. Si le fichier est verrouillé : l utilisateur qui a verrouillé le fichier peut créer et modifier les requêtes. Les autres utilisateurs pourront exécuter les requêtes existantes ou modifier ponctuellement une requête et l exécuter, mais ne pourront pas sauvegarder les modifications Rafraîchissement des requêtes Lorsqu un utilisateur utilise des requêtes alors que le fichier est verrouillé, il peut à tout moment utiliser le bouton de la barre d outils de l arbre des requêtes, pour disposer de la dernière mise à jour du fichier requêtes. Ses propres modifications seront perdues Enregistrement des requêtes Les requêtes peuvent être conservées. Le fichier mémorisant les requêtes est indépendant de l espace de travail. Il peut exister plusieurs fichiers de requêtes, enregistrés en type de fichier.dat. Celui par défaut se trouve dans le dossier : DONNEES de l installation de WinDesign et se nomme : WdRequetes.dat. 1.2 CREER UNE NOUVELLE REQUETE Pour créer une nouvelle requête, utilisez le menu contextuel de la racine de l arbre, fonction «Nouvelle requête» ou activez l icône L assistant de création de requête s affiche, et présente une première boîte intitulée «Méta modèle WinDesign». Elle propose la liste de tous les types de modèles gérés dans WinDesign, et la liste de tous les objets pour chaque type de modèle. Sélectionnez le type de modèle sur lequel s appliquera la requête, puis l objet à insérer dans la requête. Exemple : MCD, Entité. Validez par OK. Nota : les stéréotypes peuvent être sélectionnés directement sans obligation de création d un critère sélectif. REQUETES DOCUMENTEUR PUBLICATION INTRANET 7

8 La boîte «Assistant de création d une requête» s affiche, avec dans la liste de gauche, la présentation de l arbre des requêtes. La partie droite de la fenêtre permet de documenter la requête en cours de création, en particulier son nom (celui qui figurera dans l arbre de choix des requêtes), l auteur (par défaut l auteur déclaré courant) et un texte de description. Le nom de la requête peut également être saisi en surchargeant le texte par défaut affiché dans l arbre (partie gauche). On peut également affecter un type à la requête, permettant dans certaines boîtes de choix de filtrer les requêtes par rapport à ce type. Exemple : contrôle, recherches diverses, références croisées, Un nouveau type peut être créé en saisissant son nom directement dans le champ de la liste déroulante. La requête telle qu elle est définie est prête à fonctionner. Dans l exemple ci dessus, on obtiendra la liste de toutes les entités des modèles de l espace de travail, sans filtrage particulier Options complémentaires modifiant les résultats de la requête Dans la partie droite de la fenêtre, s affichent les éléments qui caractérisent le type d objet sélectionné (dans notre exemple, l entité) Renommage du nœud Le nom des types d objet utilisé par défaut est celui défini dans le méta modèle (cf. Gestion du profil). Dans certains cas, pour rendre plus explicite les résultats obtenus, on peut changer la dénomination de chaque nœud. Pour ce faire, saisir le nouveau nom dans le champ «Rôle» de la partie droite de la fenêtre, ou éditer (clic long) le champ du type d objet dans l arbre. 8 Documentation utilisateur

9 Inclusion des types spécialisés Dans le méta modèle, un type d objet peut être stéréotypé. Exemple : une vue externe (matérialisation externe des données) est stéréotypée en formulaire et structure de données. Il existe par ailleurs des vues externes non stéréotypées. De plus, à partir d un type d objet, on peut dériver de nouveaux types d objets pour hériter de ses caractéristiques et comportement, eux mêmes pouvant être stéréotypés. Exemple pour la vue externe : document et objet métier sont deux types d objets dérivés de la vue externe. Se reporter au Manuel 2 Profil : Paramétrages de WinDesign pour plus de détails. Dans le cas où la requête porte sur un type d objet ayant lui même des types d objets dérivés, la requête peut porter sur soit strictement le type d objet précisé. Dans ce cas, décochez la case à cocher «Inclure les types spécialisés». Dans le cas contraire, la requête inclura également tous les types dérivés Affichage 1 ère option : Afficher les objets et le groupe (correspond à la dénomination des liens) dans le résultat Lorsque la requête comporte plusieurs niveaux imbriqués, pour des raisons de présentation, le résultat d un niveau intermédiaire de la requête peut ne pas être affiché. Dans ce cas, décochez la case «Afficher l objet dans le résultat». 2 ème option : Afficher les objets exclus Les résultats de la requêtes présentent par défaut la liste des objets ayant répondu aux critères précisés pour la requête. On peut également afficher la liste inverse des objets exclus (ceux ne répondant pas aux critères). Cette liste s affichera en complément de la liste de résultats. Pour cela, cochez la case «Afficher les objets exclus». Pour exécuter la requête, cliquez sur le bouton «Exécuter». Se reporter au paragraphe «Exécution de la requête». 1.3 ENREGISTREMENT DE LA REQUETE Une requête construite peut ne pas être enregistrée dans le fichier des requêtes, mais seulement être exécutée. Pour valider la requête et l intégrer dans l arbre de choix des requêtes, cliquez sur le bouton «Ok». 1.4 DEFINITION D UN CRITERE En général, une requête est destinée à sélectionner un sous ensemble d objets parmi ceux contenus dans le référentiel. Pour cette sélection, on appliquera des critères sélectifs. Sur chaque noeud de la requête (dans notre exemple : entité), un ou plusieurs critères peuvent être appliqués permettant de filtrer les occurrences du type d objet recherché. Sélectionnez dans l arbre, l objet sur lequel le critère sera appliqué, puis activez l icône partie droite de la boîte, à partir de l onglet «critères» (onglet ouvert par défaut). dans la REQUETES DOCUMENTEUR PUBLICATION INTRANET 9

10 La boîte «Assistant critère» s affiche Choix de la caractéristique sur laquelle s appliquera le critère Dépliez la liste déroulante du choix de la caractéristique. Sélectionnez dans la 1 ère liste de choix, la caractéristique sur laquelle s appliquera le critère, puis l opérateur. Trois catégories de caractéristiques sont présentées : Les caractéristiques globales Elle concerne toutes les caractéristiques présentes dans tous les types d objet. Exemple : nom, libellé, alias, Les caractéristiques spécifiques 10 Documentation utilisateur

11 Ces caractéristiques sont spécifiques au type d objet. Exemple : pour l entité, la taille estimée, le nombre d occurrences, Certains objets n ont aucun caractéristique spécifique. Les caractéristiques étendues Ce sont toutes les caractéristiques qui ont été rajoutées dans le profil. Ces caractéristiques sont associées à un type ou à un stéréotype d objet Choix de l opérateur En fonction du type de caractéristique à évaluer, la liste déroulante présente les opérateurs adaptés au type de données de la caractéristiques (opérateurs numériques, logiques, chaîne de caractères, ). Sélectionnez un opérateur dans la liste Choix du terme Précisez ensuite le terme : Caractéristique : soit une autre caractéristique du même type d objet, soit une caractéristique appartenant à un type d objet défini à un niveau supérieur dans la requête (même comportement de choix que pour la 1 ère étape) Paramètre : la valeur de celui ci sera demandé à chaque exécution de la requête. Saisissez un nom dans le champ en dessous. Valeur : saisie d une valeur ou proposition d une liste de valeurs dans le cas où le type d objet a une liste fermée de valeurs. Saisissez éventuellement un commentaire descriptif complémentaire. REQUETES DOCUMENTEUR PUBLICATION INTRANET 11

12 Validez la définition du critère en cliquant sur le bouton «Ok». La fenêtre d assistant de création de requête s affiche et présente le critère saisi dans la liste des critères. 1.5 COMBINAISON DE CRITERES Dans le cas où plusieurs critères sont définis pour le même type d objet, une expression logique combinant les critères peut être également spécifiée. Par défaut, l opérateur ou (or) sera utilisé. Pour combiner les critères et les opérateurs, utilisez les icônes proposés au dessus du tableau. L icône permet de vérifier l expression logique et s affiche au vert si celle ci est valide Caractéristiques à afficher dans les résultats de la requête Outre l arbre des résultats reprenant le nom des objets issus de la requête, on peut également afficher dans un tableau joint à cet arbre, les caractéristiques de chacun des objets. Ces caractéristiques sont choisies à partir de l onglet «Affichage». 12 Documentation utilisateur

13 Sélectionnez la caractéristique à afficher, puis cochez la case dans la colonne «Afficher». L ensemble des caractéristiques sélectionnées pour être affichées sont reprises dans la liste supérieure «Caractéristiques affichées» Liens avec les autres objets Outre les critères sélectifs sur les caractéristiques d un objet, on peut également construire une requête pour filtrer les objets ayant ou n ayant pas de liens (à déterminer) avec d autres types d objet. Exemple : rechercher les entités participant à au moins une relation. Pour créer un lien à partir d un type d objet sélectionné dans l arbre, cliquez sur le bouton en haut à gauche de la fenêtre, ou cliquez sur le bouton «+» dans la boîte à onglets «Liens» de la partie droite de la fenêtre. L assistant propose deux modes de travail, l un en choisissant directement l objet à atteindre, l autre en choisissant d abord le type de lien puis l objet à atteindre. 1 er mode Mode par défaut : affichage de la liste des objets accessibles à partir de l objet d origine sélectionné. La liste des objets accessibles est obtenue à partir des références croisées définies dans le profil. REQUETES DOCUMENTEUR PUBLICATION INTRANET 13

14 Pour choisir un objet, sélectionnez cette objet dans la liste de gauche. La liste de droite présente les liens possibles entre l objet d origine et l objet sélectionné (dans l exemple : entre entité et relation, le lien choisi s appelle «lien relation»). Dans le cas où il y a plusieurs liens, on peut sélectionner tout ou partie de ces liens. Décochez les liens non sélectionnés. Pour valider le choix, cochez la ligne correspondant à l objet à atteindre (dans notre exemple : relation), puis cliquez sur le touche «Ok». 2 ème mode : Accès par les références croisées. Choisir dans l assistant, dans la liste déroulante «Navigation par», l option «Liens disponibles». La partie gauche de la boîte de dialogue affiche toutes les possibilités de références croisées entre l objet d origine sélectionné et les autres objets. Ces références croisées (paramétrées dans le profil) sont les mêmes que celles affichées dans les boîtes de dialogue pop up des objets dans les diagrammes. Dans certains cas, ces références croisées sont présentées par groupe. Sélectionnez dans la liste de gauche la dénomination du lien à partir duquel un ou plusieurs objet(s) sera atteint. Dans certains cas, le nom du lien est identique au nom de l objet à atteindre. Dans la partie droite s affichent les objets atteignables à partir du lien sélectionné. 14 Documentation utilisateur

15 Dans le cas où on veut choisir un sous ensemble de la liste présentée, décochez les objets non retenus. Pour valider le choix, cochez la colonne à droite du nom du lien, puis cliquez sur le bouton «Ok». Après validation de l un ou l autre des modes, la fenêtre d assistant de requêtes s affiche, en présentant dans l arbre les liens entre les objets. Le lien défini agit comme un critère sélectif. Ici, dans notre exemple, seules les entités ayant au moins une relation seront sélectionnées. De même que pour les objets, on peut définir des combinaisons et des opérateurs logiques sur les liens. Par défaut, s il y a plusieurs liens, l opérateur pris est «Ou». On peut également inverser le critère sélectif dû au lien. Par exemple, rechercher les entités qui n ont pas de relation. Dans ce cas, l expression logique du lien à partir de l entité doit être indiquée «not A». REQUETES DOCUMENTEUR PUBLICATION INTRANET 15

16 1.5.3 Critères sur des caractéristiques de liens Dans le cas où il existe des caractéristiques sur les liens entre deux types d objets (cas peu nombreux), on peut également appliquer des critères sur ces caractéristiques comme on le fait sur les types d objets. Ces critères agiront de manière restrictive. Exemple : dans notre requête précédente, nous obtenons la liste des entités ayant au moins une relation. Un critère complémentaire peut être ajouté, par exemple : liste des entités ayant au moins une relation avec une cardinalité maximum = 1. Ici la caractéristique «Cardinalité maximum» fait partie de la définition du lien relation (caractéristique spécifique). On peut donc définir le critère sur ce lien, à partir de l onglet «Critères» en ayant préalablement sélectionné le lien. 1.6 MODIFIER UNE REQUETE EXISTANTE Pour modifier une requête existante, sélectionnez la requête dans l arbre, puis activez la fonction «Description» à partir du menu contextuel ou cliquez sur l icône L Assistant de création s affiche vous permettant de modifier ou compléter la requête. 1.7 SUPPRIMER UNE REQUETE Pour supprimer une requête, sélectionnez celle ci dans la liste, puis activez la fonction «Supprimer» à partir du menu contextuel ou cliquez sur l icône 1.8 IMPORTER/EXPORTER DES FICHIERS DE DEFINITION DE REQUETES Cette fonction permet d importer ou d exporter un fichier de définition de requêtes (.dat) d un poste de travail vers un autre. Ceci permet donc d enrichir le catalogue avec des requêtes provenant de différentes sources. Pour exporter une requête ou un groupe de requêtes, à partir de l onglet «Requêtes» de l explorateur, effectuez votre sélection puis cliquez sur. Enregistrez votre fichier.dat. Pour importer un fichier requêtes, activez l icône, sélectionnez le fichier.dat à importer. La liste des requêtes se complète par les requêtes importées. Nota : l import d un fichier de requêtes ne conserve pas les groupes de requêtes éventuellement créés. Nota : fonction identique pour l import/export de fichiers de définition d éditions. 16 Documentation utilisateur

17 1.9 CONVERTIR UNE REQUETE EN REQUETE D EDITION Le documenteur de WinDesign est destiné à produire la documentation au format rtf (traitement de texte type Ms Word ) de l ensemble des objets modélisés. Cf. Chapitre : Documenteur de ce même manuel Ce documenteur est construit à partir du système de requêtes pour l extraction des objets du référentiel, et d un paramétrage pour la mise en forme des restitutions (maquettes de présentation) Pour utiliser une requête comme requête d édition, sélectionnez la requête dans la liste, puis activez la fonction «Convertir en édition» à partir de son menu contextuel. La requête se retrouve affichée en fin de liste dans la boîte «Gestion des éditions» appelée au lancement du documenteur et pourra donc être utilisée comme requête d édition. De la même manière, une requête d édition pourra être convertie en requête pour extraction. A partir de la boîte de gestion des éditions, sélectionnez l édition et activez la fonction «Convertir en requête» du menu contextuel. La requête se retrouve affichée dans l arbre des requêtes, en fin de la liste CREATION D UN GROUPE DE REQUETES REQUETES DOCUMENTEUR PUBLICATION INTRANET 17

18 Il est possible de créer des groupes de requêtes. Ceci permettra une exécution par lot. Dans la barre d outils, activez l icône. La boîte «Exécution de groupes de requêtes» s affiche. A partir de cette boîte, activez l icône pour créer un nouveau groupe, ou sélectionnez un groupe existant. Cliquez ensuite sur l icône pour afficher la boîte de sélection des requêtes. La liste des requêtes existantes s affiche, reprenant le contenu de l arbre des requêtes. Sélectionnez une ou plusieurs requêtes ou un groupe de requêtes existant et validez par Ok. La sélection s affiche dans le nouveau groupe créé ou dans le groupe présélectionné 18 Documentation utilisateur

19 Les icônes de la boîte vous permettent respectivement : De créer un nouveau groupe D ajouter une sélection dans un groupe D éditer un groupe ou une requête pour le renommer ou définir ou modifier le champ d application De supprimer la sélection De déplacer la sélection vers le haut ou le bas, et d indenter la sélection D exécuter la sélection (requête unitaire ou groupe de requêtes) Pour renommer un groupe ou une requête, cliquez sur son nom dans la colonne de gauche. Pour définir ou modifier le champ d application, positionnez vous dans la colonne de droite «Domaine d application». La boîte «Champ d application de la requête» s affiche, permettant de définir les paramètres. Lorsque le champ d application a été défini, une coche s affiche dans la colonne «Domaine d application». Nota : Lorsqu un groupe est exécuté, si le champ d application est défini pour le groupe, l exécution se fait directement. Si le champ d application n a pas été défini pour le groupe, ou si le champ d application n a pas été défini pour certaines requêtes, la boîte de saisie des paramètres s affichera avant l exécution Options d affichage 4 options d affichage des résultats sont proposées (à partir de la boîte «Assistant création requêtes»). Cochez ou décochez les cases correspondant à vos choix. Nota : ces options peuvent être définies pour chaque nœud de la requête. Afficher les objets dans le résultat Si cette option n est pas cochée, le nom des objets résultats de la requête ne seront pas affichés. Afficher le groupe dans le résultat REQUETES DOCUMENTEUR PUBLICATION INTRANET 19

20 Permet d afficher le nom des nœuds dans l arbre. Ex : entité, propriété,, que le nœud contienne des objets ou non. Si le groupe n est pas affiché, la liste des objets est affichée directement. Ex : Entité1, Entité2, Inclure les types spécialisés Par exemple, si des types ont été définis pour l objet libre (ordinateur, poste de travail, ) l option inclure les types spécialisés les prendra en compte. Si l option n est pas sélectionnée, ne seront pris en compte que les objets libres non typés. Afficher les objets exclus Permet d afficher les objets qui ne répondent pas aux critères de la requête. Les objets exclus sont affichés en fin de liste, en grisé EXECUTION D UNE REQUETE OU D UN GROUPE DE REQUETES Pour exécuter une requête, après sélection de la requête dans l arbre, activez la fonction «Exécuter» dans le menu contextuel de la requête ou cliquez sur l icône La première boîte affiche la description de la requête. Nota : l option «Afficher en matrice» permet de choisir l affichage des résultats de la requête sous forme de matrice. Cette option n est disponible dans cette boîte que si ce choix est pertinent par rapport à la requête. Cf. : Présentation des résultats de la requête La seconde boîte de dialogue permet de préciser le champ d application de la requête. Choix possibles : Le modèle actif Les modèles ouverts Tous les modèles de l espace de travail A ces 3 choix peut être rajoutée une liste de modèles, choisis à partir du bouton «Ajouter» dans n importe quel répertoire. Le bouton «Enlever» permet, après sélection, de retirer un modèle de la liste. Des modèles dans un répertoire spécifié peuvent également être sélectionnés, avec parcours ou non des sous répertoires. Cliquez ensuite sur le bouton «Terminer «pour lancer l exécution de la requête. Nota : dans le cas où la requête contient des paramètres, une boîte de dialogue s affiche pour permettre la saisie de la valeur du paramètre. Saisissez le ou les paramètre(s). 20 Documentation utilisateur

21 Cliquez sur le bouton «Terminer». La requête s exécute. Les résultats de la requête s affiche sous forme d arbre hiérarchique. Pour l exécution d un groupe de requêtes, le lancement s effectue à partir de la boîte «Exécution de groupes de requêtes», après sélection du groupe PRESENTATION DES RESULTATS DE LA REQUETE OU DU GROUPE DE REQUETES Présentation des résultats de la requête sous forme d arbre La liste des objets résultats de la requête s affiche par défaut sous forme d arbre hiérarchique. Exemple de la 1 ère requête des entités dont le nom commence par La barre d outils permet de moduler la présentation des résultats : Résultat de le 2 nde requête avec lien et filtrage sur une caractéristique de lien (entités ayant au moins une relation) Afficher le tableau des caractéristiques des objets dans la partie droite de la boîte. Dépliez le nœud sélectionné Repliez le nœud sélectionné REQUETES DOCUMENTEUR PUBLICATION INTRANET 21

22 Voir le descriptif de la requête Exporter les résultats de la requête Exécuter la requête Afficher les résultats en matrice Afficher le tableau des caractéristiques des objets Pour afficher le tableau des caractéristiques de l objet sélectionné dans l arbre, cliquez sur l icône. Les caractéristiques à afficher sont choisies à partir de l onglet «Affichage» de l assistant de création des requêtes. Par défaut, le nom de l objet est toujours affiché. Nota : la présentation de l arbre de la requête dépend des options d affichage sélectionnées pour chaque niveau. Lorsqu un groupe de requêtes est exécuté, les résultats sont présentés de la même manière, avec un nœud spécifique pour chacune des requêtes Présentation des résultats sous forme de matrice Une requête peut être définie au préalable avec l option d affichage des résultats sous forme de matrice, à partir de la boîte de définition de la requête. 22 Documentation utilisateur

23 Case à cocher : résultat en matrice. Ce choix à priori n est possible que dans la mesure où dans toutes les branches de la requête, un seul objet est affichable (cas où tous les niveaux intermédiaires ne sont pas affichés). Une matrice est faite pour présenter les liens entre deux objets, l un présenté dans les lignes, l autre présenté dans les colonnes. Le croisement de ces lignes/colonnes est rempli soit avec la nature du lien entre les 2 objets ou avec un marquage (un X par exemple) indiquant qu un lien existe. Dans ce contexte, la construction de la requête diffèrera de celle d une requête classique. Si à l analyse de la requête il s avère que plusieurs objets sont affichables, la case à cocher est automatiquement grisée. Cependant, dans ce cas, après avoir exécuté la requête avec présentation des résultats sous forme d arbre, un bouton permet d afficher ces résultats sous forme de matrice. Les différents objets affichables se trouvent alors groupés par type dans les colonnes. Exemple d une présentation d une requête précisant les modes d accès de chaque application aux bases de données. Nota : les textes affichés dans les cellules de croisement lignes/colonnes correspondent aux textes du nœud de la requête concernée. Exemple : Dans cet exemple, le texte des nœuds correspondant aux applications, sera celui affiché dans les cellules. Exemple d une requête partant d un serveur pour atteindre les utilisateurs des applications hébergées. REQUETES DOCUMENTEUR PUBLICATION INTRANET 23

24 Dans ce cas, la nature du lien étant indirect et n ayant pas une sémantique particulière, dans la construction de la requête, le texte associé au rôle utilisateur est symbolisé par X A noter que tous les niveaux intermédiaires sont grisés, donc non affichés, ce qui permet visuellement, d établir le lien direct entre la racine du nœud, ici «ordinateur», et l objet à atteindre, ici le «rôle d utilisateur» Autre modalité pour afficher les résultats d une requête sous forme de matrice En dehors du choix dans la définition de la requête, le choix de la présentation en matrice peut être fait : A l exécution de la requête Cochez la case «Afficher en matrice» pour préciser ce choix. Si cette case est grisée, c est que la requête comporte plus de 2 objets affichables (même contrôle que lors de la définition propre de la requête). A partir de l affichage des résultats sous forme d arbre 24 Documentation utilisateur

25 Comportement de la boîte d affichage des résultats en matrice Inverser les lignes et colonnes Cliquez sur le bouton. Les objets affichés en ligne s affichent en colonnes et les colonnes en lignes. Exporter les résultats Cliquez sur le bouton Même mode opératoire qu à partir de la présentation des résultats sous forme d arbre. En particulier l exportation en mode html permettra d insérer la matrice dans la documentation intranet. Ré exécuter Cliquez sur le bouton pour exécuter à nouveau la requête. REQUETES DOCUMENTEUR PUBLICATION INTRANET 25

26 Basculer en mode d affichage sous forme d arbre Cliquez sur le bouton pour afficher les résultats sous forme d arbre EXPORTER LES RESULTATS D UNE REQUETE Après exécution d une requête, on peut exporter ses résultats dans un fichier.csv, avec séparateur ou au format XML. Cliquez sur l icône. La boîte de dialogue «Export du résultat de la requête» s affiche. 1 er groupe de choix : Exporter Si l export se fait en format CSV, seule la sélection peut être exportée. Au format XML, les 3 options d export sont possibles. 2 ème groupe : Format de l export Sélectionnez le format du fichier d export. 26 Documentation utilisateur

27 Le format CSV permet d exporter uniquement la sélection. Le format XML et le format HTM permettent d exporter l ensemble des résultats. Nota : Le format HTM permettra d insérer les résultats des requêtes exportés dans la documentation intranet. Les résultats des requêtes doivent être exportées dans le répertoire de génération de la documentation intranet. Celui ci est proposé par défaut. Deux sous dossiers: requête et matrice seront créés automatiquement. 3 ème groupe : Nom du fichier Saisissez le nom du fichier d export. Par défaut, le nom de la requête est affiché. 4 ème groupe : répertoire d export Sélectionnez le répertoire dans lequel le fichier export sera sauvegardé. Nota : Pour publier les résultats des requêtes dans la documentation intranet, le répertoire d export doit être le même que celui dans lequel la documentation intranet est généré. Cliquez ensuite sur le bouton «Suivant» pour valider vos choix. La boîte de dialogue suivante varie en fonction du choix du format d export. Export au format CSV Précisez les options de formatage des lignes, puis cliquez sur «Terminer» pour lancer l export. Export au format XML La boîte présente l entête du fichier XML. Cliquez sur «Terminer» pour lancer l export. Export au format HTM Si la documentation intranet a déjà été générée, le boîte propose de lancer la mise à jour de la documentation intranet. A la fin de l export, un panneau propose de visualiser le résultat. 2. INSERTION DES REQUETES DANS LES DIAGRAMMES Cette nouvelle fonction permet de transformer une requête (cf. Manuel 5 Requêtes Documenteur) en un objet WinDesign. Ceci permet en particulier : De faire figurer les requêtes dans les diagrammes sous forme de pictogrammes D exécuter ces requêtes à partir des diagrammes REQUETES DOCUMENTEUR PUBLICATION INTRANET 27

28 De générer automatiquement les résultats des requêtes présentes sous cette forme, dans la publication intranet. 2.1 MODES OPERATOIRES Choix de la requête à insérer dans le diagramme Pour insérer une requête dans le diagramme, cliquer sur l icône de la barre d outils, et positionner le curseur à l endroit où le pictogramme de l objet requête sera inséré. La boîte de dialogue «Sélection de requêtes» s affiche. Sélectionner la requête souhaitée et valider par Ok. Le pictogramme représentant l objet requête s affiche dans le diagramme. La requête, devenue un objet WinDesign est nommée de la même manière que la requête sélectionnée dans le module de requêtes. Il est possible de renommer l objet requête, sans perdre la requête d origine, celle ci étant encapsulée dans l objet WinDesign. Modifier éventuellement l apparence graphique du symbole en utilisant les fonctions de styles et d affichage. Nota : La requête ainsi représentée se comporte comme tout objet de WinDesign. Elle est affichée dans le dictionnaire Exécution de la requête Pour exécuter l objet requête, double cliquer sur le symbole. La boîte de dialogue «Champ d application de l exécution» s affiche. (Exécution identique à l accès par le module de requêtes). 28 Documentation utilisateur

29 Cocher les cases correspondant à vos choix, puis cliquer sur le bouton «Suivant». La boîte «Assistant d exécution de la requête» s affiche. Saisir éventuellement les valeurs de paramètre, puis cliquer sur le bouton «Terminer» pour lancer l exécution de la requête. En fin d exécution, la boîte de présentation des résultats de la requête s affiche. Nota : le champ d application de la requête ainsi que les valeurs de paramètres restent mémorisés dans l objet requête et ne seront pas redemandés à l exécution suivante. Pour réinitialiser les valeurs, utiliser les boutons de la boîte pop up de définition de l objet requête (cf. chapitre ci après) Options d affichage et de mises à jour de la requête Pour accéder aux options de mises à jour de la requête, afficher la boîte pop up de définition de l objet requête. REQUETES DOCUMENTEUR PUBLICATION INTRANET 29

30 Cocher cette case pour afficher l objet requête dans le diagramme, sous forme d un décompte des occurrences, résultats de la requête, pour chaque branche, pour laquelle cette option aura été demandée. Cette option d affichage doit être définie lors de la création de la requête, en cochant l option «Compter les objets», pour les niveaux pour lesquels l affichage en mode compteur est souhaité, dans la boîte de dialogue «Assistant de création d une requête». Nota : cette option n est active dans la boîte de définition de l objet requête, que si l option «compter les objets» a été sélectionnée à la création de la requête. Cette option permet de relancer automatiquement l exécution de la requête pour mise à jour, au lancement de la génération du site intranet. Les résultats de la requête seront publiés dans la documentation intranet comme dans les versions précédentes. Cette option est particulièrement intéressante et permet de relancer automatiquement l exécution de plusieurs requêtes à partir de leur insertion dans les diagrammes et de publier leurs résultats. 30 Documentation utilisateur

31 Permet de réafficher la boîte «Champ d application de l exécution» pour modifier le champ d application de la requête. Ce choix est mémorisé dans l objet requête. Permet de réafficher la boîte «Variables de la requête» pour modifier les valeurs des paramètres. Ce choix est mémorisé dans l objet requête. La requête d origine est encapsulée dans l objet requête inséré graphiquement. Les définitions d origine et celle de l objet requête sont autonomes. Dans le cas d une modification de la requête d origine, cette modification n est pas impactée automatiquement. Pour remettre la requête encapsulée en conformité avec la requête d origine, utiliser cette option. 3. DOCUMENTEUR : PRINCIPES Le documenteur de WinDesign est destiné à produire la documentation au format rtf (traitement de texte type Ms Word ) de l ensemble des objets modélisés. Ce documenteur est construit à partir du système de requêtes pour l extraction des objets du référentiel, et d un paramétrage pour la mise en forme des restitutions (maquettes de présentation). La définition et les paramétrages des éditions sont stockées dans le fichier : WdEditions.dat. Ce fichier est installé à l origine dans le dossier : DONNEES de l installation de WinDesign. Nota Il est conseillé, comme pour tous les fichiers de paramètres destinés à être modifiés, de le copier dans un dossier partagé spécifique. 3.1 SELECTION D UNE EDITION L exécution et la définition des éditions peuvent se faire : Globalement à partir du menu «Générer documentation Edition standard (rtf)» du menu «Fichier» ou en activant l icône Spécifiquement pour un ou plusieurs objets sélectionnés de même type au niveau graphique, à partir de la fonction «Documenter» du menu contextuel de l objet. 1 er mode global Activez l icône ou sélectionnez la fonction «Générer documentation Edition standard (rtf)» du menu «Fichier. La boîte de dialogue «Gestion des éditions» s affiche. REQUETES DOCUMENTEUR PUBLICATION INTRANET 31

32 La partie gauche présente la liste des éditions disponibles, organisées par groupes de thèmes. La liste des éditions peut être filtrée par module et/ou par type d objet, à partir de la liste déroulante figurant en haut de la partie gauche. Sélectionnez une édition. Des options s affichent dans la partie droite de la fenêtre. Elles correspondent à une partie des paramétrages (cf. Paramétrages des éditions). 2 ème mode : sélection d objet(s) sur le diagramme Ce mode opératoire est destiné à documenter un objet ou une sélection d objets de même type. Sélectionnez le ou les objets sur le diagramme, puis, à partir du menu contextuel de l objet, sélectionnez la fonction «Documenter la sélection» ou «Documenter les objets de même type». La boîte de dialogue «Filtrage édition» s affiche. 32 Documentation utilisateur

33 La liste est filtrée par rapport au type d objet et ne présente que les éditions pertinentes pour le type d objet sélectionné. Sélectionnez l édition, puis cliquez sur le bouton «Exécuter» pour fermer la boîte de dialogue et lancer l exécution de l édition. 3.2 EXECUTION D UNE EDITION Le lancement de l exécution de la requête peut se lancer à partir de la boîte de gestion des requêtes, soit par activation du bouton «Exécuter», soit en activant l icône. L exécution se terminera alors par l appel de l éditeur rtf. L édition peut être également exécutée en mode «Requête», en activant l icône L exécution se terminera alors par l affichage des résultats dans une fenêtre (comme pour l exécution d une requête). L exécution de l édition se fait en 2 phases assistées : Phase 1 : Affichage de la description textuelle de l édition REQUETES DOCUMENTEUR PUBLICATION INTRANET 33

34 Cette boîte est purement informative. Sur option, l affichage de cette boîte peut être supprimé. Cochez ou non cette case à partir de la boîte «Assistant de création d une édition», dans l onglet «Information» de la boîte de dialogue.. Phase 2 : Définition du champ d application de l édition Par choix de cases à cocher, précisez l étendue de la recherche des objets à documenter, comme pour une requête. Il s agit : Des modèles ouverts ou actifs De tous les modèles de l espace de travail Ou éventuellement d un choix de modèles, dont on précise la liste à partir du bouton «Ajouter» après sélection de l option «Modèles de la liste suivante». On peut également, sans précision de modèle en particulier, donner un dossier ou répertoire du gestionnaire de fichiers, avec une option de parcours des sous répertoires. Cette option permettra d exécuter l extraction de données à partir des fichiers WinDesign existants à cet emplacement. Choisissez le champ d application et cliquez sur le bouton «Terminer». L exécution de l édition s effectue. A l issue de l exécution, le traitement de texte par défaut est ouvert. Nota : Une édition générée comporte la plupart du temps des insertions de fichiers et des codes de champs exécutant des opérations particulières (constitution d une table des matières, ). Dans le cas de Ms Word, ces insertions ne sont pas exécutées automatiquement à l ouverture du document. Pour constituer totalement le document, il est nécessaire de procéder de la manière suivante : Sélectionnez tout le document et appuyez sur la touche de fonction du clavier F9. 34 Documentation utilisateur

35 MSWord exécute toutes les insertions et codes de champs intégrés dans le document et présente ce document complètement. Le résultat dépend à la fois du contenu défini dans la requête d extraction et de la présentation définie par les maquettes d édition. 3.3 CONSTRUCTION D UNE REQUETE D EDITION Une édition est composée d une requête pour l extraction du contenu des objets du référentiel. Ces données extraites sont présentées à l aide de maquette d édition ( Cf. Maquettage de présentation des éditions). La construction d une requête d édition est identique à celles du module de requêtes Création d une requête d édition Pour créer directement une requête d édition, activez l icône. La boîte de dialogue «Gestion des éditions» s affiche. Elle présente la liste des éditions existantes. Cliquez sur. L assistant de création de requête affiche la boîte du méta modèle de WinDesign, présentant par module l ensemble des types d objets utilisables dans la requête. Choisissez un des modules, puis à l intérieur, le type d objet correspondant au 1 er niveau de l édition. On peut également, à l aide de la liste déroulante du haut de la boîte, filtrer la liste des éléments en choisissant les objets du modèle courant. Seuls les types d objets présents dans le modèle courant seront affichés. REQUETES DOCUMENTEUR PUBLICATION INTRANET 35

36 Cliquez sur Ok pour valider le choix du type d objet sélectionné. Nota : il est possible de choisir n importe quel niveau de la hiérarchie des types d objets. Dans le cas du choix d un type d objet comportant des stéréotypes, l extraction portera par défaut sur l ensemble des objets du même type. Une option permet de limiter l extraction au seul type d objet sélectionné. La boîte d assistant de création d une édition s affiche, présentant dans la partie gauche la fenêtre de construction de l arbre d extraction et dans la fenêtre de droite les éléments descriptifs pour chaque niveau défini. Lorsque la racine «Edition» est sélectionnée, la partie droite concerne des informations générales de l édition. Saisissez les champs correspondants. Cliquez sur le 1 er nœud de l arbre (opération métier dans l exemple) et appliquez éventuellement des critères sélectifs comme pour une requête et sélectionnez les liens intéressant l édition à partir de l opération métier. Pour les modes opératoires détaillés, se reporter au chapitre «Requêtes» de ce même manuel Particularité de la définition des requêtes d éditions par rapport aux requêtes standard Dans la partie droite des informations relatives à un niveau, les cases à cocher «Afficher les objets dans le résultat» et «Afficher le groupe dans le résultat» cochées par défaut, correspondent à la présence de ce niveau dans la présentation de l édition (niveau explicitement intégré). Dans le cas où, pour des raisons de présentation, on souhaite sauter un niveau, qui ne sera pas apparent dans l édition résultante, décochez les cases. Dans la partie droite des informations relatives à un niveau, la case à cocher «Inclure des types spécialisés» est vraie par défaut. Les liens à partir d un objet sont définis en mode descriptif. Cf. Colonne «Descriptif» dans l affichage des liens d un niveau. 36 Documentation utilisateur

37 Lorsque cette option est prise, les niveaux secondaires de l arbre ne sont pas pris comme un critère sélectif (dans l élaboration de requête standard, l option par défaut est inverse). Exemple : si une opération métier n a pas d activité en amont, ni de lien en entrée, l opération fera quand même partie de l extraction. Dans le cas où cette option est décochée, seules les opérations ayant une activité amont et/ou un lien en entrée (suivant opérateur choisi) feront partie de l extraction Renommage des nœuds de l arbre Dans certaines maquettes de présentation, le type d objet du nœud de la requête est inséré. Il peut donc être intéressant, pour gérer les titres de certains niveaux de l édition, de modifier le nom affiché dans l arbre, pour le rendre plus explicite, soit en modifiant le champ «Rôle» directement dans la partie droite de la boîte, ou en éditant (clic long) le nom du nœud dans l arbre. Exemple : Grouper des objets du même niveau Dans le cas où à partir d un lien (dans l exemple : lien objet en entrée), on peut accéder à plusieurs objets différents, l extraction constituera une liste séparée pour chacun d entre eux. Dans le cas où on ne souhaite qu une seule liste, les nœuds correspondants aux objets de même niveau doivent avoir le même nom. Dans l exemple ci dessus, le titre de la liste unique est «Entrées». Les objets composant ces entrées sont bien entendu distingués dans leur type Requêtes d édition spécifiques Pour documenter des structures complexes (exemple : une procédure et son contenu détaillé, un package et les objets contenus, ), et afin de ne pas redéfinir à chaque fois chacun des éléments (exemple : fiche d une opération) suivant le contexte, un nœud d une édition peut appeler (au lieu d une maquette de présentation) une autre édition avec tous ses niveaux descriptifs. Pour qu une édition soit exécutée à partir d une autre édition, c est à dire exécuter cette autre édition comme si elle était définie dans celle d origine (éditions imbriquées), sélectionnez le nœud correspondant et appuyez sur le bouton «Edition». REQUETES DOCUMENTEUR PUBLICATION INTRANET 37

38 Choisissez une édition déjà définie. La liste proposée est celle des éditions dans lesquelles le type d objet sélectionné est racine de la requête. L exécution de l édition d origine se comportera exactement comme si les deux arbres de requête étaient fusionnés. Il n y a pas de limite théorique au niveau du nombre d imbrications Convertir une requête existante en édition Pour transformer une requête déjà définie, en requête d édition, affichez l arbre des requêtes. Sélectionnez la requête dans la liste, puis activez la fonction «Convertir en édition» à partir de son menu contextuel. La requête se retrouve affichée en fin de liste dans la boîte de gestion des éditions. 38 Documentation utilisateur

39 3.4 MAQUETTAGE DE PRESENTATION DES EDITIONS Les maquettes de présentation des éditions correspondent à un paramétrage pour la mise en forme des restitutions des éléments extraits par le système de requête. Ces maquettes sont définies avec l éditeur de texte. La définition et les paramétrages des éditions sont stockées dans le fichier : WdEditions.dat Affectation d une maquette d édition à un nœud Pour affecter une maquette existante à un nœud de l arbre de requête, sélectionnez le nœud et cliquez sur le bouton dans la partie droite de la fenêtre. La boîte de gestion des maquettes s affiche. Les dossiers dans lesquels figurent les maquettes se trouvent dans le répertoire : MAQ_EDITIONS sous dossier de DONNEES (installation WinDesign). A la racine de ce dossier, on trouvera des maquettes spécifiques utilisées à l intérieur d autres maquettes, pour des listes particulières comme par exemple : les documents associés, les diagrammes auxquels participe un objet, Le sous dossier «Standard» comprend les maquettes standard banalisées utilisables pour tous les types d objets WinDesign. Le dossier «Decor» comporte les maquettes des pages de garde, entête et pied, table des matières et index. Les autres dossiers comportent des maquettes spécifiques à des types d objets particuliers. Ces sous dossiers sont organisés par module de WinDesign. Choisissez le dossier dans la liste déroulante ou sélectionnez le bouton pour changer de dossier. REQUETES DOCUMENTEUR PUBLICATION INTRANET 39

40 Nota : les chemins d accès au dernier dossier utilisé figurent dans la liste déroulante. Dans le paramétrage standard fourni, des maquettes génériques sont proposées (valables pour tous les types d objet). Ces maquettes se trouvent dans le dossier «Standard» de MAQ_EDITIONS. Certaines maquettes proposent une présentation sous forme de fiche détaillée (Exemple : Wd standard fiche objet.rtf ), d autres proposent une présentation sous forme de liste secondaire (Exemple : WD standard liste Objet niv 1.rtf ). Des variantes par rapport à ces standard sont également proposées, soit pour traduire des niveaux de profondeur, soit pour permettre de structurer une forme de dossier. Exemple : WD standard fiche dossier 1.rtf. Sélectionnez la maquette correspondante et cliquez sur le bouton «Associer». Le nom de l édition apparaît en haut de la boîte dans le champ «Fichier». Le bouton «Aperçu» permet d appeler le fichier de la maquette avec le traitement de texte rtf standard. Cliquez sur le bouton «Fermer» pour quitter la boîte. Le nom de la maquette s affiche dans l assistant de création de l édition dans la partie droite de la fenêtre. Chaque maquette est définie par un fichier au format rtf construit directement dans le traitement de texte et par un fichier *.bin qui contient les informations de la maquette dans un format interne à WinDesign, permettant l exploitation de cette maquette. Le bouton indique par sa couleur (rouge ou verte) la validité de la compilation du fichier.rtf en fichier interne. La couleur rouge, indique qu il existe des incompatibilités entre le contenu de la maquette et l exécution possible. Cf. Construction des maquettes Construction d une maquette d édition Un maquette doit être créée directement dans l éditeur rtf (Word ), son type de fichier est obligatoirement.rtf et comprend : 1) Une structure minimum Exemple de la maquette : «WD standard liste Objet niv 1» #HEADER# : Correspond à l entête du contenu suivant, en général, on met des titres des entêtes de colonne de tableau,.. Dans l exemple ci dessous le (*TITRE_NIVEAU*) est le nom du nœud de l arbre d édition documenté, (*IMAGE_TYPE_OBJET*) correspond à l icône du type d objet dans le dictionnaire de Win Design (*IMAGE_TYPE_OBJET*) (*TITRE_NIVEAU*) #BODY# Corps de l édition, comprend la présentation et les mots clés des caractéristiques de Win Design Exemple : 40 Documentation utilisateur

41 (*IMAGE_TYPE_OBJET*) (*LIBELLE*) (*NOM*) (*ALIAS*) (*DESCRIPTION*) (*TEXTE*) (*NOM_STEREOTYPE*) #FOOTER# Pied de l édition en général correspond à la «fermeture» associé à l en tête. Souvent le pied contient des éléments de présentation (trait, saut de page,..) et peu de caractéristiques #END# Au delà de ce «marquage» de fin d édition rien n est pris en compte 2) Des mots clés Ces mots clés correspondent aux caractéristiques des types d objets dans Win Design. La syntaxe est : ( AAAA) La liste des mots clés est disponible en annexe de ce manuel. Cf. Manuel Annexe : Mots clés édition, où vous trouverez une restitution de ces mots clés. Mots clés particuliers Ce sont des mots clés qui appellent une maquette qui présente une «liste de» interne à l objet documenté ou déclenche un traitement particulier (insertion de diagramme, traitement simultané de niveaux, ). REQUETES DOCUMENTEUR PUBLICATION INTRANET 41

42 3.4.3 Cas particulier de la construction d une maquette contenant plusieurs niveaux Pour créer une requête servant de base à l extraction des données pour une édition, on construit un arbre à partir d un objet «racine» et comportant «n» niveaux de profondeur. De manière générale, chaque niveau apparaît dans l édition, dans l ordre dans lequel il figure dans l arbre, avec éventuellement une maquette associée à chacun de ces niveaux. Dans une maquette, hormis les mots clés particuliers, seules pourront figurer les valeurs de caractéristiques de l objet correspondant au niveau traité. A partir de la Version 11 de WinDesign, un dispositif particulier permet, dans une même maquette, d introduire des mots clés permettant de traiter plusieurs niveaux. Ceci permettra en particulier dans l édition, de présenter les objets sur une même ligne, sans être obligé de faire une présentation par niveau consécutif. Exemple : Fiche d un bloc applicatif avec la maquette décrivant le bloc applicatif et plusieurs niveaux d objets liés. 42 Documentation utilisateur

43 L insertion du traitement d un niveau dans la maquette se fait de la manière suivante : Titre du niveau Pour insérer le titre du niveau (correspondant au nom du lien entre l objet «maître» et l objet lié) il faut utiliser le mot clé : (*TITRE_NIVEAU_LIEN_XX*) dans lequel «XX» est le numéro du lien dans la hiérarchie de l arbre. Exemple : L image ci dessous présente l arbre de la requête pour la fiche générale du bloc applicatif. Le (*TITRE_NIVEAU_LIEN_01*) sera égal au lien «Urbanisme». Le «02» correspondra à «Unité Organisationnelle», REQUETES DOCUMENTEUR PUBLICATION INTRANET 43

44 Bloc appelant une maquette descriptive du niveau Pour insérer dans cette maquette la description d un objet appartenant à un autre niveau, il faut utiliser le mot clé : (*BLOC_LIENS_Standard_XX*) dans lequel «XX» est le numéro du lien dans la hiérarchie de l arbre. Ce mot clé appellera la maquette : BLOC_LIENS_Standard Cette maquette contiendra la présentation et les caractéristiques à insérer dans la maquette d origine. Dans l exemple ci dessous, les mots clés permettant d insérer l icône du type d objet et le nom de l objet sont utilisés. Ce sont ces caractéristiques qui seront insérées à l intérieur de la maquette d appel. Nota : ce traitement particulier nécessite de rajouter le mot clé (*DEB*) avant tout mot clé à insérer, et le mot clé (*FIN*) à la fin des mots clés à insérer. 44 Documentation utilisateur

45 Exemple de résultat d insertion Nota : dans cet exemple et comme indiqué précédemment, des objets appartenant à des niveaux différents peuvent ainsi figurer sur la même ligne. Ici par exemple : «objets métier» et «activités métier» Compilation de la maquette Une fois le fichier de présentation au format rtf enregistré, au retour de WinDesign, une opération de compilation automatique est effectuée. Elle vérifie que la maquette ne présente pas d anomalie et qu elle est bien exécutable par WinDesign, en particulier pour la validation des mots clés insérés. Cette compilation a pour résultat un fichier *.bin qui sera utilisé par le documenteur dans l exécution de l édition. Dans certains cas, une fenêtre apparaît, fournissant un diagnostic des anomalies. 3.5 OPTIONS COMPLEMENTAIRES AVANT EXECUTION DE L EDITION Une fois que l édition est constituée de sa requête, des options générales peuvent être encore prises. Ces options sont accessibles à partir de la boîte de gestion des éditions. Dans le cas où on vient de construire une édition, dans la boîte de construction appuyez sur le bouton «Ok» pour retourner à la boîte de gestion des éditions. A la sélection de l édition, la partie droite de la boîte de dialogue affiche un ensemble de choix et paramètres modifiables avant l exécution. REQUETES DOCUMENTEUR PUBLICATION INTRANET 45

46 3.5.1 Groupe «Eléments à insérer» Ce groupe concerne les éléments complémentaires à la mise en forme des éditions. Il s agit de choisir la présence ou non de ces éléments et éventuellement les fichiers correspondant (documents de type rtf). Page de garde Il s agit d une présentation externe qui sera insérée au début de l édition générée. La composition de cette page de garde est libre et enregistrée dans un fichier. Entête/Pied de page Définition et présentation de l entête et du pied de page de l édition générée. La définition est effectuée à partir du traitement de texte rtf. La composition est libre et peut être complétée par des mots clé relatifs aux caractéristiques décrites dans WinDesign (Cf. Paramétrage des maquettes d éditions). Table des matières et index Composition de la table des matières et de l index. La définition est libre et construite à partir du traitement de texte rtf. Ces tables sont complétées par des mots clé de WinDesign. Le marquage des entrées de tables sont définies dans les maquettes des éditions proprement dites. Légende des types Dans la plupart des éditions, il est prévu d insérer les icônes des types d objets. Ce fichier permet d insérer la légende explicative de chaque icône utilisé à la fin du document généré Groupe «Options générales» Mise en forme par défaut Une édition est obligatoirement constituée à partir d un objet dit «racine», qui correspond à l objet principal de l édition et à d autres objets secondaires auquel il est relié (cf. Références croisées). A chaque objet participant à l édition, on peut affecter une maquette de présentation spécifique (Cf. Affection maquettes). Dans le cas où les présentations sont banalisées, pour éviter de préciser à chaque nœud d une édition la maquette correspondante, on peut définir des maquettes par défaut. 46 Documentation utilisateur

47 Ces maquettes correspondent au 1 er niveau (objet racine) et aux objets de 2 ème niveau (objets secondaires). Dans le cas où des maquettes sont précisées dans le détail de l édition, ce sont ces maquettes qui sont prises en compte et non pas les maquettes par défaut. Nota : les niveaux au delà du niveau 2 doivent être impérativement associés à des maquettes spécifiques dans l arbre de la requête. Le choix de ces maquettes par défaut est conservé pour les autres utilisations des éditions Choix d une maquette de mise en forme Cliquez sur le champ de la colonne valeur pour les objets racines ou pour les objets secondaires. La boite des maquettes de la gestion des éditions s affiche (Cf. Affectation maquettes). Sélectionnez une maquette pour l utiliser comme maquette par défaut dans l édition courante Options diverses Spécification des images de diagrammes On peut régler les paramètres de présentation des diagrammes (et de ses éventuelles miniatures) dans le document produit. Références croisées A partir de la version 9, les références croisées ont été étendues à l ensemble de l espace de travail. Cette option permet de choisir entre le champ d application de l espace de travail et celui du modèle de l objet pour les références croisées. Fichier à générer Lors de la génération du document relatif à l édition, un fichier temporaire est constitué. Il peut être enregistré après ouverture. On peut également préciser par cette option, directement et à priori, un nom de fichier dans lequel sera mémorisé le document résultant de l exécution. 3.6 ENREGISTREMENT DE LA MAQUETTE D EDITION Toutes les maquettes doivent se trouver dans un même dossier. Par défaut dans l installation de WinDesign, les maquettes se trouvent dans le sousdossier «DONNEES MAQ_EDITIONS». A posteriori l emplacement peut être quelconque, mais le dossier doit conserver le nom «MAQ_EDITIONS». Ce dossier peut être constitué de sous dossiers. Nota : lors du choix d une maquette d édition, il est possible de sélectionner un répertoire dans lequel se trouvent ces maquettes. On peut donc disposer de plusieurs jeux de maquettes en fonction de leur emplacement. REQUETES DOCUMENTEUR PUBLICATION INTRANET 47

48 4. GENERATION DU SITE DOCUMENTAIRE INTRANET WinDesign permet de générer le site documentaire intranet, pour tout ou partie de l espace de travail ouvert. La génération du site se fait par une fonction d export XML et une mise en forme à partir de fichiers XSL. Nota : pour la génération du site documentaire, vous devez disposer d un navigateur gérant ces deux formats. 4.1 APPEL DE LA FONCTION Pour générer la documentation intranet de votre espace de travail courant, activez la fonction «Générer documentation intranet» du menu «Fichier» ou activez l icône. La boîte de dialogue «Documentation intranet» s affiche. 4.2 DESCRIPTION DE LA BOITE «DOCUMENTATION INTRANET» Cette boîte de dialogue présente 4 onglets, vous permettant d effectuer des choix sur : Le dossier à générer Les éléments à exporter Les points d entrée à générer Les fichiers de mise en forme et le thème de présentation à appliquer Le répertoire d export 48 Documentation utilisateur

49 4.2.1 Onglet «Général» Liste de choix : Dossier Cette liste de choix présente les dossiers d édition, qui ont été pré définis et sauvegardés. Les options appliquées sur ces dossiers ont été définies : Dans l onglet «Général» pour les fichiers de mise en forme à appliquer et le répertoire d export Dans l onglet «Options» pour le choix des types de modèles et les fichiers à exporter, de la présentation des fiches descriptives des objets et de leur contenu, de l insertion ou non du dictionnaire et des requêtes dans l arbre. Dans l onglet «Apparence» pour insérer ou non une entête et un pied de page, et choisir éventuellement un thème de présentation à appliquer pour la génération du site documentaire intranet Dans l onglet «Divers» pour les options à appliquer sur les images exportées et le choix de la langue de présentation de la documentation intranet Groupe : Documenter Ce groupe de choix vous permet de préciser quels sont les éléments à documenter : l espace de travail ou la branche sélectionnée. Par défaut, si aucun élément (aucune branche) n est sélectionné dans l espace de travail à l ouverture de la boîte, tout le contenu de l espace de travail sera documenté. Lorsqu à l ouverture de la boîte, une branche de l arbre est sélectionnée, l option «Branche» exportera uniquement le contenu de celle ci. Dans ce cas, l option «Tout l espace de travail» peut également être choisie par radio bouton, et viendra en remplacement de l option proposée par défaut. Lorsqu un espace de travail a déjà été généré et que des modifications ont été effectuées uniquement dans une branche de l espace de travail, pour éviter de re générer l ensemble de la documentation y compris pour des modèles non modifiés, cochez l option. Seule la branche sélectionnée sera re générée et avec l arbre réactualisé Groupe «Répertoire d export» Cette zone contient le chemin d accès du dossier dans lequel les fichiers seront générés. REQUETES DOCUMENTEUR PUBLICATION INTRANET 49

50 Si l option «Effacer le contenu du répertoire d export» est cochée, l ensemble des éléments de ce répertoire seront effacés à chaque nouvel export Onglet «Options» Cet onglet permet de préciser le contenu de l export. Cochez ou décochez les cases correspondantes en fonction de vos choix Groupe «Dictionnaire» Seulement les diagrammes Cette option permet de générer un site intranet «Minimal» présentant uniquement les diagrammes et leurs enchaînements. Les fiches descriptives des objets ne sont pas générées. Le passage de la souris sur les objets du modèle affichera une bulle d aide présentant le texte de description de l objet (saisi à partir de la boîte pop up de l objet : nom et libellé). Dictionnaire par modèle, dictionnaire global Cette option permet d insérer le référentiel des objets dans l arbre de navigation. Deux types de listes dictionnaire seront proposées : une présentant les objets par modèle, l autre présentant la liste de l ensemble des objets A partir de ce référentiel, on peut accéder à la fiche descriptive de chaque objet. Dictionnaire sans les objets inclus Cette option permet de ne pas générer le référentiel les objets inclus, comme par exemple les propriétés, les attributs, Ces objets sont documentés mais non accessibles par le référentiel. Requêtes générées Cette option permet d insérer la liste des requêtes exportées pour exploiter leur résultat dans la documentation intranet. Nota : les résultats des requêtes doivent avoir été exportés au format HTM et doivent être sauvegardés dans le même répertoire que celui de la documentation intranet. 50 Documentation utilisateur

51 Recherche avancée Si cette option est cochée, le dictionnaire global sera automatiquement généré. Cette option permet d élargir les options de recherche dans la documentation intranet. Par défaut, la recherche s effectue sur le nom des objets. Cette option donne la possibilité d effectuer un filtrage sur les types et stéréotypes d objets et d élargir la recherche sur d autres caractéristiques des objet : alias, libellé, annotation, bloc note et caractéristiques étendues Groupe «Affichage des données» Sous forme d onglets Cette option présentera les fiches descriptives des objets avec leurs caractéristiques classées par onglets. Les options suivantes permettent de définir les éléments présentés dans la fiche descriptive des objets (détail, références croisées, ). Détail des objets composés Si cette option est décochée, la fiche descriptive des objets de type «propriété» pour les entités, «attribut» pour les tables, ne sera pas générée. Ce choix peut être fait pour éviter des volumes trop important du fichier généré. Ces objets «composants» seront cependant visibles dans l onglet «Références croisées» de l objet composé et seront accessibles à partir du dictionnaire. Impacts Cette option permet de générer les références croisées des objets. Par défaut, les références croisées seront présentées sous forme d arbre. L option «Présentation en tableau» affichera les références croisées sous forme de tableau. Administration Cette option générera les informations saisies à partir de l onglet «Administration» des boîtes pop up de description de l objet (auteur, date de création, ) Onglet avec tout Cette option génèrera un onglet intitulé «Tout» dans lequel seront regroupées toutes les caractéristiques descriptives de l objet, présentées dans les autres onglets (définition, diagrammes, références croisées, ). Fichiers et documents associés Cette option permet de générer un onglet présentant les documents associés aux objets. Ces documents seront accessibles en lien hypertexte dans la fiche de l objet et également à partir de la bulle d aide affichée lors du passage du curseur sur l objet dans le diagramme. REQUETES DOCUMENTEUR PUBLICATION INTRANET 51

52 Groupe «Modèles documentés» Sélectionnez dans ce groupe de choix les types de modèles à exporter en cochant ou non les cases correspondantes. Pour les maquettes (maquettage de l IHM, réalisé avec le module User Interface de WinDesign), précisez si l export se fait sous forme d images ou en HTML. Le choix «HTML» vous permet de pouvoir tester les enchaînement s d écrans (boutons actifs). L objet «Onglet» ne pouvant être exporté, un panneau vous demandera en cours d export, de préciser, pour chaque maquette contenant un onglet unique, si celui ci doit être simulé. A la demande «Voulez vous exporter la maquette sous forme d onglet?», sélectionnez «Oui». Plusieurs fichiers seront alors générés pour imiter le fonctionnement de l onglet. S il y a plusieurs onglets sur la même maquette ou si l utilisateur le décide, les onglets peuvent être exportés sous forme de cadre avec la mention [onglet non exporté] Onglet «Points d entrée» Cet onglet vous permet de définir plusieurs points d entrée possibles pour le site intranet généré. 52 Documentation utilisateur

53 A la fin de la génération intranet, une boîte de dialogue sera ouverte. Elle permettra de sélectionner le point d entrée du site intranet (page d accueil), puis de visualiser le résultat dans un navigateur. Si plusieurs points d entrée ont été créés, elle permet de sélectionner l un d entre eux dans une liste. Le point d entrée proposé par défaut correspond au nom de l espace de travail. Le fichier «wd_main.htm» présent à l ouverture de l onglet, correspond au fichier de la page par défaut. Ce point d entrée ne peut pas être supprimé. La colonne «Titre de la page html» est éditable. Par défaut, le titre correspond au nom du fichier. Ce titre peut être modifié. Il apparaîtra dans la barre du navigateur Créer un nouveau point d entrée Pour créer un nouveau point d entrée, cliquer sur l icône. La boîte de dialogue «Choix de la page de démarrage de la documentation intranet» s affiche. Cette boîte permet de sélectionner en point d entrée, soit un modèle, soit un lien web. Choix d un modèle 1 Choix du modèle courant Cochez l option pour définir le modèle courant comme page de démarrage, puis sélectionner un diagramme de démarrage à partir de la liste, présentant l ensemble des diagrammes du modèle courant. REQUETES DOCUMENTEUR PUBLICATION INTRANET 53

54 Cliquer sur «Terminer» pour valider votre choix et fermer la boîte de dialogue. La ligne du nouveau lien apparaît sélectionnée dans l onglet «Points d entrée» et s affiche sous la forme : nom du diagramme_index.htm. Renommer éventuellement le point d entrée, pour plus de clarté. Nota : ce nom est celui qui apparaîtra dans la liste de choix proposée dans la boîte de dialogue affichée à la fin de la génération de la documentation intranet. 2 Choix d un modèle de l espace de travail Même procédure que pour le modèle courant. Choix d un lien web Saisir ou effectuer un copier/coller de l adresse du lien web qui servira de point d entrée, puis cliquer sur le bouton «Terminer». La ligne du nouveau lien apparaît sélectionnée dans l onglet «Points d entrée». Ce fichier est nommé par défaut : «intranet_index.htm». Renommer éventuellement le fichier pour plus de clarté. Nota : si vous souhaitez créer plusieurs points d entrée correspondant à des liens web, il est impératif de renommer chaque fichier, pour les différencier dans la liste de choix. 54 Documentation utilisateur

55 L ensemble des points d entrée créés seront générés dans le répertoire de génération de la documentation intranet Supprimer un point d entrée de la liste Pour supprimer un point d entrée, sélectionnez le dans la liste et activez l icône Nota : Par défaut, en standard dans WinDesign, la page de garde du site intranet est nommée : wd_main.htm. Cette page ne peut pas être supprimée de la liste Sauvegarder les points d entrée Les points d entrée peuvent être définis de manière ponctuelle. Pour les sauvegarder, activer le bouton «Sauvegarder» avant de lancer la génération de la documentation intranet Onglet «Apparence» Groupe «Frame entête Frame pied Frame gauche» Entête et pied de page Ce groupe d options permet d insérer une entête et / ou un pied, pour toutes les pages du site documentaire intranet. Des fichiers sont proposés en standard. Ces fichiers peuvent bien entendu être modifiés et personnalisés par l utilisateur. Frame gauche pour le menu Cette option permet de définir la largeur du menu présentant l espace de travail, affiché à gauche de la page. Ajouter une bordure aux frames Cette option permet d insérer une bordure en dessous de l entête, au dessus du pied de page et à droite de l arbre des modèles Groupe «Thème de présentation» REQUETES DOCUMENTEUR PUBLICATION INTRANET 55

56 Ce groupe permet de sélectionner un thème de présentation à appliquer à la génération du site documentaire intranet. Une bibliothèque de thèmes est proposée par défaut. L utilisateur peut modifier des thèmes existants ou créer sa propre bibliothèque de thèmes personnalisés Onglet «Divers» Groupe d options «Images des diagrammes» Ce groupe d options permet de définir les options à appliquer sur l export des images des sousmodèles. Qualité de l image Cette valeur joue sur la qualité de l image et son volume. La valeur proposée par défaut (100) rend un bonne qualité de l image. Ce taux peut être modifié (de 1 à 100). Plus le taux sera élevé, plus la qualité de l image sera bonne, mais plus sa taille sera importante. Affichage par défaut Cette option permet de définir la taille d affichage par défaut de l image des modèles. Par défaut, les modèles sont générés en taille réelle, tels que présentés à l écran. L option «Taille ajustée en largeur» permet d afficher l image des diagrammes en tenant compte de la précision d affichage de l écran, de manière à pouvoir ajuster cette taille à la largeur de celui ci. Exemple : si la précision d affichage de l écran est de 800x600, 600 exprime la taille en pixels de la largeur. Saisir alors une valeur inférieure au nombre de pixels maximum en largeur (500 par exemple), pour tenir compte des autres éléments affichés. Si la largeur de l image du modèle est supérieure à la largeur définie pour l affichage et si l option «Taille ajustée en largeur» est cochée, un icône s affiche dans l angle supérieur gauche et dans l angle inférieur droit de l image du modèle permettant d agrandir ( zoom vers taille réelle) l image du modèle, puis ensuite, à l inverse, de la réduire ( ajustement en largeur). Ajouter une diaporama pour les modèles et groupes de diagrammes 56 Documentation utilisateur

57 Cette option permet d ajouter un diaporama présentant l ensemble des sous modèles composant un modèle et la composition des groupes. Exemple : le modèle «Approche par les flux» est composé de 4 sous modèles. En cliquant sur le nom du modèle, son diaporama s affiche dans la partie droite. Cliquez sur la miniature du sous modèle pour afficher celui ci Option «Langage de la documentation» Cette option permet de choisir le langage de présentation de la documentation intranet (titre des onglets et des rubriques, ) et de préciser éventuellement quel doit être le terme employé pour «Dictionnaire». 4.3 LANCEMENT DE LA GENERATION DU SITE DOCUMENTAIRE INTRANET Après avoir effectué vos choix de génération et de présentation du site documentaire intranet, cliquez sur OK. Une fenêtre «Documentation Intranet» s affiche en bas de la fenêtre de travail, et présente le déroulement de l export en cours. Nota : Cette fenêtre peut être affichée ou cachée par le menu «Affichage Résultats». REQUETES DOCUMENTEUR PUBLICATION INTRANET 57

58 Une boîte de dialogue s affiche en fin d export. Cette boîte permet de sélectionner le point d entrée du site intranet et de visualiser le site dans votre navigateur. Sélectionner le point d entrée souhaité et activer le bouton «Voir». Votre navigateur s affiche et présente le site documentaire généré. 58 Documentation utilisateur

59 4.4 NAVIGATION DANS LE SITE Afficher l image d un sous modèle Pour afficher l image d un sous modèle, cliquez sur son nom dans l arbre hiérarchique. L image s affiche dans la fenêtre de droite Barre d outils de l explorateur Les icônes de la barre d outils de l explorateur permettent de moduler la présentation de l arbre hiérarchique de navigation. Cliquez sur un icône pour modifier la présentation de la liste. Afficher l arbre de l espace de travail (affichage par défaut) REQUETES DOCUMENTEUR PUBLICATION INTRANET 59

60 Afficher le référentiel local Présentation de la liste des objets par modèle Afficher le référentiel global Présentation de la liste de tous les objets de l espace de travail, tout modèles confondus Afficher l arbre des requêtes 60 Documentation utilisateur

61 Afficher la page de lancement du moteur de recherche Afficher la fiche descriptive d un objet Pour afficher la fiche descriptive d un objet du sous modèle, vous pouvez cliquer : sur sa représentation graphique dans le modèle sur son nom après avoir affiché la liste dictionnaire du modèle. La fiche descriptive s affiche. Elle présente (choix d options au lancement de la documentation intranet) les différentes rubriques relatives à l objet classées par onglet. Exemple pour l objet : «Rôle : Secrétaire sinistre» Onglet «Définition» REQUETES DOCUMENTEUR PUBLICATION INTRANET 61

62 Onglet «Diagrammes» Onglet «Impact» Dans cet exemple, l option «Impact : présentation en tableau» a été choisie. 62 Documentation utilisateur

63 Onglet «Administration» Vous pouvez ensuite naviguer par les liens hyper texte entre tous les objets reliés à l objet. La présentation et le contenu de la fiche de l objet dépendront des options sélectionnées à la génération de la documentation intranet. Cf. Boîte «Génération intranet» onglet «Options». 4.5 PERSONNALISER LA PRESENTATION DU SITE INTRANET Vous pouvez personnaliser votre site, en modifiant : La page d accueil (Bienvenue sur le site documentaire intranet) La présentation des fiches et listes (forme et contenu) La présentation de l arbre hiérarchique REQUETES DOCUMENTEUR PUBLICATION INTRANET 63

64 Le fichier d entête et/ou de pied de page Le thème de présentation Personnaliser la page d accueil Pour créer votre page de garde, utilisez un éditeur de page HTML. La page doit être enregistré sous le nom : WD_Main.htm et copiée dans le répertoire de WinDesign : \données\imp exp. Les images éventuellement insérées dans la page doivent se trouver dans le sous répertoire : \Donnees\Imp exp\html_fic Modifier la présentation des fiches descriptives Pour modifier la présentation générales des listes et fiches des objets, accédez au sous répertoire de WinDesign : \Donnees\DOC_INTRANET\XSLStandard, puis sélectionnez le fichier : Style.css, qui s ouvrira avec votre éditeur de pages HTML. La localisation des fichiers de mise en page est précisée dans la fenêtre de résultats de l export (Menu «Affichage Résultats»). Effectuez les modifications voulues dans chaque groupe, puis enregistrez le fichier. La nouvelle présentation est prise en compte et s applique à l ensemble des fiches et des listes Modifier le contenu des fiches et des listes Un fichier de présentation.xsl est généré pour chaque type d objet de l export. Ces fichiers se trouvent dans le répertoire : \DOC_INTRANET\XSL Standard Modifier la présentation de l arbre hiérarchique Pour modifier la présentation de l arbre hiérarchique, ouvrez le fichier : WDStyle.css, dans le sousrépertoire de WinDesign : \Imp exp\html_fic Effectuez les modifications de styles (polices, fond,...) puis enregistrez le fichier. La nouvelle présentation de l arbre est prise en compte lors de l export. Vous pouvez également modifier le contenu de l arbre (niveau) et les icônes à partir du fichier : WDTree.js Modifier le fichier d entête ou de pied de page Ces fichiers sont des fichiers HTML. Ces fichiers doivent impérativement être sauvegardés dans le sous répertoire de WinDesign : \DONNEES\IMP EXP\HTML_Fic. Les éventuelles images insérées dans ces fichiers doivent être également sauvegardées dans le même sous répertoire Modifier ou créer un thème de présentation Les thèmes de présentation doivent être sauvegardés dans le sous répertoire de WinDesign : \DONNEES\DOC_INTRANET\IMAGES 64 Documentation utilisateur

65 5. AUTRES MODALITES D IMPORT/EXPORT 5.1 IMPORT XML AVEC FICHIER DE COMMANDES Cette fonction permet d effectuer des imports au format XML en utilisant en complément des commandes autorisant des actions supplémentaires à la simple création/modification des objets. Cet import est une alternative à l import par le format.csv et par l import XML classique décrit ciaprès. Pour accéder à la fonction, activer la fonction «Importer Fichier de commande XML» à partir du Menu «Fichier». Cet import nécessite un format conventionnel décrit dans le document «Fichier de commandes WinDesign.pdf», accessible à partir de ce lien : design.com/fr/espace_clients.htm#notes 5.2 ASSISTANT IMPORT/EXPORT (CSV/XML) L assistant permet d exporter facilement des objets du modèle actif ou d aider à la création de fichiers d import csv ou xml, qui pourront être sauvegardés et réutilisés Création d un fichier de parametres d import/export Cette fonction est accessible soit à partir du menu «Fichier» ou du menu «Administration Outils», fonction «Importer Assistant import/export (csv/xml). Activez la fonction. La boîte de dialogue «Assistant import/export» s affiche. REQUETES DOCUMENTEUR PUBLICATION INTRANET 65

66 5.2.2 Sélection du type d objet Pour sélectionner le type d objet à exporter, activer le bouton «Sélectionner» de la partie supérieure de la boîte. La boîte «Liste de types d objet» s affiche. Effectuer votre sélection et valider par Ok Sélection des caractéristiques à afficher L onglet «Caractéristiques» présente la liste de toutes les caractéristiques du type d objet sélectionné. 66 Documentation utilisateur

67 La liste supérieure «Caractéristiques affichées» contient les caractéristiques affichées par défaut. La seconde liste propose l ensemble des caractéristiques du type d objet, classées par groupe. Pour insérer des caractéristiques complémentaires, déplier le nœud du groupe concerné, puis sélectionner la ou les caractéristiques souhaitées, en sélectionnant la case à cocher de la colonne «Afficher» (double clic). Les nouvelles caractéristiques sélectionnées s affichent en bas de la liste «Caractéristiques affichées» Sélection des objets liés Pour insérer des liens dans le fichier d import/export, cliquer sur l onglet «Objets liés». REQUETES DOCUMENTEUR PUBLICATION INTRANET 67

68 L ensemble des liens du type d objet sélectionné sont affichés, classés par groupe. Pour sélectionner un lien, déplier le nœud du groupe, sélectionner un type de lien, par double clic sur la ligne. La boîte de dialogue «Liste des types d objets» s affiche. Sélectionner le type d objet concerné et valider par Ok. Cocher éventuellement les cases ci dessous pour inclure ou non les stéréotypes enfants et/ou les types méta objet enfants, du type d objet sélectionné. 68 Documentation utilisateur

69 L ensemble des objets liés sélectionnés s affichent dans la liste «Objets liés utilisés», avec une coche dans la colonne «sélection pour l import/export». Pour supprimer un objet de la liste, décocher la case Sauvegarder les paramètres d import/export Pour sauvegarder les paramètres d import/export, activer le bouton «Sauver» de la partie supérieure de la boîte. Le format de fichier est.dat. Utiliser le bouton «Charger», pour réutiliser un de vos paramétrages Aide a l Import au format CSV Pour générer l entête du fichier d import au format CSV, sélectionner le type «CSV» dans la liste de choix, dans la partie basse de la boîte de dialogue. Activer le bouton «Générer». La boîte de dialogue d enregistrement de fichier s affiche. Nommer et enregistrer le fichier d export (.csv). L entête du fichier est générée et s affiche dans Excel. Il vous suffit ensuite de remplir le tableau Excel avec vos objets à importer. Nota : à l ouverture d Excel, si toute l entête est affichée dans une seule colonne, utiliser la fonction «Fichier Ouvrir» avec l option «Fichiers texte *csv». REQUETES DOCUMENTEUR PUBLICATION INTRANET 69

70 5.2.7 Aide a l Import au format XML Pour générer le squelette du fichier d import au format XML, sélectionner le type «XML» dans la liste de choix, dans la partie basse de la boîte de dialogue. Activer le bouton «Générer». La boîte de dialogue d enregistrement de fichier s affiche. Nommer et enregistrer le fichier d export (.xml). Le squelette XML est généré et s affiche dans votre navigateur. Remplacer ensuite : «MonObjet» «mavaleur» «MonObjetLie_x» par vos données Exporter des objets du modele actif Ouvrir le modèle à partir duquel vous souhaitez effectuer l export. Charger un fichier de paramétrage existant ou en définir un nouveau. Sélectionner ensuite le type d export (CSV ou XML), puis sélectionner l option «Générer objets du modèle actif» dans la liste de choix. Filtrer éventuellement la liste des objets à exporter par rapport à une date. Activer le bouton «Générer». 70 Documentation utilisateur

71 5.3 IMPORT XML WINDESIGN Cette fonction permet d importer un modèle dans un fichier au format XML WinDesign. Activez la fonction «Export WinDesign WXML» à partir du menu «Fichier». La boîte de dialogue «Import dans WinDesign» s affiche. Sélectionnez le radio bouton correspondant à votre import : A partir d un fichier au format WinDesign XML Il s agit de l import d un fichier XML précédemment constitué (par une interface ou une procédure externe à WinDesign). Les fichiers doivent alors être sélectionnés à l endroit où ils ont été mémorisés. C est le cas notamment pour Access 2000, pour lequel un module écrit en Visual Basic doit être exécuté dans la base de données Access, en dehors de WinDesign, pour générer les fichiers XML. A partir d une DLL WinDesign Il s agit d un import à partir de DLL, assurant l extraction de la source (ex : des écrans au format.frm de Visual Basic), générant les fichiers XML intermédiaires, et effectuant directement l importation dans WinDesign. Actuellement disponible : Visual Basic6. Les procédures et les spécifications du fichier XML, sont également fournies pour pouvoir réaliser ses propres DLL, pour assurer l extraction d autres environnements. Le tableau fournit la liste des DLLs WinDesign trouvées (dans le répertoire PROGRAMMES\DLLs). Faites votre sélection. Un ensemble de fonctions de configuration sont alors proposées en fonction de la DLL sélectionnée. Il est possible de choisir un répertoire pour la création des fichiers XML intermédiaires (par défaut un répertoire temporaire) pour conserver éventuellement ces fichiers XML. Quelle que soit l option choisie, vous pouvez conserver ou non les fichiers XML servant à réaliser l import. Par défaut, les fichiers sont supprimés si l import se fait par une DLL). Si le fichier contient des coordonnées graphiques, celles ci seront reprises. Sinon, le schéma sera regénéré de manière automatique. REQUETES DOCUMENTEUR PUBLICATION INTRANET 71

72 Option : Importer dans le dictionnaire externe Cette option remplit le dictionnaire externe de WinDesign (Cf. Menu Affichage Référentiel externe), à partir duquel les objets pourront être réutilisés par la fonction de drag & drop pour construire un nouveau modèle ou compléter un modèle existant. Une fois vos choix effectués, cliquez sur «Importer «pour exécuter l import ou «Annuler «pour quitter la fonction. 5.4 IMPORT TEXTE FORMAT CSV Cette fonction permet d importer des objets à partir d un fichier texte au format.csv (chaîne de caractères séparées par des ponctuations, en général «;»). Dans certains contexte, l utilisateur de WinDesign dispose d une liste d objets, généralement présentée sous la forme d un tableau (Excel dans la majorité des cas), qu il souhaite importer dans le dictionnaire référentiel de WinDesign. Une telle liste concerne par exemple : des serveurs, dans une cartographie technique, des applications, dans une cartographie applicative, des unités organisationnelles, dans une cartographie organisationnelle Principes de l import L import des objets s effectue en conformité avec le méta modèle de WinDesign. Il faudra donc faire correspondre les différents champs du fichier avec des objets, des caractéristiques d objets ou des liens entre objets. On peut importer : Des objets (de type identique) avec leurs caractéristiques Des liens entre l objet principal importé et ses objets environnants. Ces liens doivent être prédéfinis dans le méta modèle Pré requis Afin de pouvoir être importé dans WinDesign, le fichier source (en général issu d Excel), doit respecter les contraintes suivantes : L ensemble des objets à importer doivent être de même type (ordinateurs, blocs applicatifs, unités organisationnelles, ) mais peuvent être de stéréotypes différents Chaque champ représente une caractéristiques descriptive du type d objet à importer Toutes les caractéristiques doivent être intrinsèques au type d objet importé Une des caractéristiques doit correspondre au nom de l objet (occurrence) dans WinDesign Chaque ligne du tableau correspond à une occurrence de l objet à importer, et chaque cellule contient la valeur de la caractéristique pour l occurrence correspondante Concernant les liens : les objets liés pour un même lien, devront être présentés soit avec une séparation «;», soit en retour à la ligne. Il est conseillé de construire le fichier à partir du format.xsl d Excel, puis d effectuer un «Enregistrer sous» au format.csv. Exemple Importation des blocs applicatifs avec les liens : 72 Documentation utilisateur

73 - Hébergement serveur - Fonctionnalités réalisées Constitution du tableau Entête La première ligne doit être réservée au mots clés associés aux caractéristiques des objets et des liens à importer. 1) Caractéristiques des objets à importer Dans la mesure où l importation ne concerne qu un seul type d objet, il n est pas nécessaire de suffixer les mots clés avec le nom du type d objet. Le tableau doit comporter obligatoirement la colonne «Nom» et éventuellement si nécessaire la colonne «Nom_stéréotype». Les autres caractéristiques comme «Libellé» «Type d utilisation» et «Editeur» correspondent à des caractéristiques standards des objets WinDesign et à des caractéristiques étendues. Il n y a pas de limite sur le nombre de caractéristiques à importer. Si la syntaxe n est pas conforme à la définition de la caractéristique dans WinDesign, les valeurs contenues dans cette colonne ne seront pas prises en compte. 2) Définition des liens à importer L expression des liens comporte une syntaxe spécifique, composée : Du nom du rôle correspondant au sens de lecture entre l objet principal importé et l objet lié. Exemple : «bloc applicatif» «hébergé par» «ordinateur» (lien pré existant dans le méta modèle). On prend le nom du rôle «hébergé par», puis on précise le type d objet relié avec la syntaxe suivante : #type objet# (dans notre exemple : #ordinateur#) REQUETES DOCUMENTEUR PUBLICATION INTRANET 73

74 Complété éventuellement par le stéréotype associé au type d objet à relier, avec la syntaxe suivante : stéréotype. Dans notre exemple, les deux liens importés sont : 3) Contenu des occurrences du tableau Chaque ligne du tableau correspond à une occurrence du type d objet à importer. Dans chaque colonne figurent les valeurs des caractéristiques de cet objet. Il ne peut y avoir qu une seule valeur pour chaque colonne de caractéristique. 4) Particularités pour les liens Dans le cas où, pour un même lien défini, il existe plusieurs objets liés pour le même objet importé, utilisez le retour à la ligne (Alt Entrée) dans la même cellule de la colonne définissant le lien. On peut également utiliser le séparateur «,» en restant sur la même ligne de la cellule. Exemple : serveur agence, serveur siège Pour les objets liés, seul le nom de l objet est pris en compte Import des documents associés Les documents associés à chaque type d objet de WinDesign sont seulement liés et ne correspondent pas à des objets du méta modèle. Pour permettre l importation des liens vers des documents existants (fichiers avec chemin d accès), un mot clé supplémentaire a été rajouté : «LIENS_DOC». Dans la colonne correspondant à ce mot clé, il convient de mettre les fichiers correspondants avec leurs chemins d accès complets. 74 Documentation utilisateur

75 Ces liens se retrouveront dans la définition de l objet à partir de la fonction «Documents associés» Exécution de l import Le fichier.csv est composé de manière externe à WinDesign (en général à partir d un fichier.xls d Excel). Nota : Ce fichier.csv doit être fermé avant d éxécuter l importation Accès à la fonction d import Deux modes d accès possibles : A partir du menu «Fichier» fonction «Importer Fichier texte CSV» A partir de la boite de saisie directe des objets appelé à partir du Menu «Modèle Définition des objets ou icône «Importer» présent dans la boîte.. Une fois le type d objet sélectionné, utilisez le bouton Activez la fonction. La boîte de sélection de type d objets s affiche. REQUETES DOCUMENTEUR PUBLICATION INTRANET 75

76 Sélectionnez le type d objet correspondant à l importation (rappel : un seul type d objet par fichier importé), puis validez par OK. La boîte «Choix du fichier CSV s affiche. Sélectionnez et ouvrez le fichier.csv à importer. L assistant d importation s affiche. 76 Documentation utilisateur

77 Etape 1 : validation des formats de séparateurs Groupe : Options d import Vérifier si l objet existe dans l espace de travail (conseillé) Cette option permet de rechercher si les objets importés existent déjà dans l espace de travail, et si oui, de créer un raccourci de ces objets dans le modèle d importation. Mettre à jour les objets existants (conseillé) Si les objets existent déjà, l import modifiera les valeurs des caractéristiques des objets, par rapport à celles issues du fichier d importation. Dans le cas où la valeur de la caractéristique importée est vide et que la valeur de la caractéristique de l objet existant est remplie, c est cette dernière valeur qui est conservée. Cliquez sur suivant Etape 2 : validation des contenus Cette boîte de dialogue présente en entête les noms des caractéristiques ou les syntaxes de liens à importer, avec dans les colonnes, les valeurs associées aux occurrences des objets importés. REQUETES DOCUMENTEUR PUBLICATION INTRANET 77

78 Vérifiez la cohérence du contenu et cliquez sur terminer pour procéder à l importation. Nota : Il est conseillé en cas de doute sur la structure et le contenu de l importation d annuler l opération. La boîte «Définition d objets» s affiche. Les objets ont été importés et répartis éventuellement par stéréotype. Nota : On peut également vérifier que les liens ont été créés en utilisant l onglet «Impacts» après avoir sélectionné un objet. 78 Documentation utilisateur

79 5.5 IMPORT DE FICHIERS VISIO Principe L import de fichier Visio dans WinDesign, se fait en deux temps : Le modèle Visio est ouvert et transposé dans WinDesign, avec création dans le dictionnaire, des objets importés en objets du méta modèle WinDesign, dénommés «Objets visio» Un scénario de conversion est ensuite appliqué sur les objets importés Des scénarios de conversion sont fournis en standard. Ils peuvent être modifiés. L utilisateur peut définir ses propres scénarios de conversion Importer un fichier Visio Pré requis : le fichier à importer doit être enregistré au format.vdx. Sélectionner la fonction «Importer Visio» à partir du menu «Fichier». Sélectionner un modèle de type.vdx, puis valider par Ok. L import s effectue, avec : Création des objets dans le dictionnaire (de type «Objet visio») Récupération des objets dans leur forme et leur positionnement graphique Récupération de toutes les caractéristiques des objets Les caractéristiques récupérées sont affichées dans l onglet «Caractéristiques externes» de la boîte de définition des objets. REQUETES DOCUMENTEUR PUBLICATION INTRANET 79

80 A l issue de l import, la boîte de dialogue «Sélection du scénario de conversion» s affiche. Nota : cette boîte peut être affichée à tout moment en sélectionnant la fonction «Conversions d objets» à partir du menu «Modèle». Cette boîte permet : De créer, modifier, supprimer un scénario de conversion (voir Chapitre 3) De sélectionner et de lancer un scénario de conversion existant De sélectionner une opération d un scénario de conversion pour l exécuter de manière unitaire Choix d un scénario ou d une opération de conversion Pour exécuter un scénario de conversion, à partir de la boîte de dialogue «Sélection du scénario de conversion», sélectionner le scénario à appliquer, puis activer l icône. Pour exécuter uniquement l une opération des opérations de conversion, sélectionner le scénario dans la liste, puis effectuer un double clic ou activer l icône. La boîte de dialogue «Opérations du scénario de conversion» s affiche. 80 Documentation utilisateur

81 Sélectionner l opération à exécuter puis cliquer sur l icône Exécution d une opération ou d un scénario de conversion et résultat Options au lancement Au lancement du scénario ou de l opération de conversion, la boîte de dialogue «Option de conversion» s affiche. Elle permet de sélectionner l option retenue pour l application d options de présentation graphique des objets importés. 1 Utiliser le paramétrage défini sur les opérations de conversion Les options graphiques définis dans l opération de conversion seront appliquées. Ces options sont définies à partir de la boîte «Opération de conversion» en cochant l option Cf. : Chapitre 3 : «Construction d un scénario de conversion» 2 Conserver les options graphiques existantes Aucune modification d apparence graphique ne sera appliquée sur les objets importés. REQUETES DOCUMENTEUR PUBLICATION INTRANET 81

82 3 Appliquer les options par défaut de WinDesign Les options graphiques définies dans WinDesign en standard pour chaque type d objet cible seront appliquées aux objets importés. Ce choix entraînera des modifications de présentation des diagrammes. Nota : une fois le scénario ou l opération de conversion exécutée avec l une des options, il ne sera plus possible de relancer l exécution avec une autre option Résultat Application des opérations de conversion Lors de l exécution du scénario, l ensemble des opérations de conversion est effectué. Les objets sont transformés en fonction des critères sélectifs et des équivalences définis pour chaque caractéristique, dans les opérations du scénario et en fonction de l option sélectionnée au lancement de l exécution. En fonction du choix effectué pour l application des options graphiques, la présentation du diagramme sera éventuellement à remanier (positionnement des objets, affichage des textes, ) Conversion des liens Lors de la récupération des diagrammes Visio, les liens sont convertis dans WinDesign en liens dits «libres», avec un stéréotype Visio. Une fois les objets convertis dans la cible finale, les liens entre les objets sont convertis à leur tour, par rapport à la définition d un lien unique ou d un lien par défaut décrit dans le méta modèle. Par la suite, en utilisant le menu contextuel du lien, il sera possible de le modifier en choisissant parmi les autres liens possibles Construction d un scénario de conversion Un scénario de conversion est destiné à décrire les modalités de transformation d un type d objet dans un autre. Ceci est applicable en particulier pour les sources de données provenant d imports (par exemple Visio, fichiers CSV, ), mais également à l intérieur du contexte WinDesign, pour assurer des passages entre des équivalences de formalismes de modélisation ou des niveaux différents de modélisation. Exemple : dans la modélisation d un processus, convertir un modèle réalisé à partir du formalisme standard WinDesign dans le formalisme BPMN2. Ceci est valable quelque soit le type d objet d origine et le type d objet destination. Dans les versions précédentes, on pouvait effectuer cette opération «manuellement», en particulier en passant par les types/stéréotypes dans la même catégorie d objet (activité générique, objet libre, vue externe, ), sans application de critère particulier. 82 Documentation utilisateur

83 La construction d un scénario de conversion permet, dans cette version, de définir des opérations de transformation avec critères sélectifs et modalités d équivalence de chaque caractéristique. Ainsi par exemple, dans le cas d un import Visio, l équivalence entre chaque caractéristique importée de Visio se fera avec les caractéristiques existantes dans le méta modèle de l objet cible à transformer Création d un scénario Un scénario regroupe un ensemble d informations. Il est mémorisé dans le dossier : \DONNEES\IMP EXP\Conversions de l installation WinDesign, avec une extension de fichier.cvr. Ce dossier peut être déporté sur un autre endroit à condition d établir le lien d accès à partir de la fonction «Répertoires» du menu «Administration» de WinDesign. Choisir la fonction «Conversion d objets» dans le menu «Modèle» (ce menu n apparaît qu avec un modèle déjà ouvert). La boîte de dialogue «Sélection du scénario de conversion» s affiche. Pour créer un nouveau scénario, cliquez sur le bouton. La boîte d enregistrement de fichier s affiche. Nommez le fichier («Matériel informatique» dans notre exemple) et enregistrez le fichier. Le nom du scénario apparaît dans la liste. Double cliquer sur le nom du scénario, ou après sélection du scénario sur l icône. La boîte «Opérations du scénario de conversion» s affiche. Elle permet éventuellement, dans la partie supérieure de la boîte, de renommer localement le scénario (sans modifier pour autant le nom du fichier» et d en donner une description textuelle. REQUETES DOCUMENTEUR PUBLICATION INTRANET 83

84 Création d une opération d un scénario Préalable : avant de créer une opération, il est nécessaire de sélectionner dans le diagramme courant, le ou les objets à convertir. La sélection peut être réalisée avec la boîte «Opérations du scéanario de conversion» ouverte. Ce diagramme pourra être par exemple dans l import Visio, celui transposé de Visio à WinDesign en 1 ère phase, ou n importe quel diagramme WinDesign comportant les types d objets à convertir. Ceci permettra d alimenter l assistant de conversion, pour établir les critères de passage et les équivalences entre caractéristiques. En cas de multi sélection, vérifiez qu il s agit d un ensemble homogène dont WinDesign ne prendra que les caractéristiques communes. Dans la boîte «Opérations du scénario de conversion», cliquez sur le bouton nouvelle opération. pour ajouter une Dans le cas de sélection d un seul objet, un panneau d avertissement vous informe que la conversion ne pourra s établir que sur les seules caractéristiques de l objet sélectionné (la plupart du temps suffisant si l objet est bien documenté). Validez par Oui. La boîte de dialogue «Sélection des caractéristiques à retenir» s affiche. 84 Documentation utilisateur

85 Elle permet de choisir les critères permettant de filtrer tous les objets à transformer, disposant des mêmes valeurs de caractéristiques. Caractéristiques de WinDesign : standards, spécifiques et étendues Caractéristiques externes : liste l ensemble des caractéristiques issues d une importation. Chacune de ces caractéristiques dispose d une case à cocher, et permet de formuler une expression de filtrage. Par défaut, dans les caractéristiques standard de WinDesign, les cases «N d objet» et «type d objet» sont cochées. Elles représentent la définition de la typologie de l objet du méta modèle. Dans le cas de l import Visio, le type d objet est «Objet visio» (créé dans le méta modèle pour les besoins de l import). Il est dérivé de l objet libre. Sélectionnez éventuellement d autres caractéristiques, en particulier les caractéristiques externes pour les imports (exemple : MasterShape pour Visio qui représente la forme de base associée à l objet), puis validez par Ok. L expression de filtrage correspondant aux caractéristiques retenues s affiche. Choisir le type d objet cible à partir de la rubrique «Convertir en», en activant le bouton «Modifier». La boîte de choix des types d objets s affiche (elle présente la liste des objets définis dans le méta modèle). REQUETES DOCUMENTEUR PUBLICATION INTRANET 85

86 Sélectionnez le type d objet et validez par Ok. La boite «Opération de conversion» affiche le type d objet sélectionné. Pour conserver l apparence graphique des objets importés lors de l exécution de l opération de conversion, cocher cette case. Pour modifier le filtre de sélection, cliquer sur le bouton «Modifier» de la rubrique «Filtre de sélection». La boîte de dialogue «Méta modèle de WinDesign» s affiche. Elle présente dans sa partie supérieure l ensemble de toutes les caractéristiques du type d objet et dans sa partie inférieure l expression du critère. 86 Documentation utilisateur

87 Modifiez directement l expression du critères directement dans la ligne, comme par exemple dans notre cas en ajoutant un autre cas de figure de MasterShape pour convertir dans le même type d objet WinDesign : c:numero_objet =="72" AND c:type_objet =="Objet Visio" AND x:"mastershape" =="Serveur de base de données" OR x:"mastershape" =="Serveur de fichiers" Cf. Manuel utilisateur 4 : Profil Pamarétrages Equivalence des caractéristiques Recherche des caractéristiques des objets d origine sélectionnés avec le filtre défini Pour établir une équivalence entre les caractéristiques descriptives de l objet d origine et celle de l objet cible, cliquez sur le bouton «Extraire à partir du modèle courant», pour obtenir la liste de toutes les caractéristiques de tous les objets d origine répondant au même critère. Cette extraction fera une fusion de l ensemble des caractéristiques associées à tous les objets répondant au filtrage. Dans la partie inférieure de la boîte de dialogue, la liste de ces caractéristiques s affiche Etablir l équivalence des caractéristiques Sélectionner la caractéristique source et cliquer sur dans la colonne «Fonction» REQUETES DOCUMENTEUR PUBLICATION INTRANET 87

88 La boîte de «Définition d un mapping de caractéristiques» s affiche et comprend dans sa partie haute, la fonction permettant de choisir la caractéristiques cible correspondante. Pour cela cliquer sur le bouton «Sélectionner». La boîte «Sélection d une caractéristique» affiche la liste des caractéristiques définies dans le méta modèle et associées au type d objet cible. Sélectionner la caractéristique correspondante, et validez par Ok. L équivalence entre les caractéristiques est établie. S il n y a pas à établir de correspondance dans les listes de valeur de la caractéristiques, cliquer sur Ok pour valider. La boîte de dialogue «Opération de conversion» s affiche et présente la liste des équivalences entre les caractéristiques de la source et de la cible Initialisation de valeur dans l objet source Cas particulier dans lequel la caractéristique n existe pas dans l objet source, mais est nécessaire à initialiser dans l objet cible. 88 Documentation utilisateur

89 Dans ce cas, on crée une caractéristique au titre de l objet source, sous forme de constante, avec la possibilité d établir la correspondance avec la caractéristique de l objet cible Création d une constante A partir de la boîte «Opération de conversion», cliquer sur le bouton dans la partie basse de la boîte listant les caractéristiques de l objet source et les équivalences pour l objet cible. La boîte de dialogue «Définition de valeur constante» s affiche Saisir dans le libellé le nom de la caractéristique (en général on mettra un nom approchant celui de la caractéristique cible), puis donner la valeur d initialisation. Valider par Ok. REQUETES DOCUMENTEUR PUBLICATION INTRANET 89

90 Puis, établir l équivalence avec la caractéristique de l objet cible, en cliquant dans la colonne «Fonction» sur. La boîte «Définition d un mapping de caractéristiques» s affiche. Etablir l équivalence avec le mode opératoire décrit précédemment. Choisir la caractéristique et valider. Après validation, la boîte précédente s affiche avec l équivalence entre les caractéristiques. Dans l exemple ci dessous, la conversion créera une initialisation dans l objet cible de la caractéristique «Type de contenu» avec la valeur «Fichier» Gestion des opérations d un scénario Lors de l exécution d un scénario de conversion, chaque opération sera exécutée dans l ordre dans lequel elles sont affichées. 90 Documentation utilisateur

91 Pour modifier l ordre, utiliser les flèches. La barre d outils vous permet de : Créer une nouvelle opération Modifier l opération sélectionnée Supprimer l opération sélectionnés Exécuter l opération de conversion sélectionnée Fermer la boîte de dialogue Gestion des caractéristiques externes Les caractéristiques externes issues d importation, sont accessibles pour tous les objets à partir de l onglet «Caractéristiques externes» de la boîte de définition de l objet. REQUETES DOCUMENTEUR PUBLICATION INTRANET 91

92 A l issue des opérations de conversion, la liste des caractéristiques externes correspond à toutes les caractéristiques dont on n a pas établi d équivalence. Les autres sont supprimées Conversion manuelle de caractéristiques Sans utiliser de scénario de conversion, il est possible à partir de cette liste, de procéder ponctuellement à l équivalence. Pour cela, sélectionner une caractéristique, puis effectuer un clic droit (menu contextuel). Sélectionner la fonction «Convertir en». La boîte de dialogue des caractéristiques de l objet courant s affiche. Sélectionner la caractéristique cible, puis valider par Ok. 92 Documentation utilisateur

93 La caractéristique externe disparaît de la liste et la caractéristique cible prend la valeur de la caractéristique source Suppression de caractéristique externe Utiliser la fonction «Supprimer» du menu contextuel d une caractéristique externe sélectionnée Fonction de conversion par le menu contextuel des objets Il est également possible de transformer un type d objet WinDesign en n importe quel autre objet WinDesign, sans passer par les scénarios de conversion. Pour cela, utiliser la fonction «Convertir en» accessible dans le menu contextuel de tous les objets des modèles WinDesign. La liste des types d objets du méta modèle s affiche. Sélectionner le type d objet cible et valider par la touche Ok. REQUETES DOCUMENTEUR PUBLICATION INTRANET 93

94 Dans le cas où la caractéristique source et cible dispose de liste de valeurs, une fois l équivalence des caractéristiques établie, cliquez sur le bouton «Extraire à partir du modèle courant» à partir de la boîte «Opération de conversion». La liste de valeurs correspondant à l objet source s affiche. Dans la colonne «Valeur cible», cliquez sur la ligne. La liste des valeurs de l objet cible s affiche. 94 Documentation utilisateur

95 Sélectionnez l une d entre elles pour établir la correspondance de valeur, puis validez par Ok. 5.6 EXPORT XML WINDESIGN Utilisez cette fonction pour exporter un modèle dans un fichier au format XML WinDesign, pour une communication vers d autres outils ou faire un export via une DLL ou une transformation XSL. Activez la fonction. S il n existe aucune DLL définie, la boîte de dialogue «Exporter Fichier (Via XML WinDesign)» s affiche. Sélectionnez le répertoire dans lequel vous voulez enregistrer votre fichier export. Vlidez par «Enreigstrer». L export s exécute. 2 fichiers sont créés : votre fichier export.xml et un fichier WdXML.dtd. Si des DLL ont été définies, la boîte «Export à partir de WinDesign» s affiche. REQUETES DOCUMENTEUR PUBLICATION INTRANET 95

96 Cochez le radio bouton correspondant à votre choix, dans la partie supérieure de la boîte, puis effectuez vos sélections et cliquez sur «Exporter» pour lancer l export. 5.7 IMPORT/EXPORT AVEC W Import W Fonctionnement technique L interface avec W4 s effectue via des transformations de fichiers XML au moyen de feuilles de style XSL pour passer du format d import/export de WinDesign au format de mémorisation utilisé par W4 Studio Composants Les éléments spécifiques à cette interface se constituent : d une DLL d un ensemble de fichiers XSL, établissant les équivalences entre les types d objets utilisés dans WinDesign et les types d objets cibles dans W4, que l o peut retrouver dans le répertoire PROGRAMMES/DLLs de WinDesign. La DLL «XdlmpExpW4.dll» fournit une couche d abstraction supplémentaire à WinDesign, permettant de réaliser un paramétrage supplémentaire de l import/export, notamment en rajoutant éventuellement de nouveaux types de diagrammes WinDesign comme source ou destination. Quant aux fichiers XSL, ils se décomposent en 3 catégories : Point d accès à la transformation : ce sont les fichiers dont le nom commence par «Import W4». Le reste du nom du fichier permet de fournir d autres informations sur la transformation concernée (Cf. paramétrage). Paramétrage : ce sont les fichiers dont le nom débute par «Param W4» par défaut. Ils contiennent les correspondances permettant de relier le contenu du profil WinDesign concernant un type de diagramme avec les concepts W4. Logique : ce sont les fichiers «Main Import W4.xsl» et «Main Import W4.xsl» qui contiennent toutes les règles permettant de passer d un format à un autre Déroulement de l import Après avoir lancé l import (Menu Fichier Import W4 Import ou par le menu Fichier Importer XML WinDesign et sélection de la DLL Import/Export W4 dans la liste), on accède à la boîte permettant de sélectionner le type d import (et donc la XSLT à appliquer). Une fois le choix effectué, sélectionnez le fichier *.W4M à importer. La DLL lui applique la feuille de style sélectionnée et crée un fichier au format XML WinDesign nommé «W4.xml» (soit dans le répertoire temporaire par défaut, soit dans le répertoire éventuellement spécifié dans le cas où on a choisi la DLL dans la liste). WinDesign importe finalement ce fichier pour reconstituer un modèle Paramétrage Pour plus de lisibilité, vous trouverez ci dessous en gras, les données qui sont soit variables ou qui doivent être modifiées par vos soins. Création d un nouvel import/export 96 Documentation utilisateur

97 Un nouvel import/export se base généralement sur un nouveau type de diagramme qu il faut commencer à définir dans le Paramétrage des Modèles de Traitements. Il faut lui affecter un nom et surtout un alias qui servira à l identifier par la suite. Ensuite, le plus simple pour créer un nouvel import/export est de réaliser une copie du couple de fichiers «Export W4 x_y(mga W4).xsl» / «Param W4 x_y.xsl» (ou «Import W4 x_y.xsl» / «Param W4 x_y.xsl») et d apporter les modifications suivantes : Rajouter dans les noms des 2 fichiers après le «x_y» (le numéro de version) un identifiant pour cet import/export. Dans le cas de l export, modifier entre parenthèses le (ou les) type(s) de diagramme géré(s) par ce paramétrage. Le plus souvent vous remplacerez W4 par l alias choisi dans le Paramétrage des Modèles de Traitements. Enfin, dans le fichier «Export W4 x_y Description(MGA DIAG).xsl» («Import W4 x_y.xsl») modifier la ligne : <xsl:include href= Param W4 x_y.xsl /> par : <xsl:include href=»param W4 x_y Description.xsl»/> Et dans le fichier «Param W4 x_y Description.xsl» modifier la ligne : <xsl:variable name=»varctypediag»>w4</xsl:variable> par <xsl:variable name=»varctypediag»>diag</xsl:variable> Personnalisation d un import/export Le reste de la personnalisation s effectue dans le fichier «Param W4 x_y Description.xsl» afin de faire coller les concepts utilisés par le moteur de transformation avec les termes définis dans le profil. Pour cela on utilise des variables dont les conventions de nommage sont les suivantes : VART* pour les noms de méta types (méta objet) VARS* pour les noms de stéréotypes VARG* pour les groupes de caractéristiques étendues VARC* pour les caractéristiques étendues VARV* pour les valeurs de caractéristiques étendues VARP* pour les valeurs de propriétés Export W4 A partir de la définition du profil et de la fonction d export, WinDesign permet à partir d un diagramme du module Business Process d exporter un fichier natif W4. Nota : cette interface n est pas disponible en standard. Elle correspond à une option complémentaire du module Business Process Fonctionnement technique L interface avec W4 s effectue via des transformations de fichiers XML au moyen de feuilles de style XSL pour passer du format d import/export de WinDesign au format de mémorisation utilisé par W4 Studio. Trois XSL sont disponibles, pour : Un diagramme d opérations Ossad Un diagramme de tâches BPMN Un diagramme de workflow W4 (construit dans WinDesign). REQUETES DOCUMENTEUR PUBLICATION INTRANET 97

98 Composants Les éléments spécifiques à cette interface se constituent d une DLL et d un ensemble de fichiers XSL, établissant les équivalences entre les types d objets utilisés dans WinDesign et les types d objets cibles dans W4, que l o peut retrouver dans le répertoire PROGRAMMES/DLLs de WinDesign. La DLL «XdlmpExpW4.dll» fournit une couche d abstraction supplémentaire àwindesign, permettant de réaliser un paramétrage supplémentaire de l import/export, notamment en rajoutant éventuellement de nouveaux types de diagrammes WinDesign comme source ou destination. Quant aux fichiers XSL, ils se décomposent en 3 catégories : Point d accès à la transformation : ce sont les fichiers dont le nom commence par «Export W4» selon le sens de conversion. Le reste du nom du fichier permet de fournir d autres informations sur la transformation concernée (Cf. paramétrage). Paramétrage : ce sont les fichiers dont le nom débute par «Param W4» par défaut. Ils contiennent les correspondances permettant de relier le contenu du profil WinDesign concernant un type de diagramme avec les concepts W4. Logique : ce sont les fichiers «Main Export W4.xsl» et «Main Import W4.xsl» qui contiennent toutes les règles permettant de passer d un format à un autre Paramétrage du profil Deux types de paramétrages peuvent être effectués. 1ère solution : définition d un diagramme workflow W4 Cette solution consiste à définir tous les concepts de W4 dans WinDesign et à modéliser les séquences de procédures avec ces notions. Cela permet, dans WinDesign, d utiliser le même vocabulaire et de manipuler les mêmes notions que dans W4. Dans la Version de WinDesign intégrant l option «Interface W4», le profil contient les paramétrages nécessaires pour la définition de tous les types d objets W4. Un diagramme spécifique est également prévu pour la modélisation des procédures W4. Nota : le paramétrage effectué dans le profil correspond aux objets manipulés dans le module «Studio» de W4. 98 Documentation utilisateur

99 Les types d objets manipulés dans le Workflow ont des caractéristiques étendues par rapport à la définition standard des objets WinDesign. Elles permettent de compléter les définitions et de s adapter spécifiquement à la cible W4. Exemple d une étape Les variables de procédures sont définies à partir d un stéréotype de vue externe : structure de données. Cette vue externe est associée à la procédure. Le contenu de la vue externe décrit l ensemble des variables utilisées dans le contexte de la procédure. Les activités sont dérivées de la notion générique de règles et sont associées aux étapes. REQUETES DOCUMENTEUR PUBLICATION INTRANET 99

100 Les variables utilisées dans l activité sont définies par les entrées et sorties de la règle. 2 ème solution : adaptation des diagrammes d autres méthodes Exemple Ossad Dans ce cas, il s agit par l intermédiaire de stéréotypes, d étendre les notions d un formalisme pour les adapter à l implémentation Workflow, tout en restant dans un cadre méthodologique conventionnel. Le diagramme utilisé est celui du diagramme d opérations. Exemple de l extension pour l opération : les caractéristiques étendues seront associées aux stéréotypes spécifiques W Documentation utilisateur

101 Ce stéréotype peut être appliqué à tout moment. On peut donc modéliser normalement suivant la méthode Ossad, puis en finale, stéréotyper les opérations susceptibles de devenir des étapes du Workflow, sans modifier l identité de l opération. Le stéréotype permettra d utiliser les caractéristiques étendues propres à W4. Pour les variables de procédures, même paramétrage que dans la première solution dédiée W4. Pour les activités, c est la notion de règle qu il faut utiliser dans le diagramme Ossad, qui sera ensuite typée et stéréotypée pour W Lancement de l export Pour exporter un ou plusieurs diagrammes, utilisez la fonction «Exporter W4 Export» du Menu «Fichier». REQUETES DOCUMENTEUR PUBLICATION INTRANET 101

102 Une boîte de dialogue «Configuration» s affiche permettant de sélectionner la feuille de style (fichier XSL) à appliquer. Cliquez sur Ok pour valider votre choix et afficher la boîte de dialogue «Sélection des diagrammes à exporter» La liste est une restriction de tous les diagrammes des modèles de l espace de travail par rapport au type géré par la feuille de style sélectionnée. Une fois la validation effectuée, WinDesign procède à un export XML standard des diagrammes sélectionnés. C est un fichier appelé «~TemporaryExportFile.xml» qui est généré (soit dans le répertoire temporaire par défaut, soit dans le répertoire éventuellement spécifié dans le cas où on a choisi la DLL dans la liste). Nota Pour spécifier le répertoire par défaut, cochez la case «Ne plus afficher cette boîte» de la boîte «Configuration». Pour modifier ce répertoire par défaut par la suite, utilisez le menu «Exporter W4 Paramétrage» pour réafficher la boite et décocher la case. Une fois le fichier temporaire créé, la DLL lui applique la feuille de style sélectionnée. La transformation une fois effectuée, indiquez la nom de fichier «.W4M» (extension du fichier utilisé par W4 Studio) sous lequel sauvegarder le résultat. Enfin, la DLL crée également le fichier «.W4W» (fichier d environnement W4) offrant un autre accès au fichier généré. 102 Documentation utilisateur