Changes between Initial Version and Version 1 of ApplicationDefinition/MapSet/MapGroup


Ignore:
Timestamp:
03/11/08 06:56:50 (17 years ago)
Author:
pagameba
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • ApplicationDefinition/MapSet/MapGroup

    v1 v1  
     1= !MapGroup =
     2
     3A sub-tag of the [wiki:ApplicationDefinition/MapSet MapSet] tag, a !MapGroup contains sub-tags for map rendering sources that are to be included in a visible map.  A !MapGroup must contain at least one '''Map''' tag to be valid.  For example:
     4
     5{{{
     6<MapGroup id="Parks" xsi:type="MapType">
     7  <Map xsi:type="MapGuideLayerType">
     8    <Type>MapGuide</Type>
     9    <SingleTile>true</SingleTile>
     10    <Extension>
     11      <ResourceId>Library://Samples/Sheboygan/Maps/Sheboygan.MapDefinition</ResourceId>
     12    </Extension>
     13  </Map>
     14</MapGroup>
     15}}}
     16
     17The Map tag contains the following sub-tags:
     18
     19'''Type''':
     20  The type of the map can be one of '''!MapGuide''' or '''!MapServer''' at this time.  Future versions will support all the !OpenLayers Layer types for this value.
     21
     22'''!SingleTile''':
     23  This contains a string value of either '''true''' or '''false''' to indicate if the map is composed of tiles ('''false''') or a single image ('''true''').
     24
     25'''Extension''':
     26  The Extension tag contains sub-tags that are not defined by the schema.  The content of the sub-tags depends partly on the '''Type''' of map specified.
     27
     28== General Extension ==
     29
     30The generally supported Extension tags are supported by all or most of the map types.  These are described below.
     31
     32=== Links ===
     33The Links tag allows you to specify metadata URLs to be associated with groups and layers.  The Legend widget can use this metadata to add links into the rendered legend tree to hyperlink users to additional information about groups and layers. 
     34
     35The Links tag may contain the following sub tags:
     36
     37 * Group - may occur any number of times.  This specifies a group that is to have a metadata link.  It has the following sub-tags:
     38   * Name - occurs once.  This is a string value that is the name of the group.  If a group of this name doesn't exist, the whole entry is ignored.
     39   * Url - occurs once.  This is a string value that specifies the URL of a page to display for the group.
     40 * Layer - may occur any number of times.  This specifies a layer that is to have a metadata link.  It has the following sub-tags:
     41   * Name - occurs once.  This is a string value that is the name of the layer.  If a layer of this name doesn't exist, the whole entry is ignored.
     42   * Url - occurs once.  This is a string value that specifies the URL of a page to display for the layer.
     43
     44Example:
     45
     46{{{
     47<Links>
     48  <Group>
     49    <Name>Roads</Name>
     50    <Url>http://myserver/groupinfo/roads.html</Url>
     51  </Group>
     52  <Layer>
     53    <Name>Parcels</Name>
     54    <Url>http://myserver/layerinfo/parcels.html</Url>
     55  </Layer>
     56</Links>
     57}}}
     58
     59=== !MapEvents ===
     60The !MapEvents tag allows you to specify actions to take when layers and groups are turned on or off by a user.  Valid actions are to turn on or off other layers and groups. 
     61
     62The !MapEvents tag may contain the following sub-tags:
     63
     64 * Layer - may occur any number of times.  Specifies events associated with a specific layer.
     65   * Name - the name of the layer that the events are associated with.
     66   * !OnEnable - the events to trigger when the user turns the layer on, see below.
     67   * !OnDisable - the events to trigger when the user turns the layer off, see below.
     68 * Group - may occur any number of times.  Specifies events associated with a specific group.
     69   * Name - the name of the group that the events are associated with.
     70   * !OnEnable - the events to trigger when the user turns the group on, see below.
     71   * !OnDisable - the events to trigger when the user turns the group off, see below.
     72   
     73The !OnEnable and !OnDisable tags contain the following sub-tags defining the event that are triggered:
     74
     75 * Layer - may occur any number times.  Specifies a layer that is affected as a result of an event.
     76   * Name - a string value, the name of the layer to affect.
     77   * Enable - a string value, '''true''' or '''false'''.  If '''true''', the layer is turned on, otherwise it is turned off.
     78 * Group - may occur any number times.  Specifies a group that is affected as a result of an event.
     79   * Name - a string value, the name of the group to affect.
     80   * Enable - a string value, '''true''' or '''false'''.  If '''true''', the group is turned on, otherwise it is turned off.
     81
     82Example:
     83 
     84{{{
     85<MapEvents>
     86  <Layer>
     87    <Name>Road</Name>
     88    <OnEnable>
     89      <Layer>
     90        <Name>Road Labels</Name>
     91        <Enable>true</Enable>
     92      </Layer>
     93      <Group>
     94        <Name>Road Decorations</Name>
     95        <Enable>true</Enable>
     96      </Group>
     97    </OnEnable>
     98    <OnDisable>
     99      <Layer>
     100        <Name>Road Labels</Name>
     101        <Enable>false</Enable>
     102      </Layer>
     103      <Group>
     104        <Name>Road Decorations</Name>
     105        <Enable>false</Enable>
     106      </Group>
     107    </OnDisable>
     108  </Layer>
     109  <Group>
     110    <Name>Amusements</Name>
     111    <OnEnable>
     112      <Layer>
     113        <Name>Road</Name>
     114        <Enable>true</Enable>
     115      </Layer>
     116      <Group>
     117        <Name>Parks</Name>
     118        <Enable>true</Enable>
     119      </Group>
     120    </OnEnable>
     121    <OnDisable>
     122      <Layer>
     123        <Name>Road</Name>
     124        <Enable>false</Enable>
     125      </Layer>
     126      <Group>
     127        <Name>Parks</Name>
     128        <Enable>false</Enable>
     129      </Group>
     130    </OnDisable>
     131  </Group>
     132</MapEvents>
     133}}}
     134
     135=== !MapGuide Extension ===
     136
     137If you have defined a !MapGuide map type, you must provide a {{{<ResourceId>}}} sub-tag that defines the repository path to the MapDefinition to be used to render this map.
     138
     139=== !MapServer Extension ===
     140
     141If you have defined a !MapServer map type, you must provide a {{{<MapFile>}}} sub-tag that defines the path to the MAP file to be used to render this map.