Displaying an item's workflow details

The workflow component tag is used to display workflow details of an item. This tag can be added to presentation templates, element designs and component designs. Any date and time displayed are based on the timezone of the server delivering the content, not the timezone of the computer you are using to view the Web site.

<workflowcmpnt type=" " context=" " name=" " field=" " separator=" " format=" " ifEmpty=" " awareness=" " start=" " end=" " />
<workflowcmpnt Opens an ID Component tag.
type=" " This determines where the workflow field is being referenced from. Either "site", "sitearea", or "content".
context=" " This determines which item is being referenced.
Selected
Refers to a particular item as specified in the name attribute below.
Current
This will reference the component from the current site, site area or content file that is being browsed by the user.
AutoFill
The component being referenced will be determined by the search parameters of a menu, navigator or taxonomy component.
name=" " Enter the name and library of the item being referenced. For example, name="library/item" . If no library is specified, the library specified in the URL of the current page is used. This is not used if context=current or context=autofill.
field=" " Enter the IDField you wish to display.
  • status
  • workflow
  • currentstage
  • publishdate
  • expirydate
  • generaldateone
  • generaldatetwo
  • additionalviewers
separator=" " Only used when field="additionalviewers". Used to separate each additional viewer. For example, separator=", "
Note: Double-byte character sets

Not all double-byte character sets support extended ASCII. To use tags such as "&nbsp;" you will need to replace "&" with "&amp;".

For example:
separator="&amp;nbsp;&amp;nbsp;"
format=" "
When referencing number or date elements:
In this case, the format is used to specify the display format of dates and numbers. The following formats can be defined when displaying dates:
  • format="DATE_SHORT"
  • format="DATE_MEDIUM"
  • format="DATE_LONG"
  • format="DATE_FULL"
  • format="DATE_TIME_SHORT"
  • format="DATE_TIME_MEDIUM"
  • format="DATE_TIME_LONG"
  • format="DATE_TIME_FULL"
  • format="TIME_SHORT"
  • format="TIME_MEDIUM"
  • format="TIME_LONG"
  • format="TIME_FULL"
  • format="relative" (The relative date will be displayed as either "today", "yesterday" or the number of days ago.)
You can also set user-defined formats for both dates and numbers.
When referencing user details:
When formatting user details, the format parameter is used to define which LDAP parameter to use when displaying user details. For example:
  • format="cn" is used to display the common name.
  • format="dn" is used to display the distinguished name.
Maximum character length:
You can also specify a maximum number of characters to display by using this format:
  • format="length:number_of_characters"
For example, to display a maximum of ten characters you would specify the following parameter:
  • format="length:10"
ifEmpty=" " Enter some text to display if no result is returned by the tag. If not specified, nothing is displayed if no result is returned by the tag.
awareness=" " If awareness="true" then user names are displayed using the people awareness features. These features displays user names as hyperlinks that allow users to contact people with whom they might want to work. Wherever person links appear, users can click the link to display a menu of actions for collaborating (contacting and working) with the person named by the link. If you, as administrator, have also configured an IBM® Lotus® Sametime® server to work with WebSphere Portal, person links indicate whether a person is active, away, offline, or in a Do Not Disturb state.

People awareness will only work in content rendered using either a local or remote rendering portlet.

If not specified, then awareness="false" and people awareness is not used.

start=" "

end=" "

The start and end attributes are used to wrap the data returned by a Web content tag within other tags, such as HTML. These attributes are not mandatory.
/> Closes the tag.