Report generation is an important feature of the IBM® Rational® System Architect tool. But the report generation component of IBM® Rational® Publishing Engine, which it includes, can pose a learning challenge, particularly while generating reports in a Rational System Architect and IBM® Rational® DOORS® integration. This article explains the steps to generate cross-tool reports for Rational System Architect and Rational DOORS projects by using Rational Publishing Engine features.
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Generate cross-tool reports with RationalPublishing EngineProject reports when Rational System Architect and RationalDOORS are integrated
Report generation is an important feature of the IBM® Rational® System Architecttool. But the report generation component of IBM® Rational® Publishing Engine,which it includes, can pose a learning challenge, particularly while generating reportsin a Rational System Architect and IBM® Rational® DOORS® integration. This articleexplains the steps to generate cross-tool reports for Rational System Architect andRational DOORS projects by using Rational Publishing Engine features.
Before you start
This article explains the steps to generate cross-tool reports for IBM® Rational®System Architect and IBM® Rational® DOORS® projects by using IBM® Rational®Publishing Engine features.
Overview of the three tools
Rational System ArchitectThis is a leading enterprise architecture tool that provides integrated support forall four domains of business, information, systems, and technology. It offers themost complete enterprise modeling solution by enabling its users to analyzecorporate business processes, build new component-based applications,redesign the back-end databases, or document the legacy systems.
Rational DOORSRational DOORS is a requirements management application that containsfeatures for capturing, tracking, and managing user requirements.
Rational Publishing EngineThis tool automates the generation of documents for ad hoc use, formalreviews, contractual obligations, or regulatory compliance. This can helpimprove productivity and reduce risk and cost. It uses predefined templates forrapid adoption, and all of these are available through an easy-to-use graphicaltemplate-editing environment.
Integration of these three tools
Through Version 11.3.1.1, Rational System Architect includes a comprehensivereporting system that can generate reports in XML, HTML, or Microsoft® Wordformat.
With the integration of Rational Publishing Engine with Rational System Architect,you can now connect to Rational System Architect and Rational DOORS datasources, generate multiple output formats with complete flexibility in appearance,and create concurrent documents in multiple target formats from a single template.
Prerequisites for this exercise
You must have Rational System Architect Version 11.3.1.1 or later, RationalDOORS Version 9.0, 9.1, or 9.2, and Rational Publishing Engine Version 1.1.1 orlater, as well as the Rational System Architect and Rational DOORS Integrationmodule installed.
This article uses the included samples encyclopedia, called JK Enterprises, whichyou can download from the My developerWorks wiki site. The encyclopedia isprovided as an MDF file called J K Enterprises – Cognos Version 1.0.mdf.
To use this encyclopedia:
1. Start SAEM for SQL Server, click Database Menu, and select Attach.
2. Browse to the folder of the saved MDF file and attach it.
You can use the same report template to run against new encyclopedias also.
Linking the Rational System Architect process with the RationalDOORS requirement
1. Open the J K Enterprises encyclopedia in Rational System Architect,
2. Create a business process diagram named Apply for FinancialCredit Product, as Figure 1 shows.
Figure 1. Business process diagram example in Rational System Architect
Larger view of Figure 1.
3. In the Apply for Financial Credit Product diagram, select the DetermineApplicant Eligibility process.
4. Stage the selected symbols by selecting Select Tools – DOORS – StageSymbol for DOORS from the Rational System Architect main menu, asFigure 2 shows.
• Browse the developerWorks page for Rational Publishing Engine.
• Check the Rational Publishing Engine Information Center fordocumentation for all versions, or get support from the Rational PublishingEngine help system.
• Rational System Architect:
• Browse the developerWorks page for Rational System Architect and watchthe demonstration online.
• Check the Rational System Architect Information Center for documentationfor all versions, or get support from the Rational System Architect helptopics.
• Rational DOORS:
• Browse the Rational DOORS developerWorks page for links to technicalarticles and many related resources.
• Explore the Rational DOORS Information Center.
• Visit the Rational software area on developerWorks for technical resources andbest practices for Rational Software Delivery Platform products.
• Stay current with developerWorks technical events and webcasts focused on avariety of IBM products and IT industry topics.
• Attend a free developerWorks Live! briefing to get up-to-speed quickly on IBMproducts and tools, as well as IT industry trends.
• Follow developerWorks on Twitter.
• Watch developerWorks on-demand demos, ranging from product installationand setup demos for beginners to advanced functionality for experienceddevelopers.
• Explore Rational computer-based, Web-based, and instructor-led onlinecourses. Hone your skills and learn more about Rational tools with thesecourses, which range from introductory to advanced. The courses on thiscatalog are available for purchase through computer-based training orWeb-based training. Additionally, some "Getting Started" courses are availablefree of charge.
• Download a free, fully enabled trial version of Rational System Architect.
• Get the free trial download for Rational DOORS Web Access.
• Evaluate IBM software in the way that suits you best: Download it for a trial, tryit online, use it in a cloud environment, or spend a few hours in the SOASandbox learning how to implement service-oriented architecture efficiently.
Discuss
• Participate in technical discussions in the Rational Publishing Engine forum.
• Participate in the Enterprise Architecture and Business Architecture forum andthe Rational System Architect Forum, where you can share information aboutmethods, frameworks, and tool implementations. Discussions includetool-specific technical discussions about Rational System Architect.
• Join the Rational DOORS forum to ask questions and participate in discussions.
• Get involved in the My developerWorks community. Connect with otherdeveloperWorks users while exploring the developer-driven blogs, forums,groups such as the Rational Café, and wikis, such as the Rational EnterpriseArchitecture wiki.
About the author
Jothi SubramaniJothi Subramani holds a bachelor’s degree in computer science andhas been a software architect for more than a decade. In the past fouryears, while involved in the design and development of Rational SystemArchitect, she has made significant contributions to the SA Explorer andIntegration modules.