Displaying Breadcrumbs (Optional)

You can configure an organization chart to display breadcrumbs. Typically, breadcrumbs display the names of people in an organization hierarchy.

The following example shows an organization chart with breadcrumbs:

Organization chart with breadcrumbs

An organization chart can have only one set of breadcrumbs. The breadcrumbs appear horizontally at the top of an organization chart, above the chart legend if the legend is set. The breadcrumbs string wraps automatically if it is wider than the organization chart. If a breadcrumb contains a space, the breadcrumb string may wrap at the space, causing the breadcrumb to appear on two lines.

Style classes control the formatting of breadcrumbs. The default style classes are PT_ORGCHART_BRDCRM and PT_ORGCHART_UNLINK_BRDCRM. You can specify your own style classes using the CrumbDescrStyle and UnlinkCrumbDescrStyle properties.

You can specify an image to separate breadcrumb entries. If an image is not specified, the breadcrumbs are separated by three spaces. Each breadcrumb entry can be configured to be linkable. This configuration is similar to linkable text on organization chart nodes.

To implement breadcrumbs in an organization chart, you:

  • Clone the breadcrumb subrecord PTORGCRMB_SBR.

  • Add the clone of PTORGCRMB_SBR to a work record.

  • Add the work record to a page such that it is available in the component buffer so that PeopleCode can be invoked from the record fields.

    One way to accomplish this is to include the record in a level 1 grid on the same page as the organization chart, and hide the grid.

  • To make a breadcrumb linkable, set the corresponding PTORGCRMBLINKABLE field to “Y”, in much the same way as you make a descriptor linkable in an organization chart node.

  • Add PeopleCode to provide application-specific processing when a linkable breadcrumb is selected.

    When a user clicks a linkable breadcrumb, any FieldEdit and FieldChange PeopleCode in the PTORGCRMBID field executes.

At runtime, your PeopleCode will add rows to the work record that holds the information for each breadcrumb (person).

Each breadcrumb in a chart is defined by a row in the record.

See Organization Chart Subrecord Definitions, CrumbDescrStyle property: OrgChart class.

Breadcrumb Methods and Properties

The following OrgChart class methods and properties control the appearance of breadcrumbs:

  • SetCrumbData

  • SetCrumbRecord

  • UnlinkCrumbDescrStyle

  • CrumbDescrStyle

  • CrumbMaxDisplayLength

  • CrumbSeparatorImage