Client Actions Bookmarks - Standard Bookmark Action

A Bookmark is used to store the state of a Weave map. The following map properties are stored as part of the map state : map extent, visible layers, active entity, existing redlines and selected features (from version 2.5 29). When a bookmark is created, the user gives the bookmark a name and nominates the map properties that are to be stored with the bookmark :

Once created, the bookmark is added to the set of bookmarks listed in the Bookmarks Menu, and is therefore able to be returned to via subsequent nomination from the menu:

Bookmarks are therefore a useful way of storing previous map analysis, and they are useful for making specific extents and data on the map, readily accessible.

Including the Standard Bookmark tool in a Weave client adds the Bookmarks Menu control to the client interface, thus providing the Create, Publish, Share and Manage Bookmarks menu options. The Standard Bookmark tool is declared with the XML :
<item action="weave.bookmark" />

Bookmarks are either private to the user who created them, or they may be published, which will thus make them available to all users of the subject Weave client.

When a user selects the Create Bookmark menu option, a private bookmark is created.

The Publish Bookmark menu option allows a nominated bookmark to be published.
Published bookmarks may be optionally organised using Categories and Groups; Categories and Groups effectively allow published bookmarks to be organised in to a hierarchical structure within the Bookmarks menu.

The Share Bookmark menu option is used to create a URL representing a bookmark. The created URL will open Weave and display the saved properties of the bookmark (map extent, layers, active entity, selection and redlines).This option is useful for sharing a Weave analysis outside the Weave environment. For example, via an email.
The ability to share a bookmark was introduced to Weave in version 2.5.29.

The Manage Bookmarks menu option opens a form that is used to modify the properties of existing Private, Published and Shared bookmarks.

As a minimum, bookmarks and their properties are stored within a browser’s profile settings, for a subject user. Bookmarks created and managed by logged in Weave users, however, will be stored on the Weave Server, see Persistent storage, below . 

A user interface guide to using the Create Bookmark menu option is available here : https://cohgawiki.atlassian.net/wiki/spaces/WUG/pages/3248145/Create+Bookmark

ID

weave.bookmark

Sub-tags

Examples

Grouping published bookmarks

To group published bookmarks under sub-menus you need to create one or two data definitions, depending upon how many levels you're after, that contain the list of groups that should be available. And then create a bookmark:config item to tell Weave that it should use those data definitions when handing the categories and/or groups.

Categories are the top level groupings and the groups are the second level.

The following is an example of two inline data definitions that will contain the data definition used for the bookmark samples following it. They do not have to be inline data definitions, any data definition type will work, but their use here makes it easier to follow this example.

Bookmark grouping data definitions

The following example configuration file shows an entire file containing all the parts required to setup the bookmark category and grouping configuration which will the be used by any of the bookmark tools you add to the client. Note that this example is assuming that you'll be using both categories and groups, if you're only using one you only need to define one data definition and include that in the bookmarks:config (either the categories or groups tag).

<?xml version="1.0" encoding="UTF-8"?>

<config xmlns="urn:com.cohga.server.config#1.0" 
		xmlns:bookmarks="urn:com.cohga.weave.client.bookmarks#1.0"
		xmlns:data="urn:com.cohga.server.data.database#1.0"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
		xmlns:xsd="http://www.w3.org/2001/XMLSchema">

	<bookmarks:config>
		<categories>bookmark_categories</categories>
		<groups>bookmark_groups</groups>
	</bookmarks:config>

	<data:datadefinition id="bookmark_categories">
		<inlinedataconnection>
			<parameter type="string" name="label" label="Label"/>
			<row>
				<cell>Corporate</cell>
			</row>
			<row>
				<cell>Environment</cell>
			</row>
			<row>
				<cell>Front Desk</cell>
			</row>
			<row>
				<cell>Projects</cell>
			</row>
		</inlinedataconnection>
	</data:datadefinition>

	<data:datadefinition id="bookmark_groups">
		<inlinedataconnection>
			<parameter type="string" name="label" label="Label"/>
			<row>
				<cell>Assets</cell>
			</row>
			<row>
				<cell>External</cell>
			</row>
			<row>
				<cell>Finance</cell>
			</row>
			<row>
				<cell>Internal</cell>
			</row>
			<row>
				<cell>Property</cell>
			</row>
			<row>
				<cell>Works</cell>
			</row>
		</inlinedataconnection>
	</data:datadefinition>
</config>

Bookmark action examples

These example are just snippets showing what would need to be added to a client config to include the bookmark tool in a client toolbar. The category and grouping information is provided by the configuration example above, but the tools can also be configured using the attributes defined in the table above.

<item action="weave.bookmark"/>

<item action="weave.bookmark" categories="false"/>

<item action="weave.bookmark" categories="false" groups="false"/>