 | Level: Intermediate IBM Rational (john.hsia@us.ibm.com)IBM
31 May 2005 The IBM Automation Toolkit for Rational Software Modeler (ATRSM) is a plug-in that allows standalone COM-enabled programs to access and modify UML models loaded into Rational Software Modeler (RSM).
Purpose
The IBM® Automation Toolkit for Rational® Software Modeler (ATRSM) is a plug-in that allows standalone COM-enabled programs to access and modify UML models loaded into IBM® Rational® Software Modeler (RSM). With ATRSM, an external VB program, a Microsoft Word macro or a VBScript can easily access UML model semantics and UML diagrams using the same APIs used by Eclipse plug-ins.
Some possible applications of ATRSM are:
- Microsoft Excel macro creates a new UML model and populates it based on the contents of an Excel worksheet
- VB program generates a Microsoft Word document with semantics and diagrams of UML models currently open in RSM or IBM® Rational® Software Architect (RSA)
- VBScript executed from the command line provides a short report of model elements that are currently selected in the model explorer or the diagram editor
ATRSM is ideal for IBM® Rational® Rose and IBM® Rational® XDE customers with RoseScript or VB Macros to migrate. While the product APIs have changed in RSA and RSM, this would still allow access from COM-enabled environments and languages. ATRSM also registers type libraries for RSM APIs so that developers can take advantage of intellisense and browsing capabilities within the VB IDE.
Prerequisites
This plug-in only runs on Microsoft Windows and is dependent upon version 6.0.0.1 of RSA or RSM--for the latest evaluation versions of RSA or RSM, see the Resources section later in this article. To get the latest updates for RSA/RSM, use the update manager (Help>Update Manager).
Installation instructions
Download the zip file at the bottom of this article. This zip file includes:
- Documentation - Installation instructions, example instructions and usage documentation can be found in one comprehensive document - GettingStarted.doc
- Examples - Examples of using ATRSM from VB and VBScript
- ATRSM plug-in
Once you have downloaded the zip:
- Unzip ATRSM.zip to C:\ATRSM
- Open C:\ATRSM\GettingStarted.doc in Microsoft Word and follow the installation instructions in section 3.0 of GettingStarted.doc.
A license agreement will be presented during installation. Copyright© 2004-2005 IBM.
Support details
ATRSM is not a supported feature of RSA or RSM. The additional behavior provided by this plug-in is not supported by IBM or by IBM Technical Support. ATRSM simply allows customers to access current functionality already provided by the underlying RSM/RSA APIs (e.g. MSL, Notation). These APIs are typically documented in RSM/RSA and supported as part of RSM/RSA. If you experience problems using these APIs, confirm that the problem is with RSM and RSA by writing an equivalent pluglet as a control case. If the problem is with ATRSM, please report it to technical support.
Download | Description | Name | Size | Download method |
|---|
| ATRSM Plug-in | ATRSM.zip | 1.7 MB | HTTP |
|---|
Resources - Get the evaluation version of Rational Software Architect or Rational Software Modeler from the Trials and betas page.
- For technical resources about Rational's products, visit the developerWorks Rational content area. You'll find technical documentation, how-to articles, education, downloads, product information, and more. Information is centered around specific products. For example, for specific information about Rational Software Architect, visit the RSA technical resources page.
- Get involved in the developerWorks community by participating in developerWorks
blogs.
- Ask questions about Rational Software Architect/Rational Software Modeler in the
Rational Software Architect, Software Modeler, Application Developer and Web Developer forum.
About the author | | | This content is brought to you by the IBM Rational staff. |
Rate this page
| |
