- OSLC Home: http://open-services.net
- OSLC on Twitter: http://twitter.com/oslcNews
- OSLC-CM Home: http://open-services.net/bin/view/Main/CmHome
- Details on the RTC Implementation: https://jazz.net/wiki/bin/view/Main/ResourceOrientedWorkItemAPIv2
- Carolyn Pampino on the RQM-RTC integration: http://jazz.net/blog/index.php/2009/08/26/sprint-alignment-for-developers-and-testers/
- Scaling Agile with C/ALM eBook: http://www.infoq.com/resource/articles/scaling-agile-with-calm/en/resources/InfoQ-IBM-ScalingAgilewithCALMeBook.zip
Displaying items by tag: management
Introduction
When it comes to achieving the goals you set, it is important to have the best tools for the job. If you are already using IBM® Rational® DOORS® or are considering using it, there exists something, which can elevate the experience of using IBM® Rational® DOORS® and allow you to further enhance its already impressive capabilities - IBM® Rational® DOORS® Requirements Management Framework Add-on (also referred to as IRDRMFAO).
Challenges
In this article you will learn about what challenges you might encounter while attaining or managing the highest possible level of process maturity and how you can easily overcome them thanks to IRDMFAO.
- Firstly you can encounter problems when it comes to adopting requirements processes and their execution, especially when they are very complex. This can be a particularly significant issue should all stakeholders be involved in the process.
- When large quantities of requirements need to be analysed, it can be quite a lengthy and difficult process, which is why it needs to be as well optimized as possible.
- Consistency can be another huge obstacle, since it’s difficult to maintain between multiple projects. However, it is crucial for success.
- You may need to reach compliance with ISO 15288 and EIA632 standards. This can prove to be quite problematic
- You can get to a point where your process data model has to be updated on the projects that you are currently working on.
Option to solve it
All of these challenges can add up to be quite a problem. Luckily, IBM® Rational® DOORS® Requirements Management Framework Add-on can help you with every single one. It is a solution, which has been created by industry experts for others in the industry, since it can be utilized by a variety of occupations, e.g. Software Engineers, Hardware Engineers, System Engineers and many more. IRDMFAO is in its essence a requirements management add-on, a solution, whose primary aim it is to help you achieve peak time optimization through getting your project on track with a practice, which is one of the very best ones possible with DOORS. To add to that, IRDMFAO is engineered to help you reach compliance with EIA632 and ISO 15288 standards and CMMI recommendations. IRDRMFAO adds utilities, a process and a data model to DOORS. However the most important thing is that all DOORS commands remain accessible for its users, because there is no interference with the DOORS layout.
Preferred solutions
IRDMFAO provides you with several features, which help overcome the aforementioned challenges, firstly, a RMF Generic Data Model (RMF is an acronym which describes information handled by the product or an action performed by the product). IRDMFAO comes up with a universal data model, however you are not limited to only using this one. As a matter of fact, you will be able to pick from an assortment of module types and relationships, which IRDMFAO provides.
In this example of a RMF model, every box serves as a module type (which serves the purpose of instantiating DOORS formal modules). There are also relationships (verifies, refers to…), which are provided by DOORS link modules and linksets.
In short, every action bolstered by the Requirements Management process handles particular elements of the data model and makes use of varying sorts of relationships and module types (also known as templates). For example, System requirements analysis makes use of UR,IDJ SR modules (UR - Users Requirements; IDJ - Issues & Decisions and Justifications; SR - System Requirements) and the “is justified by”, “satisfies”, “refers to” links.
IRDMFAO does not limit you in using a particular data model. It allows you to customize and adapt it for the needs of your project, since you can decide to only make use of some parts and then, if you see fit, continuously add more. This makes adopting requirements processes and their execution simpler and less time consuming, while also making updates to your data model more intuitive, improving efficiency and consistency in the process.
Regarding the analysis of requirements, IRDMFAO has you covered by implementing specialized facilities that will aid you with management of particularly important requirements, whether they are considered hazardous (Critical requirements) or they are especially important to the project (Key requirements). There are also those that fit into both categories. IRDMFAO offers you “Risk analysis” - a specialized view using which you can assign significance and closely observe the especially problematic requirements. Another dedicated view - “Key requirements list” - allows you to do the same with the requirements you deem to be essential for your project. This will allow you to analyze and work with large volumes of requirements requiring analysis and save you precious time while also making the whole process more efficient.
Last but not least, IRDMFAO provides its check project or module consistency tool to help you maintain peak consistency across your various projects and also modules. It is designed to serve as a precursor for a manual check, as it can notice errors and inconsistencies. You can either use it to monitor through collection of already defined rules or utilize the Integrity Check functionality, in which you can establish your own integrity rules.
Specialized solutions. Approaches, tips
Now for a bit of an inside look, let’s inspect how IRDMFAO works. It enables you to instantaneously switch between two approaches that it uses. The first is the document approach, which you can utilize to view structured information (like chapters, sections, paragraphs) or reach a state of universal and continuous visualisation.
The second, database approach, allows you to define data using attributes and evaluate information, filter only the information that matters to you through filters and view traceability matrices.
To properly utilize the advantages that IRDMFAO offers, you will have to either create a new RMF project or transfer a DOORS project that already exists into a RMF project.
An important aspect of IRDMFAO is PUID (Project Unique Identifier). In its essence, it is used as a reference name of objects handled by the product (RMF objects), for example Requirements. There are two rules for this: firstly, two different objects should not have the same PUID values and secondly, the PUID should remain constant, meaning that even after change (editing the text or relocating the object) is done to it, the PUID should not change.
You do not have to do this manually (although you can), since you can allow IRDMFAO to manage the values automatically. This is another way that IRDMFAO makes your life easier.
Conclusion
All in all, IBM® Rational® DOORS® Requirements Management Framework Add-on (IRDMFAO) is an integrated collection of tools, which is immediately usable and upholds the very best practices used in the industry, in particular regarding systems engineering activities. It can help you maximize your potential by facilitating acceleration in adoption and enactment of requirements processes. Additionally, it guarantees compliance with EIA632 and ISO 15288 standards and SEI-CMM-I recommendations, can improve consistency and drastically simplify analysing huge amounts of requirements (and much more!).
Option 1: Project Area or Component Template
How to:
- In the current project go to Project or Component Properties > Templates
- Create New
- Click on data which you want to copy (if you click on Artifact then all artifact will be part of the template
- Create a new project area or component and use a template for creation (template must be downloaded and uploaded if you are porting to a new server)
Advantages:
- Works also for porting to a new server
- Links between artifacts are kept
- project area properties are automatically saved
- Are links within the project area/component are kept
Features
IBM Rational Team Concert is a powerful tool that is designed to be used in the software development area. But its key advantages are not in simple capabilities which can be found in a lot of other similar instruments. These advantages are based on collaboration mechanisms and the possibility to organize the effective work of numerous developers grouped into teams and sub-teams. It brings team awareness to all project members about current project status, a unified security model supported by roles and users, dashboards, and reporting capabilities.
The tool can not be called a new one because it's developed by the Rational Software brand of IBM and was first released in 2008. The software is available in various deliveries: “thick” clients, “thin” web client, and cloud solution. Additionally, there's a separate ISPF client to support developers in z/OS, COBOL, and PL/1 using TSO/ISPF but we will not be concentrated on these specific aspects here.
If we could take a look at the main milestones of Rational Team Concert development so we will note one very important fact: the tool is very stable at the last time. We can see that the periods between global releases are big. As users of this tool, we can believe that IBM will not wonder us very strongly by the full rebuilding of the capabilities and graphical users interface at least. Accordingly, we will not spend a lot of time and money retraining our developers and rebuilding out process descriptions to conform to those changes. Nevertheless, take into account that the development process continues constantly and many enhance and defect fixes are produced persistently.
Speaking more strictly, IBM Rational Team Concert is a collaboration tool designed to unite each member into a conveyor that can support persistent software development production with high quality and control throughout many projects of an organization. It provides a collaborative environment that software development teams use to manage all aspects of the process – change request management, version and configuration management, planning, building automation, revision control, reporting, etc.
Rational Team Concert isn't a cheap tool but it can be legally used for free by development teams with several developers from one to ten. In this case, the technical support from IBM will not be available for you but a lot of information placed at jazz.net and Jazz Forum will mitigate this problem significantly.
All Rational Team Concert artifacts have URI links defined for them. It's created in the core of the Jazz platform the part of which is the Rational Team Concert. The tool provides traceability across all artifacts allowing the link to them into information chains in the same way as the Internet can do it. For instance, you can link together such artifacts as work items, changesets, builds, tests, requirements, and so on. And the especially interesting fact that most of those links can be created automatically in the process of your work.
Change Management
Request (it's called a work item in Rational Team Concert) is a usual point to start any efforts in a project. It's an atomic kind of data in projects. Work items can be of various types, contain many attributes, and support various workflows with specific states and transitions among the states. They are used to trace and coordinate tasks by project members. And it's never minding which kinds of tasks are used. A project manager can be confident that all tasks will be realized or, at least, it will be easy to make it clear why some tasks are delayed or are the blockers for other ones.
The change management process is customizable at all. You can use diverse approaches to establish change management in your company. For example, you can use some typical templates coming to Out-Of-The-Box together with the installation of Rational Team Concert. Those templates bring some standard work item types (for example, epics, stories, tasks, defects, and so on, in case of using the Scrum process template). You can improve those work item types by customizing their attributes and workflows or develop your own work item types from scratch. In this way, only your imagination can limit the ways how you could apply a Rational Team Concert!
Version Control And Configuration Management
Rational team concert includes integrated version control and configuration management subsystem. It supports parallel development for teams of any size – from single groups of developers to big teams formed from many separate groups. The teams can be located somewhere in one place or be distributed everywhere in the world. The subsystem is seamlessly integrated with change management capabilities, so you can easily track which changes were made in codes, documents, and other files based on any tasks assigned to any developers.
But the force of Rational Team Concert is especially perceptible when you apply the tool for managing the versions of whole repositories but not single files only. You will save your artifacts in one or many components, fix the status of the components with snapshots and baselines. As a result of this, you will be able to restore the state of your project to a point how it was any time before. The flexibility of streams allows you to develop the software products in parallel, start any research where the results aren't clear still and avoid mixing them with the project artifacts, urgently fix any defects in the final phase of testing, and continue the development in parallel without any breaks and unexpected impacts.
But the force of Rational Team Concert is especially perceptible when you apply the tool for managing the versions of whole repositories but not single files only. You will save your artifacts in one or many components, fix the status of the components with snapshots and baselines. As a result of this, you will be able to restore the state of your project to a point how it was any time before. The flexibility of streams allows you to develop the software products in parallel, start any research where the results aren't clear still and avoid mixing them with the project artifacts, urgently fix any defects in the final phase of testing, and continue the development in parallel without any breaks and unexpected impacts.
Developers can work with Eclipse IDE and Microsoft Visual Studio which Rational Team Concert can be directly integrated into. In the case of non-integrated IDEs (for example, Delphi or others), you can easily work in parallel with the native Rational Team Concert Eclipse client available for installation. If you aren't a developer who works with numerous files simultaneously, it will be enough to work with Web-browser. Nevertheless, you can additionally install Rational Team Concert Shell which is a client embedded into Windows Explorer if you work in a Windows-compatible operation system.
Planning
The planning subsystem gives you a powerful mechanism for building plans, tracking single and related tasks, grouping the tasks at the level of a whole project or a single development sub-team.
To perform the tasks, you are to define timelines and iterations projects which define time constraints for any tasks to be created. You can define multiple timelines in a project if you have several teams working in various time schedules (for example, the main development team and a group providing tech support for customers).
It's possible to consider the developers as resources with having the predefined amount of time which they can spend in their work. Common time of all developers is an available collective resource in the project. You will see in real-time how the common time available in the project is being reduced by distributing the tasks among the developers. It gives you a precise tool to exactly plan the project based on the time really available for planning. Moreover, moving through the project, you will control how your expectations to finish the work at the predefined time conform to reality. It will give you feedback on whether you have to do something to accelerate the project works, or change the number of developers to successfully finish the project, or perform other urgent actions.
In a project, you can define overall project plans and specific plans for separate teams. Accordingly, some tasks can be directed to different plans excluding any ways to see the tasks assigned to other teams.
Automated building
IBM Rational Team Concert includes built-in management by building processes. It can be integrated with a lot of building engines (Maven, Hudson/Jenkins, Ant, command line supported, etc). And as everywhere in Jazz, building capabilities are closely integrated with another part of the instrument.
It's possible to realize the full process when delivery of some code to the mainstream will start its building automatically. Moreover, if the building was successful, it can result in launching the testing scripts in the related IBM Rational Quality Manager which is responsible for testing processes.
Of course, the building can be started manually or by schedule. It's easy to plan building processes by nights at the non-working time especially if it takes several hours, for example. When you come to the office in the morning, you will only check the building results and fix the problems.
Reports And Dashboards
Rational Team Concert can work with reports developed in external tools such as Eclipse BIRT, Rational Publishing Engine, Rational Insight, etc. Those reports can be printed or imported into Rational Team Concert to be able for generating data directly within Rational Team Concert in a typical Web-browser. Moreover, you can convert some reports into dashboards to control project status in real-time.
The reporting tool informs about any actions in the environment, behavior, and performance of work of a team in the project. Visualization of information about the development process can reveal certain trends that otherwise remain hidden or unclear. By making this information visible, reports can improve the effectiveness of decision-making efforts.
Rational Team Concert includes a big library of report and dashboard templates. For example, install the tool, create a project area and use the report informing about blocking tasks, the report about building results, the report displaying tasks of a single sub-team, the report with most valuable tasks, and others. The templates can be modified and created anew.
Process
Any project in Rational Team Concert is based on a process. A process in Rational Team Concert is a combination of roles, permissions, work item types, follow-up and behavior triggers, timelines, etc. The tool can strictly automate the activities for different users which have assignments to one or several roles. It will guarantee that nobody will do something that is forbidden to him and everybody can access only the data which is permitted to access for him.
You can constantly improve the development process and build your own process fixing it as a process template. Starting another project, you will be able to use that template to deploy the best practices which were found to be effective in your environment into this project.
Collaboration
You can set components owners at the level of sub-teams or single developers so that only some developers could access these components. Capabilities to setup visibility of project areas and separate components allow you to involve a lot of external developers restricting their access to some data. For example, external developers will not even know that there are other projects in your organization or other components with artifacts within a project. You can give access to customer representatives with read-only access for monitoring purposes.
Rational Team Concert simplifies the exchange of information in the context of the work performed. The project members can be automatically notified of any changes to the project activities. Changes can be provided in the form of discussion in various work items. Interested parties can automatically track the status of an individual task and subscribe themselves to future notifications.
Multiple views allow you to share information about the team. You can monitor the work of the team, change the level of details of information and customize the displayed information. For example, “My Work” and “Team Events” views create a comfortable private workspace to be informed about the current project state and effectively participate in the development process.
Community
The jazz technology platform is hosted at jazz.net where you can be informed about the capabilities of Jazz and register for participation. You can open requests for improvements, track schedules, participate in discussions, communicate with the developers of Jazz and Rational Team Concert, and get known about the last releases of Rational Team Concert and other products based on Jazz. Developers of Jazz and Rational Team Concert itself work closely with the community and publish a lot of technical documentation at the site jazz.net.
Overview
IBM Rational Quality Manager is a collaborative, web-based, quality management solution that offers comprehensive test planning and test asset management from requirements to defects. The Jazz platform enables teams to seamlessly share information. It uses automation to speed project schedules and report on metrics for informed release decisions. It can also be purchased as part of the Collaborative Lifecycle Management solution—a set of seamlessly integrated tools: IBM Rational Team Concert, IBM Rational Quality Manager, and IBM Rational DOORS Next Generation.
Rational Quality Manager works with requirements in IBM Rational DOORS Next Generation to keep test cases in sync whenever requirements evolve. Rational Quality Manager also integrates with a wide range of test automation tools like IBM Rational Functional Tester, enabling you to run tests and collect results, all from a central location.
But when we will take a look at embedded software development, we will find big specifics because it's used on machines and devices that are not typically thought of as computers. Usually, this kind of software is specialized for the particular hardware that it runs on and has time and memory constraints. It can be exactly described that no or not all functions of such software are initiated/controlled via a human interface, but through machine-interfaces instead. We can point to such similar devices as cars, phones, modems, robots, toys, security systems, pacemakers, TV sets, digital watches, various medical devices, etc. This software can be very simple, such as lighting controls running on an 8-bit microcontroller with a few kilobytes of memory, or can become very sophisticated in solutions such as airplanes, missiles, and process control systems.
IBM Rational Quality Manager supports reliable and flexible integration with testing systems from National Instruments specially designed for use in embedded software development. National Instruments (NI) Test Integration Adapter for IBM Rational Quality Manager software enhances test engineer teams' efficiency by automating NI TestStand sequence execution and reporting from Rational Quality Manager.
Engineering departments create increasingly complex products, and as a result, automobiles, aircraft, medical devices, consumer electronics, and more depend on software driving the hardware components. IBM Rational software and National Instruments integrate development and test environments to help clients with their most important goals:
- Test the code of smart products, which might have hundreds of thousands or millions of lines of code, for defects.
- Reduce the cost of code defects by identifying them earlier in the development process.
- Mitigate increasing product complexity by tackling quality challenges earlier in the development process.
- Improve efficiency by breaking down the tasks between engineering departments.
Combining Rational Quality Manager software and National Instruments (NI) TestStand provides comprehensive test case traceability, test case results management, and automated test scheduling and execution. Test results are made available to all teams so that applications can be validated at virtually every point along the development path, from simulation and prototyping, through deployment onto hardware, and integration into the end system. Both operational efficiency and test accuracy can be improved through the ability to reuse test components throughout multiple project phases and even on different projects.
A specially designed piece of software - the NI Test Integration Adapter for Rational Quality Manager software - provides integration between NI TestStand and Rational Quality Manager. This integration product includes the following main features and functions:
The requirement to test traceability: Test engineers can use the integration to link automated tests to test cases and to requirements. NI TestStand applications (and by extension all the code modules called) and parameter files on the test machine are linked to a Rational Quality Manager test case that provides traceability to other project aspects including requirements, overall quality plan, project plan, change-defect management system, and so on.
Test automation: From the web-based interface of Rational Quality Manager, test engineers can invoke the execution of the NI TestStand applications that are linked to the Rational Quality Manager test case. The execution status reported by the NI TestStand sequence is displayed in the Rational Quality Manager web interface as part of the test case execution results. Test engineers can then optionally create defects linked to the test case results to keep track of noncompliance detected by running the test.
Test case results management: Upon completion of the NI TestStand sequence, various outputs from the sequence are automatically published to Rational Quality Manager storage and an HTML report is linked to the Rational Quality Manager test case execution result page. The HTML report is created by this software product on the local machine and the details of the report content as well as what is stored in IBM JazzTM are configured by the user.
Videos
Excellent video about the integration of modeling, requirements, and testing software development areas into the whole software development process with solutions from IBM and National Instruments.
Simulink from The MathWorks, Inc. (an American privately held corporation that specializes in mathematical computing software) is graphical programming software for building models, simulations, and analyses for complex dynamical systems. It offers tight integration with the rest of the MATLAB environment. The tool can be very useful in automatic control and digital signal processing for multidomain simulation and Model-Based Design.
For completeness, the DNG public API's that are available are:
- RDNG Reportable API - extracting read only information from RDNG generally for creating custom reports to be run from DNG or RPE. As well, it can be used in a lot of custom applications interacting with RDNG. Big advantage of this API is its simplicity and great performance if you need to work with big amounts of data. Sometimes it's called as RDNG Reportable REST API.
- OSLC RM V2 API - the open standard way to programmatically integrate with DOORS Next Generation, there is an elaborate workshop to get you started here OSLC Workshop article. These programs can be from any language that supports various HTTP methods of requests, e.g. Java, C# etc. Hence these are more flexible to run and can read and update DNG data, as part of a web server, or standalone, but have some limitations set by the current OSLC standard, for example module support. In release 6.0.5 extension have been added for modules. It's very powerful tool to work with RDNG data including capabilities of data modification but can be a little bit more complex in use than other ways.
- TRS 2.0 - the OSLC Tracked Resource Set open standard REST API to hook into the stream of low level changes done to resources in the DNG application (and other Jazz apps as well); read only.
- RM API - it's realized in client extension capability that is accessible from Rational DOORS Next Generation. This is Javascript extension framework that generally can be added as widgets which you can run from the dashboard, and can be used to view and edit DNG data. The widgets are developed in accordance to OpenSocial standard (based on Google Gadget framework). It's more tailored to DNG, so has better module support, but is limited to be run in a browser/javascript environment. It's very easy to make an automation of your work in this way. You can do a lot of interesting tricks with currently open Web page based on DOM/XML standards. You can add support of many popular libraries such as JQuery and so on. But this big simplicity results in some constraint in implementation. For example, you can easily access RDNG artifacts in current module or collection as well as access any selected artifacts but there are some difficulties if you need access artifacts in current view or currently available on the page. But use RM API together with other APIs described above can allow you do stunning things with RDNG.
Helpful Links
Ord. Link Comment 1 API Landing page This is a landing page for the various API wiki pages that exist on the Jazz.net development wiki as well as a central collective page of the known APIs that are available for integrating programmatically with our CE/CLM products. It serves as a convenience for accessing API information about CE/CLM products and is not guaranteed to have up-to-the-minute information. 2 DOORS Next Generation Reportable API The DOORS Next Generation server provides REST APIs for accessing information about requirement artifacts for reporting. You can access each API by using a standard web browser, IBM Rational Publishing Engine or a third party tool can can consume the DNG reporting services responses. This document covers reporting capabilities for DNG versions 6.0 and higher. 3 Using OSLC capabilities in the Requirements Management application You can use Open Services for Lifecycle Collaboration 2.0 (OSLC) capabilities in the Requirements Management (RM) application for the Rational solution for Collaborative Lifecycle Management (CLM). This article includes examples of how to use those capabilities in an HTTP poster tool. These basic examples are described. 4 Open Services for Lifecycle Collaboration Workshop The workshop will help guide you to leverage the Open Services for Lifecycle Collaboration (OSLC) standard interfaces for interoperating with Jazz-based products including RDNG. These labs will highlight key aspects by leveraging web browser access and programmatic access via Java client programs. The final lab will illustrate by an example how to write your own server using Java servlets. This lab is based on the OSLC-CM 2.0 and OSLC-RM 2.0 Specification. After you complete these labs, you will have a good foundation by which to leverage OSLC to implement an interoperability project. 5 OSLC Requirements Management Version 2.1. Part 1: Specification This specification defines the OSLC Requirements Management domain, also known as OSLC RM. The specification supports key RESTful web service interfaces for software Requirements Management systems. 6 OSLC Requirements Management Version 2.1. Part 2: Vocabulary This specification defines a vocabulary and resource shapes for the OSLC Requirements Management resources. 7 IBM DOORS Next Generation Server API Documentation (additions from v6.0) Additions to standard OSLC API specially developed for use with RDNG. It takes into account some RDNG specifics that is out of scope of OSLC specification. 8 Getting Started with RDNG Extending Capabilities Brief video giving a quick introduction into client extending capabilities. 9 Client extension API for the Requirements Management (RM) application This document specifies the client extension API that forms part of the 6.0.5 release of the Requirements Management (RM) application. The version of this API is 1.1. 10 Client extension capability (all versions) List of links to client extension APIs for all supported versions. 11 jQuery API Useful API when developing RDNG client extensions. 12 Web APIs When writing code for the Web with JavaScript, there are a great many APIs available. Below is a list of all the interfaces (that is, types of objects) that you may be able to use while developing your Web app or site.
Useful Links
https://www.facebook.com/oslcfest/
DOORS Next Generation (v4.0.6): Adding an extension to your dashboards via URL
https://www.youtube.com/watch?v=q3DxAneAPYQ
Adding widgets to the widget catalog of IBM Rational DOORS Next Generation (V4.0.6)
https://www.youtube.com/watch?v=mXl1YcDYjVg
