Modal task URIs

In Lawson Smart Office (LSO) version 10.0.0 two generic URI parameters were added to support modal tasks. The requirement was to be able to launch any LSO URI in a modal window.

A modal window is a child window that requires users to interact with it before they can return to operating the parent application (http://en.wikipedia.org/wiki/Modal_window). There are many scenarios where this could be useful (if a modal behavior is desired) such as Mashups, personalized links, navigator links, canvas shortcuts etc.

Parameters

The first parameter is called lso-modal. The parameter can be appended to any LSO URI and it does not require a value. When a URI with this parameter is launched the window that is displayed will be modal to the LSO Canvas. Some URIs will not actually display a window and in those cases the parameter will have no effect.

Example 1 – Launch the M3 program MMS001 in a modal window:
mforms://mms001?lso-modal

Example 2 – Launch a web page in a modal window:
http://www.google.com?lso-modal

The second parameter is called lso-allow-transparency and you only need to use it in some special cases. The default value is true and in this case the parameter can be omitted. Set the value to false to prevent transparent modal windows. This parameter will have no effect unless the lso-modal parameter is also present.

Due to a restriction in WPF it is not possible to display native (non-WPF) content in a transparent window. A common example of native content in LSO is the WebBrowser control. Modal windows in LSO are transparent by default but when a web page is displayed a non-transparent window is used instead. This is handled automatically for http/https URIs but in some cases the parameter must be added manually to prevent transparent modal windows. One example is a Mashup that contains a WebBrowser control and another example is a M3/S3 panel that includes a WebBrowser control added by a JScript personalization. In these cases the lso-allow-transparency parameter should be used with the value false.

Example 3 – Launch a Mashup in a non-transparent modal window:
mashup:///?BaseUri=Mashups\MyMashup.mashup&RelativeUri=Main.xaml&lso-modal&lso-allow-transparency=false

Example 4 – Launch the M3 program CRS610 in a non-transparent modal window:
mforms://crs610?lso-modal&lso-allow-transparency=false

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Connecting to %s