You can use the Rational Team Concert Eclipse client to
create a new workflow that a master lifecycle is modeled on, or modify
an existing workflow.
Before you begin
Note: Creating new workflows, or modifying existing workflows
is only available when using Enterprise server licenses. A Standard
server license does not support custom workflows; only the predefined
workflows can be used. This task requires web server administrator
credentials.
You can use IBM Rational Team Concert to create
a new workflow or modify an existing workflow that you can use to
configure new lifecycles in IBM Rational Asset Manager.
With
the Rational Team Concert version 2.0 Eclipse client, you can create
a new work item and a new workflow, bind them, and save your changes
to create a new workflow that is available on Rational Asset Manager.
You can download the Rational Team Concert Eclipse client from jazz.net.
Prerequisites:
- Rational Team Concert Eclipse client version 2.0 or later must
be installed. You can download the client from jazz.net.
- You must know the server URL. Use the same URL as the one that
is specified in Rational Asset Manager on the Configuration page
for the Rational Team Concert server: .
You must use the same server URL for the Rational Team Concert connection
that is set for the instance of the Rational Team Concert server that
was supplied with Rational Asset Manager. Use the same web server
admin credentials to log in to Rational Team Concert when you create
the new workflow.
- You must know the user name and password for the web server admin
permissions.
Procedure
To create a workflow:
- From the Rational Team Concert client, connect to the Rational
Team Concert server that was supplied with Rational Asset Manager.
You must use the same server URL for the Rational Team Concert connection
that is set for the Rational Team Concert server that was supplied
with Rational Asset Manager. To find the URL, click . You must use the same web server admin
credentials to log in to this new connection. You must connect to
the RAM Lifecycle project area the first time
in your Rational Team Concert client. Afterwards, if you are connected,
you will see the RAM Lifecycle project area.
- Click the tab.
- Create a new Work Item Type and Category. To
modify a workflow, you select an existing Work Item Type and Category.
You do not add new types or categories.
- Under Configuration, select
- To create a new work item category, next to the Choose
the Type Category to edit, click Add and
enter a name for the work item category. This name (ID) must be unique. To modify a workflow, you select an existing type category.
- You must also add a work item type to a category. Under Work
Item Types, click Add. The
work item type is what will be visible as a workflow in Rational Asset
Manager.
- In the Add Type window enter
a work item type name and ID (for example, "MyWorkItemType" and "MyWorkItemTypeID"). The workflow item type name can be any name that you specify
but it will be displayed as the workflow in Rational Asset Manager
(not the workflow category name or the work item type category). The
ID must be unique.
- In the Custom Attributes section,
you must add three required attribute types:
- Click Add, select Reuse Existing
Attribute, and from the list choose Asset link.
Click OK.
- Click Add, select Reuse Existing
Attribute, and from the list choose Active
state history. Click OK.
- Click Add, select Reuse Existing
Attribute, and from the list choose Repository
id. Click OK.
- Click Save.
- Create a new Rational Team Concert workflow. To
modify a workflow, you select an existing workflow.
- In Rational Team Concert, in the Project Area, click
- To create a new workflow, under Choose the
Workflow to edit click Add, and
enter an ID. To modify a workflow, select an existing
workflow and add or modify states and transitions.
- In the Name field, enter a name
for the workflow.
- Create the state transition model.
- To create a state click States; then click Add and
name the state. Repeat this step for each state in your workflow.
- To create a transition, click Transitions;
then click Add and name the transition. Repeat
this step for each transition in your workflow.
- A Start action is required. From the list,
enter a state for the Start action by choosing
an existing state or creating a new one.
Optional: You can add icons. They are not required but using
them can help make the asset display in Rational Asset Manager more
understandable to users.
- Click Save.
- Bind the new workflow and new work item category.
- Select .
- From the lists, select the names of the work item type
category and workflow that you created or modified in the previous
steps.
- Click Save.
You are finished with creating the new or modifying the
existing workflow.
- To make the workflow available in Rational Asset Manager,
restart Rational Asset Manager or wait ten minutes for the caches
to be cleared. Rational Asset Manager includes an in-memory
cache of workflows. The cache is cleared after 10 minutes, but if
Rational Asset Manager is restarted, it detects the updated workflows
from the Rational Team Concert server. You can also click . In version 7.2, the cache is only cleared on the server
that the user is logged into. In a cluster environment, this feature
might cause a problem because it clears the cache on one server, but
will not clear the Rational Team Concert cache on other servers in
the cluster.
- To validate that the new workflow is available, log in
to Rational Asset Manager as an administrator and select Administration
and under Communities select a community. For the given community
click . In the list
of workflows, you should see the name of the workflow that you created
or modified.
After Rational Asset Manager is recycled, if the new
workflow is not visible, the workflow might not be configured correctly
and you must use the Rational Team Concert client to make the necessary
updates (for example, if you did not specify a unique ID for your
work item, then it will not appear). Log in to Rational Team Concert
and review the details of the new work item and workflow to ensure
that you specified a unique work item type name, the required attributes,
a workflow Start action, and a correct state transition model. Make
changes as needed, save them, restart the Rational Asset Manager server
and verify that the workflow is available.