DOORS Training MR DOORS Training See also MR

DOORS Training MR DOORS Training See also MR DOORS Guidance Document: DOC 0434536

Training Overview • DOORS Overview & Application in MR • Editing Modules • Establishing Linking, Traceability • Baselining • Printing 2 / DOORS in MR Training / 9/25/2020

Course Objectives 1. By the end of this course you will be able to: 2. Get a DOORS Account and install DOORS 3. Understand how DOORS works within the MR design controls process 4. Create traceability to show compliance between requirements and tests 5. Create an output file to enter into the DHF 3 / DOORS in MR Training / 9/25/2020

What is DOORS? • Requirements Management System • Database of individual requirements and test procedures • 3 Main Types of “containers”: - Folders - Modules - Objects • “V” diagram is our representation of how the containers are connected 4 / DOORS in MR Training / 9/25/2020

Obtaining a DOORS Account 1. Install the program under the Process section. Follow the directions to have modules open automatically in Read-only mode. 2. Find the DOORS training and assessment at this support central site under Training: http: //supportcentral. ge. co m/products/sup_products. a sp? prod_id=17886 The assessment is GEHCENG-CM 2285 T in my. Learning. 3. Request a New DOORS Account under Make a Support Request. 5 / DOORS in MR Training / 9/25/2020

DOORS Terminology Views: Organized way of seeing stored information; saved set-ups for columns to display, column width, and filters Attributes: Appear in the column format in DOORS Linkset: Store information needed to establish links Objects (each row of info is an object) Object Level (as seen in the Module Explorer): Hierarchy of objects showing parent/child relationship Object ID: Unique, auto-generated attribute present for each object in a module Link Arrows indicate established Links (links connect an object in one module to an object in another module 6 / DOORS in MR Training / 9/25/2020

DOORS Terminology Modules: Container within DOORS that stores information Change bars: Green – No changes Green after baseline Yellow – Changed Yellow and saved since baseline Red –Edited but not Red saved Baseline: Read-only version of module that captures a point in the module’s history and preserves it Filter: Controls what information appears in a view 7 / DOORS in MR Training / 9/25/2020

MR philosophy on using DOORS (Database/ Storage) MR_Programs Project Folder DVMR Program Attribute on every object HDx 2 HDw In DOORS, modules and (where applicable) objects are re-used across multiple programs My. Workshop/e. Library (DHF) DVMR DOORS modules filtered on HDx 2 a specific program. Program specific output HDw archived in DHF In My. Workshop and in DHFs, documentation is program specific 8 / DOORS in MR Training / 9/25/2020

MR philosophy on using DOORS , cont’d Program-based vs. Platform-based Program-based Platform-based Input clean requirements each program Re-do trace for every program Review current documents for requirement applicability, add if new Trace for requirements remains the same – only need to re-establish for new requirements Platform-based gives us a lot of potentially time-saving benefits. MUST TAKE CARE not to do the wrong thing! Multi-valued Program Attribute 9 / DOORS in MR Training / 9/25/2020

Reuse versus New Requirement Object !!! WARNING !!! • Do not make content changes to objects that are already attributed to other programs! • If your program requires a slight update to the core content of an object, branch it. Branch means to copy the object that exists, paste directly after the current object, then modify the text as needed and attribute to the correct program(s). 10 / DOORS in MR Training / 9/25/2020

Reuse existing module or create new? Check with your LSD before creating a new module! MR systems do not usually change that drastically from one program to the next… Unless completely new or changed subsystem emerges, re-use appropriate existing module. Check with your LSD! 11 / DOORS in MR Training / 9/25/2020

Finding and Renaming the Templates • Templates are in the Template folder of the MR DB folder • Once the template has been copied and pasted into the correct folder, rename it using Module Properties (access by right-clicking) Templates to Use Fill in the Name and Description fields Nomenclature Name field: <document name> <type of document> Description field: <short description of the document> (spell out any acronyms in the 12 / DOORS in MR Training / Description field) 9/25/2020

Accessing Modules • Open a module in DOORS in 1 of 3 ways: 1. Read-only: Read only access (follow the DOORS installation directions to set this as your default) 2. Shareable Edit: Allows controlled, multi-user editing 3. Exclusive Edit: Exclusive write access • Once a module is open, you can change your access method through File -> Edit Mode Always open a module in Read- only unless you must edit it! 13 / DOORS in MR Training / 9/25/2020

Inserting New Objects into Modules • To create a new requirement or test, you’ll need to create a new object • Insert an object at any point in the module • Pay attention to the object “level” when you insert it (use either the Module Explorer view or the Object Level attribute) • Insert the new object either: – at the same level or – one level below Insert Menu Insertion Point (new object goes under the selected object) 14 / DOORS in MR Training / 9/25/2020

Other DOORS Editing Tips For more information on editing modules in DOORS, check out the DOORS Guidance Document (DOC 0434536) for MR in My. Workshop: (http: //myworkshop. health. ge. com/ematrix/common/e. Lib. Document. jsp ? type=type_Procedureor. Process. Document&name=DOC 0434536&rev =2 15 / DOORS in MR Training / 9/25/2020

Attribute Columns • Attributes = Property of an object. Attributes are visualized as columns • You can add / remove attribute columns from a view and their content will not be deleted • Other than the Object Text attribute, the Programs attribute is a major attributes in MR’s modules • MR uses multiple program attribute values within one object… Attribute Columns Programs attribute values Never uncheck a Programs attribute value without checking with your LSD!! ----------------------------It could adversely affect another program’s 16 / DOORS in MR Training / 9/25/2020

Creating linksets • Before establishing a link, a linkset should be created • Most of the necessary linksets have been created • If you are trying to establish a link and get any kind of message, contact your LSD 17 / DOORS in MR Training / 9/25/2020

Establish Traceability: Creating Links • Linking allows the user to establish traceability between 2 objects • DOORS allows users to view inlinks and outlinks: – Red arrows show outlinks – Yellow arrows show inlinks • Only objects identified as Requirements or Test Types are linked Link Arrows which indicate established Links DIRECTION IS IMPORTANT!!! Links MUST start in the successor (lower level) document 18 / DOORS in MR Training / 9/25/2020

Establishing links • Once the linksets have been created - link up from the lower level requirements to the higher level requirements for requirements modules. For verification modules, the links are created from the verification module to the Target module (read only) requirements module. Source module (edit mode) Even after you have created the linkset, the first time you make a link in a module you will get this message: Note: The source module object will turn pink/mauve if the link was “started” Just click Yes 19 / DOORS in MR Training / 9/25/2020

Views • The following views are already in the module templates: –Standard: Shows minimum information (object ID and object text). –All Columns: Default view. Shows all columns available by default in every module created with an MR template. –Traceability: Shows the object ID (based on _Trace. Program) for all links. Used this view for printing traceability to My. Workshop. Views –Traceability – Verbose: Shows the object ID (based on _Trace. Program) for all links. Use this view to check for complete and correct traceability. –e. Library Print: Shows necessary columns sized to appropriate column width for the document to be printed to My. Workshop. • MR module views have preset columns and column widths, to show certain attributes. “All Columns” View - Add / Edit requirements in this view “e. Library Print” View – Print to e. Library in this view 20 / DOORS in MR Training / 9/25/2020

Preparing to View Traceability Before you view/print Traceability: 1. Change the module’s edit mode to Exclusive Edit 2. Select Program Attribute (“_Trace. Program”) in the Module Properties From File -> Module Properties, go to the General tab. Highlight “_Trace. Program” and select View/Edit. Select the correct _Trace. Program attribute value. Click OK. 21 / DOORS in MR Training / 9/25/2020

Viewing Traceability • • Access “Traceability” view to display the inlinks/outlinks Adjust columns so that the output will fit on one landscape page-width “View” Drop-down Menu Inlink/Outlink Traceability Columns Note: The View drop-down has 2 Traceability Views. “Traceability” is what is used to print to My. Workshop: It only shows the requirement / test Object IDs. “Traceability Verbose” can be used by the author to make sure 22 / DOORS in MR Training / traceability makes sense 9/25/2020

Filtering • Filters let you control what information is displayed on your screen. • Use a Simple filter or an Advanced filter – depending on what you need. – Simple filter: objects displayed based on a single attribute – Advanced filter: objects displayed based on a combination of multiple attributes with operators AND, OR • Examples: Requirements doc printout: “(_Object Type >= Heading) AND (_Programs includes <xxxx>)” Verification Procedure printout: “(_Test Type >= Heading) AND (_Programs includes <xxxx>)” Requirements Traceability: “(_Object Type >= Requirement) AND (_Programs includes <xxxx>)” Verification Procedure Traceability: “(_Test Type >= Test) AND (_Programs includes <xxxx>)” When Filtering on “_Programs”, use the operator “includes” for Best Results 23 / DOORS in MR Training / 9/25/2020

Baselines • Baselining modules offers a way to save the module at a certain point in its development. • Before you make a baseline, ask: –Will you need to make any more changes before releasing this version? • Baselines are read-only – you cannot make any changes to a baseline • Once the baseline has been created, the change bar will turn GREEN It is CRUCIAL to make sure that you Baseline in conjunction with e. Library releases 24 / DOORS in MR Training / 9/25/2020

Naming a Baseline • Create the new baseline through File -> Baseline -> New… Use the Baseline Naming Convention for easy identification of the version you need • When naming the baseline, include: –Suffix: DOCxxxxxxx. Rx (where “DOCxxxxxxx” is the document from My. Workshop and “Rx” is revision that will go into My. Workshop) –Description: Purpose of release and Program • For formal baselines (those that are for a document going to My. Workshop) the user needs to select the next whole number • For informal baselines (those that people make for their own purposes), they can choose the next decimal available The document number and rev MUST match the doc number and revision that the document will be in My. Workshop when it is released! This will show up on the cover page, so they must match! Baselined for DVMR 2 FDR 3 Baseline Format for the Suffix field: DOCxxxxxxx. Rx 25 / DOORS in MR Training / 9/25/2020

Running the Impact Analysis Scripts • The Impact Analysis Scripts give you a comparison module for 2 baselines within one module • For more information on running the Impact Analysis Scripts in DOORS, check out the DOORS Guidance Document (DOC 0434536) for MR in My. Workshop: (http: //myworkshop. health. ge. com/ematrix/common/e. Lib. Document. jsp ? type=type_Procedureor. Process. Document&name=DOC 0434536&rev =2 26 / DOORS in MR Training / 9/25/2020

Getting the PDF Application Download PDFCreator (free from open source http: //sourceforge. net/projects/pdfcreator/)* You will need a PDFrendering application to print your files to PDF, then upload them to My. Workshop! *if you already have Adobe Acrobat Elements (or a full professional version of Adobe Acrobat), then you can already create a PDF without downloading PDFCreator 27 / DOORS in MR Training / 9/25/2020

Page Setup in MR DOORS • MR DOORS has 7 templates in Page Setup • Use the templates marked “DRAFT” during document review (QA needs DRAFT to be written in the footers) • Use these templates for your output document, each time you open a module and create an output file (the template is not remembered) These templates have preset properties for consistency among documents and ease of use 28 / DOORS in MR Training / 9/25/2020

Printing Requirements Document b d a. Select the “e. Library Print” view. Adjust columns as needed. b. Set the Filter (_Object Type >= Heading) AND (_Programs includes <xxxx>). c. Go to File -> Page Setup to select the correct Page Setup (recommended for printout: “MR Requirements – Portrait”). d. From the print menu, select PDFCreator from the drop-down menu in the Name field. Click OK to start the pdf creation. e. In the PDFCreator window, name the file in this manner: “ 01_<Program Name>_<Document Title>” For example: 01_DVMR 2_Pulse Sequence SSRS e 29 / DOORS in MR Training / 9/25/2020

Printing Verification Procedure c d a. Select the “e. Library Print” view. Adjust columns as needed. b. Set the Filter (_Test Type >= Heading) AND (_Programs includes <xxxx>). c. Go to File -> Page Setup to select the correct Page Setup (recommended for test procedure: “MR Test Procedure”). d. From the print menu, select PDFCreator from the dropdown menu in the Name field. Click OK to start the pdf creation. e. In the PDFCreator window, name the file in this manner: “ 01_<Program Name>_<Document Title>” For example: e 30 / DOORS in MR Training / 9/25/2020

Printing Traceability • Print Traceability view. It’s ready for My. Workshop. c d a. Under File -> Module Properties, set the _Trace. Program attribute to the program of interest. b. Go to the Traceability View. c. Set the Filter “(_Object Type >= Requirement) AND (_Programs includes <xxxx>)” for requirements or “(_Test Type >= Test) AND (_Programs includes <xxxx>)” for test procedures. d. Go to File -> Page Setup to select the correct Page Setup (recommended for Traceability: “MR Requirements – Landscape”). e. From the print menu, select PDFCreator from the drop-down menu in the Name field. Click OK to start the pdf creation. f. In the PDFCreator window, name the file in this manner: “ 02_<Program Name>_<Doc Name>_Traceability” For Example: 02_DVMR 2_Pulse Sequence SSRS_Traceability e 31 / DOORS in MR Training / 9/25/2020

Printing Impact Analysis Document Print the History File (i. e. , Impact Analysis) a b a. Access your History Module from the _History Files folder. Adjust columns as needed. b. Go to File -> Page Setup to select the correct Page Setup (recommended for impact analysis: “MR History File - Landscape”). c. From the print menu, select PDFCreator from the drop-down menu in the Name field. Click OK to start the pdf creation. d. In the PDFCreator window, name the file in this manner: “ 03_<Program Name>_<Document Title>_Impact Analysis” For example: “ 03_DVMR 2 Pulse Sequence SSRS Impact Analysis” d 32 / DOORS in MR Training / 9/25/2020

Checklist: Printing from DOORS to PDF (in the following order) q Create the baseline q Select the appropriate trace program q Set the view q Set filters* (If you set the filters before you set the view, the filters will be lost and need to be reset. ) q Choose the appropriate page setup q Print to PDF (choose PDFCreator from the Printer selection dropdown) * - Filters do not need to be set for Impact Analysis documents 33 / DOORS in MR Training / 9/25/2020

Support for DOORS Questions… 1. Try the DOORS Help… it really works! 2. Task Force Team Jacqueline Schertz Cynthia Gahagan Rebecca Kelderhouse 3. Support Central Case http: //supportcentral. ge. com/products/sup_products. asp? prod_id=17886 • Server Issues • License Availability Issues • Questions that DOORS Help & Task force cannot answer 34 / DOORS in MR Training / 9/25/2020

Helpful Links • DOORS Guidance Document - DOC 0434536 (http: //myworkshop. health. ge. com/ematrix/common/e. Lib. Document. jsp? type=type _Procedureor. Process. Document&name=DOC 0434536&rev=2) • DOORS at GEHC Support Central Site (http: //supportcentral. ge. com/products/sup_products. asp? prod_id=17886) • PDFCreator Site (http: //sourceforge. net/projects/pdfcreator/) 35 / DOORS in MR Training / 9/25/2020

Now What? That concludes the MR DOORS Training session. You just have one more step… Once you have completed the following exam in My. Learning: GEHC-TECH-HCS 23995448 …You will be added to the MR Team in DOORS and have access to the modules within those folders! Thank you!! 36 / DOORS in MR Training / 9/25/2020

Questions & Answers 37 / DOORS in MR Training / 9/25/2020