DOORS enlightenment webinars for 2014

16.1.2014

IBM has released the calendar for the DOORS enlightenment webinars for the first half of 2014. These presentations take place at 12:00 ET (Eastern Time Zone in the USA), but typically they are recorded and viewable at the webinar home page.

Date           Subject
17.01.14     Proposed Attribute Method: A Flexible Method of Change Control for DOORS

07.02.14    Effectively optimizing the DOORS Database

21.02.14    Common Mistakes and Misconceptions in Using DOORS

07.03.14    Creating Traceability in DOORS and Beyond – The Various Methods

21.03.14    Using DOORS in secure, flexible Cloud environment

04.04.14    Managing Parallel Streams of Requirements in DOORS at GM

18.04.14    Managing Requirements for Highly Complex Products

02.05.14    DOORS 101: An Introduction to DOORS 9.5

16.05.14    Agile Requirements: Modeling Across Agile Iterations

06.06.14    DOORS and Rational Publishing Engine – The latest enhancements

20.06.14    Integrating Requirements and with IBM Rational DOORS and IBM

More information and registration at http://ibmfederal.us/DOORS-Enlightenment/

Advertisements

Configuring the DOORS client: command line switches and registry settings

28.10.2013

Many DOORS client properties can be configured using command line switches and/or Windows registry settings, e.g. what database is to be used, what is the default opening mode for opening modules, specifying the user account to log into DOORS etc.

For a general overview on how to set these properties, see the IBM Help page Configuring the registry and using command-line switches for the Rational DOORS client and on what properties can be configure see: Command-line switches for the Rational DOORS client.

To set the command line switches on Windows client the Windows shortcut properties have to be modified. In the picture below the “Target” field shows already one switch, the “-data 36679@pmsoftqa4” which determines that a DOORS client started through this shortcut (icon) will use some other database than the default.

comm1

If I wanted always to open my modules in “Read Only” mode instead of the default Exclusive Edit I could add “-defopenmode READ_ONLY -defopenlinkmode READ_ONLY” to the end of the Target field. After adding that, my switches for this shortcut would read “-data 36679@pmsoftqa4 -defopenmode READ_ONLY -defopenlinkmode READ_ONLY” in total. Note that there is a separate switch for those modules opened directly from DOORS main window and for those opened through link browsing.

The command line switches listing in the Help page lists also short versions of the switches so that the long line above can be shortened to “-d 36679@pmsoftqa4 -o r –O r”. I usually prefer the long versions, because that way it is easier to see what the setting is.

The same settings can be also done by editing Windows registry: start up regedit.exe and browse to the path for the DOORS Config settings – this path will be different for different Windows version. For me on Windows 7 Professional 64-bit it is “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Telelogic\DOORS\9.5\Config”

comm2

To specify registry settings you have to create new registry values in the “Config” key, these should be of type “String Value”. After creation, rename the value to the wanted switch, e.g. “defopenmode”. After renaming you can give data to the value by double-clicking on the value name

comm3

In the picture below the registry settings are defined for opening modules

comm4

The command line switches in the shortcut will override the registry settings, so even though the registry defines READ_ONLY modes for opening modules, individual shortcuts might have READ_WRITE and the modules are opened in Exclusive Edit.


DOORS link attributes: Link Proposal System and scripts

9.7.2013

What are link attributes?

Links in DOORS have attributes similar to objects or modules. DOORS creates the system link attributes “Created On / By”, “Modified On / By” etc. – in addition suspect link handling in DOORS is dependent on link attributes, namely “Suspicion Cleared Backwards / Forwards”. Similar to object attributes we can also create link attributes based on the requirements management process: we might e.g. want to store the priority of the link or the reason for linking the objects.

Link attributes and link attribute types are created in link modules, but most often edited in the source modules. It is possible to edit to link attributes in the source modules by using the Object Properties / Links dialog. Select a specific link and press the “Details” button to see or edit link attribute values for that link.

linkattr1

Because this editing action needs many clicks, link attributes are not quite often used. It is possible to edit link attributes also in link modules, but it is even more complicated than in source modules. To display link attribute values in a column is more easier than editing if you create traceability columns using the Analysis Wizard – step 3 allows to select which link attributes are displayed in columns.

linkattr2

Link Proposal System

As an example on how to use link attributes I implemented  a “Link Proposal System”. The main idea is that as users create links the status of those links are maintained by a link attribute.

E.g. we could have an enumerated link attribute Link Status with values of  “Proposed”, “Accepted” and “To be deleted” and set the “Proposed” value to be the default value. Every link created will then have a Link Status of “Proposed”. Thus even though the link exists it is not accepted in this process.

A person reviewing traceability can check the links in a review trace view and set those which are accepted to have “Accepted” Link Status. If a link is not accepted, then it is marked as “To be deleted” – and deleted either manually or with a DXL script.

Standard DOORS usage would use traceability views showing only the links which have been accepted, i.e. links with status of “Proposed” or “To be deleted” are not shown in these views. Of course all the links are visible in DOORS UI and users can browse those, but within this kind of process they are not links which should be used for traceability.

linkattr3

Support scripts

The make the modification of links attributes easier I also wrote a prototype DXL script for modifying single-value enumerated link attributes, such as might be for example used in the Link Proposal System.

The script dialog has two selection lists. The upper shows what outgoing or incoming links the currently selected object has and the lower shows what single-value enumerated link attributes have been created in the link module containing the link and the attribute.

The link selection list shows in addition to the link attribute name also the attribute value. The value can be changed by double-clicking on the selected link attribute name – as this script deals with enumerated attributes, it will cycle through the values for that attribute for each double-click.

linkattr4

The DXL script can be downloaded from http://www.softqa.fi/dxl/edit_link_attr.dxl


Google Docs: Importing and exporting DOORS requirements

2.7.2013

One of the most used export formats in DOORS is the Spreadsheet format (or direct export to Microsoft Excel). This is also the only easily available file format which allows for offline editing as the corresponding Spreadsheet import (from Comma or Tabulator Separated Values files, CSV/TSV) can update existing DOORS data. These exports can also be imported to cloud-based Google Docs allowing for collaborating on DOORS requirements

If it is planned to re-import the modified data to DOORS it is useful to prepare an export view in DOORS. This export view mainly breaks up the main column to separate columns for Object Heading and Object Text so that individual attributes can be updated on re-import. The view should also include the Object Identifier column as this is needed during import.

view

After exporting from DOORS (File / Export / Microsoft / Excel (and then maybe save as CSV from Excel) or File / Export / Spreadsheet to CSV) the resulting CSV file can be imported to a Google Spreadsheet.

gimport

As see from the preview window, Google import for CSV file does not read the column names correctly from the first line of the CSV file. For this reason  it is more useful to do the import to Google Docs straight from an Excel file in XLS / XLSX format, as this file seems to be formatted correctly: gregs

After import the file can be formatted in Google as needed: in the above example I have frozen the first row, set word wrap on for Object Text column and  displayed in bold the Object Heading column and column titles in first row.

As the Google Docs is a cloud based service this file can be now published to specific users. The shared file can also have user settings: how can read the file, who can comment, who can edit the data.

gshare

The commenting option in Google Docs can be useful within Google while discussing the requirements, but these comments cannot be exported or printed. gcomment

Modifications done in Google Docs are stored in the Revision history, allowing also to roll-back changes, if needed.

gchanges

New requirements (new objects) can be added in Google by inserting new rows to the spreadsheet. No Object Identifier details are needed for these as DOORS will give the identifiers on import.

After modifications the file can be exported from Google to DOORS by selecting File / Download as / Comma Separated Values (DOORS can update data only from CSV / TSV files).

gexport

The generated CSV file can be imported to DOORS in the original module by selecting File / Import / Spreadsheet. The updated objects can be identified by DOORS by using the Object Identifier as unique key.

import

After import DOORS will display the result for the import: how many object updated and how many created. If there is a main column in the current view, the modified or created objects are shown as modified by a red change bar before saving the changes.

result

If your modifications or additions include characters outside of the normal ASCII symbol set (e.g. Finnish text) then it might be useful before importing check the import preview by pressing the Advanced button in the Spreadsheet import dialog and selecting correct “Encoding” for the characters – I used UTF-8 to import the ÄÖ-characters correctly.

For more information on Google Docs see Wikipedia article https://en.wikipedia.org/wiki/Google_Docs (also good to read the “Data safety and privacy” chapter here) or Google Drive help https://support.google.com/drive/?hl=en.


DOORS 9.5.1

26.6.2013

DOORS 9.x –sarjan uusin versio 9.5.1 (ja jopa sen 1. korjauspaketti 9.5.1.1) on julkistettu. Vaikka kysymyksessä on versionumerosta päätellen pieni päivitys, on 9.5.1 –versiossa mukana uusiakin ominaisuuksia ja toimintoja, sekä DOORS-clientissa että DOORS Web Access –selainliittymässä.

Rational Publishing Engine-teknologiaan pohjautuva Document Generation –toiminta on päivittynyt. Aikaisemmat erilliset export-valinnat on yhdistetty samaan dialogiin ja nyt on mahdollista esim. exportoida samaan aikaa Word-dokumentti ja PDF-tiedosto. Jotenkin tämä uusi käyttöliittymä kyllä vaikuttaa hieman harjoittelijan tekemältä ja lisäksi Document Generation toiminnallisuus on oikeastaan huonontunut verrattuna aikaisempaan 9.5 –versioon: nyt mukana on vain kaksi RPE-templaattimallia: book tai table. Eikä näitä templaatteja voi itse muokata ilman täyttä Rational Publishing Engine-tuotetta.

doorsrpe

Merkittävä muutos DOORS-tietokannan hallinnassa liittyy linkkien hallintaan: ensinnäkin tietokannan ominaisuuksissa voi kieltää automaattisen linkkimodulien luomisen – tämä tarkoittaa sitä että tietokanta ei enää täyty ”DOORS Links” –linkkimoduleilla, vaan käyttäjien on pakko käyttää määriteltyjä linkkimoduleita. Lisäksi asetuksissa voidaan myös asettaa käyttöön varoitus jos poistetaan objekteja joissa on ulospäin meneviä linkkejä  (vakiostihan DOORSissa objekteja joissa on sisäänpäin tuleva linkki ei saa poistettua ennen linkin poistamista).

DOORS-taulukkojen hallintaa on kehitetty, uudessa dialogissa pystyy helpommin muokkaamaan taulukon rakennetta ja esim. yhdistämään soluja sekä samalla valitsemaan yksittäisessä taulukossa esitetyn attribuutin, joka taulukko voi siis esittää eri attribuutteja.

table

9.5.1-versiossa uuden projektin voi alustaa olemassa olevasta DOORS Project Archive (DPA)-paketista. DOORSin mukana on ohjelmahakemiston ssea_templates-alihakemistossa neljä mallitemplaattia. Templaattihakemiston paikan voi myös tietokannan ominaisuuksissa määritellä haluamakseen, jolloin templaatit ovat käyttäjien helposti löydettävissä. Asensin Medical Devices-projektitemplaatin ja se oli sisällöltään hyvin kattava: kansiot, modulit, attribuutit, linkkisuhteet, linkkimodulit ja näkymät olivat valmiina. Sanoisin että tämä on erinomainen lisä DOORSiin! Valitettavasti DOORS Help ei ole ajan tasalla tämän toiminnallisuuden kannalta, koska malliprojekteista ei ole dokumentaatiota.

DOORSin historiatiedoissa pystyy nyt kaivautumaan current-version muutoksista baseline-tietoihin, eli aikaisempiin moduliversioihin – ennen tätä DOORShan näytti historiassa vain ne muutokset, jotka ovat tapahtuneet viimeisimmän baselinen jälkeen.

history

Näiden muutosten lisäksi 9.5.1 release note toteaa  “You can configure your system to display a preview window when you hover over an internal link that shows a summary of the linked object, similar to the preview window that is displayed for collaboration links”. En ole vielä löytänyt miten tai mistä tälläisen linkkitietojen näyttöasetuksen saisi päälle, joten tätä en ole pystynyt testaamaan. Lisäys 11.07.2013 IBM julkaisi ohjeet miten tämä konfigurointi tehdään, jotta toiminto onnistuisi pitää olla asennettuna myös DOORS Web Access, pelkkä DOORS ei siis pysty tähän, ks. linkki.

DOORS Web Access versio 9.5.1 sisältää käyttöliittymän parannuksia: mm. käyttäjäasetukset tallentuvat käyttäjäkohtaisesti, joten ei haittaa vaikka vaihtaisi selainta tai työasemaa. Lisäksi nyt voi valita halutaanko näkymälistaa tai baselinelistaa esittää.

Version 9.5.1 julkistustiedot IBM sivustolla http://www-01.ibm.com/support/docview.wss?uid=swg24034716


DOORS-myyttejä ja vastauksia

8.4.2013

IBM Rationalin vaatimustenhallinnan työkalujen tuotepäällikkö Richard Watson julkaisi äskettäin blogikirjoituksen “The reports of my death are greatly exaggerated: DOORS is alive and well”, jossa hän käy lävitse markkinoilla liikkuvia huhuja DOORSin tulevaisuudesta.

Myyttejä on mm.

  • DOORS 9.x tuotesarjan kehitys ja tuki on loppumassa – IBM: päinvastoin, DOORS 9.5 tuotekehitystä jatkuu, esim. 2013 tulee uusia ominaisuuksia
  • Asiakkaiden pitää siirtyä 9.x-tuotteesta korvaavaan DOORS NG:hen – IBM: ei pidä, eikä kannata, koska tällä hetkellä DOORS Next Generationin ominaisuudet eivät vielä vastaa DOORS 9.5 ominaisuuksia
  • Jos haluaa käyttää DOORS NG:tä, pitää ostaa uusi lisenssi – IBM: DOORS 9.5 lisenssin omistajat saavat myös DOORS NG:n lisenssin, tuotteita voi käyttää rinnakkain

Alkuperäinen blogikirjoitus.


Some useful links for DOORS users in IBM domains

12.5.2011

Some of the links listed below need registration with IBM ID (email + password) and/or existing maintenance contract

Download DOORS sofware

Download site for DOORS version previous to 9.1 (i.e. Telelogic DOORS 9.0 and downwards)
https://www.ibm.com/support/docview.wss?uid=swg21380552

Download site for IBM Rational clients and servers (version 9.1 up to 9.3)
https://www14.software.ibm.com/webapp/iwm/web/reg/pick.do?lang=en_US&source=RATL-RATIONAL

Download latest versions from IBM Passport Advantage
http://www-01.ibm.com/software/howtobuy/passportadvantage/index.html

Support pages

DOORS Support Portal, starting with the discussion forums (DXL, Administration, General and Integrations)
http://www.ibm.com/support/entry/portal/Forums_communities/Software/Rational/Rational_DOORS

Rational Support Blog (publishes new DOORS Support items)
https://www.ibm.com/developerworks/mydeveloperworks/blogs/nfrsblog/?lang=en

IBM Requirements Management Blog
https://www.ibm.com/developerworks/community/blogs/requirementsmanagement/?lang=en

Help and documentation

IBM Rational DOORS Documentation for version 9.1 and 9.2
http://publib.boulder.ibm.com/infocenter/rsdp/v1r0m0/index.jsp

Rational DOORS Information Center for version 9.3 and up
http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp

Rational DOORS 9.5 Help
http://pic.dhe.ibm.com/infocenter/doorshlp/v9r5/index.jsp

White papers, technotes and tutorials

DeveloperWorks Technical Library for DOORS
http://www.ibm.com/developerworks/views/rational/libraryview.jsp?sort_by=&show_abstract=true&show_all=&search_flag=&contentarea_by=Rational&search_by=&product_by=P%3ARational+DOORS&topic_by=-1&industry_by=-1&type_by=All+Types&ibm-search=Search

IBM Knowledge Center for Rational DOORS
http://www-01.ibm.com/support/knowledgecenter/SSYQBZ/welcome

IBM Education Assistant for DOORS (tutorial videos for version 9.2 and up)
http://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jsp?topic=/com.ibm.iea.doors/plugin_coverpage.html

Release notes for Rational DOORS and Rational DOORS Web Access (v 9.1 -)
http://www-01.ibm.com/support/docview.wss?rs=1090&uid=swg27038526

Web-based training for selected Rational products (old versions, but useful nevertheless)
http://www-01.ibm.com/support/docview.wss?uid=swg27040220

Telelogic legacy forums: discussions and file attachments

Available at IBM site for DOORS and other Telelogic branded applications
http://www-01.ibm.com/support/docview.wss?uid=swg27017148

DOORS Next Generation sites

DOORS Next Generation main page from Jazz.net, including dowload latest version
https://jazz.net/products/rational-doors/

DOORS Next Generation infocenter/help
http://pic.dhe.ibm.com/infocenter/clmhelp/v4r0m2/index.jsp?topic=%2Fcom.ibm.rational.dng.help.doc%2Ftopics%2Fc_about_dng.html

Latest update: February 10th 2014