Quality Manager 4.0.5 Saves Records Per Page Query

I don’t believe this was announced in the 4.0.5 release notes, but Rational Quality Manager now allows Records Per Page to be saved for a query.

If you don’t know what I’m talking about, it’s the setting shown below.

RQM Items Per Page

Even an IBM expert didn’t realize this change made it in. Very cool.

A client of mine new to 4.0.4 asked for this, and it just so happened to be fixed quickly. So rare that the stars align in this way.

Jazz 405 Is Out

IBM Jazz 4.0.5 Released

Jazz 405 Is Out
]1Jazz 4.0.5 Is Out

IBM just released IBM Jazz 4.0.5. While you can download 4.0.5 now, I thought I’d cover some compelling reasons to do so.

What’s new in Jazz Team Server 4.0.5

  • You can limit the amount of time that a report runs — good for stopping reports that take too long or that error out.
  • CLM server monitoring is now installed by default. Seems like a few hoops must be jumped through to use it though.
  • Archive and restore process templates: I see this being used to help migrate projects to sandbox servers.
  • Project Members can be searched for within the Manage Project page. Filtering for Project Members
  • Clear the current iteration instead of having to have a default
  • Membership data for projects and teams, including roles, is now sent to data warehouse so it can be reported on.
  • New window to create timelines and iterations (seems cleaner to me, just my opinion)
  • repotools now supports online backup of work item indices

What’s new in Rational Team Concert 4.0.5

  • Can now copy and paste build properties
  • ClearCase Importer has been improved
  • Export source code data query results from builds into a file
  • Improved usability for merging changes containing gaps in history
  • Remote Project Support (Rational Developer for System z and TPF Toolkit)
  • Removal of restriction on promoting Kanban views
  • Improvements on Tag creation and display on Work Items
  • UrbanCode Deploy integration
  • Can exclude components from builds
  • Context-aware search command line command supports SSL and smart cards
  • The ISPF client can accept all for incoming changes (I have no idea what this means, looks mainframe/cobol related)
  • Can set line delimiter handling in source control to NONE
  • Connect to JazzHub from RTC Eclipse Client
  • New help for command-line interface
  • Argument seperator in command-line interface
  • Create Package Wizard has an option to include work items
  • Create Package Wizard has a preview package option.
  • Can query results of package export
  • Ant tasks for packaging and deployment
  • In the web client, you can now view preconditions and follow-up actions.
  • The plan editor has been greatly enhanced
  • Bug fixes for MS Project 2010 export with correct dates
  • Kanban view now reports on exceeded count limits
  • Can migrate plans from pre-4.0.5 releases and include explicit rankings
  • New filtered combo widget (drop-down list searching without using the drop-down list. Pretty nice.) Drop-downs also will show tree views
  • Query results will now show approvals, links, and comments in-line
  • Approvals now bulk-editable in Eclipse
  • Can filter links in query results
  • Links are now bulk-editable in Eclipse
  • Override schedule properties of builds

What’s new in Rational Quality Manager 4.0.5

  • Test Suite runs can be puased, resumed, and stopped.
  • Support for multiple subcategories
  • Reportable REST API for lab resources
  • Subcategory filters in table views
  • Can restore deleted test artifacts
  • Manage categories through heirarchical views
  • New views for category management (show all and show outline)
  • Can create new values from existing values in a different category via drag and drop
  • Test Plans have three new sections: Test Scripts, Test Case Results, and Test Suite Results
  • The test case results for test scripts that have test data associated with them now include the row number of the test data for each step result.
  • New process advisors for state transitions
  • Support for reconciling a subset of requirements collections
  • Various scalability improvements

What’s new in Rational Requirements Composer / DOORS Next Generation 4.0.5

  • Scripting (with warnings against using in production)
  • Drag and drop linking
  • Link creation via Cut and Paste
  • Get hyperlinks for multiple artifacts at once
  • Define preferred link types for artifact types
  • Drag-and-drop reodering of artifacts within a module (finally!)
  • Drag-and-drop artifacts between modules and collections
  • Use OSLC to link to all artifacts in a module view
  • Module scrolling is faster and improved
  • Can now upload a new artifact and include it in a collection or a module in one step (versus uploading, then inserting existing artifacts)
  • Can now control more easily how many levels are shown within a module
  • Embedded images/graphic artifacts are now proportionally scaled within the artifact viewer
  • Search now defaults to the current project instead of all projects
  • Double-clicking now selects an artifacts and the space bar highlights an artifact
  • You can now copy artifacts and create links between the original and duplicated artifact
  • Copy artifacts via drag-and-drop within modules
  • Improved keyboard shortcuts
  • Improved performance while editing within modules
  • Improved scroll preview within modules (it shows up only when needed)
  • Module views available to RRDI
  • New RRDI reports — Requirement List by Collection, Requirements with Execution Results by Collection, Artifact Count, Requirement Counts, Requirements Distribution, Requirements Linked to Test Cases by Collection, Gap Analysis, among many others (must enable them in JTS advanced properties)
  • RRDG exports include printing module in book or table format
  • Quick print of reports without giving parameters
  • Inline view of PDF files in artifacts
  • RDF URIs for the type system
  • ReqIF improvements (to support RDF types)
  • Tips for Requirements Management

I got all of the above information by going to this page, and manually viewing each of the links. The above list does not include all improvements.

My Thoughts

IBM has committed to providing quarterly updates to their Jazz CLM applications. This list is quite big considering IBM’s schedule. RQM probably got the most needed improvements with subcategories, and DOORS Next Generation (DNG)/Rational Requirements Composer is starting to mature nicely. I’m very interested to see how the scripting report works (I believe it uses JavaScript) and how rapidly it matures.

2014 will be a great year for Jazz, particularly for DNG, if IBM can keep their promise of how they intend to version control requirements. That, with reusability, will really have companies who currently use DOORS evaluate DNG seriously.

iOS7 Tip: Restore Lost Contacts

Ran into an issue with the current iOS7 release with contacts, and figured I’d share.

The other morning my contact list was wiped. No contacts. But contacts were on my Mac. I sign into iCloud and all my contacts are there (and Apple did a GREAT job with the iCloud contacts page, you should really check it out).

I realized that one of my Exchange accounts had its password expire and I hadn’t set a new password. Creating a new password and putting it on my iPhone restored all of my contacts.

Free Private Source Code Hosting on JazzHub

Free Private Source Code Hosting on JazzHub

From now until the end of 2013, registering on IBM’s JazzHub allows free hosting of source code for public and private projects.

This was just announced so I haven’t been able to dive in head first on this, but JazzHub seems to be an implementation of Rational Team Concert in the cloud that has been set up to import code from github, who also allows free project hosting for open source projects.

Screen Shot 2013-10-23 at 5.27.09 PM

There is a small catch here. Your private projects are hosted at no cost to you until January 2015, where fees start to apply. At that time you can either migrate your projects elsewhere, convert them to open source, or decide to pay.

While we here at Baselines Incorporated have always been experts in requirements management, we learned Rational Team Concert when we saw that Jazz was the future platform for the Rational DOORS brand. While Rational Requirements Composer/DOORS Next Generation are not currently at feature parity with DOORS Classic, going towards Jazz allows for a much better backend architecture than the current DOORS Classic settings, which will eventually allow for things like true version control of requirements! (This will be the killer feature that solidifies DOORS Next Gen’s place in the market as the new requirements leader. You heard it here first.)

Git/Github is great for version control. Aside from a bit of a learning curve because of a new paradigm of source code control, I don’t personally have many complaints about it. It’s easy to use when you know how to use it. The simultaneous problem and benefit with git in my opinion is that other than the command line, there’s no standard client to use.

RTC allows use of a command line, explorer shell extensions in Windows, Visual Studio, and Eclipse. Eclipse has a fully configured RTC download and RTC is a plug-in on the Visual Studio side. There are git plugins for Eclipse too (I’m not sure about VS). But RTC was built with Eclipse in mind and so there is just one RTC plug-in for Eclipse.

In any case, if you’ve been wanting to try out RTC for some application ideas you’ve had, there’s really not a lot of reason not to try JazzHub right now.

Feel free to contact us for more information regarding DOORS, DOORS Next Generation, Rational Team Concert and Rational Quality Manager.

IBM Technote on Imported Word Table Captions

I wonder if my last post had anything to do with this.

How to remove “Table” caption prior extracting document in IBM Rational Publishing Engine

What a horrible title for this technote. The “Table” caption comes in as a HEADING, not a caption. And this problem only exists in exports from DOORS that were brought in from MS Word and that is also not mentioned. The word DOORS isn’t even in the title, which tells me that most RPE customers are using DOORS.

While the information in the technote is valuable, I still can find no actual reason any long time user of DOORS would want invisible table headers to have a heading of “Table” on tables exported to DOORS from Word documents. Unless every DOORS table will always have this heading regardless of where it is created, this “feature” needs to be removed in the next release.

Tricky DOORS 9.3.0.7/RPE Bug with DOORS Tables

Friday was not a fun day for me. I had to troubleshoot a bizarre issue with Rational Publishing Engine. Anyone who has worked with RPE knows that while it’s a very good tool, troubleshooting document errors is a long process that can absolutely test every ounce of patience you have.

The issue in this particular case was that in certain modules, an extra heading would be added to a table. This did not happen in every module, which seems to point to not being an issue with the RPE template (a .dta file) but rather with the data of the table itself. The problem was that the tables appeared to be identical!

Reproducing The Problem

I’ve been able to replicate the problem in Word 2010, DOORS 9.3.0.7 and DOORS 9.4, and RPE 1.1.2.2. Here’s what to do.

Create a new Word Document. Put a table in it. Here’s what I did. You can click the number next to each photo for a fullsize view.

Export from Word to DOORS

Initial Word Document
]1 Initial Word Document with Tables
Exporting to DOORS
]2 Exporting to DOORS
New DOORS Module
]3 New DOORS Module based on Word Document

Okay, everything so far looks good. Let’s export with RPE. I’m going to use the doorsData.dta file that comes with RPE just for demonstration purposes.

doorsData.dta
]4 doorsData.dta

Let’s do an export and look at our output.

Extra Table Heading!
]5 Where did that Table Heading Come From?

The red arrow shows an erroneous heading! What’s going on here? I didn’t put that there. Those italicized Table captions comes after each table, and that’s controlled by the .dta file.

Troubleshooting The Problem

I could write lots of paragraphs here boring you with everything I tried. I’ll tell you this to speed things up: I tried multiple .dta files and multiple DOORS modules and the results appeared consistent between modules. What I mean is, one module would consistently output table headings and one module would consistently not output table headings, regardless of the .dta file used to export. Strange indeed. I’d look at random table cells in each table and they all looked identical.

I know what might work! Inserting a DOORS Table into a module that was behaving like this. So that’s next.

Creating another DOORS Table.
]6 Creating another DOORS Table.

Now we export again and check the results.

A tale of two tables.
]7 A tale of two tables.

Ok, so it’s not a module-by-module basis, it’s a table-by-table basis on which this error occurs! I’m stumped. The only thing I know for sure here is that it is not a .dta problem. It appears that tables captured from Word documents behave this way, while tables created in DOORS don’t.

I talk this problem over with a colleague and she tells me that there are other modules that are exhibiting this behavior. She did a little research and ultimately determined the problem.

DOORS Tables (Suck)

If you are a religious person, and you use DOORS, you must believe that DOORS Tables are a tool of the devil. When I train people in DOORS, I explain that having tables in modules is not just a DOORS issue, it’s a requirements management issue. Tables can make it easy to digest information, but they can also obscufate requirements. Is each cell a requirement? Each row? A combination of rows? The entire table? Since the purpose of requirements management is to make requirements clearer, tables go against the very nature of effective requirements.

Over a decade ago, Telelogic had a problem. DOORS did not support tables. Their clients were demanding table support, so some designer came up with the idea to “hack” DOORS objects and make tables consist of these hacked DOORS objects. Each DOORS table has an “invisible” table header object, and each row has an invisible row object. Why did I put the first “invisible” in quotes? Well, because you actually can see these invisible DOORS table header objects, under the correct circumstances. How?

Click View->Show->Table Cells. It’ll likely be checked when you see it in the menu. Clicking it will uncheck this option.

How to view invisible table headers
]8 How to view invisible table headers

Ok, now that you’ve done that, you’ll see objects that appear to have a Heading of > > Table. Like so:

Invisible Table Headers!
]9 Invisible Table Headers!

So now that we can see these table headers, I can now get to the properties of the invisible table headers. TBLISSUE-6 represents the table where the problem is showing up. I right-click the object and choose Properties and am presented with this!

Here's the problem!
]10 Found the problem!

This table header object has an Object Heading of Table! Where did it come from? The Microsoft Word export process now sets the Object Heading of each invisible DOORS Table Header object as “Table”, thus putting a bug into every single RPE template that deals with DOORS data!

The only way I can think of to fix this, for sure, 100% of the time, without affecting data in any of your modules is to remove this Object Heading from each DOORS table exported from Word. What a pain! But let’s do that and see what happens.

Problem solved, for now.
]11 Problem solved, for now.

Thoughts

I wasted almost an entire work day trying to troubleshoot and solve this issue. I’m not very happy about this, and am posting here in order to help others who may encounter the same issue. This fix was not at all obvious and even the problem occurs sporadically.

I read the release notes for each DOORS release I implement and I either completely missed this change to DOORS or more likely, this change was not documented. It’s also angering, because as a user, if I want to put Object Headings on my invisible Table Headers then I will do so. Also, the latest RPE sample files do not reflect this change, as demonstrated, so in my opinion, the DOORS developers introduced a bug into RPE!

Even more frustrating is that I’ve entered PMRs and RFEs for DOORS behavior that I believe are outright bugs and they get ignored outright or I have to justify changing them because of how much they cost my clients. Yet stuff like this happens with no warning and my clients eat the cost of me and others trying to figure out what’s happened here.

Friday I announced on this site that Baselines Incorporated is now an authorized reseller of IBM Rational Software. I stated that I would ensure that the content of this site along with my opinions would not be affected by us selling IBM Rational DOORS and Rational Publishing Engine and the like. The bad news is that this bug exists at all, but the good news, for me anyway, is that I got to prove that I am a man of my word.

I sincerely hope this article helps people save some time in the future and that IBM fixes this issue in a soon-to-be-released future release. In the mean time, a PMR/SR has been entered and I am engaging my IBM representatives about this horrible change.

Baselines Inc Now Sells IBM Rational Software

I’m excited to announce that Baselines Incorporated now has the ability to sell IBM Rational software, including IBM Rational DOORS, IBM Rational Team Concert, IBM Rational Rhapsody, and IBM Rational Publishing Engine, IBM Rational Quality Manager, to name a few. This has been a few months in the making and I want to thank everyone involved for helping to make this happen.

I will still give my same opinions and thoughts on where IBM should go with their software and hopefully my status as a business partner and reseller will go towards my thoughts being heard and implemented.

This change won’t affect the content of this site. The exciting part is that if Baselines has an existing relationship with your company, then this is an extra service we can offer, as you can purchase IBM Rational DOORS from us. We can generate quotes and there are different payment and financing options that can be chosen as well.

Baselines Incorporated, The Requirements Management Experts, are experts in IBM Rational DOORS, DOORS DXL scripting, Rational Publishing Engine and Rational Team Concert. We make it our business to understand our clients’ requirements management, change management process and workflow, and validation and verification needs and fulfill their expectations. If it involves requirements, it involves our knowledge.

If you have any questions about any of our services, don’t hesitate to contact us!

IBM Rhapsody and DOORS Englightenment Series 2012

I received the following email from Nancy Rundlet at IBM.

IBM is now offering both Rhapsody Enlightenment and DOORS Enlightenment every Friday, alternating between the two products. NOTICE that there are 3 new DOORS Enlightenment topics that have been added in November and December as well as links to the recordings for the events that have recently been delivered. Please scan the list below for those topics of interest and when you click on the link, you will see an abstract for each of the topics.

Please spread the word to others who may be interested.

Rhapsody Enlightenment Series

6/22 12-1 ET Validating the consistency & completeness of your requirements with modeling Manohar Rao https://www2.gotomeeting.com/register/785884730

7/13 12-1 ET Reverse Engineering existing code into Rhapsody Chris Carson https://www2.gotomeeting.com/register/890348450

7/27 12-1 ET Systems Engineering: Importing Requirements from DOORS to Rhapsody Justin Dyer https://www2.gotomeeting.com/register/933085170

8/10 12-1 ET Safety Critical Software Development with Rhapsody Bruce Douglass https://www2.gotomeeting.com/register/208807610

8/24 12-1 ET Systems Engineering: Trade Study Analysis Gavin Arthurs https://www2.gotomeeting.com/register/575771018

9/14 12-1 ET DDS Software Development with Rhapsody Dan Poirot https://www2.gotomeeting.com/register/289500490

9/28 12-1 ET Systems Engineering: Automating Harmony SE Processes with the SE Toolkit Andy Lapping https://www2.gotomeeting.com/register/653823042

10/12 12-1 ET How to Organize Your Model for Teaming, Reuse, Configuration Management Ed Mayer https://www2.gotomeeting.com/register/724120402

10/26 12-1 ET Systems Engineering: Creating Combined Simulations with Rhapsody and The Mathworks Simulink Ron Felice https://www2.gotomeeting.com/register/812217530

11/9 12-1 ET Test Driven Development with Rhapsody TestConductor Jeff Cohen https://www2.gotomeeting.com/register/801734122

12/14 12-1 ET Systems Engineering: Creating Interface Specifications with DOORS and Rhapsody Ed Mayer https://www2.gotomeeting.com/register/974353882

DOORS Enlightenment Series

Webcast series 1st Friday (Introductory) and 3rd (Advanced) each month 12:00 Noon ET for approximately 1 hour

6/29/12 DOORS Next Generation Update (every 2 – 3 months) Richard Watson https://www2.gotomeeting.com/register/348355346

7/6/12 Importing with ease Jim Marsh https://www2.gotomeeting.com/register/423068266

7/20/12 Common Metrics Collection in DOORS George Siampos https://www2.gotomeeting.com/register/996061362

8/3/12 Extending DOORS with DOORS Web Access Jim Hays https://www2.gotomeeting.com/register/856848242

8/17/12 Optimizing the Performance of DOORS Web Access Jim Marsh https://www2.gotomeeting.com/register/838124410

9/7/12 DOORS and Testing — The options available Jim Hays https://www2.gotomeeting.com/register/123105626

9/21/12 Requirements Management and Product Line Engineering Michelle Specht https://www2.gotomeeting.com/register/305250674

10/5/12 Collaborating with DOORS Discussions Melissa Robinson https://www2.gotomeeting.com/register/890606066

10/19/12 Extending DOORS – Introduction to DXL (DOORS eXtension Language) Don Cunningham https://www2.gotomeeting.com/register/370491698

11/2/12 Basic Tips and Tricks of Using DOORS Rick Learn https://www2.gotomeeting.com/register/240379874

11/16/12 Managing Change Proposals in DOORS Steve Grossman https://www2.gotomeeting.com/register/211722578

11/30/12 The Latest Update on DOORS Next Generation Richard Watson https://www2.gotomeeting.com/register/609802306

12/7/12 Extending DOORS to Model Based Systems Engineering Barclay Brown https://www2.gotomeeting.com/register/139105194