WebRemedyBackChannelPost Function

Action

This function converts an XML representation of data, which is given by the parameter sData, to the format expected by Remedy Web servers on the BackChannel URL by means of the function RemedyBackChannelData. It then posts this converted data to the server by means of the function WebPagePost.

Note: This function is only available with Remedy projects.

Include file

Remedy.bdh

Syntax

WebRemedyBackChannelPost( in sUrl        : string;
                          in sData       : string;
                          in nDataLength : number optional;
                          in sContent    : string optional;
                          in sTimer      : string optional;
                          in formUrl     : form optional ): boolean;

Return value

true if successful
false otherwise

Parameter	Description
sUrl	Absolute URL to the document on the server. All characters that are part of the query string are not URL-encoded.
sData	XML representation of Data to post to the server. The actual data which is posted is obtained by a call of the function WebRemedyBackChannelData.
nDataLength	Optional: This parameter is ignored. The purpose of this parameter is to make the parameter list of this function identical to the parameter list of the function WebPagePost.
sContent	Optional: Content type string used in the request, for example, "text/plain; charset=UTF-8".
sTimer	Optional: Name of the timer used for page measurements. If this parameter is omitted, no measurements are performed.
formUrl	Optional: Form identifier used in the `dclform` section. The expanded form is added to the URL after the "?".

Example

dcltrans
transaction TWeb
begin
  WebRemedyBackChannelPost("http://lab50/arsys/BackChannel", "<?xml version='1.0'?>\r\n"
    "<SegueRemedyXml operation=\"GetURLForForm\">\r\n"
    "  <string name=\"server\">lab50</string>\r\n"
    "  <string name=\"app_name\"></string>\r\n"
    "  <string name=\"form\">Sample:Cities</string>\r\n"
    "  <string name=\"view\"></string>\r\n"
    "  <bool name=\"fetch_dimensions\">0</bool>\r\n"
    "  <string name=\"win_name\">lab50Sample:CitiesARRoot" + GetTimeStamp() + "</string>\r\n"
    "  <string name=\"win_arg\">window.openingArgs={fvlist:{},wMode:&quot;2&quot;,wForceClear:1,fvSetDefaults:0};</string>\r\n"
    "</SegueRemedyXml>", STRING_COMPLETE, "text/plain; charset=UTF-8", "BackChannel - GetURLForForm");
end TWeb;