Previous Topic: Attribute Filter SyntaxNext Topic: Characters in URLs


Launch a Browser

The <launch-browser> element lets you launch a specified URL in a browser and pass parameters to the URL. These parameters can be hard-coded values or values from model attributes.

Note: For more information about parameters, see the definition of <param-type> in the file SOI_HOME\SamUI\webapps\sam\WEB-INF\common\schema\basic-config.xsd.

Example: <launch-browser> Code

This example launches the default browser on the client computer. The <url> element specifies the URL pattern. You can specify parameters to substitute in the URL pattern by enclosing the parameter number (starting at 0) in curly braces {}. You then specify <param> elements for each parameter.

<launch-browser>
   <url>http://{0}</url>
   <param>
      <attribute>AttributeID.NETWORK_ADDRESS</attribute>
   </param>
</launch-browser>

CA SOI processes the <param> elements in order so that the first one corresponds to the 0th parameter in the URL pattern. A <param> element has a specific syntax. The most common element is <attribute>, which substitutes the value of the specified attribute for the selected context. In this example, the value of the Network Address attribute is substituted in the URL pattern.

Important! See Characters in URLs for information about the characters to use and not to use in URLs.