User Guide

The HTTP API 49
• The dataToPost argument is the data to post. If the third argument is "application/x-www-
form-urlencoded"
or omitted, dataToPost must be form-encoded according to section 8.2.1
of the RFC 1866 specification (available at www.faqs.org/rfcs/rfc1866.html).
• The contentType argument, which is optional, is the content type of the data to post. If
omitted, this argument defaults to
"application/x-www-form-urlencoded".
• The serverScriptsFolder argument is an optional string that names a particular folder—
relative to the Configuration folder on the application server—to which you want to post the
data. To post the data, Dreamweaver uses the appropriate transfer protocol (such as FTP,
WebDAV, or Remote File System).
If an error occurs, Dreamweaver reports it in the
statusCode property of the returned object.
Example
In the following example of an MMHttp.postText() function call, assume that a developer has
placed the myScripts.cfm file in a folder named DeployScripts, which is located in the
Configuration folder on the local computer:
MMHttp.postText(
"http://ultraqa8/DeployScripts/myScripts.cfm",
"arg1=Foo",
"application/x-www-form-urlencoded",
"Configuration/DeployScripts/"
)
When Dreamweaver executes this function call, the following sequence occurs:
1 The myScripts.cfm file in the Configuration/DeployScripts folder on the local computer is
copied to another folder named DeployScripts, which is a subfolder of the root folder on the
ultraqa8 website. To deploy the files, Dreamweaver uses the protocol specified in the site
configuration properties.
2 Dreamweaver uses HTTP protocol to post the arg1=Foo data to the web server.
3 As a result of the post request, the web server on ultraqa8 executes the myScripts.cfm script
using the
arg1 data.
MMHttp.postTextCallback()
Availability
Dreamweaver UltraDev 4, enhanced in Dreamweaver MX.
Description
Performs an HTTP post of the text to the specified URL and passes the reply from the server to
the specified function. Typically, the data associated with a post operation is form-encoded text,
but it could be any type of data that the server expects to receive.
Arguments
callbackFunc, URL, dataToPost, {contentType}, {serverScriptsFolder}
• The callbackFunc argument is the name of the JavaScript function to call when the HTTP
request is complete.
• The URL argument is an absolute URL on a web server; if http:// is omitted from the URL,
Dreamweaver assumes HTTP protocol.
000_DW_API_Print.book Page 49 Wednesday, August 20, 2003 9:14 AM