Developer's Guide - MapGuide Open Source - OSGeo

Additional Parameters to an Invoke URL
Command
With this release of MapGuide, the current selection is the only variable that
can be passed as part of an Invoke URL command.
To pass the current selection, edit the web layout. Define a new Invoke URL
command. On the Additional Parameters tab, enter a key and value. The key
must be a valid HTTP POST key. For the value, enter $CurrentSelection. Add
the command to the toolbar, context menu, or task bar menu.
When the command is executed, the current selection is passed to the page,
along with the standard variables like SESSION and MAPNAME.
For example, if you define the key SEL to have the value $CurrentSelection,
then when the URL is invoked
$selection = $_POST['SEL'];
gets the current selection, in XML format.
See Working With the Active Selection (page 46) for details about using the
XML data.
Passing Parameters From an Invoke Script
command
An Invoke Script command in a web layout can be used to pass custom
parameters to a page. The parameters can be any values that are available via
the Viewer API.
To pass parameters, edit the web layout. Define a new Invoke Script command.
On the Additional Parameters tab, enter the JavaScript code to retrieve the
values to be passed. Add the command to the toolbar, context menu, or task
bar menu.
The JavaScript code can call Viewer API functions or other functions to retrieve
values. To pass the parameters to a page, call the Submit method of the
formFrame with the parameters, the page URL, and the name of the target
frame.
For example, if you wrap custom HTML around the Viewer, you could define
JavaScript functions in the wrapper, then call these functions from an Invoke
44 | Chapter 3 Working With Feature Data