Capturing requirements: Importing documents

  • 210 views
Uploaded on

After you complete this module, you should be able to do these tasks: …

After you complete this module, you should be able to do these tasks:
- Import a word document and create a module with supporting artifacts
- Import a CSV file and create requirements artifacts

More in: Education , Technology
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads

Views

Total Views
210
On Slideshare
0
From Embeds
0
Number of Embeds
0

Actions

Shares
Downloads
0
Comments
0
Likes
0

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide

Transcript

  • 1. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 1© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.© Copyright IBM Corporation 2013Capturing requirements: Importing documentsContentsModule overview -2Importing requirements into a project -3Importing process checklist -4Importing a document and creating a module -5Import results -10Creating a module? Word paragraph stylesmatter -11Checking styles -12Lab 1: Importing a Microsoft® Word file as aRM module -13Lab 2 : Importing requirements artifacts from aCSV file -14Review -15Module summary -16
  • 2. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 2© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.2 © Copyright IBM Corporation 2013Module overviewAfter you complete this module, you should be able todo these tasks: Import a word document and create a module with supportingartifacts Import a CSV file and create requirements artifacts
  • 3. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 3© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.3 © Copyright IBM Corporation 2013Importing requirements into a projectCreate a rich-text artifactfrom a document file.Create rich-text artifactsfrom a CSV file.Automatically extractand create rich-textartifacts, and optionally amodule, from adocument file.Import from various sources: Publication tools Tables, such as database exports Text files Scanned documentsExchange requirementsby using a ReqIF file.You can import requirements fromdocuments and CSV files into a requirementsproject.You might have project requirements that aredocumented in a spreadsheet or in aMicrosoft Word document. You might find iteasier to solicit early stakeholder input in adocument outside of the requirementsmanagement application . If necessary, youcan import documents of various types intoyour requirements management applicationproject and make the content available toother users.You can import information in these ways:•Import and extract requirements from a textdocument.•Import requirements from a CSV file.•Import a text document and covert it to arich-text file.Tips:•Use the CSV import function to importsimple textual requirements that haveassociated attribute values.•Use the Word import function to importrich-text documents, including documentsthat have embedded images or otherembedded objects.•Import requirements from within a textdocument when you want to automaticallycreate a set of requirements artifacts from atext document.
  • 4. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 4© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.4 © Copyright IBM Corporation 2013Import checklist Identify the essential data sources and files. Select the import location. Determine how you want theinformation to be imported. Analyze the source data format. Prepare source file or files for import. Test the import: if necessary, modify the source file. Run the import. Verify and save the results.Rich-text artifactRequirementsDiagramsGraphicsInformationModule artifactArtifactsHeadingsPreparing the source file or files forimport implies tagging the file withdelimited text, making sure thecorrect styles are used, and more
  • 5. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 5© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.5 © Copyright IBM Corporation 2013Importing a document and creating a module (step 1/4)Determine how you want theinformation to be imported.To start the import wizard, selectArtifacts > Import.
  • 6. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 6© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.6 © Copyright IBM Corporation 2013Importing a document and creating a module (step 2/4)Define the criteria to use toidentify the requirements.The artifact types that arecreated depend on the criteriathat you specify .Identify the essential datasources and files.Select the import location.Determine how you wantthe information to beimported.In the import wizard, you define how therequirement artifacts are extracted. You canspecify where to save the artifacts that arecreated from the import.
  • 7. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 7© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.7 © Copyright IBM Corporation 2013Importing a document and creating a module (step 3a/4)Define the criteria to use toidentify the requirements.The artifact types that arecreated depend on thecriteria that you specify .Use the style in the documentto specify a certain artifacttype .Specify how to handle imagefiles.Identify keywords and assignan artifact type to each.The RM application identifies requirementsin a text document by detecting headings,images, keywords, and text delimiters in thedocument. For each part of the document,you can specify an artifact type to create .
  • 8. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 8© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.8 © Copyright IBM Corporation 2013Importing a document and creating a module (step 3b/4)Identify text delimiters andassign an artifact type toeach.Specify an artifact type toapply to all other text.
  • 9. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 9© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.9 © Copyright IBM Corporation 2013Importing a document and creating a module (step 4/4)Before you extract and import therequirements, review the artifacts. Ifyou see unexpected results, makechanges.
  • 10. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 10© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.10 © Copyright IBM Corporation 2013Import resultsModuleFolder with artifacts thatcompose the moduleAfter the import is complete, verifythat all of the requirements werecorrectly extracted. You might needto clean up the new requirements.
  • 11. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 11© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.11 © Copyright IBM Corporation 2013Creating a module? Paragraph styles matterLevel 1 Section artifact (Heading)Level 2 Section artifact (Heading)Level 2 artifactLevel 3 artifactParagraph styles in Microsoft Wordcorrespond to the structural hierarchyof a module in the RM application.When you import a Microsoft Worddocument into the RM application,the artifact hierarchy is created basedon the applied styles in MicrosoftWord.
  • 12. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 12© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.12 © Copyright IBM Corporation 2013Checking stylesBefore you import a Microsoft Worddocument into the RM application, checkthe paragraph styles that are applied inMicrosoft Word. Make sure thatthe styles are applied correctly.Paragraphs in the Microsoft Worddocument that have outline levels 1 - 9are imported as Artifact and createSections
  • 13. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 13© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.13 © Copyright IBM Corporation 2013Lab 1 : Importing a Microsoft® Word file as a RM moduleAt the end of this lab, you shouldbe able to do these tasks : Describe how Microsoft Wordparagraph styles affect a modulethat is created by an import. Prepare for an import by identifyingand fixing paragraph styleproblems. Import a Microsoft Word file tocreate a module and its supportingartifacts.
  • 14. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 14© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.14 © Copyright IBM Corporation 2013Lab 2 : Importing requirements artifacts from a CSV fileAt the end of this lab you willbe able to: Describe how Microsoft®Word paragraph styles affecta module that is created by animport Prepare for an import byidentifying and fixingparagraph style problems inMicrosoft Word Import a Microsoft Word file tocreate a module and itssupporting artifacts.
  • 15. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 15© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.15 © Copyright IBM Corporation 2013Review List a few options for importingrequirements from externalfiles. Before you import a MicrosoftWord document, whatinformation must you consider ?
  • 16. Essentials of IBM® Rational® DOORS Next Generation V4.01Capturing requiremetns : importing a document 16© Copyright IBM Corporation 2013Course materials may not be reproduced in whole or in part without the prior written permission of IBM.16 © Copyright IBM Corporation 2013Module summaryIn this module, you learned how to do these tasks : Import requirements from a CSV file Import a Microsoft Word document and create amodule and its artifacts