アラーム フィールド、REST の例、および属性マッピング

casp1032jp
Spectrum アラーム フィールド
デフォルトで、CA Spectrum をサードパーティの Service Desk アプリケーションと統合するための拡張統合フレームワークは、すべての Service Desk との通信にポーリング メカニズムを使用します。
以下の CA Spectrum アラーム モデル フィールドのデータが Service Desk に渡され、インシデントが作成されます。 
  • サマリ
  • reportedByUserID
  • 重大度
  • Alarm_Status
  • assetID
  • TroubleShooter
  • Creation_Date
  • ModifiedTime
  • affectedEndUserID
  • 解決方法
CA Spectrum アラーム モデル フィールドからインシデント フィールドへのマッピング
以下の REST API は、上記の CA Spectrum アラーム モデル フィールドからインシデント フィールドへのマッピングを返します。
URL
サンプル:
 http://<CA Spectrum host name>:<CA spectrum port>/ca-nim-sm/api/v2/config/integration/caspectrum/mapping/incident
メソッド
GET
要求ボディ
なし
Headers
Authorization:
 Basic bmltYWRtaW46bmltYWRtaW4=
 
Accept:
 application/json
 
Content-type:
 application/json
レスポンス
 [
  {
    "NIMField": "reportedByUserID",
    "MDRField": "reportedByUserID",
    "Description": "UserName or ID of the user who reported the Incident"  
},
  {
   "NIMField": "name",
    "MDRField": "summary",
    "Description": "short description of the Incident"
},
  {
   "NIMField": "severity",
    "MDRField": "severity",
    "Description": "Severity of the Incident"
  },
  {
    "NIMField": "description",
    "MDRField": "description",
    "Description": "Description of the Incident"
  },
  {
    "NIMField": "status",
    "MDRField": "alarmStatus",
    "Description": "Status of the Incident"
  },
  {
    "NIMField": "affectedCIID",
    "MDRField": "assetID",
    "Description": "CI on which Incident is created"
  },
  {
    "NIMField": "assigneeUserID",
    "MDRField": "troubleShooter",
    "Description": "User to which the incident is assigned"
  },
  {
    "NIMField": "creationTimeStamp",
    "MDRField": "creationDate",
    "Description": "Time at which the incident is created/opened"
  },
  {
    "NIMField": "updatedTimeStamp",
    "MDRField": "modifiedTime",
    "Description": "Last updated time stamp for the incident"
  },
  {
    "NIMField": "affectedEndUserID",
    "MDRField": "affectedEndUserID",
    "Description": "UserName or ID of the user impacted by the Incident"
  },
  {
    "NIMField": "resolution",
    "MDRField": "resolution",
    "Description": "Describes the resolution of the incident"
  }
  ]
インシデント フィールドと Service Desk インシデントのマッピング
統合インシデントと Service Desk インシデント間のフィールド マッピングを表示するには、以下の REST API を使用します。
URL
一般:
 http://<serverhost>:<serverport>/ca-nim-sm/api/<version>/config/integration/<mdrName>/mapping/<ciName>
サンプル: 
http://<Spectrum_OC_Host>:<OC_Port>
/ca-nim-sm/api/v2/config/integration/<service_desk_id>/mapping/incident
メソッド
GET
要求ボディ
なし
Headers
Authorization:
 Basic bmltYWRtaW46bmltYWRtaW4=
 
Accept:
 application/json
 
Content-type:
 application/json
標準化されたインシデントと ServiceNow インシデント フィールド間のマッピングを表示するには、以下の REST API を呼び出す必要があります。
http://<CA
 Spectrum host name>:<CA Spectrum port>/ca-nim-sm/api/v2/config/integration/<service_desk_id>/mapping/incident
ログ レベルの確認 
以下の REST API を使用して、統合コンポーネントのログ レベルを取得します。 
URL
一般:
 http://<serverhost>:<serverport>/ca-nim-sm/api/<version>/Loglevel
メソッド
GET
要求ボディ
なし
Headers
Authorization:
 Basic bmltYWRtaW46bmltYWRtaW4=
 
Accept:
 application/json
 
Content-type:
 application/json
レスポンス
[
  {
    "name": "root",
    "level": "INFO"
  },
  {
    "name": "cacsm",
    "level": "INFO"
  },
  {
    "name": "omodule",
    "level": "INFO"
  },
  {
    "name": "oapi",
    "level": "INFO"
  },
  {
    "name": "resources",
    "level": "INFO"
  },
  {
    "name": "model",
    "level": "INFO"
  },
  {
    "name": "HPServiceManager",
    "level": "INFO"
  },
  {
    "name": "common",
    "level": "INFO"
  },
  {
    "name": "configuration",
    "level": "INFO"
  },
  {
    "name": "com.ca.integration.normalization.mdr.ca.cmdb",
    "level": "INFO"
  {
    "name": "BMCRemedy",
    "level": "INFO"
  },
  {
    "name": "im",
    "level": "INFO"
  },
  {
    "name": "ServiceNow",
    "level": "INFO"
  },
  {
    "name": "CASDM",
    "level": "INFO"
  }
]
デバッグする統合コンポーネントの Loglevel の有効化
以下の REST API を使用して、特定の統合コンポーネントのレベルを設定します。 
URL
一般:
 http://<serverhost>:<serverport>/ca-nim-sm/api/<version>/Loglevel/<name>
メソッド
PUT
要求ボディ
なし
Headers
Authorization:
 Basic bmltYWRtaW46bmltYWRtaW4=
 
Accept:
 application/json
 
Content-type:
 application/json
ペイロード
{
 "name": "common",
 "level": "DEBUG"
}
レスポンス
{
 "name": "common",
 "level": "DEBUG"
}
属性マッピング
以下の表では、CA Spectrum (アラームおよびインシデント)とサポートされている Service Desk アプリケーション間の属性マッピングを示しています。 
CA Spectrum または設定済みの Service Desk からのこれらの属性に行われた更新が変更され、ポーリングやユーザが設定した OneClick 通知メカニズムに基づいて他方に反映されます。
注:
 プッシュ メカニズムによる OneClick 通知は、ServiceNow でのみ有効化され、サポートされてます。デフォルトで、CA Spectrum は更新のために Service Desk サーバをポーリングします。
アラーム フィールド名
インシデント フィールド名
MDR フィールド名
CACSM
ServiceNow
HPSM
BMC Remedy ITSM
reportedByUserID
reportedByUserID
RequesterID
opened_by
 
サブミット元
サマリ
名前
Description
short_description
タイトル
Description
重大度
severity
重大度
severity
 
 
説明
説明
DescriptionLong
説明
Description
詳細説明
Alarm_Status
status
TicketStatus
状態
Status
Status
assetID
affectedCIID
RelatedCI
cmdb_ci
AffectedCI
 
トラブルシュータ
assigneeUserID
AssignedContactID
assigned_to
Assignee
担当者ログイン ID
Creation_Date
creationTimeStamp
CreationTimeStamp
opened_at
OpenTime
サブミット日
ModifiedTime
updatedTimeStamp
LastModTimeStamp
sys_updated_on
UpdatedTime
最終変更日
affectednEnduserID
affectednEnduserID
RequestedForID
caller_id
TicketOwner
 
解決方法
解決方法
間隔
close_notes
対策
間隔