Bookshelf Home | Contents | Index | PDF |
Siebel Portal Framework Guide > Delivering Content to External Web Applications > XML Request Structure > XML Command BlockTo initiate an action on a Siebel Business Applications XML screen, you must use a specific set of XML tags and they must conform to a specific structure. Table 17 lists the three valid XML tags that are used to perform a command. For example, using the information from Table 17, a valid syntax format for an XML command block is as follows: <CMD NAME= <ARG NAME= <ARG NAME= <ARG NAME= <ARG NAME="SWESetMarkup"> XML | HTML </ARG> <ARG NAME="SWEDataOnly"> TRUE | FALSE </ARG> <ARG NAME="SWESetNoTempl"> TRUE </ARG> Each A valid XML command block must conform to a specific structure. It must have a valid execute tag followed by a command tag that encloses the arguments. The syntax of the name-value pairs and the attributes that accompany the XML tags within a command block must follow a specific format. This topic describes the syntax of each XML tag. For the DTD for the inbound XML document, see Inbound DTD. EXE TagThe Execute tag is the root tag for each command that you want to execute. DescriptionThink of the Execute tag as a container. Each container represents a single SWE command or screen action. Enclosed within an Execute tag are the commands, arguments, and information required to complete a single command. Use only one AttributesTable 18 lists the attribute used with the Execute tag: ExampleThe following example uses the Execute tag to enclose the login command. <?xml version="1.0" encoding="UTF-8"?> <EXEC PATH="/callcenter/start.swe"> <CMD NAME="SWECmd" VALUE="ExecuteLogin"> <ARG NAME="SWEUserName">jdoe</ARG> <ARG NAME="SWEPassword">jdoepassword</ARG> <ARG NAME="SWESetMarkup">XML</ARG> <ARG NAME="SWEDataOnly">TRUE</ARG> <ARG NAME="SWESetNoTempl">TRUE</ARG> CMD TagThe Command tag is required for each command block and is used to indicate the SWE command that you want to execute. DescriptionLike the Execute tag, the Command tag also acts as a container. Enclosed between the open and close Command tags are the arguments required to complete a command. Use only one AttributesTable 19 lists the attributes that are used with the Command tag: ExampleUsing the information from the table above, the following example illustrates how to use the Command tag to execute a login command: <?xml version="1.0" encoding="UTF-8"?> <CMD NAME="SWECmd" VALUE="ExecuteLogin"> <ARG NAME="SWEUserName">jdoe</ARG> <ARG NAME="SWEPassword">jdoepassword</ARG> <ARG NAME="SWESetMarkup">XML</ARG> <ARG NAME="SWEDataOnly">TRUE</ARG> <ARG NAME="SWESetNoTempl">TRUE</ARG> ARG TagA command block can contain multiple Argument tags. Each Argument tag indicates an additional command parameter required to complete the action specified in the command block. DescriptionThe Argument tag uses name-value pairs to send command parameters to the SWE. A command does not execute without having all the appropriate parameters passed to the SWE. AttributesTable 20 lists the attributes that are used with the Argument tag.
ExampleFor each argument name that you include in a command block, you must also indicate a value for the argument. For example, to use the InvokeMethod command, you must indicate which method you want to invoke. Additionally, if the method is one that requires parameters, as is the case with the WriteRecord, then you must send those parameters to the SWE. With the WriteRecord method, you must indicate the view and the applet that you are working with. You also must indicate the column to which you want to write the record, and you must indicate what information you want to write. The following example illustrates how to use Argument tags to send the required parameters for a WriteRecord method: <?xml version="1.0" encoding="UTF-8"?> <EXEC PATH="/callcenter/start.swe"> <CMD NAME="SWECmd" VALUE="InvokeMethod"> <ARG NAME="SWEMethod">WriteRecord</ARG> <ARG NAME="SWEView">Account List View</ARG> <ARG NAME="SWEApplet">Account List Applet</ARG> <ARG NAME="Lot Name">65 metal car</ARG> <ARG NAME="Starting Price">3.00</ARG> <ARG NAME="SWESetMarkup">XML</ARG> <ARG NAME="SWEDataOnly">TRUE</ARG> <ARG NAME="SWESetNoTempl">TRUE</ARG> Required ArgumentsThe following arguments are required for each command block sent to the SWE: <ARG NAME="SWESetMarkup">XML | HTML | WML</ARG> <ARG NAME="SWEDataOnly">TRUE | FALSE</ARG> <ARG NAME="SWESetNoTemp">TRUE</ARG> For detailed information about these arguments, see the following:
Common Name-Value PairsTable 21 lists commonly used argument name-value pairs. NOTE: When determining what arguments to define, it is a good idea to look at the XML Response. The response includes the expected arguments. |
Siebel Portal Framework Guide | Copyright © 2016, Oracle and/or its affiliates. All rights reserved. Legal Notices. | |