This is an archive related to a previous version of Esri Maps for IBM Cognos. If you need the current version go to http://doc.arcgis.com/en/maps-for-cognos/.
Esri Maps for IBM Cognos provides a default set of symbols, colors, and color ramps used to style features on the map. These are defined in two JSON configuration files: one that specifies the default symbols in user mode (for report consumers), and one that defines them in design mode (for report authors).
Administrators can edit these files to modify the default symbols and color ramps available to report authors and consumers.
The symbols definition files define default values for the following:
Modify the two default symbols definition files to make changes to the default symbols available to report consumers and authors.
Browse to <em4c_location>/webcontent/esrimap/em4c-bisprovider/config/design/symbols.json.txt.
The following code shows an example of a
default symbols definition file that describes the default
symbology used in your application. Each of these is an array of JSON objects that
describe the default symbols used to style different types of
features on the map. Objects are enclosed in curly brackets ({ })
and separated by commas. Multiple objects are enclosed in square
brackets ([ ]) to indicate an array. Each JSON object contains
properties formatted as name-value pairs that represent
data.{
defaultFillSymbols: [],
defaultLineSymbols: [],
defaultMarkerSymbols: [],
heatMapColorRamps: [],
classBreaksColorRamps: [],
uniqueValueColorRamps: []
}
Browse to <em4c_location>/webcontent/esrimap/em4c-bisprovider/config/default/symbols.json.txt.
Simple fill symbols define the default styles applied to polygons. Each fill symbol object is defined as follows:"defaultFillSymbols": [{
"color": [17, 140, 17, 179],
"type": "esriSFS",
"style": "esriSFSSolid",
"outline": {
"type": "esriSLS",
"style": "esriSLSSolid",
"color": [17, 140, 17, 179],
"width": 1.25
}
},
...
],
The following image illustrates the default fill symbols:
Simple line symbols specify the default styling applied to polylines or polygon outlines. Each line symbol object is defined as follows:],
"defaultLineSymbols": [{
"color": [255, 11, 11, 255],
"width": 0.4,
"type": "esriSLS",
"style": "esriSLSSolid"
},
...
]
The following image illustrates the default line symbols:
Marker symbols are used to style point features. The default marker set defines the symbols that are automatically used to represent features when point data is added to the map.
By default, Esri Maps for IBM Cognos uses simple marker symbol shapes to symbolize point data added to the map.
The defaultMarkerSymbols section of the default symbols definition file (symbols.json.txt) points to the symbols that should be used by default to symbolize points on the map. You can modify this section to point to different symbols included with Esri Maps for IBM Cognos. Each marker symbol object is defined as follows:],
"defaultMarkerSymbols":[{
"angle": 0,
"xoffset": 0,
"yoffset": 0,
"type": "esriSMS",
"style": "esriSMSCircle",
"color": [255, 11, 11, 128],
"size": 7.25,
"outline": {
"color":[255,11, 11, 255],
"width": 1,
"type": "esriSLS",
"style": "esriSLSSolid"
}
},
...
]
Optional properties include the following:
The order in which the marker symbol objects are defined in the file corresponds to the order in which they are used to render features on the map as new point data is added. For example, by default, red circle shapes (esriSMSCircle) are used for the first point layer, blue circle shapes for the second layer, and so on.
Color ramps for heat maps specify a range of colors applied to a group of symbols that represent a heat map. Each color ramp is specified as a set of colors defined as red, green, blue, and alpha values.
For example, the following JSON objects specify the colors that make up the color ramps shown below:],
"heatMapColorRamps": [
[
[0, 0, 255, 0],
[0, 0, 255, 0.6],
[0, 255, 255, 0.6],
[0, 255, 0, 0.6],
[255, 255, 0, 0.6],
[255, 0, 0, 0.6]
],
[
[133, 193, 200, 1],
[144, 161, 190, 1],
[156, 129, 132, 1],
[167, 97, 170, 1],
[175, 73, 128, 1],
[184, 48, 85, 1],
[192, 24, 42, 1],
[200, 0, 0, 1],
[211, 51, 0, 1],
[222, 102, 0, 1],
[233, 153, 0, 1],
[244, 204, 0, 1],
[255, 255, 0, 1]
]
]
Color ramps for class breaks specify a range of colors applied to features grouped into classes. The start, end, and intermediate colors that make up the color ramp are defined as objects that define the red, green, and blue values of each color (colors may also be described using hex values or named color values).
For example, the following JSON objects specify the colors that make up the color ramps shown below:],
"classBreaksColorRamps": [
{ "0.0": [124, 4, 4], "1.0": [247, 198, 198] },
{ "0.0": [2, 32, 227], "0.5": [0, 242, 242], "1.0": [32, 204, 16] },
{ "0.0": "#feeedf", "0.25": "#fdbe86", "0.5": "#fd8c3d", "0.75": "#e65507", "1.0": "#a63700" }
]
Unique value color ramps specify a range of colors applied to features grouped according to unique values. The start, end, and intermediate colors that make up the color ramp are defined as objects that define the red, green, and blue values of each color (colors may also be described using hex values or named color values).
For example, the following JSON objects specify the colors that make up the color ramps shown below:],
"uniqueValueColorRamps": [
{ "0.0": [51, 153, 51], "0.5": [255, 255, 191], "1.0": [255, 0, 0] },
{ "0.0": [161, 215, 106], "0.5": [247, 247, 247], "1.0": [233, 163, 201] },
{ "0.0": [123, 50, 148], "0.5": [247, 247, 247], "1.0": [0, 136, 55] }
]
Verify that your custom picture markers are available to Esri Maps for IBM Cognos report authors and consumers.
Esri Maps for IBM Cognos now uses the modified default symbols and color maps to style the data.