+

Search Tips   |   Advanced Search


Workflow control elements

Workflow elements allow you to specify workflow related parameters when creating items that use a workflow.


Workflow element

This element specifies the workflow name and stage in which a content item should be created.

The value in the name attribute must match that of an existing workflow.

If the workflow is located in a different library from the content item, you can specify the library name as well. If no library is specified, the Web Content Integrator will search the library that was specified in the <ibmwcm:library> element.

If no <ibmwcm:library> element is present, the Web Content Integrator will search the default library specified in the task configuration.


Table 1. workflow element

Element parameters: Details for this element:
Applies to item types All
Required for item types None
Allowable Values Workflow name and related workflow stage.
Required Attributes The name of an existing workflow, or the library and name of an existing library and workflow separated by a forward slash.

For example:

  • 3-Stage-Workflow

  • Library1/3-Stage-Workflow

Optional Attributes None
Required sub-elements

workflowStage

The value of this sub-element should be the name of a workflow stage that is included in the named workflow.
Optional sub-elements None

Examples:

<ibmwcm:workflow name="StdWorkflow">
    <ibmwcm:workflowStage>Live</ibmwcm:workflowStage>
</ibmwcm:workflow>


<ibmwcm:workflow name="DesignLib/StdWorkflow">
    <ibmwcm:workflowStage>Live</ibmwcm:workflowStage>
</ibmwcm:workflow>


Date elements

This element is used to specify an RFC 822 formatted date which will be used as the date of one of the date fields in the content item.


Table 2. Date elements

Element parameters: Details for this element:
Applies to item types Content
Required for item types None
Allowable Values

publishDate

Used to set the published date of an item. If this element is not present in the <item>, the value in the <pubDate> element will be used to set the publish date of the content item. This requires a publish action to have been included in a workflow stage in the specified workflow.

expirationDate

Used to set the expiry date of an item. This requires an expire action to have been included in a workflow stage in the specified workflow.

genDateOne and genDateTwo

Used to populate the general date fields of an item.

Required Attributes An RFC 822 formatted date.
Optional Attributes None
Required sub-elements None
Optional sub-elements None

Examples:

<ibmwcm:publishDate>
    Fri, 31 Oct 2008 15:32:00 EST
</ibmwcm:publishDate>


<ibmwcm:expirationDate>
    Sun, 1 Nov 2009 12:00:00 EST
</ibmwcm:expirationDate>


<ibmwcm:genDateOne>
    Wed, 1 Nov 2006 09:30:00 EST
</ibmwcm:genDateOne>


<ibmwcm:genDateTwo>
    Thu, 2 Nov 2006 09:30:00 EST
</ibmwcm:genDateTwo>


additionalViewer element

This element allows the additional viewers field to be populated via the feed. It should contain the common name of a single user or group that is to be added to the field. To specify multiple users and groups, use multiple additionalViewer elements.


Table 3. additionalViewer element

Element parameters: Details for this element:
Applies to item types Content
Required for item types None
Allowable Values

  • [all users]

  • [all authenticated portal users]

  • The common name of any valid portal user or group.

Required Attributes None
Optional Attributes None
Required sub-elements None
Optional sub-elements None

Examples:

<ibmwcm:additionalViewer>[all users]</ibmwcm:additionalViewer>

<ibmwcm:additionalViewer>Sales</ibmwcm:additionalViewer>

<ibmwcm:additionalViewer>jsmith</ibmwcm:additionalViewer>


Parent topic:

RSS Namespace Extension for Web content