Import Requirements Document

19
[email protected] ReqView Import of Requirements Document version 0.13

description

This presentation explains how to import requirements document into ReqView via HTML, CSV or ReqIF format.

Transcript of Import Requirements Document

Page 1: Import Requirements Document

[email protected]

ReqViewImport of Requirements Document

version 0.13

Page 2: Import Requirements Document

Overview of Import Methods

HTML CSV ReqIF *

Tree hierarchy Yeshierarchy given by paragraph styles

Yeshierarchy given by

level attribute

Yes

Rich text format Yes No Yes

Images Yes No Yes

ID No Yes Yes

Custom attributes No Yes Yes

Traceability No No Planned

Import from MS Word MS Excel, DOORS DOORS

ReqView - Import of Requirements Document

© Eccam 2

* ReqIF is OMG standard for requirements exchange

Page 3: Import Requirements Document

HTML Import from MS Word1. Open document in MS Word, remove title page,

table of content and other unwanted sections

2. Check that the document is correctly structured

– Headings become sections and paragraphs requirements

– Rich text (bold, italic, underlined, text color, sub/superscript) is preserved

– Tables, bulleted and numbered lists are appended to the preceding requirement

– Images are added as attachments in separate requirements

ReqView - Import of Requirements Document

© Eccam 3

Page 4: Import Requirements Document

HTML Import from MS

Word

ReqView - Import of Requirements Document

© Eccam 4

Check document structure

Check document formatting

Page 5: Import Requirements Document

HTML Import from MS Word3. Save Word document

ReqView - Import of Requirements Document

© Eccam 5

Choose Web page, Filtered

file type

CheckUse PNG as a

graphics format

Set document Encoding to

Unicode (UTF-8)

Page 6: Import Requirements Document

HTML Import from MS Word4. Open ReqView and import HTML from File

menu Import HTML

ReqView - Import of Requirements Document

© Eccam 6

Choose HTML file exported

from MS Word

Choose all image

attachments

Page 7: Import Requirements Document

HTML Import from MS Word

ReqView - Import of Requirements Document

© Eccam 7

Structure is preserved

Images are imported as attachments

Requirements gets unique ID

Rich text formatting is preserved

Read More >>

Page 8: Import Requirements Document

CSV Import from Excel1. Open Excel file and organize it to at least

following columns: ID, Section, Description, Level

ReqView - Import of Requirements Document

© Eccam 8

Unique ID

Section name

Text requirement description

Level number

Page 9: Import Requirements Document

CSV Import from Excel2. Save Excel file as CSV (Comma delimited)

(*.csv)

3. Create configuration file mapping Excel columns to ReqView attributes

ReqView - Import of Requirements Document

© Eccam 9

{"name": “ReqView User Needs","mapping" : [

{ "attribute": "id", "external": “ID"},{ "attribute": "heading", "external": “Section"},{ "attribute": "text", "external": “Description"},{ "attribute": "level", "external": “Level"}

]}

Page 10: Import Requirements Document

CSV Import from Excel4. Convert CSV to ReqView by

Synchronizer specifying

– Given input CSV file

– Requested output ReqView file

– Prepared configuration file with attribute mapping

– Optional password

ReqView - Import of Requirements Document

© Eccam 10

synchronizer --import -f csv-i UserNeeds.csv -o UserNeeds.reqw-c UserNeeds.cfg -p password

Download Synchronizer

Page 11: Import Requirements Document

CSV Import from DOORS1. Open DOORS module and create a view with at

least Absolute Number, Object Heading, Object Textand Object Levelattributes

ReqView - Import of Requirements Document

© Eccam 11

Page 12: Import Requirements Document

CSV Import from DOORS2. In File / Export / Spreadsheet menu open Export

Spreadsheet dialog

ReqView - Import of Requirements Document

© Eccam 12

Check to export attribute names

Choose comma as data separator

Choose UTF-8 encoding

Page 13: Import Requirements Document

CSV Import from DOORS3. Create configuration file mapping DOORS

attributes to ReqView attributes

4. Convert CSV to ReqView by Synchronizer same as for Excel

ReqView - Import of Requirements Document

© Eccam 13

{"name": "Test document","mapping" : [

{ "attribute": "id", "external": "Absolute Number"},{ "attribute": "heading", "external": "Object Heading"},{ "attribute": "text", "external": "Object Text"},{ "attribute": "level", "external": "Object Level"}

]}

Read More >>

Page 14: Import Requirements Document

ReqIF Import from DOORS1) Define custom attributes for export

– Discussion – text attribute for comments

– History – text attribute summarizing changes

– Status – enumeration of allowed status values,e.g. draft, accepted, rejected

ReqView - Import of Requirements Document

© Eccam 14

Page 15: Import Requirements Document

ReqIF Import from DOORS2. Create ReqIF definition and export ReqIF file

ReqView - Import of Requirements Document

© Eccam 15

DOORS Next Gen

Page 16: Import Requirements Document

ReqIF Import from DOORS3. Create configuration file mapping DOORS

attributes to ReqView attributes

ReqView - Import of Requirements Document

© Eccam 16

{"mapping" : [{ "attribute": "id", "external": "ReqIF.ForeignID"},{ "attribute": "heading", "external": "ReqIF.ChapterName"},{ "attribute": "text", "external": "ReqIF.Text"},{ "attribute": "discussion", "external": "ReqView_Discussion"},{ "attribute": "history", "external": "ReqView_History"},{ "attribute": "status", "external": "ReqView_Status"}

]}

Note: Names of ReqIF external names depends on DOORS version.

Page 17: Import Requirements Document

ReqIF Import from DOORS4. Convert ReqIF to ReqView by

Synchronizer specifying

– Given input ReqIF file

– Requested output ReqView file

– Prepared configuration file with attribute mapping

– Optional password

ReqView - Import of Requirements Document

© Eccam 17

synchronizer --import -f reqif-i UserNeeds.xml -o UserNeeds.reqw-c UserNeeds.cfg -p password

Page 18: Import Requirements Document

ReqIF Import from DOORS

ReqView - Import of Requirements Document

© Eccam 18

DOORS Next Gen ReqView Desktop

Read More >>

Page 19: Import Requirements Document

ReqView References• ReqView Homepage

http://www.reqview.com

• ReqView Desktop Online http://www.reqview.com/apps/desktop/ReqViewDesktop.html

• ReqView Desktop at Chrome Store https://chrome.google.com/webstore/detail/reqview-desktop/cmbnhmeabefpflildnahpbghcejkblin

• Support Site - online help, knowledge base and discussion forumhttp://support.reqview.com/solution/categories

ReqView - Import of Requirements Document

© Eccam 19