This chapter describes the possibilities Stardust offers for diagram retrieval.
Stardust allows you to retrieve
via a simple servlet-based interface. You may easily generate image files with contents like the following:
If not configured differently in your web.xml deployment descriptors,
the servlet for diagram retrieval can be accessed with:
http://<server>:<port>/<context-root>/eclipse/servlet/DiagramServlet
e.g.:
http://localhost:8080/carnot/diagrams/eclipse/servlet/DiagramServlet
There are several parameters which can be provided with the query string of this URL. Distinguish between mandatory and optional parameters.
| Mandatory Parameters | Description | Optional Parameters (additionally) |
|---|---|---|
| activityInstanceOid | The activityInstanceOid is used internally to retrieve the processInstanceOid. (It is then not necessary to provide an optional activityId for the processInstanceOid, because it will be deduced by the given activityInstanceOid.) |
|
| processInstanceOid | The diagram shows completed, active and pending activities of this process instance in different colors. The information about the process instance state are retrieved from the corresponding audit trail database. |
|
| processId | The selected diagram is displayed without any particular coloring. This option is intended to be used for reports on the process model. |
|
Whereby the optional parameters have the following effects:
activityId=...diagramId=...partitionId=...realmId =...encoding=... image/png or image/jpeg. The default value is image/png.modelSource=...modelSource will be
ignored and the model is loaded from the audit trail. If the model specified
by modelSource is not existing, the following error message will
occur:
Path "xx/.../xx/modelname.xpdl" for modelSource does not exists.
For example the URL:
http://localhost:8080/carnot/diagrams/servlet/DiagramServlet?processInstanceOid=12&encoding=image/png
will retrieve a PNG file with the default diagram of the process
definition of process instance 12 with coloring for the state of this process
instance.