For historical reasons all top level toc models, i.e. those that are directly referenced in a client config, should start their id with toc., e.g.
<toc:model id='toc.main'>

</toc:model>
rather than
<toc:model id='main'>

</toc:model>

Note: Weave 2.6.8 removes this requirement

Nesting Update

An update to the toc model, at Weave 2.4.10, allows a toc model to be directly included within another toc model.
Previously it was only possible to include another toc model within a group in a toc model.

For example, a previous nested toc model would look like this:

<toc:model id="subtoc">
  <mapengine>default</mapengine>
  <entry id="layer1" label="Layer 1" layer="layer1"/>
</toc:model>

<toc:model id="toc.main">
  <mapengine>default</mapengine>
  <entry id="group1" label="Group 1" toc="subtoc"/>
  <entry id="layer2" label="Layer 2" layer="layer2"/>
</toc:model>

which would result in a toc like:

+Group 1
 Layer 1
Layer 2

The following is now possible:

<toc:model id="subtoc"> <!-- same as previous example -->
  <mapengine>default</mapengine>
  <entry id="layer1" label="Layer 1" layer="layer1"/>
</toc:model>

<toc:model id="toc.main">
  <mapengine>default</mapengine>
  <entry id="subtoc1" toc="subtoc"/> <!-- note no label set -->
  <entry id="layer2" label="Layer 2" layer="layer2"/>
</toc:model>

which would result in a toc like:

The original structure can now also be accomplished like this:

Virtual Layers

There can be special virtual layers added to a map engine by additional bundles that provide extra functionality (e.g. an acetate layer or selection drawing), and these layers need to be taken into consideration when creating a table of contents for a map. Virtual layers will be covered later in this document.

Lockable layers

You just need to create a duplicate of the layer with the word UNLOCKED at the start. For example, if you have a layer called property in the mxd, arcims or wms you would create another called UNLOCKEDproperty. There is no need to add the unlocked layer to the toc model. When the user right clicks the layer, Weave checks to see if this layer is available in the mapengine. If it is, the Unlock Layer menu item will be enabled.

You can add it to the toc view contextmenu with the following.

Namespace

urn:com.cohga.server.map.toc#1.0

Tags

model

Properties

Name	Type	Required	Description
id	string	yes	unique identifier for this toc model. Should start with ‘toc.' for top level toc models, unless you’re running Weave 2.6.8 or later in which case this is not required.
mapengine	ref urn:com.cohga.server.map.toc#1.0:mapengine	no	The default map engine to associate with the entries included in this toc model if they don't set their own map engine. This value is not required if the this toc model only includes other toc models, it is required if the toc model includes layers or groups that don't set their own map engine

Sub-tags

Name	Type	Cardinality
entry	urn:com.cohga.server.map.toc#1.0:entry	1..n

Content

None

entry

Properties (for a 'layer')

Name	Type	Required	Description
id	string	no	Not "required" but you should set it. It uniquely identifies an entry when saving a toc model, for example in a bookmark, which make your life a lot easier if you ever want to re-arrange or rename your map layers, if it is not specified Weave will generate one for you (which could result in there being multiple toc entries with the same id, which can cause problems). It should be set it to a unique value for every entry, it doesn't really matter what the value is, just make it unique across all toc model entries (a combination of map engine id and layer name would work if you have a lot of layers). This value should never be changed once it has been set, or any bookmarks that reference this entry will be invalidated.
layer	string	yes	The identifier for the layer within the map engine
label	string	yes	Identifier displayed to the user for the entry
mapengine	ref urn:com.cohga.server.map.toc#1.0:mapEngine	no	Override the default map engine for this layer
checked	boolean	no	Determines the entry should be turned on or off by default
visible	boolean	no	Should the entry be displayed in the TOC at all
description	string	no	A description to display when the mouse hovers over the layer in the ToC panel
entity	ref urn:com.cohga.server.entity#1.0:entity	no	The id of an entity that should be associated with this layer, by associating an entity with a layer additional functionality is available.
style	string	no	For map engines that support multiple styles for a layer this value can be used to change the default style. Note that adding the `weave.toc.styleLayer` action to the toc panel context menu allows the user to switch styles on the fly.
acl	ref urn:com.cohga.server.acl#1.0:acl	no	A reference to an ACL to attach to the layer
minScale	number	no	Specifies a minimum scale below which the entry in the toc will not be enabled. Note that this may not affect the display of the layer in the map, just the entry in the toc panel.
maxScale	number	no	Specifies a maximum scale above which the entry in the toc will not be enabled. Note that this may not affect the display of the layer in the map, just the entry in the toc panel.

Properties (for a 'toc')

Name	Type	Required	Description
toc	ref urn:com.cohga.server.map.toc#1.0:acl	yes	A toc model to include in this one
label	string	no	The label for a group to include the toc within, if not set the toc will be included directly within the parent toc model
acl	ref urn:com.cohga.server.acl#1.0:acl	no	A reference to an ACL to attach to the toc

Properties (for a 'group')

Name	Type	Required	Description
id	string	no	Not "required" but you should set it. It uniquely identifies an entry when saving a toc model, for example in a bookmark, which make your life a lot easier if you ever want to re-arrange or rename your map layers, if it is not specified Weave will generate one for you (which could result in there being multiple toc entries with the same id, which can cause problems). It should be set it to a unique value for every entry, it doesn't really matter what the value is, just make it unique across all toc model entries. This value should never be changed once it has been set, or any bookmarks that reference this entry will be invalidated.
label	string	yes	Identifier displayed to the user for the group
mapengine	ref urn:com.cohga.server.map.toc#1.0:mapEngine	no	Override the default map engine for this group
checked	boolean	no	Determines the group should be turned on or off by default
description	string	no	A description to display when the mouse hovers over the group
expandable	boolean	no	Will the user be able to expand/collapse the group in the TOC
expanded	boolean	no	Will the group start out already expanded
exclusive	boolean	no	Only one item within the group can be checked at a time
folder	boolean	no	Should the expand/collapse control be hidden for this group
entity	ref urn:com.cohga.server.entity#1.0:entity	no	The id of an entity that should be associated with this group, by associating an entity with a group additional functionality is available.
acl	ref urn:com.cohga.server.acl#1.0:acl	no	A reference to an ACL to attach to the group
minScale	number	no	Specifies a minimum scale below which the entry in the toc will not be enabled. Note that this may not affect the display of the layer in the map, just the entry in the toc panel.
maxScale	number	no	Specifies a maximum scale above which the entry in the toc will not be enabled. Note that this may not affect the display of the layer in the map, just the entry in the toc panel.

Sub-tags (for a 'group')

Name	Type	Cardinality
entry	urn:com.cohga.server.map.toc#1.0:entry	1..n

Content

None

Examples

A Simple ToC

A ToC included in another ToC

A selection ToC directly included in another ToC

A ToC with an ACL where one group of users get a 5cm aerial photo layer and everyone else 50cm.

Selection Layers

One group of virtual layers that's almost always available are those representing the users current selections. When selections are enabled in Weave each map engine (unless configured otherwise) gets additional layers added to it, one representing the selection for the active entity, one representing the selection for all entities, and one each representing the current selection for the individual entities.

Because we're looking at a table of contents at the moment I'll assume that you're interested on how to add these layers to a table of contents (as opposed to other ways of having these layers displayed).
And to do this you need to add an entry to your toc model for each of the virtual layers you wish to enable. The virtual layers themselves are given special layer ids and just need to be added like any other layer.

The simplest way to add the selection to the map is to turn on the layer that represents the selection for the active entity, and to do that you would add the following layer definition to your toc model:

Note that you can also use just "_selection" as an alternative for "_selection.active", and the values used for the labels in these entries is not important and can be set to anything you think appropriate.

The above example will add an entry to the table of contents allowing the user to turn on and off the active selection.

If you wanted to always draw the current selection and not allow the user the option of turning it off the you would use the following:

An alternative to displaying just the active selection is to display the selections for every layer (keep in mind this could be slow). And, this is done using the "_selection.all" virtual layer, for example:

This will draw the selection for the current entity in a more pronounced style and the other entities in a less pronounced style, unless changed in the map engine configuration.

The other virtual selection layers are given a layer id that relates to the entity id that they're associated with, for example to add a selection layer for a 'road' entity you would use:

And this can be applied for as many entities as you wish to appear in the table of contents.

You can use groups in the table of contents to setup a quite complex selection drawing structure, allowing the user to choose between drawing the current selection, drawing all selections or drawing selections for individual entities. This would be done as follows:

This way the user will have full control over which selections are drawn.

Weave System Administrator Guides

Table Of Contents

Virtual Layers

Lockable layers

Namespace

Tags

model

Properties

Sub-tags

Content

entry

Properties (for a 'layer')

Properties (for a 'toc')

Properties (for a 'group')

Sub-tags (for a 'group')

Content

Examples

Selection Layers