8.3 Calling XMA-Components via Browser Links

An XMA component can be started by activating a HTTP link to it in a browser. The link is composed of the component URL as described above extended with the extension .xma and optional parameters. The parameters are coded the same way as URL-coded form parameters in HTTP.

<component-url>.xma[?<name>=<value>[&<name>=<value>]*]

Example:

http://localhost:7001/krimicee/KrimiShell.xma?idClient=34235

All URLs ending with .xma are mapped to a special servlet (XmaLauncherServlet, this is delivered with the XMA-Bootruntime which has to be registered by the XMA application). The response of this servlet has the MIME-Type application/x-xmalauncher, which should cause the browser to pass it to the XMA-Boot-Runtime's executable at the client-side (if the XMA-Boot-Runtime installation registered the MIME-Type correctly this is done automatically for Internet Explorer). The parameters in the URL are passed to the started XMA-Component.

An XMA application started by a browser link is not able to return any values. It is also not possible that the caller waits (blocks) until the XMA application is finished if started by a browser link.

As stated above the MIME-Type application/x-xmalauncher should be passed to the XMA-Boot-Runtime's executable (xma.exe, xma.sh). For the Internet Explorer (under Windows) this is done by the XMA-Boot-Runtime's installation by the setting of registry keys.

For Firefox (Windows/Linux) at the first start of an XMA application the browser will ask the user if the response should be downloaded or be opened with a specific program. One has to select as program the XMA-Boot-Runtime's executable (xma.exe, xma.sh). Firefox will remember this decision if so specified, unfortunately this has to be repeated for each user.

See the following links for Firefox details:

http://wiki.osuosl.org/display/howto/Firefox

http://kb.mozillazine.org/MimeTypes.rdf

To support non ASCII characters (from languages like Croatian, Hungarian, Czech) in URL parameters for XMA components the Windows system country settings have to be set to the language which is used by the server application.

Via: Start – Settings – Country Settings – Area Scheme