= Launch Options =

When starting a Fusion application, you generally just type a URL to the template in the address bar of your browser and hit enter.  Something like:

* {{{http://my.server.com/myapp/index.html}}}

This starts up the application in its default state by loading the !MapGroup specified in the !MapWidget tag of the default !ApplicationDefinition.xml file and shows the map at its default extent.  However, you can specify some options when loading the application to override some of these defaults.

To pass new options to the Fusion application, you can add parameters to the URL as follows:

 * {{{http://my.server.com/myapp/index.html?[option]=[value]}}}

Several options can be added by separating them with an ampersand (&).

 * {{{http://my.server.com/myapp/index.html?[option]=[value]&[option2]=[value2]}}}

''Tip: you don't need to include index.html in the URL.''

 * {{{http://my.server.com/myapp/?[option]=[value]}}}

== !ApplicationDefinition ==

The !ApplicationDefinition option allows you to specify a different !ApplicationDefinition.xml file than the default.  By default, Fusion will look for a file named !ApplicationDefinition.xml in the same location as the index.html file.  You may specify a URL to an !ApplicationDefinition.xml file or, if you are using !MapGuide, you may specify a Resource Identifier for an !ApplicationDefinition resource located in your !MapGuide repository (Library or Session).

''Tip: if you are specifying a Resource Identifier to an ApplicationDefinition resource in a Session repository, you will also need to provide the Session option.

Examples:

 * {{{http://my.server.com/myapp/?ApplicationDefinition=AlternateDefinition.xml}}}
 * {{{http://my.server.com/myapp/?ApplicationDefinition=Library://MyApp/MyApp.ApplicationDefinition}}}

== Session ==

The Session option allows you to force Fusion to use a specific session identifier when communicating with the server.  This is very useful for integrating Fusion into an existing application where you have already established a user session with the server.  

''Tip: When using !MapGuide, it makes it possible for a user to authenticate with !MapGuide as part of another process and then launch a Fusion application with access to the resources granted to that user without requiring them to log in again.''

Examples:
 * {{{http://my.server.com/myapp/?Session=12345678}}}
 * {{{http://my.server.com/myapp/?ApplicationDefinition=Session:12345678//MyApp.ApplicationDefinition&Session=12345678}}}