デフォルトのシンボルとカラーランプの変更—Esri Maps for IBM Cognos

Esri Maps for IBM Cognos には、マップ上のフィーチャのシンボル設定に使用されるシンボル、色、およびカラーランプのデフォルトセットが用意されています。これらは、2 つの JSON 構成ファイルで定義されています。1 つはユーザーモードでのデフォルトシンボルを指定し (レポート利用者向け)、もう 1 つはデザインモードでのデフォルトシンボルを定義します (レポート作成者向け)。

管理者は、これらのファイルを編集して、レポート作成者および利用者が使用できるデフォルトのシンボルとカラーランプを変更できます。

注意:

デフォルトシンボル定義ファイルのバックアップを作成してから、プロパティを変更することをお勧めします。

シンボル定義ファイルは、次のデフォルト値を定義します。

塗りつぶしシンボル
ラインシンボル
ヒートマップのカラーランプ
マーカーシンボル
クラス閾値のカラーランプ
個別値のカラーランプ

デフォルトシンボル定義の編集

4 つのデフォルトシンボル定義ファイルを変更して、レポート利用者および作成者が使用できるデフォルトシンボルを変更します。

注意:

これらの変更は、環境内にある各 EM4C サーバーに対して行う必要があります。

デフォルトシンボル定義ファイルを見つけます。
<em4c_location>\webcontent\esrimap\em4c-bisprovider\config\design\symbols.json.txt を参照します。
元の symbols.json.txt ファイルのバックアップコピーを作成します (たとえば、backup_symbols.json.txt)。
任意のテキストエディターを使用して、symbols.json.txt を開きます。
次のコードは、アプリケーションで使用されるデフォルトシンボルについて記述するデフォルトシンボル定義ファイルの例を示しています。これらはそれぞれ、JSON オブジェクトの配列で、JSON オブジェクトはマップ上の各種フィーチャのシンボル設定に使用されるデフォルトシンボルについて記述しています。オブジェクトは、中括弧 ({ }) で囲まれ、カンマで区切られています。複数のオブジェクトが角括弧 ([ ]) で囲まれ、配列を示しています。各 JSON オブジェクトには、データを表す名前と値のペアという形式のプロパティが含まれています。
```
{
    defaultFillSymbols: [],
    defaultLineSymbols: [],
    defaultMarkerSymbols: [],
    heatMapColorRamps: [],
    classBreaksColorRamps: [],
    uniqueValueColorRamps: []
}
```
この後に説明する各セクションの規則に従い、必要に応じてデフォルトのシンボルおよびカラーランプを変更します。
JSONLint などの整合チェックツールを使用して、更新した JSON コードの整合性をチェックします。
編集したファイルを保存して閉じます。
デザインモードでアプリケーションをテストします。
ユーザーモード用のデフォルトシンボル定義ファイルを見つけます。
<em4c_location>\webcontent\esrimap\em4c-bisprovider\config\default\symbols.json.txt を参照します。
ステップ 2 ～ 6 を繰り返します。
ユーザーモードでアプリケーションをテストします。

塗りつぶしシンボル

シンプル塗りつぶしシンボルは、ポリゴンに適用されるデフォルトのスタイルを定義します。各塗りつぶしシンボルオブジェクトは、次のように定義されます。

"defaultFillSymbols": [{
	"color": [17, 140, 17, 179],
	"type":  "esriSFS",
	"style": "esriSFSSolid", 
	"outline": { 
		"type": "esriSLS", 
		"style": "esriSLSSolid", 
		"color": [17, 140, 17, 179], 
		"width": 1.25
		}
			},
...
],

詳細:

color - ラインの赤、緑、青、アルファの値をその順序で定義する、4 つのエレメントから成る配列を指定します。値の範囲は、0 ～ 255 です。
注意:
塗りつぶし色は、style プロパティが塗りつぶし (esriSFSSolid) に設定されている場合にのみ適用されます。パターン塗りつぶしを指定する場合、color プロパティは無視されます。
type - シンボルのタイプを指定します。シンプル塗りつぶしシンボルの type プロパティは esriSFS です。
style - 塗りつぶしに適用されるスタイルを指定します。デフォルトの塗りつぶしスタイルは esriSFSSolid です。次の塗りつぶしパターンを利用できます。
- esriSFSSolid
- esriSFSCross
- esriSFSDiagonalCross
- esriSFSBackwardDiagonal
- esriSFSForwardDiagonal
- esriSFSHorizontal
- esriSFSVertical
- esriSFSNull (非表示)
outline - ポリゴンアウトラインのプロパティを指定します。詳細については、「ラインシンボル」をご参照ください。

次の画像は、デフォルトの塗りつぶしシンボルを示しています。


esriSFSSolid	esriSFSCross	esriSFSDiagonalCross	esriSFSBackwardDiagonal	esriSFSForwardDiagonal	esriSFSHorizontal	esriSFSVertical

ラインシンボル

シンプルラインシンボルは、ポリラインまたはポリゴンアウトラインに適用されるデフォルトのシンボル設定を指定します。各ラインシンボルオブジェクトは、次のように定義されます。

],
  "defaultLineSymbols": [{
  	"color": [255, 11, 11, 255],
  	"width": 0.4,
  	"type": "esriSLS",
  	"style": "esriSLSSolid"
  },
  ...
]

詳細:

color - ラインの赤、緑、青、アルファの値をその順序で定義する、4 つのエレメントから成る配列を指定します。値の範囲は、0 ～ 255 です。
width - ラインの幅をポイント単位で指定します。
type - シンボルのタイプを指定します。シンプルラインシンボルの type プロパティは esriSLS です。
style - ラインに適用されるスタイルを指定します。デフォルトのラインスタイルは esriSLSSolid です。次のラインパターンを利用できます。
- esriSLSSolid
- esriSLSDash
- esriSLSDashDot
- esriSLSDashDotDot
- esriSLSDot
- esriSLSNull (非表示)

次の画像は、デフォルトのラインシンボルを示しています。

マーカーシンボル

マーカーシンボルは、ポイントフィーチャのシンボル設定に使用されます。デフォルトマーカーセットは、マップへのポイントデータ追加時にフィーチャを表すために自動的に使用されるシンボルを定義します。

Esri Maps for IBM Cognos は、デフォルトで、シンプルマーカーシンボルの形状を使用して、マップに追加されたポイントデータをシンボル表示します。

デフォルトシンボル定義ファイル (symbols.json.txt) の defaultMarkerSymbols セクションは、マップ上のポイントのシンボル表示にデフォルトで使用されるシンボルを示します。このセクションを変更して、Esri Maps for IBM Cognos に含まれる別のシンボルを示すようにすることができます。各マーカーシンボルオブジェクトは、次のように定義されます。

],
"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" 
			}
				},
	...
]

詳細:

type - シンボルのタイプを指定します。シンプルマーカーシンボルの type プロパティは esriSMS です。ピクチャマーカーシンボルの場合、type は esriPMS です。
style - シンボルに適用されるスタイルを指定します。デフォルトのシンボルスタイルは esriSMSCircle です。次のシンボルスタイルを利用できます。
- esriSMSCircle
- esriSMSCross
- esriSMSDiamond
- esriSMSSquare
- esriSMSX
color - シンボルの赤、緑、青、アルファの値をその順序で定義する、4 つのエレメントから成る配列を指定します。値の範囲は、0 ～ 255 です。
size - シンボルのサイズをポイント単位で指定します。

オプションのプロパティには、次のものがあります。

angle - マーカーシンボルを回転させる角度を指定します (0 ～ 360 度)。東を 0 度として、反時計回りに回転します。
xoffset - 実際のポイント位置からマーカーシンボルまでの水平オフセットを指定します (ポイント単位)。正の値は右へのオフセット、負の値は左へのオフセットになります。
yoffset - 実際のポイント位置からのマーカーシンボルの垂直方向オフセットをポイント単位で指定します。正の値は上へのオフセット、負の値は下へのオフセットになります。
outline - シンボルアウトラインのプロパティを指定します。詳細については、「ラインシンボル」をご参照ください。

ファイル内のマーカーシンボルオブジェクトの定義順序は、新しいポイントデータの追加時にマーカーシンボルオブジェクトがマップ上のフィーチャの描画に使用される順序に対応します。たとえば、デフォルトでは、最初のポイントレイヤーに赤い円の形状 (esriSMSCircle) が使用され、2 つ目のレイヤーには青い円の形状が使用され、以下同様となります。

ヒント:

組織にレポート作成者および利用者が利用できるカスタムシンボルがある場合は、「カスタムシンボルセットの追加」をご参照ください。

ヒートマップのカラーランプ

ヒートマップのカラーランプは、ヒートマップを表すシンボルのグループに適用される色の範囲を指定します。各カラーランプは、赤、緑、青、アルファの値として定義されたカラーセットとして指定されます。

たとえば、次の JSON オブジェクトは、以下に示すカラーランプを構成する色を指定しています。

],
	"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]
	]  
]

クラス閾値のカラーランプ

クラス閾値のカラーランプは、クラスにグループ化されたフィーチャに適用される色の範囲を指定します。このカラーランプを構成する開始色、終了色、および中間色は、各色の赤、緑、青の値を定義するオブジェクトとして定義されます (16 進値または名前付きの色の値として色を記述することもできます)。

たとえば、次の JSON オブジェクトは、以下に示すカラーランプを構成する色を指定しています。

],
  "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" }
]

個別値のカラーランプ

個別値のカラーランプは、個別値に基づいてグループ化されたフィーチャに適用される色の範囲を指定します。このカラーランプを構成する開始色、終了色、および中間色は、各色の赤、緑、青の値を定義するオブジェクトとして定義されます (16 進値または名前付きの色の値として色を記述することもできます)。

たとえば、次の JSON オブジェクトは、以下に示すカラーランプを構成する色を指定しています。

],
  "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] }
]

変更したデフォルトのシンボルとカラーランプのテスト

Esri Maps for IBM Cognos のレポート作成者および利用者がカスタムピクチャマーカーを使用できるかどうかを確認します。

注意:

ご使用の環境に複数の EM4C サーバーが含まれている場合は、必ず変更済みの symbols.json.txt ファイルを各サーバーにコピーしてから、テストを開始してください。

symbols.json.txt を保存して閉じます。
Web アプリケーションサーバーを再起動し、ブラウザーのキャッシュを消去します。
Esri Maps Designer で、マップ連動レポートのマップを構成します。
ポイント、ライン、およびポリゴンのデータをマップに追加します。カラーランプを変更した場合は、データのグループ化またはヒートマップの適用後に、カラーランプが想定どおりに適用されることを確認します。
これで、Esri Maps for IBM Cognos が変更済みのデフォルトシンボルおよびカラーマップを使用して、データをシンボル設定するようになりました。
マップを保存して閉じます。
レポートをプレビューして、変更済みのデフォルトシンボルおよびカラーランプが利用者モードで使用できることを確認します。

このトピックへのフィードバック

注意:

デフォルト シンボル定義の編集

注意:

塗りつぶしシンボル

注意:

ライン シンボル

マーカー シンボル

ヒント:

ヒート マップのカラー ランプ

クラス閾値のカラー ランプ

個別値のカラー ランプ

変更したデフォルトのシンボルとカラー ランプのテスト

注意:

In this topic

デフォルトシンボル定義の編集

ラインシンボル

マーカーシンボル

ヒートマップのカラーランプ

クラス閾値のカラーランプ

個別値のカラーランプ

変更したデフォルトのシンボルとカラーランプのテスト