10.15.2013 System Development - Rational Solution for Audit Compliance - Reporting

®

IBM Software Group

© 2009 IBM Corporation

Reducing risk and cost with automated document generation

Jennifer Althouse – [email protected] Specialist

IBM Software Group | Rational software

IBM INTERNAL

Agenda

What are the documentation challenges?

Why Rational Publishing Engine?

Demonstration

2


What are the documentation challenges?

3


Traditional, manual processes can lead to documentation chaos

Documentation challenges

Missing information

Missing information

Format inconsistencies

Format inconsistencies

Corporate branding

errors

Corporate branding

errors

Reduced productivity

Reduced productivity

Non-compliance

with standards

Non-compliance

with standards

Out-of-date documentsOut-of-date documents

Incorrect legal /standard

text

Incorrect legal /standard

text

4


Why Rational Publishing Engine?

5


6

Document Creation Made Simple

High Quality, Compliant Documents

High Performance Document Generation

Rational Publishing

Engine

Usability

FlexibleoutputSpeed

High Quality, Compliant Documents in minutesusing Rational Publishing Engine


Rational Publishing Engine: document automation across the development lifecycle

Create documents from data across a wide range of distributed and diverse data sources

Access data from a wide range of Rational tools, including:

Asset Manager, DOORS, ClearCase/ClearQuest, Team Concert, Focal Point, Quality Manager, RequisitePro, Rhapsody, Requirements Composer, System Architect, Tau

Access data from third party tools via XML and REST interfaces

Source 1

Source 2

Source 3

…

Source n

7


Linked requirements to model elements

Requirements in DOORS

Requirements in Rhapsody


Generated document


10

Document Studio interface with 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 for ease of use

Create single templates to generate all different types of output format

Rational Publishing Engine: document creation made simpleSimple creation of reusable templates

Usability

10


11

Launcher interface to quickly and easily control document generation

Also available as a wizard embedded into some data sources

The user generating the document requires no domain knowledge

Rational Publishing Engine: document creation made simpleSimple generation of complex documents

Use out-of-the-box templates for quick ROI

Usability

11


12

Rational Publishing Engine: high quality, compliant documents

Template driven document generation ensures the output complies with any required formatting standards and contains correct branding and legal information

Support for multiple output formats (MS Word, HTML, PDF, XSL-FO…)

Flexibleoutput

12


13

Support for a huge range of document features Richly formatted text

Images

Tables

OLEs

Tables of Contents

Figures & Captions

Headers & Footers

Page size & Orientation

Hyperlinks – Internal or external

Full multi-cultural support

Conditional formatting

Etc…

Rational Publishing Engine: high quality, compliant documents

Flexibleoutput

13


14

Rational Publishing Engine - components

New in

RPE 1.2

New in

RPE 1.2


The Central Library

The Central Library is a data catalog that allows: Central definition and maintenance of assets

– For Example:

– Templates

– Style Sheets

– Snippets

– Debug, log and runtime settings

– Variables

– Variable Sets

Remote monitoring and control of document generation


16

Templates & TutorialsFurther resources for you to explore

RRC templates: <jazzserver>\server\conf\rm\reporting\initialization\templates\rrdgThere is one called AuditHistory.dta

RQM Templates : https://jazz.net/downloads/rational-quality-manager/releases/4.0.4?p=allDownloadsLook in the "Extras" section and you'll see "Sample Quality Management templates for IBM Rational Reporting for Document Generation (RRDG)"

RRC templates: <jazzserver>\server\conf\rm\reporting\initialization\templates\rrdgThere is one called AuditHistory.dta

RQM Templates : https://jazz.net/downloads/rational-quality-manager/releases/4.0.4?p=allDownloadsLook in the "Extras" section and you'll see "Sample Quality Management templates for IBM Rational Reporting for Document Generation (RRDG)"

Tutorials:

Systems Engineering: Reporting on Rhapsody Models with RPE

http://ibmfederal.us/demos/RErpe/

Generating Professional Documentation with Rational Publishing Engine (DOORS focused)

http://ibmfederal.us/demos/DErpe/

Tutorials:

Systems Engineering: Reporting on Rhapsody Models with RPE

http://ibmfederal.us/demos/RErpe/

Generating Professional Documentation with Rational Publishing Engine (DOORS focused)

http://ibmfederal.us/demos/DErpe/


17

Additional ResourcesFurther resources for you to explore

ibm.com/software/awdtools/pubengine/

Additional Product Information

Product demonstrations

Product datasheets

ibm.com/developerWorks User Forums Product tutorials Tech Notes, etc…


18

Design Partner Program for Medical Devices

Results inResults in

Small set of select clients invited to participate

Long-term relationship

Meetings on a recurring basis

Collaboration between Rational Offering, Strategy and Delivery teams and our clients regarding future solution features, capabilities and strategies

Facilitates ability to solicit and incorporate feedback

Have a large, vested interest in the success of Rational solutions in their IT environment

Are forward thinking and innovative

Want an ongoing working relationship with Rational

Have a desire to ensure their industry business problems are heard

Solutions that our clients are excited about and committed to because they have exerted considerable influence as part of the development process

Rational and clients both benefiting from working together to make industry solutions more valuable and relevant

Geared towardsClients who…

Geared towardsClients who…

What is it?What is it?

Mission: To involve clients early in the design and development process of our solutions to improve quality, deliver the right strategy and features based on the medical devices industry specific business problems, increase client satisfaction and loyalty, and secure references.

Would you be interested in either joining this one or creating a DPP for your industry?


Summary - Automate Document GenerationGenerate the right document at the right time

Increase productivity by allowing engineers to focus on engineering NOT formatting concerns

Maintain accuracy through quick one-click document generation Captures last minute changes from

data held in different source applications

Enhance documentation quality thru template reuse

Show link to IEC sections

Rational Publishing Engine

19

Compliance is determined by inspection of all documentation required by this standard including the RISK MANAGEMENT FILE, and assessment of the PROCESSES, ACTIVITIES and

TASKS required for the software safety class.

This standard does not prescribe the name, format, or explicit content of the documentation to be produced…

the decision of how to package this documentation is left to the user of the standard.


© Copyright IBM Corporation 2009. All rights reserved. The information contained in these materials is provided for informational purposes only, and is provided AS IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, these materials. Nothing contained in these materials is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in these materials to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in these materials may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. IBM, the IBM logo, Rational, the Rational logo, Rational, the Rational logo, and other IBM products and services are trademarks of the International Business Machines Corporation, in the United States, other countries or both. Other company, product, or service names may be trademarks or service marks of others.

Questions?Questions?

10.15.2013 System Development - Rational Solution for Audit Compliance - Reporting

Technology

Transcript of 10.15.2013 System Development - Rational Solution for Audit Compliance - Reporting