GEBS Reporting Arena
Introduction
1999 – Founded – Software Solutions 2004 – Started with Telelogic - DocExpress
2007 – Design and implemention of Telelogic Publishing Engine/ Rational Publishing Engine
2010 – Continued working in reporting area with services and products as IBM Business Partner
GEBS Services and Products
Services
RPE Implementation
Template design and optimization Migrating legacy solutions to RPE RPE Training
Custom reporting solutions
Products
Web client for RPE – Reporting Arena Web Publisher (RAWP)
New output formats for RPE – MS Excel: RAEC
– MS PowerPoint: RAPC
Using Rational Publishing Engine
to Generate Documents Across
System Development Life Cycle
ABSTRACT
This talk discusses how to use RPE to generate large-scale reports across the System Development Life Cycle. The goal is to create a cross product report that will document all the system requirements (Rational DOORS) tracing all the work items (Rational Team Concert) that implement each requirement and all the test cases (Rational Quality Manager) that validate that requirement.
Polling Question 1
• What products would you like to use RPE for:
– A) DOORS
– B) RTC
– C) Rhapsody
– D) RQM
Polling Question 2
• How do you currently automatically
generating your organizations documents?
– A) We prepare documents manually
– B) RPE
– C) DocExpress/SoDA,
– D) Company created tool
– E) other
Rational Document Generation
Rational Publishing Engine
This tool automates the generation of documents for ad hoc use, formal reviews, contractual obligations, or regulatory compliance. This can help improve productivity and reduce risk and cost. It uses predefined
templates for rapid adoption, and all of these are available through an easy-to-use graphical template-editing environment.
Rational Publishing Engine
Supported Rational Tools: Asset Manager, ClearCase, ClearQuest
DOORS, RequisitePro, Requirements Composer Focal Point, System Architect
Quality Manager, Team Concert
Rhapsody and Software Architect (through the Design Manager)
Supported Non-Rational Tools: It also provides access to data from other
companies' software through Extensible Markup Language (XML) and Representational State Transfer (REST) interfaces.
1. Rational DOORS + DOORS WEB Access
2. Rational Rhapsody + Design
Manager
3. Rational Team Concert
4. Rational Quality Manager
Rational Solution for Systems Engineering
Rational DOORS + DOORS Web Access
Manage system requirements and full traceability across the lifecycle.
Rational Rhapsody + Design Manager
Use modeling to validate requirements,
architecture and design throughout the development process.
Rational Solution for Systems Emgineering
Tools Overview
Rational Team Concert
Integrates task tracking, source control,
and agile planning with continuous builds
and a configurable process to adapt to the
way you work
Rational Quality Manager Achieve 'Quality by Design' with an integrated, automated testing progress.
RPE + RAWP
WEB Reporting Solution for System Engineering
1. Document Studio
Design document templates
2. Reporting Arena Web Publisher (RAWP)
Design document specifications
1. Rational Publishing Engine 1.1.2
2. Reporting Arena Web Publisher 2.1 (Ready for Rational) 3. Rational DOORS 9.3 + Rational Web Access 1.4.0.5
4. Rational Team Concert 4.0 5. Rational Quality Manager 4.0
Prerequisites
Rational Live document generation 2012
RTC storage app RQM storage app DOORS storage app XML XML XML RPE engine RAWP Server OSLC Links OSLC Links RPE Studio Document templates Design Share storage OSLC LinksRPE – Document Studio
Intuitive drag and drop template building capability
Integrated preview capability avoids wasted time in validating template changes
Powerful scripting language support (Javascript) with expression editor
Create single templates to generate all different types of output format
Reporting Arena Web Publisher
Reporting Arena Web Publisher (RAWP) provides an online interface for
generating documents using RPE.
Overcomes RPE limitations as a desktop application
Installation and updates on each user machine
With RAWP deployment is done fast and
easy, with no installation required on client
machine, just a web browser is needed
Isolated environment
With RAWP all RPE assets can be shared to be used by other users
RAWP – Main Features
Introduces new features
Resource Manager Templates Styles
Specifications
Support for MS Excel and MS PowerPoint
Scheduler
Document history and
administration
Role-based interface for template management, document publishing and administration
RAWP – Document Generation Process
1. Analize requirements
2. Create document templates and stylesheets
3. Authorize and share document templates and stylesheets 4. Create and configure document
specifications
5. Authorize and share document
specifications
6. Publish documents or schedule
Capture the report requirements
1. Extract system requirements from Rational DOORS
2. Document implementation WI from Rational Team Concert
3. Document validation test cases from Rational Quality Manager 4. Create requirements and testing
Template Development– Workflow
1. Design the document 2. Specify the layout
3. Implement the template
4. Test the template
5. Review report
6. Deploy the template and document specification
Define report layout
1. Define static/dynamic sections (first page, TOC, TOF) 2. Define sections layout - masterpages
1. Header section 2. Footer section
3. Define new style elements / Import existing company predefined styles
Document requirements
Link requirements to WI
Process Implementation Links
Rational DOORS
DOORS – RTC connection attributes
Filter object links based on link type
“Implemented by”
Process link content and extract the WI ID (ex. 97)
RPE Template - Section 0 (Introduction)
1. Import title, aprovals, change history pages from a standardcompany RPE template
2. Import predefined company styles from an existing template or use external stylesheets
3. Define new styles 4. Insert TOC, TOF
RPE Template – Section 1 (DOORS)
Iterate System Requirements
1. Import a DOORS Schema
2. Iterate through all the objects 3. Use ”InformationType” attribute to decide if an object is: 1. Heading 2. Context info 3. Requirements
4. Create Req – Wi’s
Document WI’s
RPE Template – Section 2 (RTC)
Trace WI’s that implement Requirements
1. Discover schema for WI 2. Iterate through all the
project WI
3. Use conditions to filter only the Wis that implement system requirements.
4. Display WI details
5. Create Wis – Test Cases traceability table
Document Test Cases
RPE Template – Section 3 (RQM)
Trace WI’s that implement Requirements
1. Discover RQM - Schemas 2. Iterate through all test
cases
3. For each test case, iterate through all execution results
4. Display execution results
Embedded Charts – Section 4
Vizualize the requirements coverage using charts
In some cases numeric data is much easier to understand when presented as a chart.
Limitation: Rational Publishing Engine does not have a special module for chart generation like BIRT.
Alternative: RPE can embed charts in generated documents using javascript language and some charting
engines
Using GOOGLE Charts engine
Using javascript to create chart URI inside RPE template.
http://chart.apis.google.com/chart?cht=bvg&chs=320x130&chco=307 2F3,ff0000,ffff00,808040,ff00ff&chxr=0,0,1e%2B02&chxt=y&chd=t:10| 50|60|20|70&chdl=Agreed|Proposed|Not%20Applicable|Unconfirme d|Stake_Assess
Deploy and Share Template
Configure and Generate Report
Polling Question 3
• Besides the web client do you think that a
tablet client
(RPE app)
for RPE will be also of
interest?
– A) Yes
– B) No
Publish document
Introduction section
Title page
Approvals
Change history
Document Content
References:
1. Reporting Arena Web Publisher – Product Home Page
2. Generating compliance documentation using IBM Rational Publishing Engine - Dr.
Einar W. Karlsen ([email protected]), Solution Architect, North-East Europe, IBM
3. Change Management REST API - RTC REST interface
4. Open Services for Lifecycle Collaboration - Quality Management Specification
Version 2.0
5. RPE Help - Online Manual
