Process Developer

Back Next

Adding Documentation to a Process

You can add one or more documentation items to the process or to an activity. If desired for language support, add a language identifier. The source field is for application-specific reference.

Process Developer offers two ways to add annotations to a process: Comments and Documentation. You can add a <documentation> element to a BPEL process, activities, and links. For design-time, comments are useful because you can add tasks and to do items to them. For details, see Adding Comments to a Process.

You can add documentation to any element of the process, such as an activity, link, variable, or the process itself.

If you generate a process report, the documentation is very useful. For details, see Generate Process Report.

Select an item from the Outline view or the Process Editor canvas. For example:

Select Process or a partner link, variable, or copy operation from the Outline view

Select an activity or link on the
Process Editor
canvas

In the Properties view, do one of the following:

Type text directly into the Documentation tab.

In the All view, at the end of the Documentation row, click

Dialog (..)

. Complete the dialog as shown below.

To fill in the Documentation Details:

Select New
to open the Documentation Details
dialog, as the example shows.

Fill in the dialog as follows:

Documentation
. Enter the content in your chosen format, such as plain text, HTML, or XHTML.

Language
(optional). Type in the language identifier of the natural or formal language that the content is written in. Refer to the XML 1.0 specification for language identifier reference details.

Source
(optional). This attribute indicates the source of application information, in the form of a URI. (The attribute is described in the XSD schema and is generally included with the documentation element.)

Click OK
, and select New
to add additional documentation elements.

In the Documentation entries list, you can reorganize entries by selecting the Up
or Down
buttons. The first entry in the list is displayed in the Properties view of the activity, link, or partner link.

Documentation appears as formatted tags in the Source view of your process and also in a report that you can generate.

Using the Process Developer Process Editor

Download Guide

Watch

Comments

Cloud Application Integration Homepage