How to display DEPICTIONS for Process Symbol on Explorer Diagram in Rational System Architect

Technote (troubleshooting)


Problem(Abstract)

Attempts to display a "Process" symbol defined with a depiction using the "Display Selected/As..." menus or depictions style button fail on an Explorer Diagram in IBM Rational System Architect (SA).

Symptom

The "Display Selected/as..." menus and depiction style buttons have no effect on the process symbol.


Cause

Originally this issue was identified as a product defect and reported in APAR PM87997 "Using "Display ..." menus or depictions button fail to change a Process on the Explorer Diagram in Rational System Architect " but subsequently, it was decided that SA is working as designed.

The Process symbol was designed to be used on BPMN Business Process diagrams. Its presentation is strictly controlled and this is why no full depiction is allowed by default.

A means of obtaining this has recently been added to SA 11.4.2.4 for the issue reported in APAR PM84235 "Unable to use "Display according to task type" in BPMN using SA v11.4.2" by the introduction of a new session option BPMN_AllowFullDepictionForProcess.


Environment

You may have defined your own depiction for the process symbol or not.

If you have defined your own depiction for the process symbol an example USRPROPS.txt is:

Symbol "Process" in "Business Process"
{
DEPICTIONS {DIAGRAM RETAIN STYLE IMAGES\ASSET.wmf}
DEPICTIONS {MENU IMAGES\ASSET.bmp}
}

Resolving the problem

In SA version 11.4.2.3 or earlier:

The "Task Type" Property of a Process definition is used to obtain a depiction when the BPMN Process definition is 'drag and dropped' onto an Explorer diagram.

If you set a "Task Type", the symbol on the Explorer diagram can be refreshed by either Option A or B as follows:

  1. Recreate the symbol on the Explorer diagram as follows:

    1. Deleting the symbol from the Explorer diagram.

    2. 'Drag and drop' the definition for the symbol onto the Explorer Diagram.



  2. Use the "Refresh Collection" context menu command as follows:

    1. Selecting the embedding Collection symbol.

    2. Right click.

    3. Select "Refresh Collection".


In addition, on the Business Process diagram, if you set a "Task type" for a Process definition, you can right click on the Process symbol and display it with it's adornment.


Since SA version 11.4.2.4:

There is a BPMN_AllowFullDepictionForProcess entry in the SA Session Options editor. Using this comes at the cost of it no longer being possible to obtain a depiction-less Process symbol on the Business Process Diagram.

SYNTAX: BPMN_AllowFullDepictionForProcess=?


WHERE: ? is N (default) or Y.


N designates that when 'Display As Task Type' is selected for a Process symbol on a Business Process diagram, no depiction is presented.


Y designates that when 'Display As Task Type' is selected, a full depiction is presented for a Process symbol on a Business Process diagram if the value of the Task Type has an associated depiction.

To use the BPMN_AllowFullDepictionForProcess session option:

  1. Start the SA Sessions Option Editor using the 'Tools | Session Options' menu command.

  2. Set BPMN_AllowFullDepictionForProcess to Y.

  3. Restart System Architect..

  4. Set 'Display as Task Type' for a Process Symbol,

  5. Notice a full depiction is presented for a process symbol on a Business Process diagram if the value of the Task Type has an associated depiction.


On the Business Process diagram newly drawn symbols will be drawn with a depiction by default..

On the explorer Diagram a newly drawn Business Process symbol will display by default with a depiction based on the task type. On this diagram the symbol depiction can be removed by using the "Display Selected Symbol Conventionally" context menu option.

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational System Architect
General Information

Software version:

11.4, 11.4.0.1, 11.4.0.2, 11.4.0.3, 11.4.1, 11.4.1.1, 11.4.1.2, 11.4.2, 11.4.2.1, 11.4.2.2, 11.4.2.3, 11.4.2.4

Operating system(s):

Windows

Reference #:

1637490

Modified date:

2013-06-17

Translate my page

Machine Translation

Content navigation