Shape Map Editor Dialog Box
You can use the Shape Map Editor dialog box to create and edit shape maps in a report. This topic describes the options in the dialog box.
Designer displays the Shape Map Editor dialog box when you navigate to Insert > Map > Shape Map or drag the Shape Map icon from the Components panel to the report destination, or right-click a shape map and select Format Shape Map from the shortcut menu.
Designer displays these options:
Menu
- File
- Open
Select to import a .shp or .xml file which contains some area information to the map object. - Save
Select to accept and save the changes on the map object. - Save As
Select to save the map object to an .xml file with the name you specify. - Canvas Setup
Select to open the Shape Map Canvas Setup dialog box to change the width and height of the map object. - Close
Select to close the dialog box.
- Open
- Edit
- Undo
Select to reverse a previous action. - Redo
Select to redo an action. - Cut
Select to erase an object and place it in the clipboard. - Copy
Select to copy an object and place it in the clipboard. - Paste
Select to take an object from the clipboard and place it into the map object. - Delete
Select to delete the specified object. - Insert Mode
Select to change the dialog box to the Insert Mode, in which you can add areas into the map manually. When you clear this option, the dialog box is in the Edit Mode, in which you can edit areas as required. - Reset All
Select to open the Reset All dialog box to reset the properties for the map areas including the labels and summary fields inside the areas globally. - Hide Duplicate Labels
Select to only display the label and summary field for the biggest area for map areas that have the same name.
- Undo
- View
- Show Area Inspector
Select to show the Map Area Inspector panel in the Shape Map Editor dialog box. - Show Area Labels
Select to show labels and summary fields in the map areas in the Shape Map Editor dialog box.
- Show Area Inspector
- Insert
- Background Image
Select to specify an image as the background of the map object. - Match Background Image
Designer enables this option when the size of the background image is not the same as that of the map object. You can select it to resize the map object to make it match the size of the background image. - Label
Select to insert a label to the map object. - Line
Select to insert a line to the map object. - Bind Data
Select to open the Shape Map Data Binding Wizard dialog box to bind a dataset to the map object.
- Background Image
- Format
- Conditional Formatting
Select to open the Shape Map Area Conditional Formatting dialog box to add conditional formatting to the map areas. - Align
- Left
Select to align the content in the specified object to the left border of the object. - Center
Select to align the content in the specified object in the center of the object. - Right
Select to align the content in the specified object to the right border of the object. - Justify
Select to adjust the horizontal spacing so as to align the content evenly along both the left and right margins in the specified object. - Text Style
- Bold
Select to apply bold formatting to the text in the specified object. - Italic
Select to italicize the text in the specified object. - Underline
Select to add a horizontal line under the text in the specified object.
- Bold
- Conditional Formatting
- Help
Select to view information about the dialog box.
Toolbar
Designer displays the following commands on the toolbar.
- Open
Select to import a .shp or .xml file which contains area information for the map object. - Save
Select to accept and save the changes on the map object. - Canvas Setup
Select to open the Shape Map Canvas Setup dialog box to change the width and height of the map object. - Cut
Select to erase an object and place it in the clipboard. - Copy
Select to copy an object and place it in the clipboard. - Paste
Select to take an object from the clipboard and place it into the map object. - Delete
Select to delete the specified object. - Undo
Select to reverse a previous action. - Redo
Select to redo an action. - Insert Mode
If selected, the dialog box is in the Insert Mode, in which you can add areas into the map manually; otherwise, the dialog box is in the Edit Mode, in which you can edit areas as required. - Line
Select to insert a line into the map object. - Bind Data
Select to open the Shape Map Data Binding Wizard dialog box to bind a dataset to the map object. - Font Face box
Select the font face of the text in the specified object. - Font Size box
Select the font size of the text in the specified object. - Bold
Select to apply bold formatting to the text in the specified object. - Italic
Select to italicize the text in the specified object. - Underline
Select to add a horizontal line under the text in the specified object. - Background Color
Select to specify the background color of the specified object in the color palette. - Foreground Color
Select to specify the foreground color of the specified object in the color palette. - Conditional Formatting
Select to open the Shape Map Area Conditional Formatting dialog box to add conditional formatting to the map areas. - Left
Select to align the content in the specified object to the left border of the object. - Center
Select to align the content in the specified object in the center of the object. - Right
Select to align the content in the specified object to the right border of the object. - Justify
Select to adjust the horizontal spacing so as to align the content evenly along both the left and right margins in the specified object.
Map Area Inspector
This panel lists the objects in the shape map in a tree structure and properties of the objects.
Search icon
Select to open the search box to search for properties of the selected object. To start searching, type the text you want to search for in the search box and Designer lists the properties containing the matched text. Designer closes the search box when you select another object.
You can use the following options in the search box:
- Drop-down icon
Select to list more search options.- Highlight All
Select to highlight all the matched text. - Match Case
Select to search for text that meets the case of the text you type. - Match Whole Word
Select to search for text that looks the same as the text you type.
- Highlight All
- Delete icon
Select to close the search box and cancel the search.
The following tables list properties of the Area, Label, Summary, and Line objects of a shape map in the Map Area Inspector panel. You can use formula to control the value of some properties.
Area Properties
Property Name | Description |
---|---|
General | |
Class Type | Shows the class type of the object. Read only. |
Data Inherit | Shows whether the object inherits dataset from another object. Read only. |
Dataset | Shows the dataset the object applies. Read only. |
Instance Name | Shows the instance name of the object. Read only. |
Use Global Setting | Specifies whether to apply the settings that you have set globally for all the map areas to this object.
Data type: Boolean |
Area | |
Alternate Text | Specifies the tip that displays when you point to the area in HTML output or in Page Report Studio. This property takes effect only when you set Alternate Content Type of the map object to "customized" and the area has data.
Data type: String |
Detail Report | Specifies the detail report that you want to link the object to. Select the ellipsis in the value cell to set the detail report. See Linking to a Detail Report.
Data type: String |
Fill Color | Specifies the color with which to fill the area that has records. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Link | Specifies the target that you want to link the object to, which can be another report, a website, an email address, or a Blob data type field. Select the ellipsis in the value cell to set the link target. See Adding Links in Reports. Data type: String |
Name | Specifies the name of the area.
Data type: String |
Shape | |
Coordinates | Shows the coordinates of the area for laying out the map. Read only. Designer displays the coordinates as: X1,Y1,X2,Y2,X3,Y3..., where X/Y is the X/Y coordinate of one of the polygon's corner. |
Type | Shows the shape of the area. Read only. |
Boundary | |
Boundary Color | Specifies the color of the area border. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Boundary Style | Specifies the line style of the area border. Choose an option from the drop-down list.
Data type: Enumeration |
Boundary Width | Specifies the width of the area border. Type a numeric value to change the width.
Data type: Float |
Accessibility | |
External AccessKey | This property is mapped to the HTML attribute accesskey, as specified by w3.org. Data type: String |
External CSS Class Selector | Specifies the name of the Class Selector for the object in the HTML output. Data type: String |
External TabIndex | This property is mapped to the HTML attribute tabindex, as specified by w3.org. Data type: Integer |
External Title | This property is mapped to the HTML attribute title, as specified by w3.org. Data type: String |
HrefLang | This property is mapped to the HTML attribute hreflang, as specified by w3.org. You can use it to specify the base language of the resource designated by a link on the object, such as the target you define via the Link property. Data type: String |
Label Properties
Property Name | Description |
---|---|
General | |
Class Type | Shows the class type of the object. Read only. |
Instance Name | Shows the instance name of the object. Read only. |
Use Global Setting | Specifies whether to apply the settings that you have set globally for all labels in the map to this object.
Data type: Boolean |
Text Format | |
Auto Fit | Specifies whether to automatically adjust the width and height of the object according to its content.
Data type: Boolean |
Bold | Specifies whether to apply bold formatting to the text in the object. Data type: Boolean |
Font Face | Specifies the font face of the text in the object. Choose an option from the drop-down list.
Data type: Enumeration |
Font Size | Specifies the font size of the text in the object. Type an integer value to change the size. Data type: Integer |
Horizontal Alignment | Specifies the horizontal justification of the text in the object. Choose an option from the drop-down list.
Data type: Enumeration |
Italic | Specifies whether to italicize the text in the object. Data type: Boolean |
Maximum Width | Specifies the maximum width of the text you want to display in the object. Type a numeric value to change the width. This property often works together with the Auto Fit property. When you set Auto Fit of the object to "true" and the value of Maximum Width is not equal to 0, the text extends in the object until the width is this value. Data type: Float |
Strikethrough | Specifies whether to draw a line through the text in the object.
Data type: Boolean |
Text | Specifies the text in the object. Type a string to display as the label text.
Data type: String |
Underline | Specifies whether to add a horizontal line under the text in the object. Data type: Boolean |
Vertical Alignment | Specifies the vertical justification of the text in the object. Choose an option from the drop-down list.
Data type: Enumeration |
Word Wrap | Specifies whether to wrap the text according to the width of the object.
Data type: Boolean |
Geometry | |
Height | Specifies the height of the object. Type a numeric value to change the height. Data type: Float |
Width | Specifies the width of the object. Type a numeric value to change the width. Data type: Float |
X | Specifies the horizontal coordinate of the object's top left corner, relative to its parent container, when the object is not in static position in the container. Type a numeric value to change the coordinate.
Data type: Float |
Y | Specifies the vertical coordinate of the object's top left corner, relative to its parent container, when the object is not in static position in the container. Type a numeric value to change the coordinate.
Data type: Float |
Color | |
Background | Specifies the background color of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Foreground | Specifies the foreground color of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Padding | |
Bottom Padding | Specifies the space between the content in the object and the bottom border of the object. Type a numeric value to change the padding. Data type: Float |
Left Padding | Specifies the space between the content in the object and the left border of the object. Type a numeric value to change the padding. Data type: Float |
Right Padding | Specifies the space between the content in the object and the right border of the object. Type a numeric value to change the padding. Data type: Float |
Top Padding | Specifies the space between the content in the object and the top border of the object. Type a numeric value to change the padding. Data type: Float |
Border | |
Border Color | Specifies the color for the border of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Border Thickness | Specifies the width for the border of the object. Type a numeric value to change the thickness.
Data type: Float |
Bottom Line | Specifies the line style for the bottom border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Left Line | Specifies the line style for the left border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Right Line | Specifies the line style for the right border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Shadow | Specifies whether to add a drop shadow effect to the border.
Data type: Boolean |
Shadow Color | Specifies the color of the border shadow. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Top Line | Specifies the line style for the top border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Pattern | |
Pattern Color | Specifies the color in which to draw a pattern to fill the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Pattern Style | Specifies the style of the pattern. Choose an option from the drop-down list.
Data type: String |
Others | |
Auto Connector | Specifies whether to draw a line between the label and the area it describes automatically when you drag the label out of the area.
Data type: Boolean |
Invisible | Specifies whether to hide the object in the design area and in the report. Logi Report Engine performs all calculations that involve the object regardless of whether the object is visible or not. Data type: Boolean |
Accessibility | |
External AccessKey | This property is mapped to the HTML attribute accesskey, as specified by w3.org. Data type: String |
External CSS Class Selector | Specifies the name of the Class Selector for the object in the HTML output. Data type: String |
External Dir | This property is mapped to the HTML attribute dir, as specified by w3.org. Data type: String |
External ID | This property is mapped to the HTML attribute id, as specified by w3.org. Data type: String |
External Style | This property is mapped to the HTML attribute style, as specified by w3.org. Data type: String |
External TabIndex | This property is mapped to the HTML attribute tabindex, as specified by w3.org. Data type: Integer |
External Title | This property is mapped to the HTML attribute title, as specified by w3.org. Data type: String |
HrefLang | This property is mapped to the HTML attribute hreflang, as specified by w3.org. You can use it to specify the base language of the resource designated by a link on the object, such as the target you define via the Link property. Data type: String |
Language | This property is mapped to the HTML attribute lang, as specified by w3.org. Data type: String |
LongDesc | This property is mapped to the HTML attribute longdesc, as specified by w3.org. Data type: String |
Summary Properties
Property Name | Description |
---|---|
General | |
Aggregate Function | Shows the function of the summary. Read only. |
Field Type | Shows what kind of field it is. Read only. |
Group By | Shows the group-by field that the summary is based on. When this property value is null, the summary is based on the whole dataset. Read only. |
Instance Name | Shows the instance name of the object. Read only. |
Summary Name | Shows the name of the summary. Read only. |
Summary On | Shows the name of the field on which to perform the summary function. Read only. |
Use Global Setting | Specifies whether to apply the settings that you have set globally for all summary fields in the map to this object.
Data type: Boolean |
Geometry | |
Height | Specifies the height of the object. Type a numeric value to change the height. Data type: Float |
Width | Specifies the width of the object. Type a numeric value to change the width. Data type: Float |
X | Specifies the horizontal coordinate of the object's top left corner, relative to its parent container, when the object is not in static position in the container. Type a numeric value to change the coordinate.
Data type: Float |
Y | Specifies the vertical coordinate of the object's top left corner, relative to its parent container, when the object is not in static position in the container. Type a numeric value to change the coordinate.
Data type: Float |
Color | |
Background | Specifies the background color of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Foreground | Specifies the foreground color of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Padding | |
Bottom Padding | Specifies the space between the content in the object and the bottom border of the object. Type a numeric value to change the padding. Data type: Float |
Left Padding | Specifies the space between the content in the object and the left border of the object. Type a numeric value to change the padding. Data type: Float |
Right Padding | Specifies the space between the content in the object and the right border of the object. Type a numeric value to change the padding. Data type: Float |
Top Padding | Specifies the space between the content in the object and the top border of the object. Type a numeric value to change the padding. Data type: Float |
Border | |
Border Color | Specifies the color for the border of the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Border Thickness | Specifies the width for the border of the object. Type a numeric value to change the thickness.
Data type: Float |
Bottom Line | Specifies the line style for the bottom border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Left Line | Specifies the line style for the left border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Right Line | Specifies the line style for the right border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Shadow | Specifies whether to add a drop shadow effect to the border.
Data type: Boolean |
Shadow Color | Specifies the color of the border shadow. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Top Line | Specifies the line style for the top border of the object. Choose an option from the drop-down list.
Data type: Enumeration |
Pattern | |
Pattern Color | Specifies the color in which to draw a pattern to fill the object. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Pattern Style | Specifies the style of the pattern. Choose an option from the drop-down list.
Data type: String |
Text Format | |
Auto Fit | Specifies whether to automatically adjust the width and height of the object according to its content.
Data type: Boolean |
Bold | Specifies whether to apply bold formatting to the text in the object. Data type: Boolean |
Font Face | Specifies the font face of the text in the object. Choose an option from the drop-down list.
Data type: Enumeration |
Font Size | Specifies the font size of the text in the object. Type an integer value to change the size. Data type: Integer |
Format | Specifies the format in which you want to display values of the object in reports. Choose an option from the drop-down list or type the format by yourself.
Data type: String If the object is BigDecimal data type, to avoid precision loss, you should specify a prefix JRD when setting the format. |
Horizontal Alignment | Specifies the horizontal justification of the text in the object. Choose an option from the drop-down list.
Data type: Enumeration |
Italic | Specifies whether to italicize the text in the object. Data type: Boolean |
Maximum Width | Specifies the maximum width of the text you want to display in the object. Type a numeric value to change the width. This property often works together with the Auto Fit property. When you set Auto Fit of the object to "true" and the value of Maximum Width is not equal to 0, the text extends in the object until the width is this value. Data type: Float |
Strikethrough | Specifies whether to draw a line through the text in the object.
Data type: Boolean |
Underline | Specifies whether to add a horizontal line under the text in the object. Data type: Boolean |
Vertical Alignment | Specifies the vertical justification of the text in the object. Choose an option from the drop-down list.
Data type: Enumeration |
Word Wrap | Specifies whether to wrap the text according to the width of the object.
Data type: Boolean |
Others | |
Auto Connector | Specifies whether to draw a line between the summary and the area it describes automatically when you drag the summary out of the area.
Data type: Boolean |
Cache Value | Specifies whether to cache the value of the summary instead of obtaining it repeatedly.
Data type: Boolean |
Column Name | Specifies to substitute the current summary with another summary. Select the summary from the drop-down list.
Data type: String To make the property editable, you need to clear "Forbid changing column" in the Panel category of the Options dialog box. |
Data Mapping File | Specifies the data mapping file (without the locale part) you want to apply to the object for NLS use.
For example, if the data mapping file is Product_de_DE.properties, type Product in the value cell. Data type: String |
Display Null | Specifies the string to display when the summary value is null.
Data type: String |
Invisible | Specifies whether to hide the object in the design area and in the report. Logi Report Engine performs all calculations that involve the object regardless of whether the object is visible or not. Data type: Boolean |
Accessibility | |
External AccessKey | This property is mapped to the HTML attribute accesskey, as specified by w3.org. Data type: String |
External CSS Class Selector | Specifies the name of the Class Selector for the object in the HTML output. Data type: String |
External Dir | This property is mapped to the HTML attribute dir, as specified by w3.org. Data type: String |
External ID | This property is mapped to the HTML attribute id, as specified by w3.org. Data type: String |
External Style | This property is mapped to the HTML attribute style, as specified by w3.org. Data type: String |
External TabIndex | This property is mapped to the HTML attribute tabindex, as specified by w3.org. Data type: Integer |
External Title | This property is mapped to the HTML attribute title, as specified by w3.org. Data type: String |
HrefLang | This property is mapped to the HTML attribute hreflang, as specified by w3.org. You can use it to specify the base language of the resource designated by a link on the object, such as the target you define via the Link property. Data type: String |
Language | This property is mapped to the HTML attribute lang, as specified by w3.org. Data type: String |
LongDesc | This property is mapped to the HTML attribute longdesc, as specified by w3.org. Data type: String |
Line Properties
Property Name | Description |
---|---|
General | |
Class Type | Shows the class type of the object. Read only. |
Instance Name | Shows the instance name of the object. Read only. |
Others | |
Invisible | Specifies whether to hide the object in the design area and in the report. Logi Report Engine performs all calculations that involve the object regardless of whether the object is visible or not. Data type: Boolean |
Line Property | |
Line Color | Specifies the color of the line. Choose a color from the drop-down list, or select Custom to customize a color in the Pick a Color dialog box. You can also type a hexadecimal RGB value (for example, 0xff0000) to specify a color. Data type: String |
Line Style | Specifies the style of the line. Choose an option from the drop-down list.
Data type: Enumeration |
Line Thickness | Specifies the thickness of the line. Type a numeric value to change the thickness.
Data type: Float |
Accessibility | |
External CSS Class Selector | Specifies the name of the Class Selector for the object in the HTML output. Data type: String |
External ID | This property is mapped to the HTML attribute id, as specified by w3.org. Data type: String |
External Style | This property is mapped to the HTML attribute style, as specified by w3.org. Data type: String |
Language | This property is mapped to the HTML attribute lang, as specified by w3.org. Data type: String |