Creating Warehouse Map Widgets

This procedure goes over setting up Warehouse Maps widgets.

Note

We recommend that you be familiar with Warehouse Maps Creator concepts before starting this procedure.

Prerequisite: You have created the warehouse map.

Here’s an overview of the procedure:

Step	Why do this?
Step 1: Adding a Warehouse Maps Widget	A Warehouse Maps widget must exist in the application to set it up.
Step 2: Adding Layers to the Widget	You must decide which layer to add to the Warehouse Maps widget and configure each with a data source, the data fields you want to see in a Warehouse Maps, and the data field’s color mapping.

Step 1: Adding a Warehouse Maps Widget

This step is essential because a Warehouse Maps widget must exist in the application to set it up.

1. From the Rebus menu, go to Admin Tools > Widgets > Warehouse Maps Widgets.

2. Click ‘New’. You’re at the Create New Widget screen.

3. Fill in the fields listed in the table below.

Field	What You Enter…
Widget Name	Enter the name of the Warehouse Maps widget.
Widget Map	The designated map.
Widget Group	The widget group to include the Warehouse Maps widget in.

4. In the Profiles field, assign one or more profiles to your selected widget by checking the box next to the profile name(s) in the dropdown.

5. Click ‘Save’. You’ve named and added a Warehouse Maps widget.

Step 2: Adding Layers to the Widget

1. Click ‘Create Layers’.

2. Fill in the fields needed to configure a layer for the Warehouse Maps widget.

Field	What You Enter…
Layer	Select the layer you want to include in the Warehouse Maps widget.
Data Source	Select Widget or Inheritance.

3. Follow the next steps according to the selected data source:

Widget Data SourceInheritance Data Source

Fill in the fields explained below.

Field	What You Enter…
Widget	Select the widget from which to retrieve the data field and its values.
ID Property	Select the property that you used to assign ID values to the map objects.
Matching Widget Field	Select the ID data field in your widget, that will be matched to the map object’s ID values.
Drilldown Widget	Drilldown widget so that clicking a map object opens it to show the details behind the map object’s measurement. To add a Drilldown Widget, click ‘Configure’. The Select Drilldown Widget form appears. Search the widget from the left panel and select it. Then, click ‘Done’.
Widget Color Fields	Go to step 4.

4. Add color fields. To do so, follow these steps:

   1. Click ‘+Add Color Field’. The Color Field Options form appears.

   2. Fill in the fields explained in the table below:

Field	What You Enter…
Field Name	The field in your source widget.
Range	Absolute or Relative according to whether you want the Warehouse Maps’s coloring to depend on absolute values, or relative values.
Color Mapping	The color to associate to the value. To define the color, click it. The color picker tool appears where you can define the color. The color requirements differ depending on the type of field to associate colors: For a numeric type field: define the color for the ‘Low’, ‘Mid’, and ‘High’ codes. If you selected ‘Absolute’ as the Range, enter the absolute values for ‘Low’, ‘Mid’, and ‘High’. For a string type field: add as many colors as needed. Just click ‘+Add Color Field’. Specify the string value(s) to associate to the color. To associate more than one string value to the color, separate them with commas (e.g., value1,value2,value3). For a Boolean type field: define the colors for ‘True’ and ‘False’.

Click ‘Done’. You’ve configured a data field with its color values, and are brought back to the Layer screen.

5. (Optional) Add a numeric overlay. To do so, follow these steps:

   1. In the Widget Preview screen, click the Layers icon.

   2. In the ‘Values’ column, select the value you want to display for each layer.

6. Click ‘Save’. You’ve added a layer to the Warehouse Maps widget’s configuration.

Result

Once you’ve added all the layers to the Warehouse Maps, you can preview the widget in the same screen. Make sure you have activated the warehouse map from the Warehouse Maps Creator screen:

• If you have defined more than one data field for the same layer, you can view one data field’s coloring on at a time in that layer. To view a data field’s coloring, do the following:

  • Hover over Layers icon.

  • Next to the desired layer, select the data field name to display its color values on the Warehouse Maps widget.

A preview box on the right of the Warehouse Maps Creator screen shows the Map Layers hierarchy.

Copying Warehouse Maps Widgets

If you want to create a Warehouse Maps widget that’s similar to an existing one, you can copy the original widget and modify it to save time.

Steps

1. From the Rebus menu, go to Admin Tools > Widgets > Warehouse Maps Widgets.

2. From the Widgets panel on the left, select the widget that you want to copy.

3. If it’s an active map (indicated by a green circle), in the upper right, click ‘Deactivate’.

4. In the upper right, click ‘Copy’. The Duplicate Map form appears.

5. Enter the Widget Name.

6. Select the Widget Group that the widget should be in.

7. Click ‘Save’.

Result

The new Warehouse Maps widget is created based on an existing widget. All configurations from the original widget are copied to the new widget, except for the name and group.