User Guide

494

The optional parameter serverOSString defaults to UNIX but may be set to Windows or Mac and

translates any carriage returns in the

postText argument into those used on the server to avoid

confusion. For most applications, this setting is unnecessary because line breaks are usually not

used in form responses.

The optional parameter

serverCharSetString applies only if the user is running on a Shift-JIS

(Japanese) system. Its possible settings are

"JIS", "EUC", "ASCII", and "AUTO". Posted data is

converted from Shift-JIS to the named character set. Returned data is handled exactly as by

getNetText() (converted from the named character set to Shift-JIS). If you use "AUTO", the

posted data from the local character set is not translated; the results sent back by the server are

translated as they are for

getNetText(). "ASCII" is the default if serverCharSetString is

omitted. "ASCII" provides no translation for posting or results.

The optional arguments may be omitted without regard to position.

This command also has an additional advantage over

getNetText(): a postNetText() query

can be arbitrarily long, whereas the

getNetText() query is limited to the length of a URL (1K or

4K, depending on the browser).

Note: If you use postNetText to post data to a domain different from the one the movie is playing from, the movie

will display a security alert when playing back in Shockwave.

To see an example of postNetText used in a completed movie, see the Forms and Post movie in

the Learning/Lingo Examples folder inside the Director application folder.

Examples

This statement omits the serverCharSetString parameter:

netID = postNetText("www.mydomain.com\database.cgi", "Bill Jones", "Win")

This example generates a form from user-entry fields for first and last name, along with a Score.

Both

serverOSString and serverCharSetString have been omitted:

lastName = member("Last Name").text

firstName = member("First Name").text

totalScore = member("Current Score").text

infoList = ["FName":firstName, "LName":lastName, "Score":totalScore]

netID = postNetText("www.mydomain.com\userbase.cgi", infoList)