Set Web Viewer

Reference > Script steps reference > Miscellaneous script steps > Set Web Viewer

Set Web Viewer

Purpose

Controls the specified web viewer.

See also

Working with web viewers on layouts

Automating tasks with scripts

Format

Set Web Viewer [Object Name: "<object name>"; Action: <action>]

Options

•Object Name is the name of the web viewer to act upon. See Naming objects.

•Action lets you choose one of the following:

•Reset resets the named web viewer to its originally specified web address. This action also clears this web viewer’s Back and Forward history.

•Reload reloads the webpage that the web viewer is displaying.

•Go Forward goes forward one page, the same way a web browser does.

•Go Back goes back one page, the same way a web browser does.

•Go to URL lets you specify a new web address to load in the web viewer. The new web address is a calculation that you specify in the "Set Web Viewer - Go to URL" Options dialog box. In this script step, you cannot change whether the web viewer allows interaction, shows a progress bar or status messages, displays content in Find mode, or automatically encodes a URL. You can set these options only when you add or change a web viewer in Layout mode.

Compatibility

Where the script step runs	Supported
FileMaker Pro	Yes
FileMaker Server	No
FileMaker Go	Yes
Custom Web Publishing	No
FileMaker WebDirect	Partial
Runtime solution	Yes

Originated in

FileMaker Pro 8.5

Description

This script step works only for named web viewer objects.

To specify the object name, either type the name in the Object Name box or click Specify and create a calculation.

If you choose the action Go to URL:

•You specify a web address in much the same way you do when you create a web viewer on a layout. For more information, see Working with web viewers on layouts.

•You can send html data to a web viewer by including the data in a URL, using the following format:

data:[<mediatype>][;base64],<data>

Where the following syntax applies:

dataurl = "data:" [ mediatype ] [ ";base64" ] "," data

mediatype = [ type "/" subtype ] *( ";" parameter )

data = *urlchar

parameter = attribute "=" value

More information about the "data URL scheme" can be found on the web.

Notes

•FileMaker Pro supports only UTF-16 character encoding. Character data encoded using other methods will not display the target of the URL.

•FileMaker WebDirect does not support the GoForward and GoBack options.

Example 1

Resets the web viewer named Product Website to its originally specified web address.

Set Web Viewer [Object Name: "Product Website"; Action: Reset]

Example 2

Displays the FileMaker, Inc. homepage in the Product Website web viewer:

Set Web Viewer [Object Name: "Product Website"; URL: "http://www.filemaker.com"]

Example 3

Displays the URL entered in the Website field in the Product Website web viewer:

Set Web Viewer [Object Name: "Product Website"; URL: Products::Website]

Example 4

Uses the data URL scheme to display a small icon in a web viewer named WV2.

Set Web Viewer [Object Name: "WV2"; URL: "data:image/gif;base64,R0lGODlhFwAMAKEAAL+/v///AAAAUwAAACH5BAEAAAAALAAAAAAXAAwAAAI7hBGHapHcXJKPumizpigI+QliSH0XIjokWJ6oB4+qt0Zmaqpjesxz7st1YD8ZEbhJajAuDgfSYTx60wIAOw=="]