IBM officials congratulated an HTii team at a Nov. 3 IBM conference for conducting a successful seminar on requirements management using Jazz.
HTii’s Adam Hammett and Andrew Ridenour showed attendees at the Chantilly, VA conference how to migrate data from Rational DOORS 9 to DOORS Next Generation in the Jazz suite of programs.
“There’s great interest in the topic of data migration to Jazz,” Ridenour said. “We received a higher than average number of questions during and after our presentation.”
The team has submitted an abstract of the seminar to IBM for the 2016 Interconnect conference in Las Vegas.
“We don’t know what our chances are at this stage,” Hammett said, “but data migration is a big issue for lots of organizations, and our goal is to make the process as painless and precise as possible.”
The team’s presentation will be updated with new techniques being developed for the massive amounts of data many corporate users handle in DOORS. “It can literally be orders of magnitude greater than what we’ve seen with our NAVAIR clients,” Ridenour said, “and we’re upgrading our procedures to accommodate it.”
At their November 3 seminar, Hammett and Ridenour showed attendees how to migrate data from Rational DOORS 9 to DOORS Next Generation using two different techniques: one with the Requirements Interchange Format (ReqIF), a type of XML file, and the other with comma-separated values (CSV) files.
Most questions from the audience concerned ReqIF imports. “It’s a more versatile, robust format, and it allows data already in Jazz to be updated with subsequent imports,” Ridenour said. “But people often have trouble with it.”
The entire ReqIF process, from packaging the ReqIF file to importing it into Jazz, is largely non-transparent, he noted. “It requires a lot of preparatory work in the source database before creating the ReqIF file to make sure the data is imported properly.”
Seminar attendees also had questions about importing CSV files. The minimally formatted, tabular text files can create problems for even experienced DOORS users.
“The CSV import is a process with terrible feedback and error-handling,” Ridenour said. “Identifying what is going wrong is almost impossible unless the user is aware of everything that can go wrong, so we made sure people understood what those cases were.”
Tips provided by the team for successful CSV imports include
- Case sensitivity is critical, e.g., in order for the column “module” to function correctly, it must start with a lower-case, not capitalized, letter m.
- Column order and number do not matter. As long as the core attributes are included (primary text/name, artifact type), any number of additional columns can be created in any order.
- Artifact types and attributes MUST exist in the Jazz project first, BEFORE importing the CSV.
- An attribute defined in the CSV file must be associated with the artifact type on which the record is told to apply the attribute. For example, the attribute “Build” must first be associated with type “Requirement” in order for a “Build” value to be assigned to a Jazz artifact of type “Requirement.” This is done in Jazz before importing the CSV file.
The HTii team presentation can be viewed here. To minimize file size, videos contained in the brief are linked separately at the bottom of the original story below.
HTii to conduct IBM conference seminar on Jazz requirements management
An HTii team will conduct a seminar on managing requirements with Jazz at a November 3, 2015, Washington-area IBM conference.
HTii’s Adam Hammett and Andrew Ridenour will show conference attendees how to migrate data from Rational DOORS 9 to DOORS Next Generation.
The conference, IBM Continuous Engineering for the Internet of Things (ICE IoT), will take place Nov. 3-4 at the Westfields Marriott Washington Dulles, Chantilly, VA. It will provide first-hand learning about some of today’s hottest topics for engineering, including requirements management, systems design, model-based systems engineering (MBSE), new collaboration technologies and the impact of the Internet of Things on product development.
One of more than 100 workshops and presentations, the HTii seminar is scheduled for Nov. 3 at 2:45 to 3:25 PM. It’s part of Conference Track 4, Requirements Management, which will demonstrate best practices, new implementations and advances in the field.
In their seminar Hammett and Ridenour will explain how to transfer data from DOORS 9 to DOORS Next Generation with two different techniques: one with the Requirements Interchange Format (ReqIF), a type of XML file, and the other with comma-separated values (.csv) files. They will discuss the uses and limitations of both methods and provide a detailed walkthrough for each.
DOORS 9 is an IBM requirements-management application built upon a traditional desktop client/server architecture. DOORS Next Generation is a Web-based tool that’s part of the Jazz collaborative lifecycle management suite. DOORS Next Generation works in concert with other Jazz tools to provide a comprehensive solution for not only requirements management but also architecture, work item tracking and continuous integration.
Although the main focus will be on DOORS 9 to DOORS NG migration, the session will also provide a broad understanding of how DOORS NG accepts .csv and .ReqIF files.
The presentation will include videos that show the steps in detail, providing a how-to of all necessary inputs and actions. Attendees will receive copies of the videos and slides for use after the conference as a stand-alone resource when working through data transfer on their own.
More information on the conference can be found at http://www-304.ibm.com/services/learning/ites.wss/zz/en?pageType=page&c=O930156N63112I73.
Videos shown at the seminar include