webject
The webject tag identifies the webject you want to execute.
On JSP pages, you can name any defined webject in the webject tag.
You can nest this tag in unit, init, success, failure, and parallel tag blocks.
For webjects that require parameters, you specify the parameters by nesting the param tag in this tag block.
|
|
In standalone tasks, display webjects are not allowed.
Display webjects are not allowed to be embedded within parallel tag blocks.
|
Syntax
When there are parameters, you can use the following syntax:
<ie:webject name="Webject-Name"
type="TYPE_CONSTANT"
resumable="[true|false]"
use="webject_class_path">
.
. (Nest webject parameters using param tags)
.
</ie:webject>
When there are no parameters, you can use the following syntax:
<ie:webject name="Webject-Name"
type="TYPE_CONSTANT"
resumable="[true|false]"
use="webject_class_path"/>
Attribute Descriptions
Required attributes: name and type
name
Specifies an Info*Engine webject name. This attribute is required.
resumable
Indicates whether the VDB state must be saved before running the webject named in this webject tag. This attribute is only used when guaranteed task execution has been enabled and the webject is an action webject (TYPE=ACT) that resides in a task.
If you omit the attribute (or set it to false) and guaranteed task execution is enabled, then Info*Engine saves the state of the VDB before running the action webject. When this is done, the VDB can be restored in the case where the webject must be rerun.
If you set the attribute to true and guaranteed task execution is enabled, then Info*Engine does not save the state of the VDB before running the webject in a task. Set resumable to true when the webject can be run without causing side effects that would prevent the webject from producing the same results if it were run again.
type
Indicates the type of webject you want to use. The type determines which package is searched for the webject class file. Info*Engine type constants are defined for the following types of webjects:
|
Type Constant
|
Webject Type
|
|
DSP
|
Display
|
|
IMG
|
Image
|
|
ACT
|
Action
|
|
OBJ
|
Query
|
|
GRP
|
Group
|
|
EXT
|
External
|
|
MGT
|
Management
|
|
MSG
|
Messaging
|
|
WES
|
Web Event Service
|
This attribute is required.
|
|
Display webjects (type=DSP) cannot be used in Info*Engine tasks.
|
The Messaging (type=MSG) and Web Event Service (type=WES) webjects were developed for use in Info*Engine tasks. These types of webjects should not be used directly within a JSP page, although no exception is thrown. The webjects should be called from a JSP page using the task tag with a processor attribute.
use
Specifies the path to the class containing the external webject when the webject named is not a class within.
This attribute is required when the type attribute is set to EXT.
Example
The following example declares that the page or task uses tags from the Info*Engine core tag library and that the tags have the ie prefix. The example webject tag names the Copy-Group webject, which is a group webject that has two parameters:
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie" %>
<ie:webject name="Copy-Group" type="GRP">
<ie:param name="GROUP_IN" data="grp1"/>
<ie:param name="GROUP_OUT" data="grp2"/>
</ie:webject>
