BEA Logo BEA WLI Release 2.1

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

 

   WLI Doc Home   |   BPM Topics   |   Programming BPM Client Applications   |   Previous Topic   |   Next Topic   |   Contents   |   Index   |   View as PDF

DTD Formats

 

This appendix describes the WebLogic Integration DTD formats, including the following:

 


Audit DTD

The Audit DTD describes the format of the XML document that is used by the auditing facility when generating auditing statistics.

The following sections describe the Audit DTD, including:

Hierarchy Diagram

The following diagram illustrates the Audit DTD hierarchy.

Figure A-1 Audit DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Audit DTD, Audit.dtd.

<!ELEMENT wlpiresponse (instanceid, templatedefinitionid, wlpirequest)>
<!ELEMENT
wlpirequest (started, requestor, templateid, template-name,
templatedefinitionid, instanceid, actions, completed)>
<!ELEMENT
actions ((error | setvariable | activatetask | dotask | marktaskdone |
unmarktaskdone | unassigntask | settaskcomment |
settaskpriority | settaskproperties | settaskduedate |
rerouted | assigntask | instantiated | auditentry |
evaluatecondition | workflowaborted | setworkflowcomment)*)>
<!ELEMENT
completed (#PCDATA)>
<!ELEMENT
instanceid (#PCDATA)>
<!ELEMENT
requestor (#PCDATA)>
<!ELEMENT
started (#PCDATA)>
<!ELEMENT
templatedefinitionid (#PCDATA)>
<!ELEMENT
templateid (#PCDATA)>
<!ELEMENT
template-name (#PCDATA)>
<!ELEMENT
error (#PCDATA)>
<!ATTLIST error time CDATA #REQUIRED id CDATA #REQUIRED>
<!ELEMENT
setvariable (#PCDATA)>
<!ATTLIST setvariable time CDATA #REQUIRED variable NMTOKEN #REQUIRED)>
<!ELEMENT
activatetask (#PCDATA)>
<!ATTLIST activatetask time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
dotask (#PCDATA)>
<!ATTLIST dotask time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
marktaskdone (#PCDATA)>
<!ATTLIST marktaskdone time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
unmarktaskdone (#PCDATA)>
<!ATTLIST
unmarktaskdone time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
unassigntask (#PCDATA)>
<!ATTLIST unassigntask time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
settaskcomment (#PCDATA)>
<!ATTLIST settaskcomment time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
settaskpriority (#PCDATA)>
<!ATTLIST settaskpriority time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
settaskproperties (#PCDATA)>
<!ATTLIST settaskproperties time CDATA #REQUIRED taskid CDATA #REQUIRED
name CDATA>
<!ELEMENT
settaskduedate (#PCDATA)>
<!ATTLIST settaskduedate time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
rerouted (#PCDATA)>
<!ATTLIST rerouted time CDATA #REQUIRED taskid CDATA #REQUIRED name CDATA>
<!ELEMENT
assigntask

Element Descriptions

The following table describes the elements of the Audit DTD.

Table A-1 Audit DTD Element

Element

Description

Example Value

actions

Defines the actions that were performed.

Defines zero or more occurrences of the following subelements:

See Audit DTD Example.

activatetask

Defines the following attributes:

<activatetask
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

assigntask

Defines the following attributes:

<assigntask
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

auditentry

Defines the following attributes:

<auditentry
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

completed

Time at which the task execution completed.

<completed>2001-06-12
12:45:45.115
</completed>

dotask

Defines the following attributes:

<dotask
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

error

Defines the following attributes:

<error
time="2001-06-12
12:45:44.824"
id="2"/>

evaluatecondition

Defines the following attributes:

<evaluatecondition
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

instanceid

ID of the workflow instance that is the target of the response document.

<instanceid>
2
</instanceid>

instantiated

Defines the following attributes:

<instantiated
time="2001-06-12
12:45:44.824"
name="Start Test"/>

marktaskdone

Defines the following attributes:

<marktaskdone
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

requestor

ID requestor.

<requestor>
wlpisystem
</requestor>

rerouted

Defines the following attributes:

<rerouted
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

settaskcomment

Defines the following attributes:

<settaskcomment
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1">
This is a comment.
</settaskcomment>

settaskduedate

Defines the following attributes:

<settaskduedate
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1">
</settaskduedate>

settaskpriority

Defines the following attributes:

<settaskpriority
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1">
</settaskpriority>

settaskproperties

Defines the following attributes:

<settaskproperties
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1">
</settaskproperties>

setvariable

Defines the following attributes:

<setvariable
time="2001-06-12
12:45:44.824"
variable="test1">
value1
</setvariable>

setworkflowcomment

Defines the following attributes:

<setworkflowcomment
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1">
</setworkflowcomment>

started

Time at which the task execution started.

<started>
2001-06-12
12:45:44.824
</started

templatedefinitionid

ID of the workflow template definition that is the target of the response document.

<templatedefinitionid>
2
</templatedefinitionid>

templateid

ID of the workflow template that is the target of the response document.

<templateid>
2
</templateid>

template-name

Name of the workflow template.

<template-name>
Start Test
</template-name>

unassigntask

Defines the following attributes:

<unassigntask
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

unmarktaskdone

Defines the following attributes:

<unmarktaskdone
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

wlpirequest

Defines the request, including the following subelements:

See Audit DTD Example.

wlpiresponse

Root element.

Defines the following subelements:

See Audit DTD Example.

workflowaborted

Defines the following attributes:

<workflowaborted
time="2001-06-12
12:45:44.824"
taskid="2"
name="Task 1"/>

Audit DTD Example

The following example illustrates a valid application of the Audit DTD:

<wlpirequest>
<started>2001-06-12 12:45:44.824</started
<requestor>wlpisystem</requestor>
<templateid>2</templateid>
<template-name>Start Test</template-name>
<templatedefinitionid>2</templatedefinitionid>
<instanceid>8010</instanceid>
<actions>
<instantiated time="2001-06-12 12:45:44.824"
name="Start Test"/>
<setvariable time="2001-06-12 12:45:44.824"
variable="test1">value1</setvariable>
<setvariable time="2001-06-12 12:45:44.824"
variable="test2">value2</setvariable>
<activatetask time="2001-06-12 12:45:44.824" taskid="2"
name="Task 1"/>
<dotask time="2001-06-12 12:45:44.824" taskid="2"
name="Task 1"/>
<marktaskdone time="2001-06-12 12:45:44.824"
taskid="2" name="Task 1"/>
<workflowdone time="2001-06-12 12:45:45.115"
name="Start Test"/>
</actions>
<completed>2001-06-12 12:45:45.115</completed>
</wlpirequest>

 


Business Calendar DTD

The Business Calendar DTD describes the format of the XML document that is used to create business calendars. Business calendars are used to define the operating hours for an organization. For more information about configuring business calendars, see Configuring Business Calendars.

The following sections describe the Business Calendar DTD, including:

Hierarchy Diagram

The following diagram illustrates the Business Calendar DTD hierarchy.

Figure A-2 Business Calendar DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Business Calendar DTD, BusinessCalendar.dtd:

<!ELEMENT calendar (id, name, timezone, interval*)>
<!ELEMENT date (#PCDATA)>
<!ELEMENT dateinterval (fromdate, todate)>
<!ELEMENT days (#PCDATA)>
<!ELEMENT exclude (months*, days*, date*, timeinterval*, dateinterval*)>
<!ELEMENT fromdate (#PCDATA)>
<!ELEMENT fromtime (#PCDATA)>
<!ELEMENT id (#PCDATA)>
<!ELEMENT include (months*, days*, date*, timeinterval*, dateinterval*)>
<!ELEMENT interval (fromdate, todate, exclude*, include*)>
<!ELEMENT months (#PCDATA)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT timeinterval (fromtime, totime)>
<!ELEMENT timezone (#PCDATA)>
<!ELEMENT todate (#PCDATA)>
<!ELEMENT totime (#PCDATA)>

Element Descriptions

The following table describes the elements of the Business Calendar DTD.

Table A-2 Business Calendar DTD Elements

Element

Description

Example Value

calendar

Root element.

You must define the following subelements:

See Business Calendar DTD Example.

date

Date to be included or excluded.

This date must be specified using the following format: month dd, yyyy where month specifies the name of the month (such as January), dd specifies the day, and yyyy specifies the year.

<date>
December 25, 2001
</date>

dateinterval

Interval of time to be included in or excluded from the calendar.

You must define the following subelements:

<dateinterval>
<fromdate>
January 1, 2001
</fromdate>

<todate>
January 1, 2002
</todate>
</dateinterval>

days

Day to be included or excluded.

The value of this element is a text string specifying the name of the day (such as Sunday).

<days>Saturday</days>

exclude

Rule that defines an interval of time to be excluded from the main interval.

You can define the following subelements:

<exclude>
<days>
Saturday, Sunday
</days>
<date>
January 1, 2001
</date>
</exclude>

fromdate

Subelement of interval or dateinterval.

When used as subelement of interval, specifies the start date for an interval. When used as subelement of dateinterval, it is specific to the include or exclude.

This date must be specified using the following format: month dd, yyyy where month specifies the name of the month (such as January), dd specifies the day, and yyyy specifies the year.

<fromdate>
January 1, 2001
</fromdate>

fromtime

Start time from which the business calendar is in effect, or a subelement of timeinterval, in which case it specifies a range of time to include or exclude.

This time must be specified using the following format: hh:mm, where hh specifies the hour and mm specifies the minutes.

08:00

id

Unique ID.

<id>10234</id>

include

Rule that defines an interval of time to be included in the main interval.

You can define the following subelements:

<include>
<timeinterval>
08:00, 17:00
</timeinterval>
</include>

interval

Interval of time that the calendar is in effect.

You must define the following subelements:

<interval>
<fromdate>
20010101
</fromdate>
<todate>
20020101
</todate>
<exclude>
<date>
20011225
</date>
<days>
Saturday, Sunday
</days>
</exclude>
<include>
<timeinterval>
08:00. 17:00
</timeinterval>
</include>
</interval>

months

Month to be included or excluded.

The value of this element is a text string specifying the name of the month (such as January).

<months>
August
</months>

name

Calendar name.

<name>
MyCalendar
</name>

timeinterval

Interval of time to be included in or excluded from the calendar.

You must define the following subelements:

<timeinterval>
<fromtime>
17:00:00
</fromtime>
<totime>
08:00:00
</totime>
</timeinterval>

timezone

Calendar time zone. (See Note following table for valid values.)

<timezone>
EST
</timezone>

todate

Date until which the business calendar remains in effect.

This date must be specified using the following format: month dd, yyyy where month specifies the name of the month (such as January), dd specifies the day, and yyyy specifies the year.

<todate>
January 1, 2002
</todate>

totime

Time until which the business calendar is in effect.

This time must be specified using the following format: hh:mm, where hh specifies the hour and mm specifies the minutes.

<totime>17:00</totime>

Note: Valid timezone values include: Africa/Lome, GMT, UTC, Atlantic/Faeroe, Atlantic/Canary, Europe/Dublin, Europe/Lisbon, Europe/London, Africa/Luanda, Africa/Porto-Novo, Africa/Bangui, Africa/Kinshasa, Africa/Douala, Africa/Libreville, Africa/Malabo, Africa/Niamey, Africa/Lagos, Africa/Ndjamena, Africa/Tunis, Africa/Algiers, Europe/Andorra, Europe/Tirane, Europe/Vienna, Europe/Brussels, Europe/Zurich, Europe/Prague, Europe/Berlin, Europe/Copenhagen, Europe/Madrid, Europe/Gibraltar, Europe/Budapest, Europe/Rome, Europe/Vaduz, Europe/Luxembourg, Africa/Tripoli, Europe/Monaco, Europe/Malta, Africa/Windhoek, Europe/Amsterdam, Europe/Oslo, Europe/Warsaw, Europe/Stockholm, Europe/Belgrade, Europe/Paris, ECT, Africa/Bujumbura, Africa/Gaborone, Africa/Lubumbashi, Africa/Maseru, Africa/Blantyre, Africa/Maputo, Africa/Kigali, Africa/Khartoum, Africa/Mbabane, Africa/Lusaka, Africa/Harare, CAT, Africa/Johannesburg, Europe/Sofia, Europe/Minsk, Asia/Nicosia, Europe/Tallinn, Africa/Cairo, ART, Europe/Helsinki, Europe/Athens, Asia/Jerusalem, Asia/Amman, Asia/Beirut, Europe/Vilnius, Europe/Riga, Europe/Chisinau, Europe/Bucharest, Europe/Kaliningrad, Asia/Damascus, Europe/Kiev, Europe/Istanbul, EET, Asia/Bahrain, Africa/Djibouti, Africa/Asmera, Africa/Addis_Ababa, EAT, Africa/Nairobi, Indian/Comoro, Asia/Kuwait, Indian/Antananarivo, Asia/Qatar, Africa/Mogadishu, Africa/Dar_es_Salaam, Africa/Kampala, Asia/Aden, Indian/Mayotte, Asia/Riyadh, Asia/Baghdad, Europe/Simferopol, Europe/Moscow, Asia/Tehran, MET, Asia/Dubai, Indian/Mauritius, Asia/Muscat, Indian/Reunion, Indian/Mahe, Asia/Yerevan, NET, Asia/Baku, Asia/Aqtau, Europe/Samara, Asia/Kabul, Indian/Kerguelen, Asia/Tbilisi, Indian/Chagos, Indian/Maldives, Asia/Dushanbe, Asia/Ashkhabad, Asia/Tashkent, Asia/Karachi, PLT, Asia/Bishkek, Asia/Aqtobe, Asia/Yekaterinburg, Asia/Calcutta, IST, Asia/Katmandu, Antarctica/Mawson, Asia/Thimbu, Asia/Colombo, Asia/Dacca, BST, Asia/Alma-Ata, Asia/Novosibirsk, Indian/Cocos, Asia/Rangoon, Indian/Christmas, Asia/Jakarta, Asia/Phnom_Penh, Asia/Vientiane, Asia/Saigon, VST, Asia/Bangkok, Asia/Krasnoyarsk, Antarctica/Casey, Australia/Perth, Asia/Brunei, Asia/Hong_Kong, Asia/Ujung_Pandang, Asia/Ishigaki, Asia/Macao, Asia/Kuala_Lumpur, Asia/Manila, Asia/Singapore, Asia/Taipei, Asia/Shanghai, CTT, Asia/Ulan_Bator, Asia/Irkutsk, Asia/Jayapura, Asia/Pyongyang, Asia/Seoul, Pacific/Palau, Asia/Tokyo, JST, Asia/Yakutsk, Australia/Darwin, ACT, Australia/Adelaide, Antarctica/DumontDUrville, Pacific/Truk, Pacific/Guam, Pacific/Saipan, Pacific/Port_Moresby, Australia/Brisbane, Asia/Vladivostok, Australia/Sydney, AET, Australia/Lord_Howe, Pacific/Ponape, Pacific/Efate, Pacific/Guadalcanal, SST, Pacific/Noumea, Asia/Magadan, Pacific/Norfolk, Pacific/Kosrae, Pacific/Tarawa, Pacific/Majuro, Pacific/Nauru, Pacific/Funafuti, Pacific/Wake, Pacific/Wallis, Pacific/Fiji, Antarctica/McMurdo, Asia/Kamchatka, Pacific/Auckland, NST, Pacific/Chatham, Pacific/Enderbury, Pacific/Tongatapu, Asia/Anadyr, Pacific/Kiritimati

Business Calendar DTD Example

The following example illustrates a valid application of the Business Calendar DTD:

<calendar> 
<id>acme2000</id>
<name>Acme, Inc. Year 2000 Business Calendar</name>
<timezone>EST</timezone>
<interval>
<fromdate>January 3, 2000</fromdate>
<todate>December 31, 2000</todate>
<exclude>
<date>January 3, 2000</date>
<date>December 25, 2000</date>
<days>Saturday, Sunday</days>
<dateinterval>
<fromdate>
December 22, 2000 12:00:00
</fromdate>
<todate>
January 1, 2001 00:00:00
</todate>
</dateinterval>
<timeinterval>
<fromtime>17:00:00</fromtime>
<totime>08:00:00</totime>
</timeinterval>
</exclude>
</interval>
</calendar>

 


Client Call Addin Request DTD

The Client Call Addin Request DTD describes the format of the XML document that is used when calling an addin. The Client Call Addin Response DTD describes the format of the returned value. XML documents compliant with the Client Call Addin Request DTD can be passed when a template definition is being created, as part of the ActionSendXMLToClient action. For details, see Template Definition DTD.

The following sections describe the Client Call Addin Request DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Call Addin Request DTD hierarchy.

Figure A-3 Client Call Addin Request DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Call Addin Request DTD, ClientCallAddInReq.dtd:

<!ELEMENT call-addin (actionid, parm*)>
<!ATTLIST call-addin name CDATA #REQUIRED
mode (sync|async) "async">
<!ELEMENT actionid (#PCDATA)>
<!ELEMENT parm (#PCDATA)>

Element Descriptions

The following table describes the elements of the Client Call Addin Request DTD.

Client Call Addin Request DTD Example

The following example illustrates a valid application of the Client Call Addin Request DTD:

<call-addin name="com.somedomain.someproduct.WorklistAddInImpl" mode="async">
<actionid>959395846210</actionid>
<parm>itemNumber</parm>
</call-addin>

 


Client Call Addin Response DTD

The Client Call Addin Response DTD describes the format of the XML document returned when an addin is called. (The Client Call Addin Request DTD describes the format of the XML document used to call the addin.)

You can use the XPath function to extract the returned value from the response file. For example:

XPath("/call-addin/child::text()")
XPath("/call-addin/text()")

If the return value contains objects such as XML nodes, the XPath expression must be constructed according to that structure.

The following sections describe the Client Call Addin Response DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Call Addin Response DTD hierarchy.

Figure A-4 Client Call Addin Response DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Call Addin Response DTD, ClientCallAddInResp.dtd.

<!ELEMENT call-addin ANY>

Element Descriptions

The following table describes the elements of the Client Call Addin Response DTD.

 


Client Call Program Request DTD

The Client Call Program Request DTD describes the format of the XML document that is used when an external program is called. (The Client Call Program Response DTD describes the format of the returned value.) XML documents compliant with the Client Call Program Request DTD can be passed when a template definition is being created, as part of the ActionSendXMLToClient action. For details, see Template Definition DTD.

The following sections describe the Client Call Program Request DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Call Program Request DTD hierarchy.

Figure A-5 Client Call Program Request DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Call Program Request DTD, ClientCallPgmReq.dtd.

<!ELEMENT call-program (actionid, parm*, env-var*)>
<!ATTLIST call-program name CDATA #REQUIRED
mode (sync|async) "async">
<!ELEMENT actionid (#PCDATA)>
<!ELEMENT parm (#PCDATA)>
<!ELEMENT env-var (#PCDATA)>
<!ATTLIST env-var name NMTOKEN #REQUIRED>

Element Descriptions

The following table describes the elements of the Client Call Program Request DTD.

Client Call Program Request DTD Example

The following example illustrates a valid application of the Client Call Program Request DTD.

<call-program mode="async" name="notepad">
<actionid>992456131534</actionid>
<parm>C:\WLPI\readme.txt</parm>
<env-var name="TEMP">C:\TEMP</env-var>
<env-var name="TMP">C:\TEMP</env-var>
</call-program>

 


Client Call Program Response DTD

The Client Call Program Response DTD describes the format of the XML document returned when an external program is called. (The Client Call Program Request DTD describes the format of the XML document used to call the external program.)

You can use the XPath function to extract the returned value. For example:

XPath("/call-program/attribute::exit-value")
XPath("/call-program/@exit-value")

The following sections describe the Client Call Program Response DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Call Program Response DTD hierarchy.

Figure A-6 Client Call Program Response DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Call Program Response DTD, ClientCallProgramResp.dtd.

<!ELEMENT call-program EMPTY>
<!ATTLIST call-program exit-value NUMBER #REQUIRED>

Element Descriptions

The following table describes the elements of the Client Call Program Response DTD.

Client Call Program Response DTD Example

The following example illustrates a valid application of the Client Call Program Response DTD:

<call-program exit-value=0>
</call-program>

 


Client Message Box Request DTD

The Client Message Box Request DTD describes the format of the XML document that is used to prompt: (a) a user to respond to a message via a dialog box; and (b) retrieve the response. (The Client Message Box Response DTD describes the format of the returned value.) XML documents compliant with the Client Message Box Request DTD can be passed when a template definition is being created, as part of the ActionSendXMLToClient action. For details, see Template Definition DTD.

The following sections describe the Client Message Box Request DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Message Box Request DTD hierarchy.

Figure A-7 Client Message Box Request DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Message Box Request DTD, ClientMsgBoxReq.dtd.

<!ELEMENT message-box (#PCDATA, actionid)>
<!ATTLIST message-box title CDATA #IMPLIED
style (plain|information|question|warning|
error) "plain"
options (ok|ok_cancel|yes_no|
yes_no_cancel) "ok">
<!ELEMENT actionid (#PCDATA)>

Element Descriptions

The following table describes the elements of the Client Message Box Request DTD.

Client Message Box Request DTD Example

The following example illustrates a valid application of the Client Message Box Request DTD.

<message-box options="yes_no" style="question" 
title="Credit Check">Does customer 6831 pass credit check?|
<actionid>990705990915</actionid>
</message-box>

 


Client Message Box Response DTD

The Client Message Box Response DTD describes the format of the XML document returned when a user is prompted for more information via a message dialog box. (The Client Message Box Request DTD describes the format of the XML document used to prompt the user.)

You can use the XPath function to extract the returned value. For example:

XPath("/message-box/attribute::option")
XPath("/message-box/@option")

The following sections describe the Client Message Box Response DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Message Box Response DTD hierarchy.

Figure A-8 Client Message Box Response DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Message Box Response DTD, ClientMsgBoxResp.dtd.

<!ELEMENT message-box EMPTY>
<!ATTLIST message-box option (ok|yes|no|cancel) #REQUIRED>

Element Description

The following table describes the Client Message Box Response DTD element.

Client Message Box Response DTD Example

The following example illustrates a valid application of the Client Message Box Response DTD:

<message-box option=yes>
</message-box>

 


Client Request DTD

The Client Request DTD describes the format of the XML document that is returned by a subset of the runtime management methods described in Part IV, Run-Time Management.

The returned XML file contains details about all workflow and task updates that occurred as a consequence of the runtime method call. It may also contain requests for the client to handle. Such requests are generated as part of the ActionSendXMLToClient action, as described in Template Definition DTD.

The following sections describe the Client Request DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Request DTD hierarchy.

Figure A-9 Client Request DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Request DTD, ClientReq.dtd.

<!ENTITY callpgm   SYSTEM "ClientCallPgmReq.dtd">
<!ENTITY calladdin SYSTEM "ClientCallAddInReq.dtd">
<!ENTITY msgbox SYSTEM "ClientMsgBoxReq.dtd">
<!ENTITY setvars SYSTEM "ClientSetVarsReq.dtd">

<!ELEMENT
wlpiresponse (instanceid, templatedefinitionid,
(call-program | call-addin | set-variables | message-box |
custom)*)>
<!ELEMENT instanceid (#PCDATA)>
<!ELEMENT templatedefinitionid (#PCDATA)>
&callpgm;
&calladdin;
&msgbox;
&setvars;
<!ELEMENT custom ANY>

Element Descriptions

The following table describes the elements of the Client Request DTD.

Entity Descriptions

The following table describes the Client Request DTD entities.

 


Client Set Variables Request DTD

The Client Set Variables Request DTD describes the format of the XML document that is used to: (a) prompt a user to set variables via a dialog box; and (b) retrieve the response. (The Client Set Variables Response DTD describes the format of the returned value.) XML documents compliant with the Client Set Variables Request DTD can be passed when a template definition is created, as part of the ActionSendXMLToClient action. For details, see Template Definition DTD.

The following sections describe the Client Set Variables Request DTD, including:

Hierarchy Diagram

The following diagram illustrates the Client Set Variables Request DTD hierarchy.

Figure A-10 Client Set Variables Request DTD Hierarchy Diagram


 

DTD Format

The following listing shows the format of the Client Set Variables Request DTD, ClientSetVarsReq.dtd.

<!ELEMENT set-variables (actionid, variable+)>
<!ATTLIST set-variables title CDATA #IMPLIED>
<!ELEMENT actionid (#PCDATA)>
<!ELEMENT variable (#PCDATA)>
<!ATTLIST variable name NMTOKEN #REQUIRED
prompt NMTOKEN #IMPLIED>

Element Descriptions

The following table describes the elements of the Client Set Variables Request DTD.

Client Set Variables Request DTD Example

The following example illustrates a valid application of the Client Set Variables Request DTD.

<set-variables title="Error Warning">
<actionid>991408825931</actionid>
<variable name="ShipToState" prompt="An error has occurred in
processing this order. Please enter the valid US state
abbreviation for shipping:"></variable>
</set-variables>

 


Client Set Variables Response DTD

The Client Set Variables Response DTD describes the format of the XML document returned when prompting a user for more information via a set-variables dialog box. (The Client Set Variables Request DTD describes the format of the XML document used when prompting the user.)

You can use the XPath function to extract the returned value. For example:

XPath("/set-variables/child::variable[attribute::name=
"<var-name>"]/child::text()")
XPath("/set-variables/variable[@name="<var-name>"]/text()")

The following sections describe the Client Set Variables Response DTD, including: