ActiveBPEL® Designer User’s Guide

Adding Comments to a Process

ActiveBPEL offers two ways to add annotations to a process: Comments and Documentation. Comments are useful for design-time annotations because you can add tasks and to-do’s to them. They appear as HTML-formatted comments in the BPEL source code. You can also add a <documentation> element to a BPEL process, activity, and links. For details, see Adding Documentation to a Process.

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

  1. Select an item from the Outline view or the Process Editor canvas. For example:
  2. In the Properties view, at the end of the Comment row, click the Dialog Button.
  3. Type in a comment in the Comment dialog and click OK.
  4. Tip: You can add a Task tag to the beginning of the comment and the comment appears in Tasks view. For details, see Tasks and Problems Preferences.

The comments for activities and links appear when your mouse hovers over them on the Process Editor canvas, as shown.

Hover help showing a comment for an activity

Comments appear as formatted tags in the Source view of your process.

Note: If you want to add a comment about a namespace, add the comment to the process itself.