A.1 HP OMUメッセージのXML書式

例A-1は、HP OMUでの新規メッセージの作成にHP OMU Webサービスで必要とされる書式を表しています。更新リクエストの書式も、ルート・ノードが作成されるかわりに更新される点を除いて同じです。

例A-1 HP OMU Webサービスの作成書式のサンプル

<iwaveaf:create xmlns:iwaveaf="http://iwavesoftware.com/services/
   adapter-framework">
      <event>
 
        <summary></summary>
 
        <urgency></urgency>
 
        <resolvedBy></resolvedBy>
 
        <identifier></identifier>
 
        <group>
          <name></name>
        </group>
 
        <object>
          <displayName></displayName>
        </object>
 
        <source>
          <computerName></computerName>
        </source>
 
        <extended-fields>
          <!-- OMU Application -->
          <string-field name="application">
            <xsl:value-of select="a:TargetType"/>
          </string-field>
          <!-- Do not add CMA data -->
          <string-field name="ovo_ts_field">NONE</string-field>
          <!-- Own the event after it is created -->
          <string-field name="own">true</string-field>
        </extended-fields>

A.1.1 XML書式とメッセージ・フィールド名とのマッピング

表A-1は、HP Operations Managerメッセージ・フィールド名とHP Operations Manager Webサービスで使用されるXML書式とのマッピングを示しています。HP Operations Managerメッセージ属性を設定するには、HP Operations Manager Webサービスに提示するXMLドキュメントに対応するフィールドが設定されている必要があります。これには、表5-1に示した適切な変換ファイルでの処理が必要です。

表A-1 メッセージ属性とXMLパス・マッピング

HP Operations Managerメッセージ属性	XMLパス
Message No.	/create/event/type
Message Text	/create/event/summary
Message Type	/create/event/type
Severity	/create/event/urgency
No. of Duplicates	/create/event/repeatCount
Owned By	/create/event/owner
Time Created	/create/event/createDate
Time Acknowledged	/create/event/resolvedDate
Acknowledged By	/create/event/resolvedBy
Message Group	/create/event/group/name
Object	/create/event/object/displayName
Source	/create/event/source/name
Application	/create/event/source/name
Node	次の「拡張フィールド」を参照。
CMAフィールド	次の「拡張フィールド」を参照。

A.1.2 拡張フィールド

拡張フィールドは、拡張フィールド・ノードの子である<string-field/>要素として定義されます。拡張フィールドの名前はname属性で指定され、このフィールドの値は要素の値として指定されます。

いくつかの予約拡張フィールド名は、別の方法で処理されます。予約フィールド名を、その処理の説明とともに次に示します。

• application - HP Operations Managerアプリケーション属性用に予約。このフィールドに指定された値は、HP Operations Managerメッセージの作成または更新時にapplicationフィールドの設定に使用されます。

• disown - HP Operations Managerエージェントの動作を変更します。デフォルトでは、メッセージの作成に使用されたHP Operations Managerアカウントは、所有者として残ります。このフィールドをtrueに設定することにより、メッセージは作成後に所有が解除されます。

• ovo_ts_field - トランザクション・ループバックを防止します。常にNONEに設定する必要があります。

その他の拡張フィールド名を指定すると、メッセージにカスタム・メッセージ属性(CMA)フィールドが追加されます。Name属性のCMAフィールドの名前を指定し、要素の値を指定します。

注意:

CMAフィールドを追加すると、オーバーヘッドの原因になります。多数のCMAフィールドを追加しようとする場合、パフォーマンスに多少影響が出る可能性があります。