Mapオブジェクト

次のオブジェクトは、mapAPIに直接関連しています。

マップ

マップオブジェクトには以下のプロパティがあります。

プロパティ 型 説明
sysmapid ID マップのID。

プロパティの動作:
- 読み取り専用
- 更新操作で 必須
height integer マップの高さ（ピクセル単位）。

プロパティの動作:
- 作成操作で 必須
name string マップの名前。

プロパティの動作:
- 作成操作で 必須
width integer マップの幅（ピクセル単位）。

プロパティの動作:
- 作成操作で 必須
backgroundid ID マップの背景として使用される画像のID。
expand_macros integer マップの設定時に、ラベル内のマクロを展開するかどうか。

指定可能な値:
0 - (デフォルト) マクロを展開しない;
1 - マクロを展開する。
expandproblem integer 問題が1件のみの要素について、問題のトリガーを表示するかどうか。

指定可能な値:
0 - 常に問題数を表示する;
1 - (デフォルト) 問題が1件のみの場合は問題のトリガーを表示する。
grid_align integer グリッドへの整列を有効にするかどうか。

指定可能な値:
0 - グリッドへの整列を無効にする;
1 - (デフォルト) グリッドへの整列を有効にする。
grid_show integer マップ上にグリッドを表示するかどうか。

指定可能な値:
0 - グリッドを表示しない;
1 - (デフォルト) グリッドを表示する。
grid_size integer マップグリッドのサイズ（ピクセル単位）。

サポートされる値: 20、40、50、75、100。

デフォルト: 50。
highlight integer アイコンのハイライト表示を有効にするかどうか。

指定可能な値:
0 - ハイライト表示を無効にする;
1 - (デフォルト) ハイライト表示を有効にする。
iconmapid ID マップで使用されるアイコンマップのID。
label_format integer 高度なラベルを有効にするかどうか。

指定可能な値:
0 - (デフォルト) 高度なラベルを無効にする;
1 - 高度なラベルを有効にする。
label_location integer マップ要素ラベルの位置。

指定可能な値:
0 - (デフォルト) 下;
1 - 左;
2 - 右;
3 - 上。
label_string_host string ホスト要素用のカスタムラベル。

プロパティの動作:
- label_type_host が "custom" に設定されている場合は 必須
label_string_hostgroup string ホストグループ要素用のカスタムラベル。

プロパティの動作:
- label_type_hostgroup が "custom" に設定されている場合は 必須
label_string_image string 画像要素用のカスタムラベル。

プロパティの動作:
- label_type_image が "custom" に設定されている場合は 必須
label_string_map string マップ要素用のカスタムラベル。

プロパティの動作:
- label_type_map が "custom" に設定されている場合は 必須
label_string_trigger string トリガー要素用のカスタムラベル。

プロパティの動作:
- label_type_trigger が "custom" に設定されている場合は 必須
label_type integer マップ要素ラベルのタイプ。

指定可能な値:
0 - ラベル;
1 - IPアドレス;
2 - (デフォルト) 要素名;
3 - ステータスのみ;
4 - なし。
label_type_host integer ホスト要素のラベルタイプ。

指定可能な値:
0 - ラベル;
1 - IPアドレス;
2 - (デフォルト) 要素名;
3 - ステータスのみ;
4 - なし;
5 - カスタム。
label_type_hostgroup integer ホストグループ要素のラベルタイプ。

指定可能な値:
0 - ラベル;
2 - (デフォルト) 要素名;
3 - ステータスのみ;
4 - なし;
5 - カスタム。
label_type_image integer ホストグループ要素のラベルタイプ。

指定可能な値:
0 - ラベル;
2 - (デフォルト) 要素名;
4 - なし;
5 - カスタム。
label_type_map integer マップ要素のラベルタイプ。

指定可能な値:
0 - ラベル;
2 - (デフォルト) 要素名;
3 - ステータスのみ;
4 - なし;
5 - カスタム。
label_type_trigger integer トリガー要素のラベルタイプ。

指定可能な値:
0 - ラベル;
2 - (デフォルト) 要素名;
3 - ステータスのみ;
4 - なし;
5 - カスタム。
markelements integer 最近ステータスが変更されたマップ要素をハイライト表示するかどうか。

指定可能な値:
0 - (デフォルト) 要素をハイライト表示しない;
1 - 要素をハイライト表示する。
severity_min integer マップに表示されるトリガーの最小深刻度。

サポートされるトリガー深刻度の一覧については、トリガーの severity プロパティ を参照してください。
show_unack integer 問題の表示方法。

指定可能な値:
0 - (デフォルト) すべての問題数を表示する;
1 - 未確認の問題数のみを表示する;
2 - 確認済みと未確認の問題数を別々に表示する。
userid ID マップの所有者であるユーザーのID。
private integer マップ共有のタイプ。

指定可能な値:
0 - 公開マップ;
1 - (デフォルト) 非公開マップ。
show_suppressed integer 抑制された問題を表示するかどうか。

指定可能な値:
0 - (デフォルト) 抑制された問題を非表示にする;
1 - 抑制された問題を表示する。

マップ要素

マップ要素オブジェクトは、マップ上に表示されるオブジェクトを定義します。
このオブジェクトには、以下のプロパティがあります。

Property Type Description
selementid ID マップ要素のID。

プロパティの動作:
- 読み取り専用
elements array 要素データオブジェクト。

プロパティの動作:
- elementtype が "host"、"map"、"trigger"、または "host group" に設定されている場合は 必須
elementtype integer マップ要素のタイプ。

指定可能な値:
0 - ホスト;
1 - マップ;
2 - トリガー;
3 - ホストグループ;
4 - 画像。

プロパティの動作:
- 必須
iconid_off ID デフォルト状態で要素を表示するために使用される画像のID。

プロパティの動作:
- 必須
areatype integer ホストグループ内の個々のホストをどのように表示するか。

指定可能な値:
0 - (デフォルト) ホストグループ要素がマップ全体を占有する;
1 - ホストグループ要素が固定サイズになる。
elementsubtype integer ホストグループ要素をマップ上でどのように表示するか。

指定可能な値:
0 - (デフォルト) ホストグループを単一の要素として表示する;
1 - グループ内の各ホストを個別に表示する。
evaltype integer マップ要素タグのフィルタ条件の評価方法。

指定可能な値:
0 - (デフォルト) And/Or;
2 - Or。
height integer 固定サイズのホストグループ要素の高さ（ピクセル単位）。

デフォルト: 200。
iconid_disabled ID 無効なマップ要素を表示するために使用される画像のID。

プロパティの動作:
- elementtype が "host"、"map"、"trigger"、または "host group" に設定されている場合に サポート
iconid_maintenance ID メンテナンス中のマップ要素を表示するために使用される画像のID。

プロパティの動作:
- elementtype が "host"、"map"、"trigger"、または "host group" に設定されている場合に サポート
iconid_on ID 障害のあるマップ要素を表示するために使用される画像のID。

プロパティの動作:
- elementtype が "host"、"map"、"trigger"、または "host group" に設定されている場合に サポート
label string 要素のラベル。
label_location integer マップ要素ラベルの位置。

指定可能な値:
-1 - (デフォルト) デフォルトの位置;
0 - 下;
1 - 左;
2 - 右;
3 - 上。
permission integer 権限レベルのタイプ。

指定可能な値:
-1 - なし;
2 - 読み取り専用;
3 - 読み書き。
sysmapid ID 要素が属するマップのID。

プロパティの動作:
- 読み取り専用
urls array マップ要素のURL。

マップ要素URLオブジェクトについては、以下で詳しく説明しています。
use_iconmap integer ホスト要素に対してアイコンマッピングを使用するかどうか。

指定可能な値:
0 - アイコンマッピングを使用しない;
1 - (デフォルト) アイコンマッピングを使用する。
viewtype integer ホストグループ要素の配置アルゴリズム。

指定可能な値:
0 - (デフォルト) グリッド。
width integer 固定サイズのホストグループ要素の幅（ピクセル単位）。

デフォルト: 200。
x integer 要素のX座標（ピクセル単位）。

デフォルト: 0。
y integer 要素のY座標（ピクセル単位）。

デフォルト: 0。

マップ要素 ホスト

マップ要素のホストオブジェクトは、1つのホスト要素を定義します。

プロパティ Type 説明
hostid ID ホストのID。

マップ要素 ホストグループ

マップ要素のホストグループオブジェクトは、1 つのホストグループ要素を定義します。

プロパティ Type 説明
groupid ID ホストグループの ID。

マップ要素 Map

マップ要素のMapオブジェクトは、1つのマップ要素を定義します。

プロパティ Type 説明
sysmapid ID マップのID。

マップ要素 トリガー

マップ要素のトリガーオブジェクトは、1つ以上のトリガー要素を定義します。

プロパティ Type 説明
triggerid ID トリガーのID。

マップ要素タグ

マップ要素タグオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
tag string マップ要素のタグ名。

プロパティの動作:
- 必須
operator integer マップ要素タグ条件の演算子。

使用可能な値:
0 - (デフォルト) 含む;
1 - 等しい;
2 - 含まない;
3 - 等しくない;
4 - 存在する;
5 - 存在しない。
value string マップ要素のタグ値。

マップ要素URL

マップ要素URLオブジェクトは、特定のマップ要素で利用可能なクリック可能なリンクを定義します。次のプロパティがあります。

プロパティ 型 説明
sysmapelementurlid ID マップ要素URLのID。

プロパティの動作:
- 読み取り専用
name string リンクのキャプション。

プロパティの動作:
- 必須
url string リンクURL。

プロパティの動作:
- 必須
selementid ID URLが属するマップ要素のID。

マップリンク

マップリンクオブジェクトは、2つのマップ要素間のリンクを定義します。以下の プロパティがあります。

プロパティ Type 説明
linkid ID マップリンクのID。

プロパティの動作:
- 読み取り専用
selementid1 ID 一方の端でリンクされる最初のマップ要素のID。

プロパティの動作:
- 必須
selementid2 ID もう一方の端でリンクされる最初のマップ要素のID。

プロパティの動作:
- 必須
color string 16進数のカラーコードで表した線の色。

デフォルト: 000000。
drawtype integer リンク線の描画スタイル。

指定可能な値:
0 - (デフォルト) 実線;
2 - 太線;
3 - 点線;
4 - 破線。
label string リンクラベル。
linktriggers array リンクのステータスインジケーターとして使用するマップリンクトリガー。

マップリンクトリガーオブジェクトについては、以下で詳しく説明しています。
permission integer 権限レベルの種類。

指定可能な値:
-1 - なし;
2 - 読み取り専用;
3 - 読み書き。
sysmapid ID このリンクが属するマップのID。

マップリンクトリガー

マップリンクトリガーオブジェクトは、トリガーの状態に基づくマップリンクのステータスインジケーターを定義します。 このオブジェクトには、以下のプロパティがあります。

Property Type Description
linktriggerid ID マップリンクトリガーのID。

Property behavior:
- read-only
triggerid ID リンクインジケーターとして使用されるトリガーのID。

Property behavior:
- required
color string 16進数のカラーコードによるインジケーターの色。

デフォルト: DD0000。
drawtype integer インジケーターの描画スタイル。

指定可能な値:
0 - (default) 実線;
2 - 太線;
3 - 点線;
4 - 破線。
linkid ID このリンクトリガーが属するマップリンクのID。

マップURL

マップURLオブジェクトは、マップ上の特定のタイプのすべての要素で利用可能な、クリック可能なリンクを定義します。以下のプロパティがあります。

Property Type Description
sysmapurlid ID マップURLのID。

プロパティの動作:
- 読み取り専用
name string リンクのキャプション。

プロパティの動作:
- 必須
url string リンクURL。

プロパティの動作:
- 必須
elementtype integer URLが利用可能になるマップ要素のタイプ。

サポートされているタイプの一覧については、マップ要素のtypeプロパティを参照してください。

デフォルト: 0。
sysmapid ID URLが属するマップのID。

マップユーザー

ユーザーに基づくマップ権限の一覧です。次のプロパティがあります。

プロパティ Type 説明
sysmapuserid ID マップユーザーのID。

Property behavior:
- read-only
userid ID ユーザーのID。

Property behavior:
- required
permission integer 権限レベルの種類。

指定可能な値:
2 - 読み取り専用;
3 - 読み書き可能。

Property behavior:
- required

マップユーザーグループ

ユーザーグループに基づくマップ権限の一覧です。以下の プロパティがあります。

プロパティ Type 説明
sysmapusrgrpid ID マップユーザーグループのID。

Property behavior:
- read-only
usrgrpid ID ユーザーグループのID。

Property behavior:
- required
permission integer 権限レベルの種類。

指定可能な値:
2 - 読み取り専用;
3 - 読み取り/書き込み。

Property behavior:
- required

マップ図形

マップ図形オブジェクトは、マップ上に表示される幾何学図形（テキストあり/なし）を定義します。
このオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
sysmap_shapeid ID マップ図形要素のID。

プロパティの動作:
- 読み取り専用
type integer マップ図形要素のタイプ。

指定可能な値:
0 - 長方形;
1 - 楕円。

新しい図形を作成する場合、このプロパティは必須です。

プロパティの動作:
- 必須
x integer 図形のX座標（ピクセル単位）。

デフォルト: 0。
y integer 図形のY座標（ピクセル単位）。

デフォルト: 0。
width integer 図形の幅（ピクセル単位）。

デフォルト: 200。
height integer 図形の高さ（ピクセル単位）。

デフォルト: 200。
text string 図形のテキスト。
font integer 図形内のテキストのフォント。

指定可能な値:
0 - Georgia, serif
1 - "Palatino Linotype", "Book Antiqua", Palatino, serif
2 - "Times New Roman", Times, serif
3 - Arial, Helvetica, sans-serif
4 - "Arial Black", Gadget, sans-serif
5 - "Comic Sans MS", cursive, sans-serif
6 - Impact, Charcoal, sans-serif
7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif
8 - Tahoma, Geneva, sans-serif
9 - "Trebuchet MS", Helvetica, sans-serif
10 - Verdana, Geneva, sans-serif
11 - "Courier New", Courier, monospace
12 - "Lucida Console", Monaco, monospace

デフォルト: 9。
font_size integer フォントサイズ（ピクセル単位）。

デフォルト: 11。
font_color string フォントの色。

デフォルト: 000000。
text_halign integer テキストの水平方向の配置。

指定可能な値:
0 - 中央;
1 - 左;
2 - 右。

デフォルト: 0。
text_valign integer テキストの垂直方向の配置。

指定可能な値:
0 - 中央;
1 - 上;
2 - 下。

デフォルト: 0。
border_type integer 枠線のタイプ。

指定可能な値:
0 - なし;
1 - —————;
2 - ·····;
3 - - - -。

デフォルト: 0。
border_width integer 枠線の幅（ピクセル単位）。

デフォルト: 0。
border_color string 枠線の色。

デフォルト: 000000。
background_color string 背景色（塗りつぶし色）。

デフォルト: (空)。
zindex integer すべての図形および線の順序付けに使用される値（z-index）。

デフォルト: 0。

マップの線

マップの線オブジェクトは、マップ上に表示される線を定義します。
このオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
sysmap_shapeid ID マップ図形要素のID。

プロパティの動作:
- 読み取り専用
x1 integer 線のポイント1のX座標（ピクセル単位）。

デフォルト: 0。
y1 integer 線のポイント1のY座標（ピクセル単位）。

デフォルト: 0。
x2 integer 線のポイント2のX座標（ピクセル単位）。

デフォルト: 200。
y2 integer 線のポイント2のY座標（ピクセル単位）。

デフォルト: 200。
line_type integer 線の種類。

使用可能な値:
0 - なし;
1 - —————;
2 - ·····;
3 - - - -。

デフォルト: 0。
line_width integer 線の幅（ピクセル単位）。

デフォルト: 0。
line_color string 線の色。

デフォルト: 000000。
zindex integer すべての図形および線の順序付けに使用される値（z-index）。

デフォルト: 0。