Skip to main content

Common Attributes and Elements

Describes attributes and elements that are present in most BPL elements.

Common Attributes

Most BPL elements can contain the following attributes, which are listed here for brevity.

Attribute Description Value
name Usually optional. The name of this element. A string of 0 to 255 characters.
disabled Optional. You can temporarily disable the element by setting its disabled attribute to 1 (true). To re-enable the element, either remove the disabled attribute or set it to 0 (false). A Boolean value: 1 (true) or 0 (false).
xpos Optional. Sets the x coordinate of the graphic that represents this element in BPL diagrams. Ignored by the BPL compiler. A positive integer.
ypos Optional. The y coordinate. A positive integer.
xend Optional. If the graphic that represents this element has two icons (start and end), then xend sets the x coordinate for the ending icon. Ignored by the BPL compiler. A positive integer.
yend Optional. The ending y coordinate. A positive integer.

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:

generated description: annotation

The maximum length of the <annotation> string is 32,767 characters, including the CDATA escape characters.

FeedbackOpens in a new tab