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;