Using Bookmarks

A bookmark is a way to define areas of your workspace for easy access. The bookmark shades an area, usually one that is carrying out a specific task, so you can easily move to it in the workspace.

You can control some aspects of the appearance and behavior of bookmarks in FME Options, under FME Workbench and Appearance.

Organize a Workspace

Bookmarks play an important part in FME for a number of reasons:

Places a marker for quick access to a certain area.
Divides a workspace into different, clearly marked sections.
Organizes a workspace so you can move sections of transformers at one time.
Makes large workspaces easier to manage by collapsing sections that are bookmarked.
In this workspace (partially shown), bookmarks define where specific tasks are performed so they can be referenced more easily:

Create Notes and Provide Context

Other than using bookmarks for general organization and ease-of-use, here are some additional reasons:

Remembering why you created a workspace: Bookmarks can help remind you why you created a workspace, and how it works.
Deciphering someone else's workspace: Bookmarks can clarify the purpose of a workspace, and provide the necessary context for determining how it works.

Adding a Bookmark

Select an area of the workspace (for example, a group of transformers) that you want the bookmark to encompass. Click the bookmark tool or right-click and select Create Bookmark. A bookmark appears around the selected area.

Alternatively, click the book mark tool, or right-click on the canvas and select Insert Bookmark. Then drag the bookmark over the area you want the bookmark to encompass.

Finally, enter a new name for the bookmark.

Note You can create bookmarks that are nested inside other bookmarks.

Collapsing a Bookmark

You can collapse bookmarks to condense their contents and make large workspaces easier to manage. Collapsed bookmarks can be a useful alternative to custom transformers.

Click the arrow beside the bookmark name to collapse or expand it. When you collapse a bookmark, the only contents that display are the bookmark name and the names of any objects inside the bookmark that are configured for input or output. Mouse-over for a summary of the bookmark contents.

Bookmarks with all objects disabled appear as disabled when you collapse them.

Viewing Bookmarks in the Navigator

Bookmark names are listed as folders in the Navigator. Expand the bookmark name to view its contents:

Resizing a Bookmark

Click on the bookmark, hold down the mouse button, and drag the bookmark's handles.

Moving a Bookmark

Click on the bookmark's title bar and drag to move the bookmark to another location on the workspace.

By default, the bookmark's contents are attached to the bookmark. When you move it around, the contents follow. This makes it a useful tool for organizing workspaces: you can move entire sections around the canvas until they are in a good layout.

To change this behavior, right-click and toggle Move Contents With Bookmark, so it is no longer checked. A transparent magnet icon displays beside the name to indicate the contents are not attached.

Changing a Bookmark's Properties

To display the Edit dialog, click the bookmark's gear icon , or right-click and select Properties). The Edit dialog allows you to change the bookmark name and its color properties.

Other ways to rename a bookmark:

Double-click on a bookmark name.
Right-click on a bookmark name and select Rename.
Click on a bookmark and press F2.

To add a bookmark description, use annotations.

Zooming to a Bookmark

To zoom to a selected bookmark, either:

Right-click and select Zoom to Bookmark, or
Double-click the bookmark name in the Navigator.

Panning to a Bookmark

To center the workspace on a selected bookmark:

Click (once) on the bookmark name in the Navigator.

Exporting Bookmarks to a Custom Transformer

Right-click and select Create Custom Transformer to open the Custom Transformer Properties dialog.

Note See Creating Custom Transformers for information on the parameters in this dialog.

The objects that were inside the bookmark appear in a custom transformer window, under a new tab. The bookmark that was in the original workspace is replaced by a link to the custom transformer.

Disabling Objects in a Bookmark

Right-click and select Disable All Objects in Bookmark. To re-enable, right-click and select Enable All Obects in Bookmark.