Objecteering/UML Version 5.3.0 – P07280 –

Objecteering/UML Version 5.3.0
– P07280 –
Objecteering/UML : Readme
1. INTRODUCTION............................................................. 3
2. INSTALLATION DU PATCH P07280 POUR
OBJECTEERING/UML 5.30 SP3 ......................................... 4
2.1.
CONFIGURATION NECESSAIRE ........................................................................................... 4
2.2.
PROCEDURE D'INSTALLATION WINDOWS ............................................................................ 4
2.2.1. Procédure de déploiement du patch............................................................................ 4
2.2.2. Fichiers déployés ........................................................................................................ 4
2.3.
PROCEDURE D'INSTALLATION LINUX .................................................................................. 5
2.3.1. Procédure de déploiement du patch............................................................................ 5
2.3.2. Fichiers déployés ........................................................................................................ 5
3. EVOLUTIONS ET FAITS TECHNIQUES CORRIGES .. 6
3.1.
3.2.
3.3.
3.4.
3.5.
3.6.
3.7.
OBJECTEERING/UML MODELER ........................................................................................ 6
OBJECTEERING/ADMINISTRATION ...................................................................................... 6
OBJECTEERING/DOCUMENTATION ..................................................................................... 6
OBJECTEERING/CMS ....................................................................................................... 6
OBJECTEERING/DOORS .................................................................................................. 7
OBJECTEERING/REQUIREMENTS ....................................................................................... 7
OBJECTEERING/XMI......................................................................................................... 7
4. RESTRICTIONS ET ANOMALIES CONNUES.............. 8
4.1.
4.2.
4.3.
OBJECTEERING/DOCUMENTATION ..................................................................................... 8
OBJECTEERING/REQUIREMENTS ....................................................................................... 8
OBJECTEERING/XMI......................................................................................................... 9
1. Introduction
Ce document vous fournit toutes les informations nécessaires pour votre prise en main des outils
Objecteering/UML. Il ne remplace pas la documentation utilisateur livrée avec Objecteering/UML,
mais apporte des informations importantes pour vous aider à démarrer vos travaux avec l'outil. Il
vous est fortement recommandé de lire ce document avant de commencer à travailler.
2. Installation du patch P07280 pour Objecteering/UML
5.30 SP3
2.1. Configuration nécessaire
Objecteering/UML SP3 avec le patch P07280 a été testé sur les plates-formes suivantes :
• Windows NT4 SP6a (x86)
• Windows 2000 SP4 (x86)
• Windows XP SP2 (x86)
• Linux Red Hat 9 (x86)
• Linux SuSE 9.2 (x86)
2.2. Procédure d'installation Windows
Le patch Objecteering/UML P07280 nécessite une installation préalable d’Objecteering/UML 5.3.0
SP3.
2.2.1. Procédure de déploiement du patch
•
•
•
•
Fermer tous les programmes Objecteering/UML.
Double cliquer sur le fichier "ObjecteeringUML_530_P07280_WIN.exe".
Une fenêtre résumant ce qui va être mis à jour apparaît. Cliquer sur le bouton "Next"
pour installer le patch.
Cliquer sur "Finish" pour terminer l’installation.
2.2.2. Fichiers déployés
Les fichiers suivants sont déployés par ce patch :
•
•
•
•
Binaires :
o baseadm.exe
o libObjecteering.dll
o objing.exe
o objingcl.exe
o wbaseadm.exe
Ressources :
o tpf/ascii.fmt
o tpf/html.fmt
o tpf/winword.fmt
o tpf/WINWORD/word.bot
o tpf/WINWORD/word.top
o tpf/HTML/html.bot
o tpf/HTML/html.top
Modules :
o DOORS_V2.0.t.prof
o GenDocModule_V4.8.d.prof
o RequirementsAdmin_V2.0.t.prof
o RequirementsManager_V2.0.t.prof
o XMIModule_V2.2.h.prof
UML Model Types :
o
o
o
o
o
Default.ofp
DefaultCpp
DefaultCSharp
DefaultJava
DefaultRequirements
2.3. Procédure d'installation Linux
Le patch Objecteering/UML P07280 nécessite une installation préalable d’Objecteering/UML 5.3.0
SP3.
2.3.1. Procédure de déploiement du patch
•
•
Fermer tous les programmes Objecteering/UML.
Ouvrir un shell et décompresser l'archive "ObjecteeringUML_530_P07280_LINUX.tgz"
et lancer l'installation en lançant les commandes suivantes :
$ tar xzf ObjecteeringUML_530_P07280_LINUX.tgz
$ cd ObjecteeringUML_530_P07280_LINUX
$ ./SETUP
•
•
Si les variables Objecteering/UML n'ont pas été initialisées, la procédure d'installation
vous demandera le répertoire d'installation d'Objecteering/UML à mettre à jour.
Un résumé d'installation s'affichera, vous demandera de confirmer le déploiement
d'Objecteering/UML.
2.3.2. Fichiers déployés
Les fichiers suivants sont déployés par ce patch :
•
•
•
•
Binaires :
o baseadm
o baseadmcl
o objing
o objingcl
Ressources :
o tpf/ascii.fmt
o tpf/html.fmt
o tpf/winword.fmt
o tpf/WINWORD/word.bot
o tpf/WINWORD/word.top
o tpf/HTML/html.bot
o tpf/HTML/html.top
Modules :
o DOORS_V2.0.t.prof
o GenDocModule_V4.8.d.prof
o RequirementsAdmin_V2.0.t.prof
o RequirementsManager_V2.0.t.prof
o XMIModule_V2.2.h.prof
UML Model Types :
o Default.ofp
o DefaultCpp
o DefaultJava
o DefaultRequirements
3. Evolutions et faits techniques corrigés
3.1. Objecteering/UML Modeler
•
•
•
•
•
Il est maintenant possible d’effectuer un check-out en ligne de commande sur les
exigences et les dictionnaires.
Correction d’un plantage lors d’appels successifs aux méthodes J
Object:objectMap.values et Object:objectMap.get().
Correction d’un problème de diagrammes apparaissant vides.
Correction d'un plantage pouvant survenir lors d'un 'Check Model' sur les diagrammes de
sequence.
Correction d'un plantage survenant après la suppression de tagged values sur les
AssociationEnd
3.2. Objecteering/Administration
•
Les identifiants des AssocationEnd sont maintenant pris en compte par la commande
“Check a database’s identifiers”.
3.3. Objecteering/Documentation
•
•
•
•
•
Correction d'une anomalie concernant les "document link insertion" durant la génération
d'un fichier RTF.
Suppression des balises "<BR>" inutiles durant la génération des fichiers HTML.
Amélioration de la génération des sublist au format RTF.
N.B. Cette amélioration implique l’utilisation des tags suivants :
"\NLIST n\", "\LIST n\", "\LITEM n\" et "\NLITEM n\" où "n" est un entier allant de 1 à
9. "n" est utilisé pour déterminer le niveau de la liste (ou sublist) courante.
Chaque sublist doit se terminer par "\END_SLIST\".
La liste principale doit se terminer par "\END_LIST\".
Chaque item de la liste doit être un "\LITEM n\" où "n" doit correspondre au "\LIST
n\" d’ouverture. (même chose pour le "\NLITEM n\" avec "\NLIST n").
Remarque : "\NLIST 1\" correspond à un "\NLIST\" et "\LIST 1\" à un "\LIST\".
Amélioration de la génération des listes au format HMTL, en conformité avec les
standards W3C.
N.B. Cette amélioration implique l’utilisation du tag suivant:
"\END_LITEM\" est utilisé pour fermer correctement une ligne de liste (ordonnée ou
non) lors de la génération HTML.
Cela permet de générer des "</LI>" dans la documentation HTML.
Correction d’une régression dans la génération de sauts de ligne dans les notes
description.
3.4. Objecteering/CMS
•
•
•
Corrections dans le contrôle de cohérence des liens ‘use’ et des éléments impactés par
les modifications de ceux-ci lors des opérations de Diff/Merge.
Correction du problème de nommage des opérations lors du merge automatique de
‘SequenceMessage’ .
Les liens sont maintenant créés après les éléments dont ils dépendent durant le merge
automatique.
•
•
•
•
•
•
Les erreurs survenant lors d'un merge automatique sont maintenant affichées en fin de
session.
Correction d’un plantage survenant lors de l’import de packages contenant des
diagrammes non refermés en J.
Correction de plantages survenants pendant la navigation sur l’explorateur mergé.
Ajout d’un contrôle sur le ‘Check Model’ afin de vérifier la présence de liens de
communications multiples sur un élément.
Correction d’un plantage pouvant survenir lors de l’import de Diagrammes de Sequence
via MultiUser.
Il n’y a plus d’apparitions successives de fenêtres de confirmation durant le merge
automatique.
3.5. Objecteering/DOORS
•
•
•
L’import de modules DOORS contenant des caractères utf-8 est maintenant possible.
Amélioration de la gestion des droits utilisateurs lors de l’export.
Amélioration générale de l’import
3.6. Objecteering/Requirements
•
Mise à jour des modules suite aux évolutions du module DOORS.
3.7. Objecteering/XMI
•
•
•
•
•
Des Retour Chariots ne sont plus systématiquement ajoutés à la fin des lignes dans les
notes importés.
Les TaggedValues et Stereotypes des liens de dépendance et d’implémentation sont
maintenant correctement importés.
Les paramètres de Tagged values des associations sont maintenant correctement
importés.
Les Contraintes de qualifiers sont maintenant correctement exportés.
Optimisation des performances de l’export.
4. Restrictions et anomalies connues
4.1. Objecteering/Documentation
•
•
•
•
•
Les chemins de génération complets doivent être définis afin d'éviter de générer des
fichiers dans la hiérarchie du serveur Objecteering/UML (les répertoires '.' et '..' sous PC
correspondent au répertoire de lancement des binaires).
Après la génération de documentation au format EMF, seul Word 97 (ou version
supérieure) peut ouvrir correctement le document généré. Les versions antérieures de
Word ne peuvent pas lire le format des images.
Si l'étape 4 de la génération de documentation ne s'effectue pas correctement, vérifiez et
corrigez les valeurs des paramètres figurant dans l'ensemble de paramètres "Editors".
Le format des notes est gardé (les lignes blanches ne sont plus enlevées).
L'explorateur intégré dans la documentation HTML générée par Objecteering/UML ne
fonctionne que sous Microsoft Windows et uniquement avec des explorateurs récents (IE
5.5, Mozilla 1.2 et supérieures). Il ne fonctionne pas avec Opera.
4.2. Objecteering/Requirements
•
•
•
•
•
•
A compter de la version de Requirements Manager de ce patch, il n’est plus possible
d'avoir deux éléments de même nom sous le même parent.
Si l’éditeur de traçabilité est masqué et que l’on ferme un autre éditeur (diagramme,
exigence, …), l’éditeur de traçabilité réapparaît mais il se peut que son fonctionnement en
soit perturbé. Dans ce type de situation, il suffit de fermer et de redémarrer
Objecteering/UML.
Pour conserver les liens de traçabilité entre le modèle UML et les exigences, lors d’un
import XML, il convient d’importer d’abord le modèle UML puis les exigences et les
dictionnaires.
Pour la génération de documentation, le plan type "Xml Export" ne doit pas être utilisé car
il ne fonctionnera pas. Il est utilisé en interne pour l’export XML.
Les éditeurs d’exigences et de dictionnaires
o Le tri par date fonctionne correctement lorsqu'il est sous le format anglais.
o Si la fonctionnalité du tri d'un éditeur apparaît comme inactive, il suffit simplement
de fermer et de réouvrir l'éditeur pour en bénéficier.
o L'ordre d'énumération est pris en compte dans le tri des propriétés typées par des
énumérés. Veuillez ordonner vos propriétés en fonction de cette stratégie.
o Dans l’éditeur d’exigence ou de dictionnaire, après avoir validé un champ multiligne avec la touche tabulation ou entrée, il faut appuyer de nouveau sur la touche
tabulation pour pouvoir continuer à naviguer avec le clavier. Même remarque
après avoir annulé avec la touche d’échappement.
o Pour valider l’édition d’un champ multi-ligne, il est nécessaire d’utiliser la
combinaison de touches CTRL-TAB (ou cliquer à l’extérieur du champ).
Astuces
o La fonctionnalité pour développer/réduire (utilisation des '+', '-', '/', '*' et les boutons
en bas à droite dans l'éditeur) vous permettent d'afficher totalement ou
sommairement le champ des exigences et/ou des termes.
o Pour insérer des retours-chariots et des tabulations, il suffit d'utiliser la
combinaison SHIFT-ENTER pour les retours chariots et SHIFT-TAB pour les
tabulations.
Pour créer (ou pour effacer) des lignes il suffit d'utilise la touche INSERT (ou
DELETE). L'utilisation de la touche TAB sur la dernière ligne et dernière colonne
ajoute automatiquement une nouvelle ligne.
Dans l’éditeur, afin de sélectionner l’équivalent d’un élément dans l’arborescence
il suffit d’utiliser la combinaison CTRL-CLICK-GAUCHE sur la ligne.
o
o
•
La commande « Edit and Reverse documentation » ne fonctionne que si le logiciel
Microsoft Word est installé.
4.3. Objecteering/XMI
•
•
•
•
Les limitations suivantes sont à prendre en compte :
o Ne pas lancer une opération d’import XMI via objingcl, , utiliser wobjing et l’IHM
o Ne pas annoter des automates d'état, ceci pouvant provoquer des problèmes
durant la phase d’analyse des fichiers.
Les automates d'état et les états ne sont pas correctement importés. Leurs noms peuvent
se perdre, ce qui mène à l'échec des contrôles de cohérence.
Une opération d'import XMI contenant du code C++ ou Java, qui a des caractères
susceptibles d'être interprétés comme des balises, interrompt l'opération d'import.
Si le répertoire d'installation de votre serveur Objecteering/UML a été précisé en utilisant
un chemin UNC à la place d'une lettre de lecteur réseau monté, la commande d'import de
XMIModule ne s'exécutera pas. Pour utiliser cette commande, vous devez monter un
lecteur réseau sur le répertoire d'installation du serveur Objecteering/UML et modifier
RevXMI_NT.bat
situé
sur
<Répertoire
d'installation
du
serveur
Objecteering/UML>\modules\XMIModule\2.2.h\bin\Windows\Nt\ comme suit :
o
Fichier initial :
@SET SP_CHARSET_FIXED=YES
@SET SP_ENCODING=XML
cd /D %4
SET SGML_CATALOG_FILES=.\bin\Windows\xml.soc
.\bin\Windows\parser %1 %2 %3
o
Fichier modifié :
@SET SP_CHARSET_FIXED=YES
@SET SP_ENCODING=XML
cd /D <Lettre du lecteur réseau monté sur le répertoire
d'installation
du
serveur
Objecteering>\modules\XMIModule\2.2.h
SET SGML_CATALOG_FILES=.\bin\Windows\xml.soc
.\bin\Windows\parser %1 %2 %3