Trigger interactive behaviors

The Trigger interactions tool allows you to trigger certain interactive behaviors (Update report objects and Set prompt) configured by the report author by making a selection on the map.

A variety of drawing tools can be used to select features on the map. If you want to broaden your selection areas, you can apply buffers to your drawings. Drawings can also be edited as needed.

When you make a selection, configured interactive behaviors are triggered based on the selection. For example, suppose the report author configured an interactive behavior on a layer showing retailer locations to update a list of retailers organized by profit and revenue. When you select a group of retailer locations on the map, the list automatically updates to reflect your selection.

You can make changes to the way configured interactive behaviors are automatically triggered when selections are made. You can also trigger individual interactive behaviors manually, or reset the results of triggered Update report objects or Set prompt behaviors to their original state.

Use the drawing tools

From the Tools menu, choose Trigger interactions.
The Trigger interactions pane opens.

Choose one of the following tools from the Draw drop-down menu and draw on the map:

	Point—Press once to create a point.
	Rectangle—Press once to quickly create a rectangle or drag on the map to draw your own.
	Circle—Press once to quickly create a circle or drag on the map to draw your own.
	Polyline—Press to create two or more points to draw a line. Press twice to complete the line.
	Polygon—Press to create three or more points to draw a polygon. Press twice to complete the polygon.
	Freehand polygon—Drag on the map to draw a freehand shape.
	Freehand polyline—Drag on the map to draw a freehand line.

Features that are intersected by your drawings are selected and highlighted on the map.

Based on the selection, configured interactive behaviors that are enabled for automatic interactions are triggered.

Buffering lets you select features within a specified distance of a drawing. If you want to add a buffer to your drawing, do the following:
1. On the Trigger interactions pane, press More to display more options.
2. Check the Buffer check box to turn on buffering. To turn off buffering at any time, uncheck the check box.
When you turn on buffering, a buffer is automatically applied to your drawings and to any subsequent drawings you make.
Note:
The default buffer distance and units were specified by the report author, but they can be changed. See Change buffer settings for more information.
If you want to draw more than one graphic to select features on the map, check the Add drawings check box and use any of the drawing tools to continue making selections. When this check box is unchecked, any additional drawings you make will clear all previous drawings.

While using the drawing tools, do any of the following as needed:

Press Clear to clear your drawings, including any buffers, from the map.

The results of any Update report objects or Set prompt interactive behaviors triggered by the selections are returned to their original state.

Press Pan/Edit to edit a drawing or to pan the map.

When you are finished, close the Trigger interactions pane.
All drawings, including buffers, are hidden, but the results of any triggered interactive behaviors remain.
When you reopen the Trigger interactions pane, your drawings are reapplied to the map.

Change buffer settings

If you are using the compact Trigger interactions pane, press More to display more options.
Check the Buffer check box to turn on buffering. To turn off buffering at any time, uncheck the check box.
Change the default buffer distance and units as desired, and press Enter.
The new buffer settings are applied to existing drawings on the map, and will apply to any new drawings you make.

Edit drawings

Draw on the map using any of the drawing tools.
Press Pan/Edit.
Press the drawing you want to edit.
Do any of the following to edit the drawing:
- To move the drawing, press anywhere inside the drawing and drag it to a new location.
- To resize the drawing, drag any of the white squares.
- To rotate the drawing, press the rotate handle at the top of the drawing and drag in a circular motion on the map.
- To change the shape of the drawing, do the following:
  - Move any vertex (gray circle) by dragging it.
  - Create new vertices by dragging any of the white circles, which mark the midpoint between vertices. When you drag a midpoint marker, a new vertex is created, along with new midpoint markers for the new line segments that are created.
  - Remove any vertex by pressing the vertex and pressing Clear vertex.
    Tip:
    You can also press the Delete key after pressing the vertex.
- To remove the drawing, press Clear drawing.
  Tip:
  You can also press the Delete key to clear the drawing.
Note:
If a buffer is applied to the drawing, the buffer is hidden while you are editing the drawing. When you are finished editing, the buffer is recalculated based on the updated drawing and is reapplied to the drawing.

Manage automatic and manual interactivity

In the Trigger interactions tool, all on-selection interactive behaviors configured by the report author are listed under Interactions. Interactive behaviors configured on layers that are not visible in the current map extent are unavailable in the list.

By default, interactive behaviors configured on layers that are visible in the current map extent are triggered automatically when you select features on the map. You can turn off automatic triggering of individual interactive behaviors using the Automatic option under Interactions. When you turn off automatic triggering of an interactive behavior, the behavior is not triggered when you make a selection until you turn the behavior on again.

Using the Manual option under Interactions, you can trigger individual interactive behaviors manually. You can also reset the results of triggered Update report objects or Set prompt behaviors to their original state.

To turn off automatic triggering of an interactive behavior, do the following:
1. Choose Automatic.
2. Uncheck the check box beside the behavior.
The next time you make a selection on the map, the behavior will not be triggered automatically. To turn on automatic triggering of the behavior again, check the check box.
To manually trigger an interactive behavior based on a selection on the map, do the following:
1. Choose Manual.
2. Choose the behavior in the list.
3. Press the Play button.
The interactive behavior is triggered based on the selection.
To reset the results of a triggered Update report objects or Set prompt interactive behavior, choose the behavior in the list and press the Reset button.
The results of the interactive behavior are returned to their original state.