Upload
sebastien-monin
View
107
Download
2
Embed Size (px)
Citation preview
«SEG3601»
D. AmyotU. Ottawa
SEG 3601SEG 3601
Gestion des exigences avec DOORSGestion des exigences avec DOORS
Adapté de présentations par Telelogic et Amyot 2005-2012
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 2
Préparation du laboratoire• Vérifiez que vous pouvez exécuter DOORS• Téléchargez DOORS_101.dpa de TWiki et
sauvegardez le sur votre bureau (desktop)
http://cserg0.site.uottawa.ca/seg/bin/view/SEG3601/WebHome
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 3
Avantages de la gestion des exigences
Traçabilité entres les exigences de haut niveau et ceux d’implémentation• Établie grâce à des liens ajoutés dans une base de données des
exigences• Liens entre les exigences, les modèles de design, les tests, le
code. Analyse de l’impact de changements proposés
• Des outils d’analyse permettent de visualiser quelles exigences (et autres artéfacts) sont affectés par un changement.
Accès contrôlé à l’information courante d’un projet• Une base de données partagée assure que tous les utilisateurs
travaillent avec la plus récente copie des données• Une base de données centrale permet à tous les utilisateurs de
voir toute l’information requiseGestion des changements
• Un système de proposition des changements implémente un processus contrôlé pour gérer les changements.
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 4
Base de données DOORS (v8.x)
Répertoiresupprimé
Modules de liens (Link modules)
Répertoires (Folders)
Projets Modules formels (Formal Modules)
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 5
Titre de colonne
Objet courant
Identificateur d’objet
“Aucun changement” (barre verte)
“Changé cette session”(non sauvegardé, barre rouge)
Numéro de section ou d’objet
“Changé” (sauvegardé, barre jaune)
Titre d’objet
Texte d’objet
Indicateur de lien (entrant et sortant)
Information affichée (v8.2 / v8.3)
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 6
Objet titre ou objet texte ?
Organisation hiérarchique des objetsObjet Titre
• A une valeur dans Object Heading, mais pas dans Object Text
• Mise en place de contexte pour objets sous le titreObjet Texte
• A une valeur dans Object Text, mais pas dans Object Heading
• Les exigences sont entrés dans les objets textes• Devraient être des feuilles dans la hiérarchie de
modules
Pas plus d’une exigence dans un objet texte
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 7
Raccourcis
Ctrl-N … insérer un objet au même niveau
Ctrl-L … insérer un objet sous le niveau courant
Ctrl-H … changer l’objet dans le mode entête
Ctrl-T … changer l’objet dans le mode texte
Ctrl-C … copier l’objet courant seulement (sans hiérarchie)
Ctrl-V … insérer après l’objet courant
Ctrl-X … coupe l’objet courant avec hiérarchie
Ctrl-Z …annuler
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 8
Attributs pour Objets, Liens et Modules
Les attributs permettent d’associer de l’information additionnelle avec chaque exigence (objet), lien ou module.
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 9
Exemples d’attributs pour les objets
Numéro absolu, créé par, date de dernière modification• Automatiquement géré par DOORS
Source• Qui a rédigé l’exigence?
Priorité• Quelle est la priorité de cette exigence?
Vérifiabilité, Sûreté, …• Est-ce que cette exigence est vérifiable ? De grande
importance pour la sécurité humaine ?Révision
• L’état de révision de l’exigenceRaison (justification)
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 10
Le concept de lien
Une relation entre deux objets dans la base de données DOORS est établie en utilisant un lien
Objets origine et destination (source and target)
• Le de l’origine à la destination
Les liens peuvent être suivis dans les deux directions.
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 11
Le concept de lien
Les liens sont stockés dans des modules de liens
• Le nom du module indique le type de lien
• Une partie de l’information est stocké avec l’origine (exemple: on ne peut effacer un objet qui possède des liens entrants)
Ensemble de liens (Linkset)
• Les liens sont regroupés en linkset.
• Un linkset contient tous les liens d’un type spécifique qui existent entre une paire de modules formels.
• Les modules de liens peuvent contenir plusieurs linksets.
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 12
Schéma pour un projet simple
Combien y a-t-il de
• Modules formels ?
• Modules de liens ?
• Linksets?
Quels sont les noms
des modules de liens?
Exigencesclient
Exigences système
Spécification du design
Tests de satisfaction
Tests fonctionnels
Teste
Teste
Teste
Satisfait
Satisfait
Tests unitaires
Standards
Contraint par
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 13
La direction des liens est importante
La direction des liens est déterminée principalement par le contrôle des accès
• L’utilisateur doit pouvoir écrire à l’origine (exemple: les standards ne peuvent pas être l’origine car le développeur n’a pas les permissions pour y écrire)
• L’utilisateur n’a besoin que des permissions pour la lecture de la destination
De plus, le choix est renforcé par le désir d’être constant pour utiliser les fonctionnalités offertes par DOORS pour les rapports.
• L’utilisation de liens du bas vers le haut (recommandé) ou du haut vers le bas de façon constante permet d’utiliser des outils de traçabilité à niveau multiples
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 14
Appliquer un schéma en limitant les liens
Activer les options suivantes dans File - Module Properties – Linksets (pour tous les modules formels)
• Only allow outgoing links as specified in the above list• Mandatory
Sinon, DOORS créera un module de liens par défaut (DOORS Links)
• L’utilisation de ce module par défaut n’est pas recommandée
Exigences client
Exigences système
Tests de satisfaction
Satisfait
NONNON
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 15
Exercice – Appliquer un schémaCréez trois modules formels: A, B, CCréez deux objets dans chaque module (A1, A2; B1, …)Dans le menu View:
• sélectionnez Show Link Modules et Show Deleted ItemsCréez un lien de A1 à B1 (utilisez le glisser-déposer (drag & drop))
• Quels modules de liens ont été créés ?• Quels linksets ont été créés ?
Créez un module de lien TestCréez un linkset obligatoire dans le module A (File – Module Properties – Linksets) pour les liens vers le module B en utilisant le module de liens TestCréez un lien de A2 à B2– qu’est-il arrivé ?
• Double-cliquez les modules de liens…Créez un lien de A1 à C1 – qu’est-il arrivé ?Activez l’option “Only allow outgoing links as specified in the above list” dans module A (File – Module Properties – Linksets)Créez un lien de A2 à C2 – qu’est-il arrivé ?
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 16
Vue de traçabilité
1. 820.30(b) Design and Development Planning
Each manufacturer shall establish and maintain plans that describe or reference the design and developmentactivities and define responsibility for implementation.
The plans shall identify and describe the interfaces with different groups or activities that provide, or resultin, input to the design and development process.
The plans shall be reviewed as design and development evolves.The plans shall be updated as design and development evolves.The plans shall be approved as design and development evolves.
2. 820.30(c) Design Input2.1. Each manufacturer shall establish procedures to ensure that the design requirements relating to a
device are appropriate and address the intended use of the device, including the needs of the userand patient.
2.2. Each manufacturer shall maintain procedures to ensure that the design requirements relating to adevice are appropriate and address the intended use of the device, including the needs of the userand patient.
2.3. The procedures shall include a mechanism for addressing incomplete requirements.2.4. The procedures shall include a mechanism for addressing ambiguous requirements.2.5. The procedures shall include a mechanism for addressing conflicting requirements.2.6. The design input requirements shall be documented by a designated individual(s).2.7. The design input requirements shall be reviewed by a designated individual(s).2.8. The design input requirements shall be approved by a designated individual(s).2.9. The approval, including the date and signature of the individual(s) approving the requirements,
shall be documented.2.10. Questions.
2.10.1. Summarize the manufacturer's written procedure(s) for identification and control ofdesign input.
2.10.2. From what sources are design inputs sought?2.10.3. Do design input procedures cover the relevant aspects, such as: (Mark all that apply and
list additional aspects.)2.10.3.1. intended use2.10.3.2. user/patient/clinical2.10.3.3. performance characteristics2.10.3.4. safety2.10.3.5. limits and tolerances2.10.3.6. risk analysis2.10.3.7. toxicity and biocompatibility2.10.3.8. electromagnetic compatibility (EMC)2.10.3.9. compatibility with accessories/auxiliary devices2.10.3.10. compatibility with the environment of intended use2.10.3.11. human factors2.10.3.12. physical/chemical characteristics2.10.3.13. labeling/packaging2.10.3.14. reliability2.10.3.15. statutory and regulatory requirements2.10.3.16. voluntary standards2.10.3.17. manufacturing processes2.10.3.18. sterility2.10.3.19. MDRs/complaints/failures and other historical data2.10.3.20. design history files (DHFs)
2.10.4. For the specific design covered, how were the design input requirements identified?2.10.5. For the specific design covered, how were the design input requirements reviewed for
adequacy?
Comply with FDA Design Control Guidance GMP Regulation
1. Capture design and related information1.1. Input electronically formatted data1.2. Reference external information sources1.3. Reference external documentation
2. Store design and related information2.1. Identify and tag design information as unique “design elements”2.2. Organize design elements
2.2.1. Organize by Design Control Guidance Element2.2.2. Organize by inter-relationships
2.3. Ensure all design elements are available2.3.1. Store design elements by Design Control Guidance Element2.3.2. Store design elements and their historical values
3. Manage all user needs3.1. Identify the source of the user need3.2. Identify all user types (groups)3.3. Identify the customer (s)3.4. Profile the expected patients3.5. State the intended use of the product (family)3.6. Capture the acceptance criteria for each user need
4. Manage design input requirements4.1. Identify the source of the requirement4.2. Identify the associated user need4.3. Capture requirement description and attributes4.4. Capture acceptance criteria4.5. Assign responsibility for each requirement4.6. Manage incomplete requirements4.7. Manage ambiguous requirements4.8. Manage conflicting requirements4.9. Approve all requirements
5. Manage acceptance5.1. Ensure the acceptance of every user need5.2. Ensure the acceptance of every design input requirement5.3. Document the results of every user need acceptance test5.4. Document the results of every design input requirements test5.5. Make acceptance results available
6. Manage change6.1. Maintain history of design element changes
6.1.1. Make complete change history available6.1.2. Maintain history within and across any organizational procedure6.1.3. Maintain history within and across any project milestone6.1.4. Maintain history within and across any Design Control Guidance Elements
6.2. Capture frequency and nature of element changes6.2.1. Provide rationale for change6.2.2. Describe decisions made6.2.3. Identify approval authority for the change6.2.4. Capture date, time, and signature of approving authority
6.3. Identify impacted elements due to a change in another element6.3.1. Create backward traces to design elements within and across any organizational procedure6.3.2. Create backward traces to design elements within and across any project milestone
1.1. Identify impacted elements due to a change in another element Traceability Reports: consistency with driving design elements Impact Reports: other design elements affected Links to impacted design elements1.1.1. Create backward traces to design elements within and across any organizational
procedure Traceability Reports: Procedure Attribute
1.1.2. Create backward traces to design elements within and across any project milestone Traceability Reports: Milestone Attribute
1.1.3. Create backward traces to design elements within and across Design ControlGuidance Elements Traceability Reports: Linked design elements
1.1.4. Create forward impacts to design elements within and across any organizationalprocedure Impact Reports: Procedure Attribute
1.1.5. Create forward impacts to design elements within and across any project milestone Impact Reports: Milestone Attribute
1.1.6. Create forward impacts to design elements within and across Design ControlGuidance Elements Impact Reports: Linked design elements
1.2. Associate changed design elements with related elements Link Change Design Object with affected design element(s) Traceability Links and Reports from affected design element(s) Impact Links and Reports from affected design element(s)1.2.1. Associate design element changes with decisions, rationale, and approval authority
information Change Decision Objects with following Attributes: Disposition Attribute Decision Attribute Rationale Attribute Owner Attribute Management Approval Attribute
1.2.2. Provide associations within and across any organizational procedure Change Design Object Traceability Link on Procedure Attribute Change Design Object Impacts Link on Procedure Attribute
1.2.3. Provide associations within and across any project milestone Change Design Object Traceability Link on Milestone Attribute Change Design Object Impacts Link on Milestone Attribute
1.2.4. Provide associations within and across Design Control Guidance Elements Change Design Object Traceability Link to traced design elements Change Design Object Impacts Link to linked design elements
1.3. Mange the change process Design Change Module Design Change Reports Object History Object History Reports Versions Baselines
1. 820.30(b) Design and Development Planning
Each manufacturer shall establish and maintain plans that describe or reference the design and developmentactivities and define responsibility for implementation.
The plans shall identify and describe the interfaces with different groups or activities that provide, or resultin, input to the design and development process.
The plans shall be reviewed as design and development evolves.The plans shall be updated as design and development evolves.The plans shall be approved as design and development evolves.
2. 820.30(c) Design Input2.1. Each manufacturer shall establish procedures to ensure that the design requirements relating to a
device are appropriate and address the intended use of the device, including the needs of the userand patient.
2.2. Each manufacturer shall maintain procedures to ensure that the design requirements relating to adevice are appropriate and address the intended use of the device, including the needs of the userand patient.
2.3. The procedures shall include a mechanism for addressing incomplete requirements.2.4. The procedures shall include a mechanism for addressing ambiguous requirements.2.5. The procedures shall include a mechanism for addressing conflicting requirements.2.6. The design input requirements shall be documented by a designated individual(s).2.7. The design input requirements shall be reviewed by a designated individual(s).2.8. The design input requirements shall be approved by a designated individual(s).2.9. The approval, including the date and signature of the individual(s) approving the requirements,
shall be documented.2.10. Questions.
2.10.1. Summarize the manufacturer's written procedure(s) for identification and control ofdesign input.
2.10.2. From what sources are design inputs sought?2.10.3. Do design input procedures cover the relevant aspects, such as: (Mark all that apply and
list additional aspects.)2.10.3.1. intended use2.10.3.2. user/patient/clinical2.10.3.3. performance characteristics2.10.3.4. safety2.10.3.5. limits and tolerances2.10.3.6. risk analysis2.10.3.7. toxicity and biocompatibility2.10.3.8. electromagnetic compatibility (EMC)2.10.3.9. compatibility with accessories/auxiliary devices2.10.3.10. compatibility with the environment of intended use2.10.3.11. human factors2.10.3.12. physical/chemical characteristics2.10.3.13. labeling/packaging2.10.3.14. reliability2.10.3.15. statutory and regulatory requirements2.10.3.16. voluntary standards2.10.3.17. manufacturing processes2.10.3.18. sterility2.10.3.19. MDRs/complaints/failures and other historical data2.10.3.20. design history files (DHFs)
2.10.4. For the specific design covered, how were the design input requirements identified?2.10.5. For the specific design covered, how were the design input requirements reviewed for
adequacy?
Comply with FDA Design Control Guidance GMP Regulation
1. Capture design and related information1.1. Input electronically formatted data1.2. Reference external information sources1.3. Reference external documentation
2. Store design and related information2.1. Identify and tag design information as unique “design elements”2.2. Organize design elements
2.2.1. Organize by Design Control Guidance Element2.2.2. Organize by inter-relationships
2.3. Ensure all design elements are available2.3.1. Store design elements by Design Control Guidance Element2.3.2. Store design elements and their historical values
3. Manage all user needs3.1. Identify the source of the user need3.2. Identify all user types (groups)3.3. Identify the customer (s)3.4. Profile the expected patients3.5. State the intended use of the product (family)3.6. Capture the acceptance criteria for each user need
4. Manage design input requirements4.1. Identify the source of the requirement4.2. Identify the associated user need4.3. Capture requirement description and attributes4.4. Capture acceptance criteria4.5. Assign responsibility for each requirement4.6. Manage incomplete requirements4.7. Manage ambiguous requirements4.8. Manage conflicting requirements4.9. Approve all requirements
5. Manage acceptance5.1. Ensure the acceptance of every user need5.2. Ensure the acceptance of every design input requirement5.3. Document the results of every user need acceptance test5.4. Document the results of every design input requirements test5.5. Make acceptance results available
6. Manage change6.1. Maintain history of design element changes
6.1.1. Make complete change history available6.1.2. Maintain history within and across any organizational procedure6.1.3. Maintain history within and across any project milestone6.1.4. Maintain history within and across any Design Control Guidance Elements
6.2. Capture frequency and nature of element changes6.2.1. Provide rationale for change6.2.2. Describe decisions made6.2.3. Identify approval authority for the change6.2.4. Capture date, time, and signature of approving authority
6.3. Identify impacted elements due to a change in another element6.3.1. Create backward traces to design elements within and across any organizational procedure6.3.2. Create backward traces to design elements within and across any project milestone
1.1. Identify impacted elements due to a change in another element Traceability Reports: consistency with driving design elements Impact Reports: other design elements affected Links to impacted design elements1.1.1. Create backward traces to design elements within and across any organizational
procedure Traceability Reports: Procedure Attribute
1.1.2. Create backward traces to design elements within and across any project milestone Traceability Reports: Milestone Attribute
1.1.3. Create backward traces to design elements within and across Design ControlGuidance Elements Traceability Reports: Linked design elements
1.1.4. Create forward impacts to design elements within and across any organizationalprocedure Impact Reports: Procedure Attribute
1.1.5. Create forward impacts to design elements within and across any project milestone Impact Reports: Milestone Attribute
1.1.6. Create forward impacts to design elements within and across Design ControlGuidance Elements Impact Reports: Linked design elements
1.2. Associate changed design elements with related elements Link Change Design Object with affected design element(s) Traceability Links and Reports from affected design element(s) Impact Links and Reports from affected design element(s)1.2.1. Associate design element changes with decisions, rationale, and approval authority
information Change Decision Objects with following Attributes: Disposition Attribute Decision Attribute Rationale Attribute Owner Attribute Management Approval Attribute
1.2.2. Provide associations within and across any organizational procedure Change Design Object Traceability Link on Procedure Attribute Change Design Object Impacts Link on Procedure Attribute
1.2.3. Provide associations within and across any project milestone Change Design Object Traceability Link on Milestone Attribute Change Design Object Impacts Link on Milestone Attribute
1.2.4. Provide associations within and across Design Control Guidance Elements Change Design Object Traceability Link to traced design elements Change Design Object Impacts Link to linked design elements
1.3. Mange the change process Design Change Module Design Change Reports Object History Object History Reports Versions Baselines
Ex. Client Ex. Techniques Cas de testsDesign
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 17
Analyse des liens
Analyse de traçabilité
• Suit les liens entrants (du haut niveau au bas niveau si les liens sont du bas vers le haut)
Analyse de l’impact
• Suit les liens sortants (du bas niveau au haut niveau si les liens sont du bas vers le haut)
Analysis Wizard
Liens suspects
• Indicateur de liens suspects
• Nettoyer des liens suspects
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 18
Exercice – Analyse des liens
Utilisez l’analyse de traçabilité pour “S333” dans les standards (profondeur de 3).
• Y a-t-il des tests unitaires?
Analysez l’impact pour“Second Unit Test” (profondeur de 3).
• Quels exigences client sont
affectées?
Utilisez le Analysis Wizard pour
trouver quelles exigences client
n’ont pas de tests
unitaires.
Exigences client
Exigences système
Spécificationdesign
Tests de satisfaction
Tests fonctionnels
Teste
Teste
Teste
Satisfait
Satisfait
Tests unitaires
StandardsContraint par
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 19
Exercice – Liens suspects
Changez le “Third Design Specification”
• Où croyez-vous que les liens
suspects apparaîtront?
Nettoyez les liens suspects
Exigences client
Exigences système
Spécificationdesign
Tests de satisfaction
Tests fonctionnels
Teste
Teste
Teste
Satisfait
Satisfait
Tests unitaires
StandardsContraint par
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 20
Filtrer, Trier, Vues, Rapports
Filtrer des objets• Par rapport à leurs attributs, leurs liens, leur position
dans la hiérarchie (feuille ou non) et leurs colonnes. Trier les objets
• Par rapport à la valeur de leurs attributsVues
• Définit la mise en page (colonnes, filtres, tris, …)• Spécifiques aux modules (sauvegardés dans ceux-ci)
Rapports• Combine une vue avec un format de page pour
l’impression• Report Wizard
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 21
Exercices – Filtrer, trier et vues
• Filtrez “Design Specifications” pour que les titres soient cachés
• Désactivez le filtre
• Filtrez “Design Specifications” pour trouver les objets qui n’ont pas de liens vers “Unit Tests”
• Triez par priorité
• Sauvegardez la vue “Ma vue”
• Activez la vue standard
• Activez “Ma Vue”
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 22
DOORS/Analyst: Intégration avec UML 2.x
Ajoutez des diagrammes UML 2.x et leurs éléments en tant qu’objets liables grâce au plug-in Analyst (Éditeur UML 2.x Tau G2)
«SEG3601»
D. AmyotU. Ottawa
DOORS/Analyst
Si DOORS/Analyst est installé, vous pouvez:
• Explorer le menu Analyst dans DOORS
• Créer un module et sélectionner Analyst --> Enable Analyst
• Vous devriez alors avoir la permission d’insérer des diagrammes UML via le menu Analyst
Gestion des exigences avec DOORS 23
«SEG3601»
D. AmyotU. Ottawa
Gestion des exigences avec DOORS 24
DOORStoURN: Intégration avec URN
Ajoutez des diagrammes URN et leurs éléments en tant qu’objets liables grâce à la fonction DXL export dans jUCMNav.
«SEG3601»
D. AmyotU. Ottawa
Intégration jUCMNav-URN
Voir la documentation et les démos sur Twiki:
• http://jucmnav.softwareengineering.ca/twiki/bin/view/ProjetSEG/DoorsExport
Il faut installer une librairie DOORS supplémentaire pour importer des modèles URN:
• http://jucmnav.softwareengineering.ca/ucm/bin/view/ProjetSEG/InstallingTheDXLLibrary
Gestion des exigences avec DOORS 25
«SEG3601»
D. AmyotU. Ottawa
Pour votre projet…
Vous pouvez plus simplement:
• Exporter vos diagrammes (de jUCMNav ou autres)
• Les inclure dans un nouveau module DOORS.
• Énumérer manuellement les élements importants (buts, scénarios, etc.) inclus dans ces diagrammes.
• Créer vos liens de traçabilité entre vos exigences et ces éléments.
Gestion des exigences avec DOORS 26
«SEG3601»
D. AmyotU. Ottawa
Voir aussi
Seilevel’s Evaluations of Requirements Management Tools: Summaries and Scores •http://www.seilevel.com/wp-content/uploads/RequirementsManagementToolWP_2.pdf
•DOORS au milieu de peloton, selon leurs critères et besoins
•On peut tout faire, c’est un outil populaire et robuste, mais l’utilisabilité est faible, surtout en ce qui a trait à la modélisation.
Gestion des exigences avec DOORS 27