Describes attributes and elements that are present in most BPL elements.
Common Element: <annotation>
Most BPL elements can contain the <annotation> element, which allows you to associate descriptive text with a shape in a BPL diagram. This element is as follows:
<annotation>
<![CDATA[ Gets the current Account Balance for a customer.]]>
</annotation>
The text within the CDATA block appears as a commentary on the associated activity. The following example provides an <annotation> for a <call> activity:
<call name="BankManana">
<annotation>
<![CDATA[Send an asynchronous
request to Bank Manana.]]>
</annotation>
</call>
The CDATA block enables you to include line breaks and special characters such as the apostrophe (') without needed to use XML escape sequences. Note the line break between asynchronous and request in the example above, which the diagram reproduces literally as follows:
The maximum length of the <annotation> string is 32,767 characters, including the CDATA escape characters.