Oracle Enterprise Manager Connectors統合ガイド

12cリリース2 (12.1.0.2)

B70511-02(原本部品番号:E25163-02)

目次

例一覧

図一覧

表一覧

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 ヘルプ・デスク・コネクタの作成

- 概要

- チケッティング・コネクタの作成

- コネクタ記述子ファイルの定義

- サービス定義

- テンプレート定義

- テンプレート登録

- コネクタのパッケージおよびデプロイ

2 イベント・コネクタの作成

- 概要

- イベント・コネクタの作成

- コネクタ記述子ファイルの定義

- サービス定義

- テンプレート定義

- テンプレート登録

- コネクタのパッケージおよびデプロイ

3 データ交換コネクタの作成

- 概要

- Enterprise Managerと外部管理システム

- データ転送頻度のオプションおよびモード

- データ交換の概念

- データ交換ハブ

- インバウンド・データ交換セッション

- アウトバウンド・データ交換セッション

- 正規化されたメッセージ形式

- 非正規化されたメッセージ形式

- メッセージ・スキーマ

- データソース

- 平均データ

- データ交換コネクタの設定

- データ交換ハブの作成

- サードパーティのJMSサーバーをデータ交換ハブとして使用

- アウトバウンド・データ交換セッションの作成

- アウトバウンドJMS宛先

- アウトバウンド・メッセージ・スキーマ

- 正規化されたメッセージ形式

- 非正規化されたメッセージ形式

- アウトバウンド・セッション・メッセージ・パラメータのチューニング

- インバウンド・データ交換セッションの作成

- インバウンドJMS宛先

- インバウンド・メッセージ・スキーマ

- インバウンド・インジケータ・スキーマ

- メッセージ・セマンティクス

- インバウンド・アラート・スキーマ

- Enterprise ManagerとOBAMの統合

- サポートされているバージョン

- Enterprise ManagerからOBAMへのデータ・フローの設定

- アウトバウンド・セッション用のOBAMアーティファクトのインポート

- JNDIの更新

- OBAMからEnterprise Managerへのデータ・フローの設定

- エンド・ツー・エンド・フロー

- OC4Jをデータ交換ハブとして使用する方法

- ヒントおよびトラブルシューティング情報

- データ交換ハブの接続エラー

- 通知メソッドおよび通知ルール

- データ・フローのヒント

- ログ・ファイル

- エンド・ツー・エンド・フローのサンプル・デモ

- 参考文献

4 参照表

- リクエスト属性

- Windowsプラットフォームでのレスポンス・ファイル・プロパティ

- sl_OHPartitionsAndSpace_valueFromDlgプロパティ

- ret_PrivIntrListプロパティ

- 問合せ可能なプロパティ

- 複合レスポンス・プロパティ

- ステータス・コード

A チケッティング・コネクタのサンプル

B エラー・メッセージおよびデバッグ

- エラー・メッセージ

- デバッグ

- デバッグ・オプションの指定

- デバッグ・メッセージの表示

C MOMイベント・コネクタのサンプル

用語集

索引

例一覧

- 3-1 アウトバウンド・セッション・メッセージ・パラメータのチューニングのコマンド構文

- 3-2 データソースの使用例

- A-1 connectorDeploy.xml

- A-2 getTicket_request.xml

- A-3 getTicket_response.xsl

- A-4 createTicket_response.xsl

- A-5 Remedy_DefaultCategory.xsl

- A-6 Remedy_DefaultAutoClose.xsl

- A-7 Remedy_DefaultAutoResolve.xsl

- A-8 connectorDeploy.xsd

- A-9 EMIncident.xsd

- A-10 connectorCommon.xsd

- A-11 createTicket_response.xsd

- A-12 getTicket_response.xsd

- A-13 publishTicket.xsd

- C-1 connectorDeploy.xml

- C-2 setup_request.xml

- C-3 setup_response.xsl

- C-4 initialize_request.xml

- C-5 uninitialize_request.xml

- C-6 cleanup_request.xml

- C-7 createEvent_request.xsl

- C-8 createEvent_response.xsl

- C-9 updateEvent_request.xsl

- C-10 updateEvent_response.xsl

- C-11 connectorDeploy.xsd

- C-12 EMEvent.xsd

- C-13 connectorCommon.xsd

- C-14 EMEventResponse.xsd

- C-15 setupResponse.xsd

- C-16 initializeResponse.xsd

- C-17 uninitialize_response.xsd

図一覧

- 3-1 データ交換アーキテクチャ

- 3-2 XMLソース文書のXSLT変換

表一覧

- 1-1 メタデータ・ファイルのカテゴリ

- 1-2 コネクション記述子メタデータの詳細

- 1-3 チケット実装

- 1-4 Enterprise Managerイベント・コネクタのスキーマ定義

- 1-5 サンプル・テンプレート・ファイル

- 1-6 自己更新ユーティリティのオプション

- 1-7 コネクタ・アーカイブ・コマンドのオプション

- 2-1 コネクション記述子メタデータの詳細

- 2-2 コネクタ・サービス操作

- 2-3 イベント・コネクタ・テンプレートXSD

- 2-4 サンプル・テンプレート・リスト

- 2-5 自己更新マニフェスト・ファイルの属性

- 2-6 自己更新ユーティリティのオプション

- 2-7 コネクタ・アーカイブ・コマンドのオプション

- 3-1 Enterprise Managerと外部管理システム間のデータ交換

- 3-2 コンテキスト・ファクトリ名

- 3-3 ターゲットのJMS宛先

- 3-4 メトリックのJMS宛先

- 3-5 RAWまたは平均メトリック・データのJMS宛先

- 3-6 RAWまたは平均ターゲット・ステータスのJMS宛先

- 3-7 セキュリティ・フィルタのJMS宛先

- 3-8 アラート・データのJMS宛先

- 3-9 RAWまたは平均SLAデータのJMS宛先

- 3-10 RAWデータと履歴データ

- 3-11 正規化されたターゲット・メッセージ

- 3-12 正規化されたメトリック・メッセージ

- 3-13 正規化されたセキュリティ・フィルタ・メッセージ

- 3-14 正規化されたメトリック・データ・メッセージ

- 3-15 正規化されたアラート・メッセージ

- 3-16 正規化されたターゲット可用性メッセージ

- 3-17 正規化されたターゲットSLAメッセージ

- 3-18 非正規化されたメトリック・データ・メッセージ

- 3-19 非正規化されたアラート・メッセージ

- 3-20 非正規化されたターゲット可用性メッセージ

- 3-21 非正規化されたターゲットSLAメッセージ

- 3-22 チューニング可能なアウトバウンド・セッション・メッセージ・パラメータ

- 3-23 EM-BAMデータ・オブジェクト

- 3-24 EM-BAM EMS定義

- 3-25 EM-BAMリンク計画

- 4-1 setModelリクエストの要素

- 4-2 リクエスト・ヘッダーの要素

- 4-3 RACの作成のプロパティ

- 4-4 ノードの追加のプロパティ(記憶域および集計ターゲット)

- 4-5 ノードの追加のプロパティ(新規ノード)

- 4-6 ノードの追加のプロパティ(任意の既存ノード)

- 4-7 ノードの削除のプロパティ(残りのノード)

- 4-8 一般ターゲットのプロパティ

- 4-9 Oracleデータベースのプロパティ

- 4-10 Oracleリスナーのプロパティ

- 4-11 ホスト・ターゲットのプロパティ

- 4-12 クラスタのプロパティ

- 4-13 クラスタ・データベースのプロパティ

- 4-14 Oracle Enterprise Managerエージェントのプロパティ

- 4-15 Oracle Enterprise Managerリポジトリのターゲット・プロパティ

- 4-16 ジョブのプロパティ

- 4-17 Oracle管理サービス(OMS)の複合プロパティ

- 4-18 データベース・インスタンスの複合プロパティ

- 4-19 Enterprise Managerのステータス・コード

- 4-20 ジョブ・ステータス・コード

- B-1 メッセージ・タイプおよび対応するコード名

Oracle Enterprise Manager

Connectors統合ガイド

12cリリース2 (12.1.0.2)

B70511-02(原本部品番号:E25163-02)

2012年10月

Oracle Enterprise Manager Connectors統合ガイド, 12c リリース2 (12.1.0.2)

B70511-02

Copyright © 2012 Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracleおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

ここでは、次の項目について説明します。

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

対象読者

Oracle Enterprise Manager統合ガイドは、他の管理システムとEnterprise Managerを統合するシステム・インテグレータを対象にしています。

注意:
このマニュアルの最新バージョンは、Oracle Enterprise Managerオンライン・ドキュメント・セットの「Extensibility」ページにアクセスしてください。

http://www.oracle.com/pls/em121/homepage

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

このドキュメントおよび他のOracle Enterprise Managerドキュメントの最新バージョンは、次のURLを参照してください。

http://www.oracle.com/technetwork/documentation/

Oracle Enterprise Managerは、詳細なオンライン・ヘルプも提供しています。オンライン・ヘルプ・システムを表示するには、Oracle Enterprise Managerの任意のページで「ヘルプ」をクリックします。

印刷されたマニュアルは次のURLのOracle Storeで入手できます。

http://oraclestore.oracle.com/

リリース・ノート、インストール関連ドキュメント、ホワイト・ペーパーまたはその他の関連ドキュメントは、OTN(Oracle Technology Network)から、無償でダウンロードできます。OTN-Jを使用するには、オンラインでの登録が必要です。登録は、次のWebサイトから無償で行えます。

http://www.oracle.com/technetwork/community/join/

すでにOTNのユーザー名およびパスワードを取得している場合は、次のURLでOTN Webサイトのドキュメントのセクションに直接接続できます。

http://www.oracle.com/technetwork/documentation/

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 ヘルプ・デスク・コネクタの作成

この章では、ヘルプ・デスク・コネクタを作成し、Enterprise Managerと統合するために必要な情報を提供します。この章の内容は次のとおりです。

- 概要

- チケッティング・コネクタの作成

- コネクタ記述子ファイルの定義

- サービス定義

- テンプレート定義

- テンプレート登録

- コネクタのパッケージおよびデプロイ

概要

Enterprise Manager Cloud Control 12cには、管理コネクタ・フレームワーク(コネクタ・フレームワークとも呼ばれる)が導入され、開発者はメタデータ(XMLおよびXSL)に基づいてヘルプ・デスク・コネクタを作成できます。

このフレームワークで作成されるヘルプ・デスク・コネクタには、次の機能が継承されます。

- 自動チケッティング: Enterprise Manager内でインシデントがトリガーされた場合は常に自動的にチケットをオープンまたは更新するよう、コネクタに記述できます。チケットが作成または更新されるようにインシデント・ルールを指定できます。

- 手動チケッティング: Enterprise Manager内のオープン・インシデントに基づき、Enterprise Managerコンソールから手動でチケットを作成できます。コネクタにより、インシデントおよびチケット・テンプレートに基づいて、チケットに詳細が移入されます。

ユーザー独自のヘルプ・デスク・システムでこれらのチケッティング機能を使用するには、一連のメタデータ・ファイルを提供する必要があります。表1-1にヘルプ・デスク・コネクタの作成に必要なメタデータ・ファイルのカテゴリを示します。

表1-1 メタデータ・ファイルのカテゴリ

カテゴリ

タイプ

説明

コネクタ記述子

XML

チケッティング・システムの統合をカスタマイズできます。このファイル内での構成UIページの作成方法をXMLで記述します。

チケット・リクエスト・テンプレート

XMLまたはXLS

イベントのコンテキスト内でのチケットの記入方法を記述します。チケット・テンプレートでは、XSL/XML言語で、チケットの作成および更新時のEnterprise Managerのインシデント・データ・フィールドから対応するチケット・データ・フィールドへのマッピングを説明してします。

レスポンス・テンプレート

XSL

チケッティング・システムWebサービスのレスポンス・データを、チケット・コネクタ・フレームワークに対応した形式に正規化します。

チケッティング・コネクタの作成

チケッティング・コネクタの作成は2ステップのプロセスで、デプロイメント記述子を作成し、データ管理用の適切なテンプレートを準備します。デプロイメント記述子には、次の情報が含まれます。

- Enterprise Managerで必要な基本構成パラメータ

- コネクタ・フレームワークが外部システムと通信する方法を定義する、Webサービスの仕様

- サービス・メソッドの仕様
サービス・メソッドは、メソッド名とWebサービス・エンドポイントをバインドするのに使用します。createTicket、updateTicketおよびgetTicketは、チケッティング・コネクタ用のサポートされているメソッド名です。

- テンプレート登録の仕様
テンプレートは、この要素に指定した情報に基づいて登録されます。コネクタ・デプロイメント記述子には、最大50個のテンプレート登録要素で構成されるオプションのリストを指定できます。

- SOAPヘッダー認証の仕様

注意:
コネクタ記述子の名前は、connectorDeploy.xmlにする必要があります。

コネクタ記述子ファイルの定義

コネクタ記述子XMLファイルを定義して、コネクタ・メタデータおよびコネクタの構成プロパティ(Webサービスのエンドポイントおよび認証スキーマなど)を記述します。

記述子を作成する際の重要な留意点は次のとおりです。

- コネクタ記述子ファイル名は、connectorDeploy.xmlにする必要があります。

- XMLファイルは、スキーマconnectorDeploy.xsdに準拠する必要があります。

リファレンス実装は、付録A「チケッティング・コネクタのサンプル」のサンプルconnectorDeploy.xmlを参照してください。

次の表では、conenctorDeploy.xsdの各セクションとその実行内容を説明します。

表1-2 コネクション記述子メタデータの詳細

メタデータ・セクション

説明

<SOAPHeaderAuthentication>
<Username required="true">
<VariableName>USERNAME</VariableName>
<DisplayName>Remedy Username</DisplayName>
</Username>
<Password>
<VariableName>PASSWORD</VariableName>
<DisplayName>Remedy Password</DisplayName>
</Password>
<AuthVariable>
<VariableName>AUTHENTICATION</VariableName>
<DisplayName>Authentication</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>LOCALE</VariableName>
<DisplayName>Locale</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>TIMEZONE</VariableName>
<DisplayName>Timezone</DisplayName>
</AuthVariable>
<SOAPHeader>
<![CDATA[
<urn:AuthenticationInfo xmlns:urn="urn:HelpDesk_Submit_Service">
<urn:userName>$USERNAME$</urn:userName>
<urn:password>$PASSWORD$</urn:password>
<urn:authentication>$AUTHENTICATION$</urn:authentication>
<urn:locale>$LOCALE$</urn:locale>
<urn:timeZone>$TIMEZONE$</urn:timeZone>
</urn:AuthenticationInfo>
]]>
</SOAPHeader>
</SOAPHeaderAuthentication>

(オプション)このセクションでは、外部システムWebサービスの認証スキーマを記述できます。

EMの「管理コネクタの構成」ページの認証セクションは、このセクションに基づいて生成されます。

ユーザー名、パスワードおよび追加のテキスト・フィールドは、このセクションに基づいて移入されます。

- <VariableName>タグで、WebサービスXML文書内の属性の名前がマーク付けされます。

- <DisplayName>タグで、対応するテキスト・ボックスのラベル付けの方法が記述されます。

<Name>Remedy Service Desk Connector</Name>
<Version>12.1.0.1.0</Version>
<EMCompatibleVersion>12.1.0.1.0</EMCompatibleVersion>
<Description>Remedy Integration with Enterprise Manager</Description>
<Category>TicketingConnector</Category>

コネクタ・タイプの名前要素値とバージョン要素値の組合せにより、EM内のコネクタ・インスタンスは一意に定義されるため、同一のものを定義する際には適切に配慮する必要があります。

EMCompatibleVersion要素は、<release specific value>と同等です。

たとえば、12Cリリースの場合は12.1.0.1.0です。

外部システム統合の要素カテゴリは、次の値のいずれかです。

EventConnector

TicketingConnector

この場合、値はTicketingConnectorになります。

<ConnectivityTestVariable>
<VariableName>TICKET_ID</VariableName>
<DisplayName>Ticket ID</DisplayName>
</ConnectivityTestVariable>

ConnectivityTestVaiableは、チケッティングの必須要素です。

定義した変数名は、初期構成ステップで接続を検証するためにgetTicketメソッドによって使用されます。

<ExternalURL>
<Pattern>
<![CDATA[http://$WEB_SERVER$/arsys/forms/$ARSERVER_NAME$/$FORM_NAME$/?qual=%27Incident%20Number*%27=%22@Incident_Number@%22]]>
</Pattern>
<ConfigVariable required="true">
<VariableName>WEB_SERVER</VariableName>
<DisplayName>Web Server</DisplayName>
</ConfigVariable>
<ConfigVariable required="true">
<VariableName>FORM_NAME</VariableName>
<DisplayName>HelpDesk Case Form Name</DisplayName>
</ConfigVariable>
<ConfigVariable required="true">
<VariableName>ARSERVER_NAME</VariableName>
<DisplayName>ARServer Name</DisplayName>
</ConfigVariable>
</ExternalURL>

このセクションでは、チケット・コネクタ・フレームワークを構成して独自のチケッティング・システムに対するチケットURLを作成できます。

<Pattern>タグの値には、URL文字列と、ARSERVER_NAME、FORM_NAME、WEB_SERVERなどのユーザー構成の変数をその文字列に挿入する方法が記述されます。

各<ConfigVariable>タグのWebconsoleセクションには、テキスト・ボックスとラベルのペアが挿入されます。(図1-2)

URLパターン文字列には、各ユーザー変数にユーザーが提供する値が適宜挿入されます。"X"というユーザー変数が存在する場合は、チケットURLが生成される際に、ユーザー入力値で"[X]"が置き換えられます。

<Service>
<Method>createTicket</Method>
<WebServiceEndpoint>
<![CDATA[http://[midtier_server]/arsys/services/ARService?server=[servername]&webService=HPD_IncidentInterface_Create_WS]]>
</WebServiceEndpoint>
</Service>
<Service>
<Method>updateTicket</Method>
<WebServiceEndpoint>
<![CDATA[http://[midtier_server]/arsys/services/ARService?server=[servername]&webService=HPD_IncidentInterface_WS]]>
</WebServiceEndpoint>
</Service>
<Service>
<Method>getTicket</Method>
<WebServiceEndpoint>
<![CDATA[http://[midtier_server]/arsys/services/ARService?server=[servername]&webService=HPD_IncidentInterface_get_WS]]>
</WebServiceEndpoint>
</Service>

このセクションで、チケッティング・システムWebサービス固有の構成を指定できます。

<WebServiceEndpoint>タグでは、デフォルトのWebサービス・エンドポイント文字列が「管理コネクタ」ページの「Webサービス」セクションに表示されるように記述されます。

メソッドでは、EM固有のサービス名の1つが定義されます。

SoapActionでは、外部システムで呼び出す必要がある操作が定義されます。

詳細は、「サービス定義」を参照してください。

<TemplateRegistration>
<FileName>getTicket_request.xml</FileName>
<InternalName>getTicket</InternalName>
<TemplateName>Get Ticket</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for getTicket method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>getTicket_response.xsl</FileName>
<InternalName>getTicket</InternalName>
<TemplateName>Get Ticket</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the response xsl file for getTicket method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>createTicket_response.xsl</FileName>
<InternalName>createTicket</InternalName>
<TemplateName>Create Ticket Reponse</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the create ticket response template. </Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>templates/Remedy_DefaultCategory.xsl</FileName>
<InternalName>Remedy_DefaultCategory.xsl</InternalName>
<TemplateName>Remedy Default Category </TemplateName>
<TemplateType>OutboundXSL</TemplateType>
<Description>This is the Remdy default category template. </Description>
</TemplateRegistration>

このセクションでは、コネクタ・テンプレートが追加されます。テンプレートには2つのタイプがあります。1.リクエスト・テンプレートおよび2.レスポンス・テンプレート(createTicketメソッドとgetTicketメソッド用)です。

詳細は、「テンプレート定義」を参照してください。

<SOAPHeaderAuthentication>
<Username required="true">
<VariableName>USERNAME</VariableName>
<DisplayName>Username</DisplayName>
</Username>
<Password>
<VariableName>PASSWORD</VariableName>
<DisplayName> Password</DisplayName>
</Password>
<AuthVariable>   <VariableName>AUTHENTICATION</VariableName>  <DisplayName>Authentication</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>LOCALE</VariableName>
<DisplayName>Locale</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>TIMEZONE</VariableName>
<DisplayName>Timezone</DisplayName>
</AuthVariable>
<SOAPHeader>
<![CDATA[
]]>
</SOAPHeader>
</SOAPHeaderAuthentication>

(オプション)このセクションでは、外部システムWebサービスの認証スキーマを記述できます。

EMの「管理コネクタの構成」ページの認証セクションは、このセクションに基づいて生成されます。

ユーザー名、パスワードおよび追加のテキスト・フィールドは、このセクションに基づいて移入されます。

<VariableName>タグで、WebサービスXML文書内の属性の名前がマーク付けされます。

<DisplayName>タグで、対応するテキスト・ボックスのラベル付けの方法が記述されます。

サービス定義

サポートされているイベント・コネクタ・サービス操作は次のとおりです。

- createTicket
外部システムでチケットを作成します。

- updateTicket
イベントの更新を外部システムに転送します。

- getTicket
Enterprise Managerとのチケット・コネクタの接続を検証するサービス・メソッドです。

コネクタ記述子でのサービス名は、前述で定義した名前と完全に一致する必要があり、大/小文字を区別します。

サービス設定の例を次に示します。

<Service>
<Method>createTicket</Method>
<WebServiceEndpoint>
<![CDATA[http://[midtier_server]/arsys/services/ARService?server=[servername]&webService=HPD_IncidentInterface_Create_WS]]></WebServiceEndpoint>
</Service>

テンプレート定義

テンプレートには、リクエストの送信時およびレスポンスの受信時に変換されるデータが含まれます。テンプレートは、Enterprise Managerの特定のサービス操作についてXMLまたはXSLファイルとして定義できます。

チケッティング・コネクタのテンプレート実装は、次のようにさらに分類できます。

表1-3 チケット実装

実装タイプ

説明

例

サービス・メソッド

これらのテンプレートは、定義されたサービス・メソッドにのみ適用できます。

<TemplateRegistration>
<FileName>getTicket_request.xml</FileName>
<InternalName>getTicket</InternalName>
<TemplateName>Get Ticket</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for getTicket method</Description>
</TemplateRegistration>
<TemplateRegistration>

デフォルト

これらのテンプレートは、createTicketまたはupdateTicketのいずれかのリクエスト・サービス・メソッドで使用できます。

<TemplateRegistration>
<FileName>templates/Remedy_DefaultCategory.xsl</FileName>
<InternalName>Remedy_DefaultCategory.xsl</InternalName>
<TemplateName>Remedy Default Category </TemplateName>
<TemplateType>OutboundXSL</TemplateType>
<Description>This is the Remdy default category template. </Description>
</TemplateRegistration>

テンプレートを定義するためのガイドラインは次のとおりです。

- メソッド固有のテンプレートには、メソッド名と同じ内部名(大/小文字を区別)が必要です。

- デフォルト・テンプレートには、任意の内部名を指定できます。

- テンプレート・タイプは次のとおりです。

InboundXSL for response xsl,
OutboundXSL for request xsl, and
OutboundXML for request xml

- テンプレート・ファイル名は重要ではありませんが、次の名前を使用することをお薦めします。

<methodName>_request.xml,
<methodName>_request.xsl, and
<methodName>_response.xsl.

テンプレート登録

テンプレート登録XMLまたはXSLのコーディングは、次の情報によって決まります。

- 定義された一連のスキーマ定義(XSD)

- ターゲット外部システムの属性

次の表に、Enterprise Managerイベント・コネクタのスキーマ定義を示します。

表1-4 Enterprise Managerイベント・コネクタのスキーマ定義

名前

説明

EMIncident.xsd

コネクタ・フレームワークによって使用可能になるEMインシデントを定義します。

ConnectorCommon.xsd

SourceObjInfoTypeなど、その他すべてのxsdで使用されるすべてのデータ型を定義します。

createTicket_response.xsd

createTicketおよびupdateTicketレスポンス用のレスポンス・スキーマです。

getTicket_response.xsd

getTicketメソッド用のレスポンス・スキーマです。

PublishTicket.xsd

publishTicketリクエスト操作用のスキーマです。

リクエスト・テンプレートを定義する際の重要なポイントは次のとおりです。

- getTicketサービスには、リクエストXMLテンプレート・ファイルの定義のみ必要です。
テンプレート・リクエストXMLは、渡される情報がコネクタ・テスト変数要素としてすでに定義されている場合に使用されます。コネクタ・テスト変数は、登録時にコネクタ・デプロイメント記述子XMLによって定義できます。

- createTicketサービスおよびupdateTicketサービスでは、コネクタ・デプロイメント記述子XMLによって定義されるデフォルトXSLテンプレート・ファイルが使用されます。
テンプレート・リクエストXSLは、Enterprise Manager内で生成されるイベント属性およびインシデント属性を使用してリクエストを生成する場合に使用されます。これらのリクエストには、Enterprise Manager内のイベント・オブジェクトおよびインシデント・オブジェクトとチケッティング・システムの属性とのマッピングが必要です。

- テンプレート・リクエストXSLの定義は、すでにリクエストXMLを定義している場合、オプションです。
原則として、このシナリオは必要ありません。

- EMIncident.xsdおよびEMEvent.xsdスキーマを使用すると、チケッティング・リクエストの作成時にマッピングで使用できるようにするEnterprise Managerのフィールドを決定できます。

レスポンス・テンプレートを定義する際の重要なポイントは次のとおりです。

- レスポンス・テンプレート(XSL)は、チケッティング・コネクタ・テンプレートXSD表に定義されているXSDに基づいて定義できます。

- テンプレート・レスポンスXSLはオプションです。
レスポンス変換(XSL)が定義されていない場合、外部システムによって返されるレスポンスXML内のデータはいずれも保持されません。外部システム・レスポンス・データに関係していない操作の場合、これは理想的な実装です。

- createTicketおよびupdateTicketサービスに対しては、createTicket_response.xsdスキーマを使用して外部システムからのレスポンスをEnterprise Managerが認識できるレスポンスに変換する方法を決定できます。

変換後、Enterprise Managerでは、<TicketId>が必要とされ、値に応じて適切なステータスが更新されます。

- Null以外
EMインシデント・マネージャ・グリッドで、インシデントが関連付けられたticketIdが保持され、適切なステータス・メッセージに注釈が付けられます。

- Null
EMインシデント・マネージャ・グリッドで、インシデントが関連付けられたエラー・メッセージに注釈が付けられます。

Remedy 7のチケッティング・コネクタ実装は、次のサンプル・テンプレート・ファイルを参照してください。

表1-5 サンプル・テンプレート・ファイル

サービス名

リクエストXSL

リクエストXML

レスポンスXSL

getTicket

オプション

getTicket_request.xml

getTicket_response.xsl

createTicket /updateTicket

Remedy_DefaultCategory.xsl

Remedy_DefaultAutoClose.xsl

Remedy_DefaultAutoResolve.xsl

該当なし

createTicket_response.xsl

コネクタのパッケージおよびデプロイ

コネクタをデプロイするために、Enterprise Managerでは自己更新機能が使用されます。この機能はコンソールからアクセスできますが、Enterprise Manager環境にコネクタをインポートするための機能です。コネクタをデプロイするには、次の手順を実行します。

1. コネクタjarファイルを準備します。
XMLおよびXSLテンプレート・ファイルをすべて1つの.jarファイルとしてパッケージします。

<name>_connector.jar
---> connectorDeploy.xml
--->template1.xml
--->template2.xsl
…..
…..
--->templateN.xsl

2. マニフェスト・ファイルを作成します。
自己更新マニフェスト・ファイルのキー属性は次のとおりです。

- EntityType
値はcore_connectorです。

- EntityTypeVersion
現行リリース・バージョンです。値は12.1.0.1.0です。

- Attribute @Name=connector_type
コネクタ・タイプ名です。

- Attribute @Name=connector_category
カテゴリ・タイプは、TicketingConnectorまたはEventConnectorです。

- ArchiveList
この要素には、コネクタ設定の一部であるアーカイブのリストが含まれます。一般に、コネクタjarは1つ存在しますが、特殊な実装の場合は追加のjar (アダプタまたはエージェント)が存在することがあります。このような場合、コネクタ固有のjarは定義リストの最初のjarである必要があります。これは必須要件です。

次の例に、connector_manifest.xmlファイルのコードを示します。

<EntityInstanceList xmlns="http://www.oracle.com/EnterpriseGridControl/SelfUpdateManifest">
<EntityInstance xmlns="http://www.oracle.com/EnterpriseGridControl/SelfUpdateManifest" EntityTypeVersion="11.2.0.1.0" EntityType="core_connector" Maturity="PRODUCTION" Vendor="Oracle" PluginID="oracle.sysman.core">
<Description>
<![CDATA[ BMC Remedy Service Desk Connector - 12.1.0.2.0
]]>
</Description>
<AttributeList>
<Version>12.1.0.2.0</Version>
<Attribute Name="connector_type" Value="Sample SCOM Connector" Label="Sample SCOM Connector" />
<Attribute Name="connector_category" Value="EventConnector" Label="Event Connector" />
</AttributeList>
<Readme>
<![CDATA[   Oracle Management Connector for SCOM integrates Oracle Enterprise Manager Cloud Control's proactive alert detect
ion and resolution features with BMC's Remedy 7.0 Service Desk capabilities to provide a seamless workflow for incident mana
gement and resolution.
Change Logs:
12.1.0.2.0
- Miscellaneous bug fixes
- Performance enhancements
]]>
</Readme>
<DependsOn />
<ArchiveList>
<Archive Filename="scomconnector.jar" IsMDS="false" />
<Archive Filename="SCOM_webservices_adapter.jar" IsMDS="false" />
</ArchiveList>
<CustomData>
<![CDATA[
]]>
</CustomData>
</EntityInstance>
</EntityInstanceList>

属性の詳細リストは、次の場所にある自己更新スキーマ定義を参照してください。

$ORACLE_HOME/sysman/emSDK/core/selfupdate/model/SelfUpdateManifest.xsd

3. emedkツールを構成します。
emedkツールは、EM UIから指示に従って構成できます。パスは、「設定」 > 「拡張性」 > 「開発キット」です。

4. 自己更新アーカイブを準備します。
これにはコネクタjarファイルおよびコネクタ用のマニフェスト・ファイルが必要です。自己更新を準備するには、次のユーティリティをコールして自己更新アーカイブ・ファイルを作成します。

edktool prepare_update
-manifest "manifest xml"
-archivedir "archives directory"
-out "output file or directory"
[-typexml "update type xml"]

表1-6に、ユーティリティで使用可能なオプションを示します。

表1-6 自己更新ユーティリティのオプション

オプション

説明

-manifest

更新が記述されている自己更新マニフェスト・ファイル。

-archivedir

マニフェスト・ファイルに指定されているアーカイブ・ファイルがあるディレクトリ。

-out

自己更新アーカイブのディレクトリまたはファイル名。ディレクトリが指定されている場合、ファイル名は自動生成されます。

-typexml

更新タイプxmlへのオプション・パス。

次の例では、マニフェスト・ファイル/u01/connector/connector_manifest.xmlに基づいて自己更新アーカイブを/u01/sarディレクトリに作成しています。connector_manifest.xmlで参照されるアーカイブは、ディレクトリ/u01/connector/archivesから取得されます。

edkUtil prepare_update
-manifest /u01/connector/connector1_manifest.xml
-archivedir /u01/connector/archives
-out  /u01/sar/sample_connector.zip

5. 次のemcliコマンドのいずれかをコールして、Enterprise Managerにコネクタ・アーカイブをインポートします。

edktool import_update
-file=\ file\
-omslocal

emcli import_update
-file=\ file\
-host=\ hostname\
[-credential_set_name=\ setname\ ] | -credential_name=\ name\  -credential_owner=\ owner\

これらのコマンドにより、自己更新アーカイブ・ファイルがEnterprise Managerにインポートされます。正常にインポートされると、更新が次のアクションを促す「ダウンロード」ステータスで自己更新ホームに表示されます。

表1-7に、このコマンドで使用可能なオプションを示します。

表1-7 コネクタ・アーカイブ・コマンドのオプション

オプション

説明

-file

更新アーカイブ・ファイルの完全なパス名

-omslocal

ファイルがOMSからアクセス可能であることを示すフラグ

-host

ファイルが使用可能なホスト・ターゲットのターゲット名

-credential_set_name

ホスト・ターゲットのリポジトリに格納されている優先資格証明のセット名。次のいずれかです。

- HostCredsNormal
デフォルト非特権資格証明セット

- HostCredsPriv
特権資格証明セット

-credential_name

リポジトリに格納されている名前付き資格証明の名前。このオプションは、-credential_ownerオプションとともに指定する必要があります。

-credential_owner

リポジトリに格納されている名前付き資格証明の所有者。このオプションは、-credential_nameオプションとともに指定する必要があります。

emcliコマンドの使用例をいくつか次に示します。

例1

ファイルsample_connector.zipをインポートします。ファイルは、OMSホストに存在している必要があります。複数のOMSが設定されている場合、リクエストはどのOMSでも処理できるため、ファイルはリクエストを処理するOMSからアクセスできる必要があります。通常、これは、すべてのOMSからアクセス可能な共有の場所にファイルを保存しておく必要があることを意味します。

emcli import_update
-file=\ /u01/sar/sample_connector.zip
-omslocal

例2

host1.example.comホストに存在するファイルsample_connector.zip.zipをインポートします。ホストは、Enterprise Managerの管理対象ホスト・ターゲットであり、このホストのエージェントは起動し実行中である必要があります。リモート・ファイルの取得には、ホストhost1.example.comの非特権優先資格証明が使用されます。

emcli import_update
-file=\ /u01/sar/sample_connector.zip
-host=\ host1.example.com\
-credential_set_name=\ HostCredsNormal\

例3

host1.example.comホストに存在するファイルsample_connector.zipをインポートします。ホストは、Enterprise Managerの管理対象ホスト・ターゲットであり、このホストのエージェントは起動し実行中である必要があります。リモート・ファイルの取得には、ユーザー\ admin1\が所有する名前付き資格証明\ host1_creds\が使用されます。

emcli import_update
-file=\ /u01/sar/sample_connector.zip\
-host=\ host1.example.com\
-credential_name=\ host1_creds\
-credential_owner=\ admin1\

6. 「自己更新」ホームページに移動します。
コネクタは「ダウンロード」と表示されます。

7. コネクタの行を選択し、「適用」をクリックしてコネクタをデプロイします。

2 イベント・コネクタの作成

この章では、イベント・コネクタを作成し、Enterprise Managerと統合するために必要な情報を提供しています。

この章は次の項で構成されています。

- 概要

- イベント・コネクタの作成

- コネクタ記述子ファイルの定義

- サービス定義

- テンプレート定義

- テンプレート登録

- コネクタのパッケージおよびデプロイ

概要

Enterprise Manager Cloud Control 12cには、管理コネクタ・フレームワーク(コネクタ・フレームワークとも呼ばれる)が導入され、開発者はメタデータ(XMLおよびXSL)に基づいてイベント・コネクタを作成できます。イベント・コネクタにより、Enterprise Managerは、外部システムに生成されたイベントを送信できます。

イベント・コネクタの作成には、次のメタデータ・カテゴリが必要です。

- コネクタ記述子XML
コネクタの定義をXML形式で提供します。

- リクエスト・テンプレートXMLまたはXSL
事前定義されたXMLテンプレートまたはXSLを使用して、EMイベントおよび外部システム属性の変換マッピングを提供します。

- レスポンス・テンプレートXSL
レスポンスを外部システムからEMデータ・モデルに変換します。

注意:
現行リリースでは、アウトバウンド操作(外部システムへのイベントの送信)のみがサポートされます。インバウンド(Enterprise Managerへの外部イベントのインポート)のサポートは、将来のリリースで検討される可能性があります。

イベント・コネクタの作成

イベント・コネクタの作成は2ステップのプロセスで、デプロイメント記述子を作成し、データ管理用の適切なテンプレートを準備します。コネクタ記述子には、次の情報が含まれます。

- Enterprise Managerで必要な基本構成パラメータ

- サービス・メソッドの仕様
サービス・メソッドは、コネクタ・フレームワークが外部システムと通信する方法を定義するWebサービス・エンドポイントとメソッド名をバインドするのに使用されます。

- テンプレート登録の仕様
テンプレートは、この要素に指定した情報に基づいて登録されます。コネクタ・デプロイメント記述子には、最大50個のテンプレート登録要素で構成されるオプションのリストを指定できます。

- SOAPヘッダー認証の仕様(オプション)

注意:
アップグレードの場合、すべての外部アラートはEnterprise Managerイベントとして12cに移行されるため、ターゲット・ページに表示されません。顧客は、ターゲット・ページに表示できるように、これらのイベントに対して手動でインシデントを作成する必要があります。
12cのフレッシュ・インストールの場合、インバウンド操作はサポートされていないため、外部イベントは生成されず、ターゲット・ページには何も表示されません。

コネクタ記述子ファイルの定義

コネクタ記述子XMLファイルを定義して、コネクタ・メタデータおよびコネクタの構成プロパティ(Webサービスのエンドポイントおよび認証スキーマなど)を記述します。

コンストラクタ記述子を作成する際の重要な留意点は次のとおりです。

- コネクタ記述子ファイル名は、connectorDeploy.xmlにする必要があります。

- XMLファイルは、スキーマconnectorDeploy.xsdに準拠する必要があります。

リファレンス実装は、付録C「MOMイベント・コネクタのサンプル」のサンプルconnectorDeploy.xmlを参照してください。次の表では、conenctorDeploy.xsdの各セクションとその実行内容を説明します。

表2-1 コネクション記述子メタデータの詳細

メタデータ・セクション

説明

<Name>Microsoft Operations Manager  Connector</Name>
<Version>12.1.0.1.0</Version>
<EMCompatibleVersion>12.1.0.1.0</EMCompatibleVersion>
<Description>Microsoft Operations Manager  Integration with Enterprise Manager</Description>
<Category>EventConnector</Category>
<ConfigVariable required="true">
<VariableName>SETUP_NAME</VariableName>
<DisplayName>MOM Registered Connector Name</DisplayName>
</ConfigVariable>
<ConfigVariable required="true">
<VariableName>RESOLUTION_STATE</VariableName>
<DisplayName>Resolution State</DisplayName>
</ConfigVariable>

コネクタ・タイプの名前要素値とバージョン要素値の組合せにより、EM内のコネクタ・インスタンスは一意に定義されるため、同一のものを定義する際には適切に配慮する必要があります。

EMCompatibleVersion要素は、<release specific value>と同等です。

たとえば、12Cリリースの場合は12.1.0.1.0です。

外部システム統合の要素カテゴリは、次の値のいずれかです。

EventConnector

TicketingConnector

この場合、値はEventConnectorになります。

ConnectivityTestVariable要素およびExternalURL要素は、イベント・コネクタに適用できません。

<Service>
<Method>cleanup</Method>
<WebServiceEndpoint>
<![CDATA[http://[server]:1271/ConnectorServiceV2.asmx]]>
</WebServiceEndpoint>
<SOAPAction>http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2/Cleanup</SOAPAction>
</Service>

メソッドでは、EM固有のサービス名の1つが定義されます。

Webサービス・エンドポイントでは、外部システムURLが定義されます。

SoapActionでは、外部システムで呼び出す必要がある操作が定義されます。

詳細は、「サービス定義」を参照してください。

<TemplateRegistration>
<FileName>setup_request.xml</FileName>
<InternalName>setup</InternalName>
<TemplateName>Setup</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for setup method</Description>
</TemplateRegistration>

テンプレート登録では、XMLまたはXSLテンプレートの定義が定義されます。

詳細は、「テンプレート定義」を参照してください。

<SOAPHeaderAuthentication>
<Username required="true">
<VariableName>USERNAME</VariableName>
<DisplayName>Username</DisplayName>
</Username>
<Password>
<VariableName>PASSWORD</VariableName>
<DisplayName> Password</DisplayName>
</Password>
<AuthVariable>
<VariableName>AUTHENTICATION</VariableName>
<DisplayName>Authentication</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>LOCALE</VariableName>
<DisplayName>Locale</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>TIMEZONE</VariableName>
<DisplayName>Timezone</DisplayName>
</AuthVariable>

<SOAPHeader>
<![CDATA[
]]>
</SOAPHeader>
</SOAPHeaderAuthentication>

(オプション)このセクションでは、外部システムWebサービスの認証スキーマを記述できます。

EMの「管理コネクタの構成」ページの認証セクションは、このセクションに基づいて生成されます。

ユーザー名、パスワードおよび追加のテキスト・フィールドは、このセクションに基づいて移入されます。

- <VariableName>タグで、WebサービスXML文書内の属性の名前がマーク付けされます。

- <DisplayName>タグで、対応するテキスト・ボックスのラベル付けの方法が記述されます。

サービス定義

次の表に、現行リリースでサポートされているイベント・コネクタ・サービス操作を示します。

表2-2 コネクタ・サービス操作

名前

説明

setup(オプション)

外部システムにコネクタを登録します。

initialize (オプション)

設定後、外部システムでコネクタを初期化します。

uninitialize (オプション)

外部イベント・システムでコネクタを初期化解除します。

cleanup (オプション)

外部イベント・システムでコネクタを登録解除します。

createEvent

新しいイベントを外部システムに転送します。

updateEvent

イベントの更新を外部システムに転送します。

前述のサービスに関する重要なポイントは次のとおりです。

- コネクタ記述子でのサービス名は、表2-2「コネクタ・サービス操作」で定義した名前と完全に一致する必要があります(大/小文字を区別)。

- setupおよびinitializeは、定義されている場合、コネクタの構成時の順序でコールされます。

- uninitializeおよびcleanupは、initializeおよびsetupと正反対のアクションです。
uninitializeは、initializeが定義されている場合に定義できます。cleanupは、setupが定義されている場合に定義できます。定義した場合、コネクタの削除時にuninitializeおよびcleanupの順序でサービスがコールされます。

- createEventおよびupdateEventは、Enterprise Managerからイベント・ルールによって生成された外部システムにイベントを転送する場合にコールされます。

サービス設定の例を次に示します。

<Service>
<Method>setup</Method>
<WebServiceEndpoint>....</WebServiceEndpoint>
<SOAPAction>.......</SOAPAction>
</Service>

テンプレート定義

テンプレートには、リクエストの送信時およびレスポンスの受信時に変換されるデータが含まれます。テンプレートは、Enterprise Managerの特定のサービス操作についてXMLまたはXSLファイルとして定義できます。

テンプレートを定義するためのガイドラインは次のとおりです。

- 内部名は、メソッド名と同一である必要があります(大/小文字を区別)。

- テンプレート・タイプは次のとおりです。

InboundXSL for response xsl,
OutboundXSL for request xsl, and
OutboundXML for request xml

- テンプレート・ファイル名は重要ではありませんが、次の名前を使用することをお薦めします。

<methodName>_request.xml,
<methodName>_request.xsl, and
<methodName>_response.xsl.

次に例を示します。

<TemplateRegistration>
<FileName>setup_request.xml</FileName>
<InternalName>setup</InternalName>
<TemplateName>Setup</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for setup method</Description>
</TemplateRegistration>

テンプレート登録

テンプレート登録XMLまたはXSLのコーディングは、次の情報によって決まります。

- 定義された一連のスキーマ定義(XSD)。

- ターゲット外部システムの属性。

次の表に、Enterprise Managerイベント・コネクタのスキーマ定義を示します。

表2-3 イベント・コネクタ・テンプレートXSD

名前

説明

EMEvent.xsd

コネクタ・フレームワークによって使用可能になるEMイベントを定義します。

ConnectorCommon.xsd

SourceObjInfoTypeなど、その他すべてのxsdで使用されるすべてのデータ型を定義します。

EMEventResponse.xsd

createEvent/updateEventメソッドのレスポンスを定義します。このレスポンスは、受信したイベント・マネージャ・イベントの外部サーバーからのものです。

initialize_response.xsd

initializeメソッド用のレスポンス・スキーマです。

setupResponse.xsd

setupメソッド用のレスポンス・スキーマです。

uninitialize_response.xsd

uninitializeメソッド用のレスポンス・スキーマです。

リクエスト・テンプレートを定義する際の重要なポイントは次のとおりです。

- setup、initialize、uninitializeおよびcleanupサービスには、リクエストXMLテンプレート・ファイルの定義が必要です。
テンプレート・リクエストXMLは、渡される情報がコネクタ変数要素としてすでに定義されている場合に使用されます。コネクタ変数は、次の情報を使用して定義できます。

- 登録時のコネクタ・デプロイメント記述子

- これらのサービスのいずれかのレスポンス・メッセージ

- createEventおよびupdateEventサービスには、XSLファイルの定義のみ必要です。
テンプレート・リクエストXSLは、Enterprise Manager内で生成されるイベント属性を使用してリクエストを生成する場合に使用されます。これらのリクエストには、Enterprise Manager内のイベント・オブジェクトとターゲット外部システムの属性とのマッピングが必要です。

- テンプレート・リクエストXSLの定義は、リクエストXMLを定義している場合、オプションです。原則として、このシナリオは必要ありません。

- EMEvent.xsdスキーマを使用すると、外部システムへのイベント送信時にマッピングで使用できるようにするEnterprise Managerのフィールドを決定できます。

レスポンス・テンプレートを定義する際の重要なポイントは次のとおりです。

- レスポンス・テンプレート(XSL)は、表2-3「イベント・コネクタ・テンプレートXSD」に定義されているXSDに基づいて定義できます。

- テンプレート・レスポンスXSLはオプションです。
レスポンス変換(XSL)が定義されていない場合、外部システムによって返されるレスポンスXML内のデータはいずれも保持されません。外部システム・レスポンス・データに関係していない操作の場合、これは理想的な実装です。

- createEventおよびupdateEventサービスに対しては、EMEventResponse.xsdスキーマを使用して外部システムからのレスポンスをEnterprise Managerが認識できるレスポンスに変換する方法を決定できます。

変換後、Enterprise Managerでは<SuccessFlag>と、値に応じて次のいずれかの要素が必要とされます。

- True
Enterprise Managerでは、外部システムのイベントのIDである<externalEventID>が必要とされます。これは、将来イベントを更新する際に使用されます。

- False
Enterprise Managerでは、<ErrorMessage>が必要とされます。Enterprise Managerにより、イベントにexternalEventIDまたはErrorMessageの注釈が付けられます。

MOMイベント・コネクタのリファレンス実装は、次の表2-4「サンプル・テンプレート・リスト」のサンプル・テンプレート・ファイルを参照してください。

表2-4 サンプル・テンプレート・リスト

サービス名

リクエストXSL

リクエストXML

レスポンスXSL

setup

オプション

setup_request.xml

setup_response.xsl

initialize

オプション

initialize_request.xml

オプション

uninitialize

オプション

uninitialize_request.xml

オプション

cleanup

オプション

cleanup_request.xml

オプション

createEvent

createEvent_request.xsl

該当なし

createEvent_response.xsl

updateEvent

updateEvent_request.xsl

該当なし

updateEvent_response.xsl

コネクタのパッケージおよびデプロイ

コネクタをデプロイするために、Enterprise Managerでは自己更新機能が使用されます。この機能はコンソールからアクセスできますが、Enterprise Manager環境にコネクタをインポートするための機能です。コネクタをデプロイするには、次の手順を実行します。

1. コネクタjarファイルを準備します。
XMLおよびXSLテンプレート・ファイルをすべて1つの.jarファイルとしてパッケージします。

<name>_connector.jar
---> connectorDeploy.xml
--->template1.xml
--->template2.xsl
…..
…..
--->templateN.xsl

2. マニフェスト・ファイルを作成します。
次の表に、自己更新マニフェスト・ファイルのキー属性を示します。

表2-5 自己更新マニフェスト・ファイルの属性

名前

説明

EntityType

値はcore_connectorです。

EntityTypeVersion

現行リリース・バージョンです。値は12.1.0.1.0です。

Attribute @Name=connector_type

コネクタ・タイプ名です。

Attribute @Name=connector_category

カテゴリ・タイプは、TicketingConnectorまたはEventConnectorです。

ArchiveList

この要素には、コネクタ設定の一部であるアーカイブのリストが含まれます。一般に、コネクタjarは1つ存在しますが、特殊な実装の場合は追加のjar (アダプタまたはエージェント)が存在することがあります。このような場合、コネクタ固有のjarは定義リストの最初のjarである必要があります。これは必須要件です。

次の例に、connector_manifest.xmlファイルのコードを示します。

<EntityInstanceList xmlns="http://www.oracle.com/EnterpriseGridControl/SelfUpdateManifest">
<EntityInstance xmlns="http://www.oracle.com/EnterpriseGridControl/SelfUpdateManifest" EntityTypeVersion="11.2.0.1.0" EntityType="core_connector" Maturity="PRODUCTION" Vendor="Oracle" PluginID="oracle.sysman.core">
<Description>
<![CDATA[ BMC Remedy Service Desk Connector - 12.1.0.2.0
]]>
</Description>
<AttributeList>
<Version>12.1.0.2.0</Version>
<Attribute Name="connector_type" Value="Sample SCOM Connector" Label="Sample SCOM Connector" />
<Attribute Name="connector_category" Value="EventConnector" Label="Event Connector" />
</AttributeList>
<Readme>
<![CDATA[   Oracle Management Connector for SCOM integrates Oracle Enterprise Manager Cloud Control's proactive alert detect
ion and resolution features with BMC's Remedy 7.0 Service Desk capabilities to provide a seamless workflow for incident mana
gement and resolution.
Change Logs:
12.1.0.2.0
- Miscellaneous bug fixes
- Performance enhancements
]]>
</Readme>
<DependsOn />
<ArchiveList>
<Archive Filename="scomconnector.jar" IsMDS="false" />
<Archive Filename="SCOM_webservices_adapter.jar" IsMDS="false" />
</ArchiveList>
<CustomData>
<![CDATA[
]]>
</CustomData>
</EntityInstance>
</EntityInstanceList>

属性の詳細リストは、次の場所にある自己更新スキーマ定義を参照してください。

$ORACLE_HOME/sysman/emSDK/core/selfupdate/model/SelfUpdateManifest.xsd

3. emedkツールを構成します。
emedkツールは、Enterprise Managerユーザー・インタフェースから指示に従って構成できます。パスは、「設定」 > 「拡張性」 > 「開発キット」です。

4. 自己更新アーカイブを準備します。
これにはコネクタjarファイルおよびコネクタ用のマニフェスト・ファイルが必要です。自己更新を準備するには、次のユーティリティをコールして自己更新アーカイブ・ファイルを作成します。

edkUtil prepare_update
-manifest "manifest xml"
-archivedir "archives directory"
-out "output file or directory"
[-typexml "update type xml"]

表2-6 自己更新ユーティリティのオプション

オプション

説明

-manifest

更新が記述されている自己更新マニフェスト・ファイル。

-archivedir

マニフェスト・ファイルに指定されているアーカイブ・ファイルがあるディレクトリ。

-out

自己更新アーカイブのディレクトリまたはファイル名。ディレクトリが指定されている場合、ファイル名は自動生成されます。

-typexml

更新タイプxmlへのオプション・パス。

次の例では、マニフェスト・ファイル/u01/connector/connector_manifest.xmlに基づいて自己更新アーカイブを/u01/sarディレクトリに作成しています。connector_manifest.xmlで参照されるアーカイブは、ディレクトリ/u01/connector/archivesから取得されます。

edkUtil prepare_update
-manifest /u01/connector/connector_manifest.xml
-archivedir /u01/connector/archives
-out  /u01/sar/sample_connector.zip

5. 次のemcliコマンドのいずれかをコールして、Enterprise Managerにコネクタ・アーカイブをインポートします。

emcli import_update
-file=\ file\
-omslocal

または

emcli import_update
-file=\ file\
-host=\ hostname\
[-credential_set_name=\ setname\ ] | -credential_name=\ name\  -credential_owner=\ owner\

これらのコマンドにより、自己更新アーカイブ・ファイルがEnterprise Managerにインポートされます。正常にインポートされると、更新が次のアクションを促す「ダウンロード」ステータスで自己更新ホームに表示されます。表2-7に、コネクタ・アーカイブ・コマンドのオプションを示します。

表2-7 コネクタ・アーカイブ・コマンドのオプション

オプション

説明

-file

更新アーカイブ・ファイルの完全なパス名

-omslocal

ファイルがOMSからアクセス可能であることを示すフラグ

-host

ファイルが使用可能なホスト・ターゲットのターゲット名

-credential_set_name

ホスト・ターゲットのリポジトリに格納されている優先資格証明のセット名。次のいずれかです。

- HostCredsNormal
デフォルト非特権資格証明セット

- HostCredsPriv
特権資格証明セット

-credential_name

リポジトリに格納されている名前付き資格証明の名前。このオプションは、-credential_ownerオプションとともに指定する必要があります。

-credential_owner

リポジトリに格納されている名前付き資格証明の所有者。このオプションは、-credential_nameオプションとともに指定する必要があります。

emcliコマンドの使用例をいくつか次に示します。

例1

ファイルupdate1.zipをインポートします。ファイルは、OMSホストに存在している必要があります。複数のOMSが設定されている場合、リクエストはどのOMSでも処理できるため、ファイルはリクエストを処理するOMSからアクセスできる必要があります。通常、これは、すべてのOMSからアクセス可能な共有の場所にファイルを保存しておく必要があることを意味します。

emcli import_update
-file=\ /u01/common/update1.zip\
-omslocal

例2

host1.example.comホストに存在するファイルupdate1.zipをインポートします。ホストは、Enterprise Managerの管理対象ホスト・ターゲットであり、このホストのエージェントは起動し実行中である必要があります。リモート・ファイルの取得には、ホストhost1.example.comの非特権優先資格証明が使用されます。

emcli import_update
-file=\ /u01/common/update1.zip\
-host=\ host1.example.com\
-credential_set_name=\ HostCredsNormal\

例3

host1.example.comホストに存在するファイルupdate1.zipをインポートします。ホストは、Enterprise Managerの管理対象ホスト・ターゲットであり、このホストのエージェントは起動し実行中である必要があります。リモート・ファイルの取得には、ユーザー\ admin1\が所有する名前付き資格証明\ host1_creds\が使用されます。

emcli import_update
-file=\ /u01/common/update1.zip\
-host=\ host1.example.com\
-credential_name=\ host1_creds\
-credential_owner=\ admin1\

6. 「自己更新」ホームページに移動します。
コネクタは「ダウンロード」と表示されます。

7. コネクタの行を選択し、「適用」をクリックしてコネクタをデプロイします。

3 データ交換コネクタの作成

データ交換コネクタはJMSサーバー・ベースの統合化手段であり、Enterprise Managerと他の管理システム間の双方向のデータ交換設定を作成できます。データ交換コネクタのアーキテクチャは、Java Message Service(JMS)およびXMLなどのオープン・スタンダードに基づいています。これにより、拡張性および互換性を容易に実現することができます。

データ交換環境には、データ交換ハブおよびデータ交換セッションの作成が必要です。この章では、データ交換プロセスに含まれる主要な概念、コンポーネントおよび機能について説明します。

また、Enterprise ManagerとOracle Business Activity Monitoring Server (OBAM)を統合するための特定の手順についても説明しています。

この章の内容は次のとおりです。

- 概要

- データ交換の概念

- データ交換コネクタの設定

- Enterprise ManagerとOBAMの統合

- OC4Jをデータ交換ハブとして使用する方法

- ヒントおよびトラブルシューティング情報

- 参考文献

概要

一般的に、企業では内部のシステムおよびサービスのほとんどをEnterprise Managerで監視しています。しかし、OBAMサーバーなどの他の監視システムや外部管理システムが企業のビジネス環境内に存在する場合もあります。これらの管理システムおよびEnterprise Managerによって収集された監視情報は、同じビジネス・アプリケーションに関連するにもかかわらず、異なる場合があります。Enterprise Managerとこれらの外部管理システムが共存し、シームレスにやり取りすることは、ビジネスにとって不可欠です。

データ交換コネクタは、JMSトピック・メッセージまたはキュー・メッセージを使用してXML形式でデータを転送することにより、この通信要件に効率的に対応します。これは、データ交換ハブおよびデータ交換セッションの作成により可能となります。

図3-1は、データ交換コネクタのアーキテクチャの概要を示しています。

図3-1 データ交換アーキテクチャ

Enterprise Managerと外部管理システム

表3-1では、Enterprise Managerと外部管理システム間のデータ交換における、データ要件および目的を説明します。

表3-1 Enterprise Managerと外部管理システム間のデータ交換

データ交換

要件

目的

Enterprise Managerから外部管理システムへ

- メトリック・データ

- アラート・データ

- このデータを使用して、ビジネス・アプリケーションが外部管理システムに送信するビジネス・インジケータおよびイベントを関連付けます。
また、メトリック・データには、サービス・レベル合意(SLA)およびターゲット・ステータス・データ、RAWメトリックも含まれます。

- レポート、イベント通知および修正の処理を改善します。

外部管理システムからEnterprise Managerへ

- ビジネス・インジケータ

- ビジネス・イベント

- レポートおよびトポロジ分析を改善します。

- Enterprise Manager環境に包括的なSLAを生成します。

データ交換コネクタを使用して2つのシステムを統合することにより、両システムの相互補完およびビジネス要件への効率的および経済的対応が実現します。

データ転送頻度のオプションおよびモード

次に、Enterprise Managerから外部管理システムにデータを送信する際の、通常のプロセスを示します。

- リアルタイム・メトリック、可用性およびSLA値が履歴データとともに転送されます。

- 履歴データは、過去24時間、7日間および31日間について転送されます。ターゲット・ステータスの履歴データは、期間中にターゲットが使用可能である時間のパーセンテージとして送信されます。

- メトリック・データは、スケジュールされた間隔で、バッチで転送されます。各バッチで、最大100データ・ポイントの送信が可能です。JMSサーバーの負荷を減らすため、後続の転送と2秒の間隔が保持されます。

- 指定したメトリックに対し、間隔内のすべての新規データ・ポイントが外部システムに送信されます。新規の値が存在しない場合、データは送信されません。初期転送の場合は、1時間前からのデータ・ポイントが考慮されます。1時間がデフォルトの間隔ですが、異なる時間間隔に構成することもできます。
たとえば、アウトバウンド・セッションが30分間隔の頻度で午前9時から午後9時までにスケジュールされている場合、最初(午前9時)には、午前8時から午前9時の間に収集されたメトリック値が転送されます。その後は、当該の間隔内で受信されたメトリック値が送信されます。つまり、午前9時30分には午前9時から午前9時30分の間に受信されたメトリック値が、午前10時には午前9時30分から午前10時の間に受信されたメトリック値が転送されます。

- アラートは待機をせずに送信されます。各アウントバウンド・メッセージには、1つのアラートのみが埋め込まれます。

- 転送されるサービス・レベル合意(SLA)データは、選択した期間のSLA値です。24時間のシナリオで、SLAメトリックを伴うアウトバウンド・セッションが1月15日午後4時にスケジュールされている場合、転送される値は、1月14日午後4時1分から1月15日午後4時までのSLA値です。

データ交換の概念

次の項では、Enterprise Managerと外部管理システム間のデータ交換環境を正常に設定するために理解することが必要な主要な概念について説明します。

データ交換ハブ

データ交換ハブは、Enterprise Managerと外部管理システムをつなぐパイプとして機能するJMS準拠サーバーです。データはこのようなハブを介して外部システムとCloud Control間を送受信されます。このハブは、メッセージがシームレスに送信され取得されるよう、既知のJMS宛先情報(アウトバウンドJMS宛先)で構成されている必要があります。少なくとも1つのハブが作成済の場合、データ交換ハブ・ページには、既存のデータ交換ハブとそれに関連するJNDIサービス・プロバイダのURLが表示されます。ハブの例として、WebLogic Server (WLS)、Oracle Containers for JEE (OC4J)などがあります。

関連項目:
「データ交換ハブの作成」

インバウンド・データ交換セッション

インバウンド・データ交換セッションを作成して、ビジネス・インジケータまたはイベント(あるいはその両方)を外部システムのデータソースからEnterprise Managerに受信します。

関連項目:
「インバウンド・データ交換セッションの作成」

アウトバウンド・データ交換セッション

アウトバウンド・データ変換セッションを作成して、メトリック値、アラート、ターゲット可用性またはそれらの組合せをEnterprise Managerから外部システムに送信します。

データは次のいずれかの形式で送信できます。

- 正規化されたメッセージ形式

- 非正規化されたメッセージ形式

正規化されたメッセージ形式

この形式では、データは2つのフェーズで送信されます。

- セッションの設定フェーズ: Enterprise Manager Cloud Controlでセッションが作成されると、ターゲット名、ターゲット・タイプ、メトリック名、メトリック列などのターゲットおよびメトリックのメタ情報がGUIDとともに送信されます。

- セッションの実行フェーズ: セッションが実行されると、実際のメトリックが送信されます。すべてのメッセージに対して重複するメタ情報が送信されるのを回避するため、メトリックにはGUIDのタグが付けられます。その結果、低いワイヤ・フットプリントが保持されます。

このメッセージの書式が有効なのは、外部システムがデータベースなどの永続性ストアによってサポートされている場合です。その場合、外部システムは、GUIDに基づいてグラフまたはレポートをレンダリングする際、表を結合してメタデータを取得できるためです。

非正規化されたメッセージ形式

この形式では、ターゲットおよびメトリックのメタ情報が、セッション実行フェーズで、すべてのメッセージとともに送信されます。セッション設定フェーズでは、メッセージは送信されません。このメッセージ形式は、外部システムが永続性ストアに裏付けられていない場合、効率的です。各メッセージはメタ情報を繰り返しますが、グラフ化およびレポート化のためのデータのダイジェストは容易です。

関連項目:
「インバウンド・データ交換セッションの作成」

メッセージ・スキーマ

コンテンツを正確に解析および解釈するには、外部システムでJMS宛先に埋め込まれたXMLメッセージの構文およびセマンティクスを理解することが必須です。メッセージのスキーマは、メッセージ形式(正規化または非正規化)により異なります。

両方の形式に対して同じJMS宛先が使用されます。そのため、異なるメッセージ形式のセッションは、メッセージのコンシューマを混乱させるため、同時に実行できません。異なる形式のセッションは、排他的に実行することをお薦めします。

データソース

データソースは、ビジネス・インジケータまたはビジネス・イベントの取得元の外部システム・ソースを論理的に表したものです。データソースの定義は、次のとおりです。

- 外部システムから受信したビジネス・コンテンツ(ビジネス・インジケータ)の構造およびスキーマ。

- 外部データ(ビジネス・イベントおよびビジネス・インジケータ)の受信に経由した転送(JMS宛先)情報。

- 外部データ(ビジネス・イベントおよびビジネス・インジケータ)が関連付けられているEnterprise Managerの関連ターゲット。

平均データ

RAWメトリックを選択する以外に、24時間、7日間および31日間の間隔での平均メトリックも選択できます。次の条件が適用されます。

- デフォルトはセッションごとのRAWメトリックです。

- RAWデータまたは異なるレベルの平均データをセッションごとに組み合せることはできません。特定のセッションについて、すべてのデータがRAW、いずれかの平均タイプ、または同じ平均レベルである必要があります。

- アラートは、選択されている平均には関係なく、常にリアルタイムに送信されます。

- 平均データを使用し、パーセンテージで表したSLAとターゲットの可用性を送信することもできます。

データ交換コネクタの設定

1. Enterprise Manager Cloud Controlから、「設定」をクリックします。

2. 「拡張性」をクリックします。

3. 「データ交換」をクリックします。
データ交換ページが表示されます(図3-2を参照)。

4. データ交換コネクタを設定します。
次の項では、データ交換コネクタの設定に必要な情報を提供します。

- データ交換ハブの作成

- アウトバウンド・データ交換セッションの作成

- インバウンド・データ交換セッションの作成

データ交換ハブの作成

次のJMSサーバーが動作保証およびサポートされています。

- WebLogic Server 8.1シリーズ以上

- OC4J 10.1.3.1シリーズ

- Oracle Enterprise Service Bus (OESB) 10.1.3.1シリーズ

- OC4J 10.1.2.0シリーズ

注意:
サードパーティによるその他のJMS準拠サーバーが使用できる場合もありますが、そのような使用方法は動作保証もサポートもされていません。サードパーティのJMSサーバーの使用については、「サードパーティのJMSサーバーをデータ交換ハブとして使用」を参照してください。

次の手順を実行して、データ交換ハブを作成します。

1. 「データ交換: データ交換ハブ」ページで、「作成」をクリックします。データ交換ハブの作成ページが表示されます。

1. データ交換ハブに一意の名前を指定します。

2. データ交換ハブにJNDIサービス・プロバイダURLを指定します。

3. 表3-2のマトリクスに従って、リストからコンテキスト・ファクトリ名を選択します。

表3-2 コンテキスト・ファクトリ名

次に対応するハブ

コンテキスト・ファクトリ

WebLogic Server

weblogic.jndi.WLInitialContextFactory

10.1.2.X OC4J

com.evermind.server.rmi.RMIInitialContextFactory

10.1.3.X OC4J

oracle.j2ee.rmi.RMIInitialContextFactory

WebLogic Server以外およびOC4j JMSサーバー以外

サード・パーティのサーバーについては「その他」を選択し、「JNDI初期コンテキスト・ファクトリ名の入力」フィールドにファクトリ名を指定します。

4. このハブにアクセスするためのユーザー資格証明を指定します。

2. 必要なJMSトピック名またはキュー名(あるいはその両方)でJMSサーバーを構成します。

関連項目:
「インバウンドJMS宛先」

3. 「OK」をクリックして構成を保存し、データ交換: データ交換ハブ・ページに戻ります。

データ交換用のハブを作成した後、アウトバウンドまたはインバウンド・データ交換セッションをセットアップできます。

サードパーティのJMSサーバーをデータ交換ハブとして使用

注意:
サードパーティのJMSサーバーの使用は動作保証もサポートもされていません。

この使用方法は動作保証もサポートもされていませんが、次の手順を実行すれば、開発またはテスト時にサードパーティのJMSサーバーをデータ交換ハブとして使用できます。

1. 使用しているJMSサーバーのJMSクライアント・ライブラリを次の場所にコピーします。

$ORACLE_HOME/middleware/oms/sysman/archives/emgc/deployments/ EMGC_DOMAIN/emgc.ear/APP-INF/lib

2. .jarファイルをコピーした後、Cloud Controlを再起動します。

3. 使用しているJMSサーバーでの所定の手順に従ってJMS宛先を作成します。トピックおよびキューのリストを参照してください。

アウトバウンド・データ交換セッションの作成

アウトバウンド・データ交換セッションを作成するには、設定ウィザードの各ページで、次の手順で説明している入力を指定します。

1. 「データ交換」ページで、「アウトバウンド・データ交換セッション」リンクをクリックします。

2. 「作成」をクリックします。ウィザードの「セッションのセットアップ」ステップが表示されます。

1. Enterprise Managerからデータを受信するには、トピックで構成された1つ以上のデータ交換ハブにアクセスできることを確認してください。データ交換ハブを設定するには、「データ交換ハブの作成」を参照してください。

2. 「名前」フィールドに、このアウトバウンド・データ交換セッションの一意の名前を指定します。

3. すでに作成済でアルファベット順に一覧表示されたハブのリストから、データ交換ハブを選択します。デフォルトでは、リストにある最初のハブが選択されます。

4. 「ユーザー」で、BAMユーザーの名前を入力するか、または送信中のデータにアクセスできる外部システムのBAMユーザーのカンマ区切りリスト(user1, user2など)を入力します。このセッションのユーザーの名前は、Oracle BAMサーバーに関連付けられます。受信側のシステムでは、セキュリティを解釈して実施する必要があります。このフィールドを空白にすると、ユーザー情報が送信されなくなります。

5. 「宛先タイプ」ドロップダウンで、Cloud Controlとの間でメッセージを送受信するいずれかのメッセージング・モデルを選択します。「キュー」では、キュー・ロジックに基づいたポイント・ツー・ポイント・メッセージングの相互作用が提供されます。「トピック」では、ブロードキャスト・モデルをベースにしたサブスクリプション方法が提供されます。
セッションでトピックを宛先タイプとして使用する場合、このセッションに対するメッセージはすべて、対応する事前定義されたトピックで送信されます。キューの場合、メッセージはすべて事前定義されたキューで送信されます。特定のセッションに対して、様々な宛先の組合せはサポートされません。

6. 「正規化」または「非正規化」のいずれかのメッセージ形式を選択します。これらの形式の詳細は、「アウトバウンド・データ変換セッション」を参照してください。

7. 「メトリックの粒度」ドロップダウンで、RAWメトリック・データをアウトバウンド・セッション経由で送信するのか、24時間、7日間または31日間の平均データを送信するのかを選択します。

8. 「次へ」をクリックします。ウィザードの「ターゲットとメトリック/アラート/可用性の選択」ステップが表示されます。

3. 「追加」をクリックします。このウィザード・ステップの「ターゲットの追加」ページが表示されます。

4. 検索アイコンをクリックして「ターゲットの検索と選択」ポップアップを呼び出し、設定対象のデータ交換トランザクションの一部とするターゲットを選択して、「選択」をクリックします。ターゲットのすべてのメトリックおよびオブジェクトのリストがターゲットの追加ページに表示されます。

5. ターゲットに対するアウトバウンド・セッション中に送信する、メトリックおよびアラートを指定します。ターゲットに対するアウトバウンド・セッション中に送信する、メトリックおよびアラートを指定します。すべてのターゲットおよびアラートを選択または選択解除する場合は、バッチ選択ボタンを使用できます。

- ターゲット可用性情報の「可用性」メトリックに対して「メトリック値の送信」を選択する必要があります。

- 「サービス・レベル合意」 (SLA)メトリックに対しては「アラートの送信」を選択できません。このメトリックは、サービス・ターゲットに対してのみ適用および使用できます。たとえば、ホスト・ターゲットにはこのメトリックはありません。

- オブジェクトの指定を必要とするメトリックもあります。たとえば、「使用可能なファイルシステム領域(%)」メトリックは特定のマウント・ポイントの名前で修飾できます。

6. 「OK」をクリックして選択内容を保存し、「ターゲットとメトリック/アラート/可用性の選択」ステップに戻ります。
これにより、選択内容を表示したり編集できます。また、「類似追加」アイコンをクリックすることにより、選択内容を別のターゲットのテンプレートとして使用することもできます。

7. メトリックの値とアラートの選択内容に問題がない場合は「次へ」をクリックします。ウィザードの「スケジュール」ステップが表示されます。次のスケジュールの選択肢の1つを選択します。

- 後でスケジュール: スケジュールを遅延し、ウィザードの「確認」ステップで「終了」をクリックした後で、アウトバウンド・データ交換セッション・サブページからセッションをスケジュールします。

- ただちにスケジュール: 次のいずれかのサブタイプを選択します。

- 1回(即時): このオプションを選択した場合、セッションは作成が終了したときに1回実行されます。

- 1回(後で): このオプションを選択した場合、セッションのタイムゾーンおよび開始日時を指定する必要があります。

- 繰返し: このデフォルト・オプションでは、タイムゾーンおよび開始時刻を指定する必要があります。また、セッションを実行する頻度タイプおよび間隔と、セッションの繰返しが無制限か指定された日時までかを指定できます。

8. 「次へ」または「確認」をクリックし、ウィザードの「確認」ステップに進みます。
変更を行う必要がある場合は、変更が必要なステップに到達するまで「戻る」をクリックします。HTTPSでない場合は、次の手順に進みます。

9. 「終了」をクリックします。アウトバウンド・データ交換セッション・サブページが再表示され、新しく作成されたセッションとそのステータスが表に表示されます。
ジョブの実行が終了する前に、「アクション」列の「スケジュールの表示」リンクをクリックしてスケジュールを表示できます。また、必要に応じて実行を停止できます。または、「停止」をクリックして実行を即時停止することもできます。

アウトバウンドJMS宛先

ハブを介してEnterprise Managerから外部システムにデータを送信するために、事前定義されたトピック名およびキュー名が使用されます。データ交換ハブを、表3-3から表3-9に記載されたJMS宛先情報で構成する必要があります。トピックとキューの両方を定義する必要はありません。たとえば、トピックを常に使用する場合は、キュー定義を削除するか、最初から作成しません。その逆も可能です。

例: WebLogic Server用のJMS宛先の構成

この例で説明するように、データ交換コネクタでは任意のJMS準拠のサーバーを使用できます。

WebLogic Server用のJMS宛先を構成するには、次の手順を実行します。

1. $ORACLE_HOME/sysman/bamディレクトリにある事前パッケージ済のWLST Pythonスクリプトを使用します。

2. 次の手順に進む前に、正しいCLASSPATHを設定します。CLASSPATHは、ORACLE_HOME (通常middleware/wlserver_10.3/server/binディレクトリ内)下にあるsetWLSEnv.shを実行すると設定できます。

3. 手順1のディレクトリにあるconfigEMSYSJMSSystemResource.pyを使用して必要なJMSトピックおよびキューを作成します。

java weblogic.WLST comfigEMSYSJMSSystemResource.py <jndi provider URL> <username> <password> <WLS server name>

例:

java weblogic.WLST configEMSYSJMSSystemResource.py "t3://localhost:7001" weblogic welcome1 AdminServer

スクリプトが正常に実行されると、次のコンポーネントが作成されます。

- リソースおよび宛先:

- JMSサーバー用のEMSYSJMSServer

- JMSシステム・リソース用のEMSYSJMSSystemResource

- サブデプロイメント用のEMSYSJMSServerDeployment

- コネクション・ファクトリ:

- jms/EMSYSTopicConnectionFactory

- jms/EMSYSQueueConnectionFactory

- トピック:

- jms/EMSYSTargetsTopic

- jms/EMSYSMetricsTopic

- jms/EMSYSAlertsDataTopic

- jms/EMSYSMetricsDataTopic

- jms/EMSYSSecurityFilterTopic

- jms/EMSYSTargetStatusTopic

- jms/EMSYSTargetSLATopic

- jms/EMSYSMetricsDataLast24HoursTopic

- jms/EMSYSMetricsDataLast7DaysTopic

- jms/EMSYSMetricsDataLast31DaysTopic

- jms/EMSYSTargetStatusLast24HoursTopic

- jms/EMSYSTargetStatusLast7DaysTopic

- jms/EMSYSTargetStatusLast31DaysTopic

- jms/EMSYSTargetSLALast24HoursTopic

- jms/EMSYSTargetSLALast7DaysTopic

- jms/EMSYSTargetSLALast31DaysTopic

- キュー:

- jms/EMSYSTargetsQueue

- jms/EMSYSMetricsQueue

- jms/EMSYSAlertsDataQueue

- jms/EMSYSMetricsDataQueue

- jms/EMSYSSecurityFilterQueue

- jms/EMSYSTargetStatusQueue

- jms/EMSYSTargetSLAQueue

- jms/EMSYSMetricsDataLast24HoursQueue

- jms/EMSYSMetricsDataLast7DaysQueue

- jms/EMSYSMetricsDataLast31DaysQueue

- jms/EMSYSTargetStatusLast24HoursQueue

- jms/EMSYSTargetStatusLast7DaysQueue

- jms/EMSYSTargetStatusLast31DaysQueue

- jms/EMSYSTargetSLALast24HoursQueue

- jms/EMSYSTargetSLALast7DaysQueue

- jms/EMSYSTargetSLALast31DaysQueue

4. EMSYSJMSSystemResource.pyを使用して、スクリプトconfigEMSYSJMSSystemResource.pyで作成されたJMS宛先を削除およびクリーン・アップします。また、次のコマンドを実行するために、手順2で定義したようにCLASSPATHを設定する必要があります。

java weblogic.WLST deleteEMSYSJMSSystemResource.py <jndi provider URL> <username> <password>

例:

java weblogic.WLST deleteEMSYSJMSSystemResource.py "t3://localhost:7001" weblogic welcome1

表3–3に示すJMS宛先は、アウトバウンド・データ変換セッションに使用されます。

表3-3 ターゲットのJMS宛先

プロパティ

説明

ConnectionFactory名

jms/EMSYSTopicConnectionFactoryまたはjms/EMSYSQueueConnectionFactory

宛先名

jms/EMSYSTargetsTopicまたはjms/EMSYSTargetsQueue

JMSメッセージ・タイプ

テキスト・メッセージ

説明

ターゲット名およびターゲット・タイプなどのターゲット・メタデータ情報がこの宛先で送信されます。

注意:

- トピックを宛先タイプとして使用するアウトバウンド・セッションの場合、jms/EMSYSTopicConnectionFactoryおよびすべてのトピック・バージョン(ms/EMSYSTargetsTopicなど)が使用されます。

- 宛先タイプがキューの場合、jms/EMSYSQueueConnectionFactoryおよびキュー・バージョン(jms/EMSYSTargetsQueueなど)が使用されます。

表3-4 メトリックのJMS宛先

プロパティ

説明

ConnectionFactory名

jms/EMSYSTopicConnectionFactoryまたはjms/EMSYSQueueConnectionFactory

宛先名

jms/EMSYSMetricsTopicまたはjms/EMSYSMetricsQueue

JMSメッセージ・タイプ

テキスト・メッセージ

説明

メトリック名、メトリック列およびターゲット・タイプなどのメトリック・メタデータ情報がこの宛先で送信されます。

表3-5 RAWまたは平均メトリック・データのJMS宛先

プロパティ

説明

ConnectionFactory名

jms/EMSYSTopicConnectionFactoryまたはjms/EMSYSQueueConnectionFactory

宛先名

- RAW:
jms/EMSYSMetricsDataTopicまたはjms/EMSYSMetricsDataQueue

- 過去24時間:
jms/EMSYSMetricsDataLast24HoursTopicまたはjms/EMSYSMetricsDataLast24HoursQueue

- 過去7日間:
jms/EMSYSMetricsDataLast7DaysTopicまたはjms/EMSYSMetricsDataLast7DaysQueue

- 過去31日間:
jms/EMSYSMetricsDataLast31DaysTopicまたはjms/EMSYSMetricsDataLast31DaysQueue

JMSメッセージ・タイプ

テキスト・メッセージ

説明

この宛先は、RAWまたは平均メトリック値の送信に使用されます。

表3-6 RAWまたは平均ターゲット・ステータスのJMS宛先

プロパティ

説明

ConnectionFactory名

jms/EMSYSTopicConnectionFactoryまたはjms/EMSYSQueueConnectionFactory

宛先名

- RAW:
jms/EMSYSTargetStatusTopicまたはjms/EMSYSTargetStatusQueue

- 過去24時間:
jms/EMSYSTargetStatusLast24HoursTopicまたはjms/EMSYSTargetStatusLast24HoursQueue

- 過去7日間:
jms/EMSYSTargetStatusLast7DaysTopicまたはjms/EMSYSTargetStatusLast7DaysQueue

- 過去31日間:
jms/EMSYSTargetStatusLast31DaysTopicまたはjms/EMSYSTargetStatusLast31DaysQueue

JMSメッセージ・タイプ

テキスト・メッセージ

説明

この宛先は、RAW (数値)または平均(パーセンテージ)ターゲット・ステータス情報の送信に使用されます。

表3-7 セキュリティ・フィルタのJMS宛先

プロパティ

説明

ConnectionFactory名

jms/EMSYSTopicConnectionFactoryまたはjms/EMSYSQueueConnectionFactory

宛先名

jms/EMSYSSecurityFilterTopic

JMSメッセージ・タイプ

テキスト・メッセージ

説明

セキュリティ・フィルタ情報がこの宛先で送信されます。

表3-8 アラート・データのJMS宛先

プロパティ

説明

ConnectionFactory名

jms/EMSYSTopicConnectionFactoryまたはjms/EMSYSQueueConnectionFactory

宛先名

jms/EMSYSAlertsDataTopic

JMSメッセージ・タイプ

テキスト・メッセージ

説明

アラートがこの宛先で送信されます。

表3-9 RAWまたは平均SLAデータのJMS宛先

プロパティ

説明

ConnectionFactory名

jms/EMSYSTopicConnectionFactoryまたはjms/EMSYSQueueConnectionFactory

宛先名

- RAW:
jms/EMSYSATargetSLATopicまたはjms/EMSYSATargetSLAQueue

- 過去24時間:
jms/EMSYSATargetSLALast24HoursTopicまたはjms/EMSYSATargetSLALast24HoursQueue

- 過去7日間:
jms/EMSYSATargetSLALast7DaysTopicまたはjms/EMSYSATargetSLALast7DaysQueue

- 過去31日間:
jms/EMSYSATargetSLALast31DaysTopicまたはjms/EMSYSATargetSLALast31DaysQueue

JMSメッセージ・タイプ

テキスト・メッセージ

説明

この宛先は、RAWまたは平均ターゲットSLAデータの送信に使用されます。RAWまたは平均SLAメトリックは、サービス・ターゲットについてのみ表示されます。

アウトバウンド・メッセージ・スキーマ

次の項では、アウトバウンド・メッセージ・スキーマについて説明します。スキーマは、正規化されたメッセージ形式か非正規化されたメッセージ形式かによって異なります。

異なるタイプのメトリック・データ間での回帰や競合を防ぐために、RAWデータと履歴データではXML要素およびターゲットの名前が異なっています。表3-10は、生成される粒度のタイプに基づいたこれらの違いを示しています。

表3-10 RAWデータと履歴データ

粒度

メトリック要素の名前

ターゲット・ステータス要素の名前

SLAターゲットの名前

RAW

MetricData

TargetStatus

TargetSLA

過去24時間

MetricDataLast24Hours

TargetStatusLast24Hours

TargetSLALast24Hours

過去7日間

MetricDataLast7Days

TargetStatusLast7Days

TargetSLALast7Days

過去31日間

MetricDataLast31Days

TargetStatusLast31Days

TargetSLALast31Days

正規化されたメッセージ形式

正規化された形式の送信メッセージのスキーマは、次のとおりです。

正規化されたターゲット・メッセージ

選択した各ターゲットに対し、対応するターゲット・メタデータ情報がセッション設定フェーズで外部システムに送信されます。これらのメッセージのスキーマは、次のとおりです。

表3-11 正規化されたターゲット・メッセージ

要素とサンプル

説明

パス式

EMSYSData/Target

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/OutboundTarget.xsd

宛先

jms/EMSYSTargetsTopicまたはjms/EMSYSTargetsQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="Target" type="de:TargetType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Target Type -->
<xs:complexType name="TargetType">
<xs:all>
<xs:element name="TargetName" type="xs:string"/>
<xs:element name="TargetType" type="xs:string"/>
<xs:element name="TargetGUID" type="xs:string"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/">
<Target>
<TargetName>/ade/foo_core9/oracle.stacd16.us.oracle.com_home</TargetName>
<TargetType>oc4j</TargetType>
<TargetGUID>852464ac3e4176460458297faaffe926</TargetGUID>
</Target>
<Target>
<TargetName>stacd16.us.oracle.com</TargetName>
<TargetType>host</TargetType>
<TargetGUID>00645a665bfd9b72b2a6bb6ef49606b0</TargetGUID>
</Target>
</de:EMSYSData>

正規化されたメトリック・メッセージ

選択した各メトリックに対し、対応するメトリック・メタデータ情報がセッション設定時に外部システムに送信されます。これらのメッセージのスキーマは、次のとおりです。

表3-12 正規化されたメトリック・メッセージ

要素とサンプル

説明

パス式

EMSYSData/Metric

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/OutboundSecurityFilter.xsd

宛先

jms/EMSYSMetricsTopicまたはjms/EMSYSMetricsQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="Metric" type="de:MetricType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Metric Type -->
<xs:complexType name="MetricType">
<xs:all>
<xs:element name="MetricName" type="xs:string"/>
<xs:element name="MetricType" type="xs:string"/>
<xs:element name="MetricGUID" type="xs:string"/>
<xs:element name="MetricColumn" type="xs:string" minOccurs="0"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/">
<Metric>
<MetricColumn>DiskActivityavserv</MetricColumn>
<MetricGUID>6ca028d5078fe542b2ee0c1b013727d7</MetricGUID>
<TargetType>host</TargetType>
<MetricName>DiskActivity</MetricName>
</Metric>
<Metric>
<MetricColumn>cpuUtil</MetricColumn>
<MetricGUID>0c71a1afac2d7199013837da35522c08</MetricGUID>
<TargetType>host</TargetType>
<MetricName>Load</MetricName>
</Metric>
</de:EMSYSData>

正規化されたセキュリティ・フィルタ・メッセージ

Enterprise Managerのデータを使用する外部システムは、セッション名に基づいて、アクセス・コントロールを実行できます。これは、セキュリティ・フィルタを取得することで実現できます。これらのセキュリティ・フィルタ・メッセージのスキーマは、次のとおりです。

表3-13 正規化されたセキュリティ・フィルタ・メッセージ

要素とサンプル

説明

パス式

EMSYSData/SecurityFilter

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/OutboundMetric.xsd

宛先

jms/EMSYSSecurityFilterTopicまたはjms/EMSYSSecurityFilterQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="SecurityFilter" type="de:SecurityFilterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Security Filter Type -->
<xs:complexType name="SecurityFilterType">
<xs:all>
<xs:element name="SessionName" type="xs:string"/>
<xs:element name="UserName" type="xs:string"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/">
<SecurityFilter>
<SessionName>LoanSession</SessionName>
<UserName>LoanAdminUser</UserName>
</SecurityFilter>
</de:EMSYSData>

正規化されたメトリック・データ・メッセージ

正規化されたメッセージ形式では、メトリックはGUIDとともに送信され、メッセージごとのメタ情報の送信が回避されます。このメトリック・メッセージのスキーマは、次のとおりです。

表3-14 正規化されたメトリック・データ・メッセージ

要素とサンプル

説明

パス式

EMSYSData/MetricData

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/ OutboundNormalizedMetricsData.xsd

宛先

jms/EMSYSMetricsDataTopicまたはjms/EMSYSMetricsDataQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="MetricData" type="de:MetricDataType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Metric Data Type -->
<xs:complexType name="MetricDataType">
<xs:all>
<xs:element name="SessionName" type="xs:string"/>
<xs:element name="TargetGUID" type="xs:string"/>
<xs:element name="MetricGUID" type="xs:string"/>
<xs:element name="Timestamp" type="xs:dateTime"/>
<xs:element name="Value" type="xs:float"  minOccurs="0"/>
<xs:element name="StringValue" type="xs:string" minOccurs="0"/>
<xs:element name="KeyValue" type="xs:string" minOccurs="0"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/ 10203/OutboundData/">
<MetricDataLast24Hrs>
<MetricGUID>df8067b7d515747434b58d69230b8451</MetricGUID>
<Value>0.67</Value>
<Timestamp>07/13/2012 14:44:42</Timestamp>
<SessionName>Session1</SessionName>
<TargetGUID>00645a665bfd9b72b2a6bb6ef49606b0</TargetGUID>
</MetricDataLast24Hrs>
</de: EMSYSData >

正規化されたアラート・メッセージ

正規化されたメッセージ形式では、アラートはGUIDとともに送信され、メッセージごとのメタ情報の送信が回避されます。このアラート・メッセージのスキーマは、次のとおりです。

表3-15 正規化されたアラート・メッセージ

要素とサンプル

説明

パス式

EMSYSData/Alert

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/ OutboundNormalizedAlertsData.xsd

宛先

jms/EMSYSAlertsDataTopicまたはjms/EMSYSAlertsDataQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="Alert" type="de:AlertType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Alert Type -->
<xs:complexType name="AlertType">
<xs:all>
<xs:element name="SessionName" type="xs:string"/>
<xs:element name="TargetGUID" type="xs:string"/>
<xs:element name="MetricGUID" type="xs:string"/>
<xs:element name="Timestamp" type="xs:dateTime"/>
<xs:element name="Severity" type="xs:string"/>
<xs:element name="Value" type="xs:float" minOccurs="0"/>
<xs:element name="Message" type="xs:string" minOccurs="0"/>
<xs:element name="KeyValue" type="xs:string" minOccurs="0"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/ /10203/OutboundData/">
<Alert>
<MetricGUID>0c71a1afac2d7199013837da35522c08</MetricGUID>
<Value>25.35</Value>
<Message>CPU Utilization is 25.35%, crossed warning (15) or critical (95) threshold.</Message>
<Severity>Warning</Severity>
<Timestamp>07/13/2012 14:59:42</Timestamp>
<SessionName>Session9</SessionName>
<TargetGUID>00645a665bfd9b72b2a6bb6ef49606b0</TargetGUID>
</Alert>
</de:EMSYSData

重大度のリスト

- CLEAR

- INFO

- WARNING

- CRITICAL

- AGENT UNREACHABLE CLEAR

- AGENT UNREACHABLE START

- BLACKOUT END

- BLACKOUT START

- METRIC ERROR END

- METRIC ERROR START

正規化されたターゲット可用性メッセージ

正規化されたターゲット可用性情報メッセージのスキーマは、次のとおりです。

表3-16 正規化されたターゲット可用性メッセージ

要素とサンプル

説明

パス式

EMSYSData/TargetStatus

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/OutboundNormalizedTargetStatus.xsd

宛先

jms/EMSYSTargetStatusTopicまたはjms/EMSYSTargetStatusQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="TargetStatus" type="de:TargetsStatusType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Target Status Type -->
<xs:complexType name="TargetStatusType">
<xs:all>
<xs:element name="SessionName" type="xs:string"/>
<xs:element name="TargetGUID" type="xs:string"/>
<xs:element name="Status" type="xs:integer"/>
<xs:element name="Timestamp" type="xs:dateTime"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData
xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203
/OutboundData/">
<TargetStatusLast7Days>
<Status>1</Status>
<Timestamp>07/11/2012 16:21:53</Timestamp>
<SessionName>Session1</SessionName>
<TargetGUID>00645a665bfd9b72b2a6bb6ef49606b0</TargetGUID>
</TargetStatusLast7Days>
</de:EMSYSData>

次の表に、ステータス値を示します。

値

ステータス

1

ターゲットは起動し使用可能です。

-1

- ターゲットは停止しています。

- メトリック・エラー

- エージェントは停止しています。

0

- ブラックアウト

- ターゲットは監視されていません。

- ターゲットが不明です。

正規化されたターゲットSLAメッセージ

正規化されたターゲットSLA情報メッセージのスキーマは、次のとおりです。

表3-17 正規化されたターゲットSLAメッセージ

要素とサンプル

説明

パス式

EMSYSData/TargetSLA

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/OutboundNormalizedTargetSLA.xsd

宛先

jms/EMSYSTargetSLATopicまたはjms/EMSYSTargetSLAQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<!-- Schema for Normalized Outbound Target Status message -->
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/ DataExchange/10203/OutboundData/"xmlns:de="http://xmlns.oracle.com/
EnterpriseManager/DataExchange/10203/OutboundData/
" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<!-- Define the root element -->
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root type -->
<xs:complexType name="EMSYSDataType">
<!-- Zero or more TargetSLA elements -->
<xs:sequence>
<xs:element name="TargetSLA"                                  type="de:TargetSLAType" minOccurs="0"                                                                  maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the TargetSLA Type -->
<xs:complexType name="MetricDataType">
<xs:all>
<xs:element name="SessionName"                          type="xs:string"/>
<xs:element name="TargetGUID"                          type="xs:string"/>
<xs:element name="SLA" type="xs:integer"/>
<xs:element name="Timestamp"                          type="xs:dateTime"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<?xml version="1.0" encoding="UTF-8"?>
<!-- Schema for Normalized Outbound Target Status message -->
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/ DataExchange/10203/OutboundData/"xmlns:de="http://xmlns.oracle.com/
EnterpriseManager/DataExchange/10203/OutboundData/
" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<!-- Define the root element -->
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root type -->
<xs:complexType name="EMSYSDataType">
<!-- Zero or more TargetSLA elements -->
<xs:sequence>
<xs:element name="TargetSLA"                                  type="de:TargetSLAType" minOccurs="0"                                                                  maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the TargetSLA Type -->
<xs:complexType name="MetricDataType">
<xs:all>
<xs:element name="SessionName"                          type="xs:string"/>
<xs:element name="TargetGUID"                          type="xs:string"/>
<xs:element name="SLA" type="xs:integer"/>
<xs:element name="Timestamp"                          type="xs:dateTime"/>
</xs:all>
</xs:complexType>
</xs:schema>
<de:EMSYSData
xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203
/OutboundData/">
<TargetStatusLast7Days>
<Status>1</Status>
<Timestamp>07/11/2012 16:21:53</Timestamp>
<SessionName>Session1</SessionName>
<TargetGUID>00645a665bfd9b72b2a6bb6ef49606b0</TargetGUID>
</TargetStatusLast7Days>
</de:EMSYSData>

非正規化されたメッセージ形式

次の項では、非正規化された形式の送信メッセージのスキーマについて説明します。

非正規化されたメトリック・データ・メッセージ

非正規化されたメトリック・データ・メッセージのスキーマは、次のとおりです。

表3-18 非正規化されたメトリック・データ・メッセージ

要素とサンプル

説明

パス式

EMSYSData/MetricData

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/ OutboundDenormalizedMetricsData.xsd

宛先

jms/EMSYSMetricsDataTopicまたはjms/EMSYSMetricsDataQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="MetricData" type="de:MetricDataType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Metric Data Type -->
<xs:complexType name="MetricDataType">
<xs:all>
<xs:element name="SessionName" type="xs:string"/>
<xs:element name="TargetName" type="xs:string"/>
<xs:element name="TargetType" type="xs:string"/>
<xs:element name="MetricName" type="xs:string"/>
<xs:element name="MetricColumn" type="xs:string" minOccurs="0"/>
<xs:element name="Timestamp" type="xs:dateTime"/>
<xs:element name="Value" type="xs:float"  minOccurs="0"/>
<xs:element name="StringValue" type="xs:string" minOccurs="0"/>
<xs:element name="KeyValue" type="xs:string" minOccurs="0"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/">
<MetricDataLast24Hours>
<SessionName>Session1</SessionName>
<TargeName>OC4J 10.1.3</TargetName>
<TargetType>generic_service</TargetType>
<MetricName>Usage Value</MetricName>
<Timestamp>2001-12-17T09:30:47-05:00</Timestamp>
<Value>3.14159</Value>
</MetricDataLast24Hours>
</EMSYSData>

非正規化されたアラート・メッセージ

非正規化されたアラート・メッセージのスキーマは、次のとおりです。

表3-19 非正規化されたアラート・メッセージ

要素とサンプル

説明

パス式

EMSYSData/Alert

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/ OutboundDenormalizedAlertsData.xsd

宛先

jms/EMSYSAlertsDataTopicまたはjms/EMSYSAlertsDataQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="Alert" type="de:AlertType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Alert Type -->
<xs:complexType name="AlertType">
<xs:all>
<xs:element name="SessionName" type="xs:string"/>
<xs:element name="TargetName" type="xs:string"/>
<xs:element name="TargetType" type="xs:string"/>
<xs:element name="MetricName" type="xs:string"/>
<xs:element name="MetricColumn" type="xs:string" minOccurs="0"/>
<xs:element name="Timestamp" type="xs:dateTime"/>
<xs:element name="Severity" type="xs:string"/>
<xs:element name="Value" type="xs:float" minOccurs="0"/>
<xs:element name="Message" type="xs:string" minOccurs="0"/>
<xs:element name="KeyValue" type="xs:string" minOccurs="0"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/">
<Alert>
<SessionName>Session9</SessionName>
<TargeName>OC4J 10.1.3</TargetName>
<TargetType>generic_service</TargetType>
<MetricName>Usage Value</MetricName>
<Value>25.35</Value>
<Message>CPU Utilization is 25.35%, crossed warning (15) or critical (95) threshold.</Message>
<Severity>Warning</Severity>
<Timestamp>07/13/2012 14:59:42</Timestamp>
</Alert>
</de:EMSYSData>

非正規化されたターゲット可用性メッセージ

非正規化されたターゲット可用性メッセージのスキーマは、次のとおりです。

表3-20 非正規化されたターゲット可用性メッセージ

要素とサンプル

説明

パス式

EMSYSData/TargetStatus

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/ OutboundDenormalizedTargetStatus.xsd

宛先

jms/EMSYSTargetStatusTopicまたはjms/EMSYSTargetStatusQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root element -->
<xs:complexType name="EMSYSDataType">
<xs:sequence>
<xs:element name="TargetStatus" type="de:TargetStatusType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Target Status Type -->
<xs:complexType name="TargetStatusType">
<xs:all>
<xs:element name="SessionName" type="xs:string"/>
<xs:element name="TargetName" type="xs:string"/>
<xs:element name="TargetType" type="xs:string"/>
<xs:element name="Status" type="xs:integer"/>
<xs:element name="Timestamp" type="xs:dateTime"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/">
<TargetStatus>
<Status>1</Status>
<Timestamp>07/11/2012 16:21:53</Timestamp>
<SessionName>Session1</SessionName>
<TargeName>OC4J 10.1.3</TargetName>

<TargetType>generic_service</TargetType>
</TargetStatus>
</de:EMSYSData>

非正規化されたターゲットSLAメッセージ

非正規化されたターゲットSLA情報メッセージのスキーマは、次のとおりです。

表3-21 非正規化されたターゲットSLAメッセージ

要素とサンプル

説明

パス式

EMSYSData/TargetSLA

スキーマ・ファイルの場所

$ORACLE_HOME/sysman/bam/OutboundDenormalizedTargetSLA.xsd

宛先

jms/EMSYSTargetSLATopicまたはjms/EMSYSTargetSLAQueue

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<!-- Schema for Denormalized Outbound Target Status message -->
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/ DataExchange/10203/OutboundData/"  xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/ 10203/OutboundData/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<!-- Define the root element -->
<xs:element name="EMSYSData" type="de:EMSYSDataType"/>
<!-- Define the root type -->
<xs:complexType name="EMSYSDataType">
<!-- zero or more target status elements -->
<xs:sequence>
<xs:element name="TargetSLA"                           type="de:MetricDataType"                           minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Define the Target Status Type -->
<xs:complexType name="TargetSLAType">
<xs:all>
<xs:element name="SessionName"                           type="xs:string"/>
<xs:element name="TargetName"                           type="xs:string"/>
<xs:element name="TargetType"                           type="xs:string"/>
<xs:element name="SLA" type="xs:integer"/>
<xs:element name="Timestamp"                           type="xs:dateTime"/>
</xs:all>
</xs:complexType>
</xs:schema>

サンプル

<de:EMSYSData xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/OutboundData/">
<TargetSLA>
<SLA>100</SLA>
<Timestamp>07/11/2012 16:21:53</Timestamp>
<SessionName>Session1</SessionName>
<TargeName>OC4J 10.1.3</TargetName>
<TargetType>generic_service</TargetType>
</TargetSLA>
</de:EMSYSData>

アウトバウンド・セッション・メッセージ・パラメータのチューニング

emctlコマンドを使用して、アウトバウンド・セッション・メッセージ・パラメータをチューニングできます(表3-22を参照)。

注意:
パラメータを有効にするため、プロパティの設定後にOMSを再起動する必要があります。

表3-22 チューニング可能なアウトバウンド・セッション・メッセージ・パラメータ

プロパティ名

デフォルト値

セマンティクス

oracle.sysman.core.dataExchange.MaxData PointsPerMessage

100

メッセージ内のメトリック・データ・ポイントの数。

oracle.sysman.core.dataExchange.Interval BetweenMessage

2秒

次のJMSメッセージまでの時間間隔(秒単位)。

oracle.sysman.core.dataExchange.FirstDatasetWindow

60分

最初のメッセージの送信時に、過去の最初の設定データ・ウィンドウの日付が送信されます。単位は分です。

例3-1 アウトバウンド・セッション・メッセージ・パラメータのチューニングのコマンド構文

emctl {set property|get property}
{oracle.sysman.core.dataExchange.MaxDataPointsPerMessage |
oracle.sysman.core.dataExchange.IntervalBetweenMessage |
oracle.sysman.core.dataExchange.FirstDatasetWindow}

プロパティの設定後、OMSを再起動してプロパティを有効にする必要があります。

インバウンド・データ交換セッションの作成

インバウンド・データ交換セッションを作成するには、設定ウィザードの各ページで、次の手順で説明している入力を指定します。

1. データ交換ページで、「インバウンド・データ交換セッション」リンクをクリックします。

2. 「作成」をクリックします。ウィザードの「セッションのセットアップ」ステップが表示されます。

1. Enterprise Managerからデータを受信するには、トピックで構成された1つ以上のデータ交換ハブにアクセスできることを確認してください。データ交換ハブを設定するには、「データ交換ハブの作成」を参照してください。

2. 「名前」フィールドに、このインバウンド・データ交換セッションの一意の名前を指定します。

3. すでに作成済でアルファベット順に一覧表示されたハブのリストから、データ交換ハブを選択します。デフォルトでは、リストにある最初のハブが選択されます。
KPIをCloud Controlにインポートする場合、対応するビジネスKPIに受信ビジネス・イベントが関連付けられます。インポートしない場合、イベントは、ExternalAlertMetricという名前の特別な組込みメトリックに関連付けられます。

4. 「次へ」をクリックします。ウィザードの「ビジネス・イベント/インジケータの選択」ステップが表示されます。

3. ビジネス・イベントをCloud Controlに送信する必要がある場合は、「ビジネス・イベントの追加」をクリックします。それ以外の場合は、ステップ4にスキップします。ビジネス・イベント/インジケータの選択: ビジネス・イベントの追加ページが表示されます。

1. イベントの取得元となる既存データ・ソースの名前を指定します。セッション内のデータソース名は、一意であることが必要です。

2. オプションで、「受信メッセージにXSL変換を適用」を選択し、受信メッセージにXSLスタイルシートを適用します。この変換は、図3-2に示します。「表示」をクリックすると、複数行のテキスト・ボックスが表示され、XSLドキュメントを挿入できます。このオプションを選択した場合は、「構文チェック」を選択して、処理を続行する前にエントリが正確であることを確認します。
XSLT変換の最も一般的な使用対象として、ビジネスKPIまたはイベントをトランスポートする受信メッセージがあります。KPIまたはイベントにより必要なメッセージ(スキーマ)が生成されない場合は、メッセージの書式自体を変更するのではなく、Cloud Control側でXSLを適用できます。

図3-2 XMLソース文書のXSLT変換

3. 受信イベントに対するJMS宛先の詳細を指定します。データの取得元となる宛先ConnectionFactory、およびオプションの永続サブスクライバ名(トピックの場合のみ必要、キューの場合は不要)を指定する必要があります。これにより、トピックに関連するすべてのメッセージが指定されたサブスクライバに送信されます。トピックに永続サブスクライバを指定すると、受信イベントの消失を防止できます。
Cloud Controlとデータ交換ハブの間で必ず認証済の接続が作成されるようにするため、ユーザー名およびパスワードを指定し、これらの資格証明で接続を確立します。「接続テスト」をクリックすると、入力が有効であることを検証できます。

4. ビジネス・イベントを、Cloud Controlで監視中のターゲットに関連付けます。ビジネス・イベントは任意のEnterprise Manager監視ターゲットと関連付けできます。
ターゲットのドロップダウン・リストには使用可能なすべてのターゲット・タイプが表示され、「汎用サービス」ターゲット・タイプがデフォルトとして表示されます。リストにない特定のターゲットに関連付けられたビジネス・イベントを選択する場合は、ターゲット・ページからターゲットを追加してから、インバウンド・セッションを作成するプロシージャを再起動します。

5. 「OK」をクリックして構成を保存してから、入力内容を表形式で表示し、必要に応じて選択内容を編集します。
また、「類似追加」をクリックすることにより、選択内容を別のターゲットのテンプレートとして使用することもできます。

4. ビジネス・インジケータをCloud Controlに送信する必要がある場合は、「ビジネス・インジケータの追加」をクリックします。それ以外の場合は、手順5に進みます。ビジネス・イベント/インジケータの選択: ビジネス・インジケータの追加ページが表示されます。

1. インジケータの取得元となる既存の外部データ・ソースの名前を指定します。セッション内のデータソース名は、一意であることが必要です。データソースから送信されたXMLメッセージでネームスペースが有効な場合は、それを示すチェック・ボックスを選択し、完全修飾ネームスペースも指定します。

2. オプションで、「受信メッセージにXSL変換を適用」を選択し、受信メッセージにXSLスタイルシートを適用します。「表示」をクリックすると、複数行のテキスト・ボックスが表示され、XSLドキュメントを挿入できます。このオプションを選択した場合は、「構文チェック」を選択して、処理を続行する前にエントリが正確であることを確認します。

3. 「インジケータの追加」をクリックして、Cloud Controlに送信する必要があるビジネス・インジケータを指定します。ビジネス・インジケータに対応するメトリック名は<ソース名>_<インジケータ名>になります。すべてのインジケータには、数値のみを含めることができます。

4. 受信インジケータに対するJMS宛先の詳細を指定します。データの取得元となる宛先ConnectionFactory、およびオプションの永続サブスクライバ名(トピックの場合のみ必要、キューの場合は不要)を指定する必要があります。これにより、トピックに関連するすべてのメッセージが指定されたサブスクライバに送信されます。永続サブスクライバ・トピックを指定すると、受信イベントの消失を防止できます。
Cloud Controlとデータ交換ハブの間で必ず認証済の接続が作成されるようにするため、ユーザー名およびパスワードを指定し、これらの資格証明で接続を確立します。「接続テスト」をクリックすると、入力が有効であることを検証できます。

5. ビジネス・インジケータを、Cloud Controlで監視中のターゲットに関連付けます。どのようなターゲット・タイプのインスタンスにも関連付けが可能なビジネス・イベントとは異なり、ビジネス・インジケータは、サービス・ターゲット・タイプのインスタンスにのみ関連付けできます。
ターゲットのドロップダウン・リストには使用可能なすべてのターゲット・タイプが表示され、「汎用サービス」ターゲット・タイプがデフォルトとして表示されます。リストにない特定のターゲットに関連付けられたビジネス・イベントを選択する場合は、ターゲット・ページからターゲットを追加してから、インバウンド・セッションを作成するプロシージャを再起動します。

6. 「OK」をクリックして入力を保存してから、入力内容を表形式で表示し、必要に応じて選択内容を編集します。
また、「類似追加」をクリックすることにより、選択内容を別のターゲットのテンプレートとして使用することもできます。

5. 構成に問題がなければ「次へ」をクリックします。ウィザードの「スケジュール」ステップが表示されます。次のスケジュールの選択肢の1つを選択します。

- 後でスケジュール: スケジュールを遅延し、ウィザードの「確認」ステップで「終了」をクリックした後で、アウトバウンド・データ交換セッション・サブページからセッションをスケジュールします。

- ただちにスケジュール: 次のいずれかのサブタイプを選択します。

- 1回(即時): このオプションを選択した場合、セッションは作成が終了したときに1回実行されます。

- 1回(後で): このオプションを選択した場合、セッションのタイムゾーンおよび開始日時を指定する必要があります。

- 繰返し: このデフォルト・オプションでは、タイムゾーンおよび開始時刻を指定する必要があります。また、セッションを実行する頻度タイプおよび間隔と、セッションの繰返しが無制限か指定された日時までかを指定できます。

6. 「次へ」または「確認」をクリックし、ウィザードの「確認」ステップに進みます。
変更を行う必要がある場合は、変更が必要なステップに到達するまで「戻る」をクリックします。HTTPSでない場合は、次の手順に進みます。

7. 「終了」をクリックします。インバウンド・データ交換セッション・サブページが再表示され、新しく作成されたセッションとそのステータスが表に表示されます。
ジョブの実行が終了する前に、「アクション」列の「スケジュールの表示」リンクをクリックしてスケジュールを表示できます。また、必要に応じて実行を停止できます。または、「停止」をクリックして実行を即時停止することもできます。

インバウンドJMS宛先

アウトバウンド・データ交換の設定でEnterprise Managerデータの送信に事前定義されたトピックおよびキューが使用されるのとは異なり、ビジネス・パフォーマンス・インジケータおよびビジネス・パフォーマンス・イベントの受信には、事前定義されたトピックまたはキューは使用されません。

ただし、データソースに使用されるJMSトピックまたはキューを、インバウンド・データ交換セッションに使用されるJMSサーバー内で構成する必要があります。

インバウンド・メッセージ・スキーマ

次の項では、インバウンド・メッセージ・スキーマを定義しています。各スキーマとともに、メッセージの例が示されています。

インバウンド・インジケータ・スキーマ

セッションの作成後、送信者は、インバウンド・データ交換セッションで定義したJMS宛先を介し、データ交換ハブを使用して、XML形式でデータを転送できます。

メッセージは、修飾ネームスペースまたは非修飾ネームスペースのいずれかです。メッセージが修飾されたネームスペースの場合、ネームスペースは、データソースの設定時に入力する必要があります。

修飾XMLメッセージの例

<po:PurchaseOrder xmlns:po:"http://acme.com/Orders">
<OrderAmount>5000</OrderAmount>
<NoOfItems> 15 </NoOfItems>
</po:PurchaseOrder>

非修飾XMLメッセージの例

<PurchaseOrder>
<OrderAmount>5000</OrderAmount>
<NoOfItems> 15 </NoOfItems>
</PurchaseOrder>

メッセージ・セマンティクス

受信メッセージは、次に示すセマンティックに従う必要があります。

- 例3-2のように、トップレベル要素のローカル名は、データソース名と同一である必要があります。

- メッセージが修飾されている場合、ネームスペースは、データソースの設定時に定義される必要があります。

- 例3-2のように、1つ以上のインジケータを、この要素内で子要素として送信できます。

- タイムスタンプを名前として持つサブ要素には、特別なセマンティクスがあります。タイムスタンプ名を持つサブ要素が存在する場合、インジケータはそのタイムスタンプ値とともに挿入されます。タイムスタンプ要素が存在しない場合、インジケータをリポジトリに挿入する際、現在の時刻が使用されます。
たとえば、リクエストが次のようにタイムスタンプ・サブ要素とともに受信された場合、インジケータはそのタイムスタンプ(2012-09-30 17:43:19.474)とともに挿入されます。

<po: PurchaseOrder xmlns:po:"http://acme.com/Orders">
<OrderAmount>5000</OrderAmount>
<NoOfItems> 15 </NoOfItems>
<Timestamp>2012-10-30 17:43:19.474</Timestamp>
</po: PurchaseOrder>

タイムスタンプ・サブ要素が存在しない場合、インジケータは、受信された現在のタイムスタンプとともにリポジトリに挿入されます。

例3-2 データソースの使用例

Orderというデータソース名で、受信ビジネス・インジケータのデータソースを作成します。次の3つのKPIを追加します。

- OrderAmount

- NoOfItems

- Credit
この場合、受信XMLメッセージは、次の形式であることが必要です。

<Order>
<OrderAmount>35</OrderAmount>
<NoOfItems>102</NoOfItems>
<Credit>72</Credit>
<Timestamp>2007-01-16 16:29:00.978</Timestamp>
</Order>

注意:
この例では、トップレベル要素のローカル名は、データソース名<Order>と同一である必要があります。
また、Creditなどのインジケータは、同じ名前を持つ子要素として送信されます。

メッセージ要素のデフォルト設定

- TargetNameおよびTargetTypeがメッセージの一部である場合、それらは(データソースに)関連するターゲットのターゲット名およびターゲット・タイプと一致している必要があります。

- TargetNameがメッセージの一部でない場合、データソースが関連付けられていたターゲットにデフォルト設定されます。

- TargetTypeがメッセージの一部でない場合、ターゲットのターゲット・タイプにデフォルト設定されます。

- メッセージにTimestampが含まれていない場合、現在のタイムスタンプにデフォルト設定されます。

- メッセージにCategoryが含まれていない場合、カテゴリGenericExternalAlertMetricにデフォルト設定されます。

- メッセージにMetricNameが含まれていない場合、アラート・メトリックにデフォルト設定されます。

- ProducerIDは、カテゴリGenericExternalAlertMetricおよびMetricのオプションです。
ただし、ユーザー定義メトリックの場合、プロデューサIDが必要です。その場合、ProducerIDは、メトリックの作成者と同一にする必要があります。

インバウンド・アラート・スキーマ

外部システムから、その独自のアラートまたはイベントをEnterprise Managerに送信し、Enterprise Managerのページに表示してSLAの一部として計算できます。

このスキーマは、次の場所で使用可能です。

$ORACLE_HOME/sysman/bam/InboundEvents.xsd

受信アラート・メッセージのスキーマは、次のとおりです。

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/InboundEvents/" xmlns:de="http://xmlns.oracle.com/EnterpriseManager/DataExchange/10203/InboundEvents/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<!-- Define the Alert element -->
<xs:element name="Alert" type="de:AlertType"/>
<!-- Define the Alert Type -->
<xs:complexType name="AlertType">
<xs:all>
<xs:element name="TargetType" type="xs:string" minOccurs="0"/>
<xs:element name="TargetName" type="xs:string" minOccurs="0"/>
<xs:element name="Category" type="xs:string" minOccurs="0"/>
<xs:element name="MetricName" type="xs:string" minOccurs="0"/>
<xs:element name="ProducerID" type="xs:string" minOccurs="0"/>
<xs:element name="Severity" type="xs:string"/>
<xs:element name="Message" type="xs:string" minOccurs="0"/>
<xs:element name="Key1" type="xs:string" minOccurs="0"/>
<xs:element name="Key2" type="xs:string" minOccurs="0"/>
<xs:element name="Key3" type="xs:string" minOccurs="0"/>
<xs:element name="Key4" type="xs:string" minOccurs="0"/>
<xs:element name="Value" type="xs:string" minOccurs="0"/>
<xs:element name="TimeStamp" type="xs:dateTime" minOccurs="0"/>
</xs:all>
</xs:complexType>
</xs:schema>

Enterprise ManagerとOBAMの統合

次の各項では、データ交換コネクタを使用してEnterprise ManagerとOBAMを統合する方法について説明します。

サポートされているバージョン

テスト済および認証済のOBAMサーバーのリリースは、次のとおりです。

- Oracle BAM Server 10gR2 (10.1.2.0.0)および10gR2パッチ・セット

- Oracle BAM Server 10gR3 (10.1.3.1.0)および10gR3パッチ・セット

- Oracle BAM Server 11gR1 (11.1.1.1.0)および11gR1パッチ・セット

注意:
Oracle BAM Server 10gR2および10gR3は、OC4Jベースです。Oracle BAM Server 11gR1以上は、WebLogic Web Serverベースです。したがって、設定の手順はかなり異なります。
次の各項では、基本的な手順およびガイドラインを示します。固有の情報および詳細は、Oracle BAM Serverのドキュメントを参照してください。

Enterprise ManagerからOBAMへのデータ・フローの設定

正常にEnterprise ManagerからOBAMへデータ・フローを実行するには、次の手順を実行します。

1. 必要なアーティファクトのインポート(「アウトバウンド・セッション用のOBAMアーティファクトのインポート」を参照)

2. JNDI詳細の更新(「JNDIの更新」を参照)

3. 表3–25に示すリンク計画の実行(これは、OBAM 10g R3以前のリリースにのみ必要です。)

アウトバウンド・セッション用のOBAMアーティファクトのインポート

OBAMサーバーは、Enterprise Managerの一部としてパッケージまたはインストールされません。OBAMインスタンスが存在し、起動し実行中であることが前提となっています。Enterprise Managerからデータを読み込んで保持するには、特定のアーティファクトが存在し、実行されている必要があります。事前パッケージ済のスクリプトからアーティファクトをインポートします。

OBAMサーバーとの統合に必要なOBAMアーティファクトをインポートするには、スーパーユーザーとして、次のスクリプトを実行します。

- Oracle BAM 11gR1 (11.1.1.1.0)以上のリリースの場合:

ICommand cmd=import file=emsys_all_11.xml

- Oracle BAM 10gR3以前のリリースの場合:

ICommand cmd=import file=emsys_all_10.xml

これらのファイルはいずれも、次の場所にあります。

$ORACLE_HOME/sysman/bam directory

前述のエクスポート・スクリプトにより、次のOBAMアーティファクトが作成されます。

- EM-BAMデータ・オブジェクト

- EM-BAM EMS定義

- EM-BAMエンタープライズ・リンク計画(emsys_all_10.xmlを使用する場合のみ)。表3–25を参照してください。

EM-BAMデータ・オブジェクト

表3-23に、インポート・コマンドで作成されるデータ・オブジェクトを示します。

表3-23 EM-BAMデータ・オブジェクト

データ・オブジェクト

説明

/SYSMAN/EMSYSTargets

ターゲット名およびターゲット・タイプなどのターゲット・メタデータ情報を含みます。

/SYSMAN/EMSYSMetrics

メトリック名、メトリック列およびターゲット・タイプなどのメトリック・メタデータを含みます。

/SYSMAN/EMSYSAlertsData

Enterprise Managerから受信した受信システム・アラートを含みます。これには、アラート・メッセージ、アラート重大度、アラート・タイムスタンプおよびこのアラートの発生が基づくターゲット情報などの情報が含まれます。

/SYSMAN/EMSYSTargetSLA

データ・オブジェクト・スナップショットのSLA値。

/SYSMAN/EMSYSTargetSLA Last24Hours

過去24時間の平均SLA値を格納するデータ・オブジェクト。

/SYSMAN/EMSYSTargetSLA Last7Days

過去7日間の平均SLA値を格納するデータ・オブジェクト。

/SYSMAN/EMSYSTargetSLA Last31Days

過去31日間の平均SLA値を格納するデータ・オブジェクト。

/SYSMAN/EMSYSTargetSLAData

Enterprise Managerから受信したターゲットSLA情報を含みます。

/SYSMAN/EMSYSTargetStatus

ターゲット・ステータス情報(パーセンテージ)を含みます。

/SYSMAN/EMSYSTargetStatus Last24Hours

24時間の平均値としてのターゲット・ステータス情報(パーセンテージ)を含みます。

/SYSMAN/EMSYSTargetStatus Last7Days

7日間の平均値としてのターゲット・ステータス情報(パーセンテージ)を含みます。

/SYSMAN/EMSYSTargetStatus Last31Days

31日間の平均値としてのターゲット・ステータス情報(パーセンテージ)を含みます。

/SYSMAN/EMSYSMetricsData

RAWメトリック用のデータ・オブジェクト。

/SYSMAN/EMSYSMetricsData Last24Hours

過去24時間の平均メトリック・データを格納するデータ・オブジェクト。

/SYSMAN/EMSYSMetricsData Last7Days

過去7日間の平均メトリック・データを格納するデータ・オブジェクト。

/SYSMAN/EMSYSMetricsData Last31Days

過去31日間の平均メトリック・データを格納するデータ・オブジェクト。

/SYSMAN/EMSYSSecurityFilter

その他すべてのデータ・オブジェクトに対して、セキュリティ・フィルタとして機能します。これには、セッション名および対応するセッション・データにアクセスできるユーザーが含まれます。

EM-BAM EMS定義

表3-24に、インポート・コマンドで作成されるエンタープライズ・メッセージ・ソースを示します。

表3-24 EM-BAM EMS定義

データ定義

説明

EMSYSMetricsEMS

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSMetricsTopicでリスニングする受信メトリック・メタデータのEMS定義を含みます。

EMSYSTargetsEMS

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetsTopicでリスニングする受信ターゲット・メタデータのEMS定義を含みます。

EMSYSSecurityFilterEMS

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSSecurityFilterTopicでリスニングするセキュリティ・フィルタ・データのEMS定義を含みます。

EMSYSAlertsDataEMS

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSAlertsDataTopicでリスニングする受信アラートのEMS定義を含みます。

EMSYSMetricsDataEMS

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSMetricsDataTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusDataEMS

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetStatusTopicでリスニングする受信ターゲット・ステータス・メッセージ・メトリックのEMS定義を含みます。

EMSYSTargetSLAEMS

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetSLATopicでリスニングする受信ターゲットSLAメッセージのEMS定義を含みます。

EMSYSMetricsEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSMetricsQueueでリスニングする受信メトリック・メタデータのEMS定義を含みます。

EMSYSTargetsEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetsQueueでリスニングする受信ターゲット・メタデータのEMS定義を含みます。

EMSYSSecurityFilterEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSSecurityFilterQueueでリスニングするセキュリティ・フィルタ・データのEMS定義を含みます。

EMSYSAlertsDataEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSAlertsDataQueueでリスニングする受信アラートのEMS定義を含みます。

EMSYSMetricsDataEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSMetricsDataQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSMetricsDataLast24HoursEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSMetricsDataLast24HoursQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSMetricsDataLast7Days EMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSMetricsDataLast7DaysQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSMetricsDataLast31Days EMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSMetricsDataLast31DaysQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSMetricsDataEMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSMetricsDataTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSMetricsDataLast24Hours EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSMetricsDataLast24HoursTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSMetricsDataLast7Days EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSMetricsDataLast7DaysTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSMetricsDataLast31Days EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSMetricsDataLast31DaysTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLAEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetSLAQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLALast24Hours EMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetSLALast24HoursQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLALast7Days EMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetSLALast7DaysQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLALast31Days EMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetSLALast31DaysQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLAEMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetSLATopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLALast24Hours EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetSLALast24HoursTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLALast7Days EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetSLALast7DaysTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetSLALast31Days EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetSLALast31DaysTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetStatusQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusLast24HoursEMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetStatusLast24HoursQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusLast7Days EMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetStatusLast7DaysQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusLast31Days EMS-Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetStatusLast31DaysQueueでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusEMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetStatusTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusLast24Hours EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetStatusLast24HoursTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusLast7Days EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetStatusLast7DaysTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusLast31Days EMS-Topic

jms/EMSYSTopicConnectionFactoryおよびjms/EMSYSTargetStatusLast31DaysTopicでリスニングする受信メトリックのEMS定義を含みます。

EMSYSTargetStatusDataEMS- Queue

jms/EMSYSQueueConnectionFactoryおよびjms/EMSYSTargetSLAQueueでリスニングする受信ターゲットSLAメッセージのEMS定義を含みます。

JNDIの更新

表3-24に記載されたすべてのEMSを更新して、JMSサーバーの正しいJNDI初期コンテキスト・ファクトリおよびプロバイダURLを反映する必要があります。手順は次のとおりです。

1. OBAMコンソールで、「アーキテクト」をクリックします。
BAMアーキテクト画面が表示されます。

2. 左上部のドロップダウン・リストで、「エンタープライズ・メッセージ・ソース」を選択します。
左側のペインに、6つのエンタープライズ・メッセージ・ソースが表示されます。

3. メッセージ・ソース・リンクをクリックし、次の手順を実行します。

1. 右側のペインで、「編集」をクリックし、JNDIサービス・プロバイダURLの詳細を、t3://localhostから使用するデータ・ハブのJNDIサービス・プロバイダURLに変更します。

2. 「保存」をクリックします。

4. メッセージ・ソース・オブジェクトのすべてに対し、これを繰り返します。

5. リリースに応じて次の更新を実行します。

- 11gR1以上のリリースのOBAMの場合:
データ・ハブのWebLogicサーバーとOBAMのWebLogicサーバー間で、グローバル信頼またはドメイン間信頼を有効にします。詳細は、WebLogicのドキュメントを参照してください。

- 10gR3以前のリリースのOBAMの場合:
BAM_HOME\BAM\j2re1.4.1_01\libディレクトリで、java.naming.security.principalをjndi.propertiesにあるJMSサーバーのパスワードに更新します。

6. すべてのOBAMサービスを再起動します。

EM-BAMエンタープライズ・リンク計画

BAMデータ・オブジェクト(表3–23)およびEMS定義(表3–24)に加えて、emsys_all_10.xmlを使用してアーティファクトを作成すると、表3–25に示すリンク計画も作成されます。これらは、Oracle BAM Server 10gR3以前のリリースにのみ必要です。表3–25に示す計画は、インポート・コマンドに基づいて作成されます。

表3-25 EM-BAMリンク計画

計画

説明

EMSYSMetricsPlan

受信メトリック・メタデータ・メッセージの受信、変換および永続のための定義を含みます。

Enterprise Manager内にアウトバウンド・セッションを作成および設定する前に、これを実行する必要があります。

EMSYSTargetsPlan

受信ターゲット・メタデータ・メッセージの受信、変換および永続のための定義を含みます。

Enterprise Manager内にアウトバウンド・セッションを作成および設定する前に、これを実行する必要があります。

EMSYSSecurityFilterPlan

受信セキュリティ・フィルタ・メッセージの受信、変換および永続のための定義を含みます。

Enterprise Manager内にアウトバウンド・セッションを作成および設定する前に、これを実行する必要があります。

EMSYSAlertsDataPlan

受信アラート・メッセージの受信、変換および永続のための定義を含みます。

1つ以上の選択済アラートを伴うアウトバウンド・セッションがEnterprise Manager内で実行中に、これを実行する必要があります。

EMSYSMetricsDataPlan

受信メトリック・メッセージの受信、変換および永続のための定義を含みます。

1つ以上の選択済メトリックを伴うアウトバウンド・セッションがEnterprise Manager内で実行中に、これを実行する必要があります。

EMSYSTargetStatusDataPlan

受信ターゲット・ステータス・メッセージの受信、変換および永続のための定義を含みます。

1つ以上の選択済可用性メトリックを伴うアウトバウンド・セッションがEnterprise Manager内で実行中に、これを実行する必要があります。

EMSYSTargetSLADataPlan

受信ターゲットSLAメッセージの受信、変換および永続のための定義を含みます。

1つ以上の選択済SLAメトリックを伴うアウトバウンド・セッションがEnterprise Manager内で実行中に、これを実行する必要があります。

EMSYSAlertsDataRollup

EMSYSAlertsData内の24時間以上経過したデータを、EMSYSAlertsData.Archiveに移動するための定義を含みます。

オンデマンド・ベースで実行できます。

EMSYSMetricsDataRollup

EMSYSMetricsData内の24時間以上経過したデータを、EMSYSMetricsData.Archiveに移動するための定義を含みます。

オンデマンド・ベースで実行できます。

EMSYSTargetStatusDataRollup

EMSYSTargetStatusData内の24時間以上経過したデータを、EMSYSTargetStatusData.Archiveに移動するための定義を含みます。

オンデマンド・ベースで実行できます。

OBAMからEnterprise Managerへのデータ・フローの設定

データ・オブジェクト、EMS、計画などの事前定義済のOBAMアーティファクトが(必要に応じて) Enterprise Managerとともに定義され送信される、Enterprise ManagerからOBAMサーバーへのデータ転送の場合と異なり、OBAMからEnterprise Managerへのデータ転送の場合、アーティファクトの定義および送信はありません。これは、データ・オブジェクトまたはEMSが不明なためです。

したがって、OBAM 11g以上のリリースからのインバウンド・データ転送の場合、インテグレータは、Oracle Data Integratorを使用してデータ・オブジェクトからデータを読み取り、アウトバウンドJMSトピックまたはキューに入れる必要があります。OBAM 10g以前のリリースの場合、インテグレータは、アウトバウンド計画を使用してデータ・オブジェクトからデータを読み取り、アウトバウンドJMSトピックまたはキューに入れることができます。詳細は、ODIおよびOBAMのドキュメントを参照してください。

エンド・ツー・エンド・フロー

必要なアーティファクトでOBAMサーバーを、JMSトピック名またはキュー名でJMSサーバーを構成した後は、Enterprise ManagerからOBAMへの正常なデータ・フローのために、次のことを確認してください。

- OBAMサーバーおよびEnterprise Managerが起動し実行中であること。

- 必要なJMSトピックまたはキューで構成されたJMSサーバーが起動し実行中であること。

- 表3–25に記載されたすべてのエンタープライズ計画(OBAM 10g以前のリリースの場合のみ)が実行中であること。
手動で計画を起動できるか、Design Studioまたはアラートにより計画をスケジュールできること。

確認した後に、次の手順で先に進みます。

- Enterprise Manager内で、データ交換ハブおよびアウトバウンド・データ交換セッション・インスタンスを作成します。
OBAMサーバーで使用する場合は、常に、正規化されたメッセージ形式を使用してください。OBAMサーバー計画は、正規化されたメッセージにのみ対応しています。

- アウトバウンド・データ交換をスケジュールします。
Enterprise Managerは、アウトバウンド・データ交換セッションでスケジュールされたとおりに、データを送信します。

OC4Jをデータ交換ハブとして使用する方法

WebLogic ServerのかわりにOC4Jをデータ交換ハブとして使用するには、次の手順を実行します。

1. クライアント・ライブラリをコピーし、Cloud Controlを再起動します。

- 10.1.3.x OC4Jの場合、10.1.3.x oc4jclient.jarファイルを次の場所にコピーします。

$ORACLE_HOME/middleware/oms/sysman/archives/emgc/deployments/EMGC_DOMAIN/ emgc.ear/APP-INF/lib

- 10.1.2.x OC4Jの場合、10.1.2.x oc4j.jarファイルを次の場所にコピーします。

$ORACLE_HOME//middleware/oms/sysman/archives/emgc/deployments/EMGC_DOMAIN/ emgc.ear/APP-INF/lib

2. .jarファイルをコピーした後、Cloud Controlを再起動します。

3. JMS宛先でOC4Jサーバーを構成します。これを行うには、Application Server Controlを使用するか、次のようにjms.xmlファイルを手動で更新します。
次の例に、OC4J用のjms.xmlセクションを示します。

<topic-connection-factory/>
location="jms/EMSYSTopicConnectionFactory"

<topic>
name="EMSYSAlertsDataTopic"
location="jms/EMSYSAlertsDataTopic"
<description>Topic for alerts data</description>
</topic>

<topic>
name="EMSYSMetricsDataTopic"
location="jms/EMSYSMetricsDataTopic"
<description>Topic for metrics data</description>
</topic>

<topic>
name="EMSYSMetricsTopic"
location="jms/EMSYSMetricsTopic"
<description>Topic for metrics metadata</description>
</topic>

<topic>
name="EMSYSSecurityFilterTopic"
location="jms/EMSYSSecurityFilterTopic"
<description>Topic for security filter</description>
</topic>

<topic>
name="EMSYSTargetStatusTopic"
location="jms/EMSYSTargetStatusTopic"
<description>Topic for target status</description>
</topic>

<topic>
name="EMSYSTargetSLATopic"
location="jms/EMSYSTargetSLATopic"
<description>Topic for target SLA</description>
</topic>

<topic>
name="EMSYSTargetsTopic"
location="jms/EMSYSTargetsTopic"
<description>Topic for targets metadata</description>
</topic>

<queue-connection-factory/>
location="jms/EMSYSQueueConnectionFactory"

<queue>
name="EMSYSAlertsDataQueue"
location="jms/EMSYSAlertsDataQueue"
<description>Queue for alerts data</description>
</queue>

<queue>
name="EMSYSMetricsDataQueue"
location="jms/EMSYSMetricsDataQueue"
<description>Queue for metrics data</description>
</queue>

<queue>
name="EMSYSMetricsQueue"
location="jms/EMSYSMetricsQueue"
<description>Queue for metrics metadata</description>
</queue>

<queue>
name="EMSYSSecurityFilterQueue"
location="jms/EMSYSSecurityFilterQueue"
<description>Queue for security filter</description>
</queue>

<queue>
name="EMSYSTargetStatusQueue"
location="jms/EMSYSTargetStatusQueue"
<description>Queue for target status</description>
</queue>

<queue>
name="EMSYSTargetSLAQueue"
location="jms/EMSYSTargetSLAQueue"
<description>Queue for target SLA</description>
</queue>

<queue>
name="EMSYSTargetsQueue"
location="jms/EMSYSTargetsQueue"
<description>Queue for targets metadata</description>
</queue>

ヒントおよびトラブルシューティング情報

次の項では、データ交換プロセスの際に発生する様々な問題の解決に役立つ、ヒントおよびトラブルシューティング情報を説明します。

データ交換ハブの接続エラー

Cloud Controlで作成されたデータ交換ハブの接続では、認証の問題が原因でエラーが発生する場合があります。これらのエラーは次の場所に表示されることがあります。

- Cloud Controlログ・ファイル

- Cloud Controlの「データ交換」ページ。次に例を示します。
データ交換ハブ<hub_name>の検証中にエラーが発生しました。データ交換ハブへのアクセスが許可されていません。<session_name>セッションは正常に作成されませんでした

- データ交換ハブのログ(OC4JログのOC4Jコンテナ・エラーなど)。次に例を示します。
2008-01-29 17:37:28.259 NOTIFICATION J2EE RMI-00004 Invalid username or password for default (oc4jadmin). Authentication failed.08/02/28 17:37:28 INFO: RMIProto .readConnectionHeader Local ORMI version = 1. 3 different from remote version 1.1 will use 1.12008-01-29 17:37:28.290 ERROR [RealmLoginModule] authentication failed

接続の問題を解決するには、次の手順に従います。

1. データ交換ハブのユーザー名/パスワードの組合せが正しいことを確認します。これは、JDeveloperなどのクライアント・プログラムやJMSクライアントを使用して確認できます。

2. 次のように、Cloud Controlでデータ交換ハブの接続エントリを再作成します。

1. スーパー・ユーザーまたは管理者としてCloud Controlにログインします。

2. Enterprise Manager Cloud Controlから、「設定」をクリックします。
左マージンに設定リンクが表示されます。

3. 「データ交換」をクリックします。
「データ交換」ページが表示されます。

4. 「データ交換ハブ」タブでハブ接続を選択し、「削除」をクリックします。

5. 新しいデータ交換ハブを作成します。「データ交換ハブの作成」を参照してください。

通知メソッドおよび通知ルール

重要:
このセクションで推奨する検証は、トラブルシューティングを目的としたもので、変更を目的としていません。通知メソッドまたは通知ルールを更新すると、望ましくない結果になる可能性があります。

通知メソッド

アウトバウンド・セッションに使用される各データ・ハブに対し、新しい通知メソッドが作成されます。メソッドの名前はhub_nameNotifDeviceで、hub_nameは、メソッド作成の対象のデータ・ハブの名前です。

通知ルール

(選択したアラートを伴う)各アウントバウンド・セッションに対し、通知ルールが作成されます。

ルールの名前はsession_nameNotifRuleで、session_nameは、ルール作成の対象のアウトバウンド・セッションの名前です。

ルールが正常に作成されているか検証する手順は、次のとおりです。

1. Enterprise Manager Cloud Controlから、「プリファレンス」リンクをクリックします。

2. 左側のペインで、「通知」の下にある「ルール」をクリックします。
通知ルール・ページが表示されます。

3. 対応するルールをクリックし、選択したターゲットおよびメトリックが正しいことを確認します。

データ・フローのヒント

- 次のJNDI詳細が、使用するデータ・ハブに正しく入力されていることを確認します。

- JNDI URL

- ユーザー名

- パスワード

- インバウンド・セッション設定の場合、データソース定義でJMSにJNDI資格証明を指定しないでください。
JMSトピックまたはキューが認証詳細を指定することで保護されている場合は、ユーザー名およびパスワードを指定します。そうでない場合、フィールドは空白のままにしてください。

- JMSサーバーが起動し実行中であり、必要なJMSトピック名およびキュー名で構成されていることを確認します。

- インバウンドまたはアウトバウンドのいずれかのセッションがスケジュール済で実行中であることを確認します。

- インバウンド・セッション・データソースの場合は、トピック詳細が正しく入力されていることを確認し、「接続テスト」をクリックします。

- 2つのアクティブなインバウンド・セッションで同一のトピック名またはキュー名を使用すると、データ破損の原因となります。

- インバウンド・セッションの頻度は、外部システムがデータを送信する頻度と同期的または相対的である必要があります。
たとえば、外部システムが10分に1度データを送信している場合、インバウンド・セッション頻度を2分に設定するのは非効率的です。

- アウトバウンド・セッションの場合は、受信者またはEL計画(OBAMの場合)が実行中であることを確認します。

- 効率を上げるため、アウトバウンド・セッションのスケジュール頻度は、そのセッション内で定義されたメトリックをEnterprise Managerが収集する頻度と相対的または同期的であることが必要です。
たとえば、Enterprise Managerにおいて、アウトバウンド・セッションで定義したメトリックの収集頻度が5分の場合、アウトバウンド頻度をより低く(たとえば1分などに)設定するのは新規データがリモートにある可能性があるため非効率的です。このような場合、アウトバウンド頻度を5分または10分に設定すると効率的です。

新規のメトリック値がある場合にのみ転送されることに注意してください。

- 異なるメッセージ形式を持つ2つ以上のアウトバウンド・セッションを同時にスケジュールしないでください。

- 低い頻度が特に必要な場合以外は、より高い頻度の間隔を設定してください。これにより、Enterprise Manager/JMSサーバー負荷を削減できます。

ログ・ファイル

データを受信できない場合や、ステータスが「失敗」の場合は、ログをチェックしてください。ログをチェックするには、次の手順を実行します。

1. Enterprise Manager Cloud Controlから、「ジョブ」タブをクリックします。

2. 「拡張検索」をクリックします。

3. 「ターゲット・タイプ」で、ドロップダウン・リストから「ターゲットなし」を選択します。

4. 「ステータス」で、ドロップダウン・リストから「すべて」を選択します。

5. 「実行」をクリックします。

6. 検証するジョブをクリックします。

- インバウンド・セッションの場合、ジョブ名は<Session Name>ISJOBです。

- アウトバウンド・セッションの場合、ジョブ名は<Session Name>OSJOBです。

7. SucceededまたはFailedなど、ステータス値のリンクをクリックします。

8. 「手順」をクリックします。

- インバウンド・セッションの場合、ステップ名はreceiveMetricDataViaJmsです。

- アウトバウンド・セッションの場合、ステップ名はsendMetricDataViaJmsです。

9. 次のコマンドを使用して、ログ・ディレクトリ内のIDに基づくステップIDの値および検索ログ(通常$ORACLE_HOME/sysman/logディレクトリにあります)を書き留めます。
"grep -i "JobWorker stepID" *.trc

注意:
デフォルトのシステム・ログ・ディレクトリは、$ORACLE_HOME/sysman/logです。

10. 次をチェックします。

- 例外またはエラー

- 同一のタイムスタンプに対する(同一のディレクトリ内に存在する)その他の例外のemoms.log

11. emomslogging.propertiesのログ・レベルをDEBUGに変更し、より詳細なデバッグ情報を取得するためにEnterprise Managerを再起動します。

エンド・ツー・エンド・フローのサンプル・デモ

インテグレータの利便性を図るために、Oracleでは、エンド・ツー・エンド・データ・フローの詳細を説明したサンプル・デモを提供しています。デモにアクセスするには、次のディレクトリに進みます。

$ORACLE_HOME/sysman/bam

アウトバウンド・セッション・サンプルの説明は、ファイルoutboundsession_sample_readme.txtで提供されています。デモに必要なレポートは、READMEファイルで説明するように、ファイルoutboundsession_report.xmlをインポートして作成できます。

インバウンド・セッション・サンプルの説明は、ファイルinboundsession_sample_readme.txtで提供されています。デモに必要なアーティファクトは、READMEファイルで説明するように、ファイルinboundsession_report.xmlをインポートして作成できます。

参考文献

データ交換プロセスにおいて、すべての関連テクノロジを効果的に利用する上で役に立つ、オンライン・リソースを次に示します。

- Oracle Business Activity Monitoring: http://www.oracle.com/technology/products/integration/bam/index.html

- Oracle Data Integrator:
http://www.oracle.com/technology/products/oracle-data-integrator/index.html

- Java Message Service:
http://java.sun.com/products/jms/

- Oracle Containers for J2EE(OC4J):
http://www.oracle.com/technology/tech/java/oc4j/index.html

- Oracle Enterprise Service Bus(ESB):
http://www.oracle.com/technology/products/integration/esb/index.html

- Enterprise Managerメトリック:
『Oracle Enterprise Managerフレームワーク、ホストおよびサードパーティ・メトリック・リファレンス・マニュアル』。次のURLで入手できます。

http://www.oracle.com/technology/documentation/oem.html

4 参照表

この章では、コネクタに関する参照情報を表形式で提供しています。次の項で、それぞれのカテゴリの参照表を記載しています。

- リクエスト属性

- Windowsプラットフォームでのレスポンス・ファイル・プロパティ

- 問合せ可能なプロパティ

- 複合レスポンス・プロパティ

- ステータス・コード

この章では、WindowsプラットフォームでRACの作成ジョブおよびノードの追加ジョブによって生成されるレスポンス・ファイルのプロパティに関する情報も提供しています。

リクエスト属性

この項の表に、次のプロパティ・タイプの問合せパス、説明およびデータ型を示します。

- setModelリクエスト

- リクエスト・ヘッダー

- RACの作成

- ノードの追加

- ノードの削除

表4-1に、setModelリクエストの要素のパス・タイプ、説明およびデータ型を示します。

表4-1 setModelリクエストの要素

パス・タイプ

説明

データ型

<EMModel xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xmlns="http://xmlns.oracle.com/sysman/connector/base/msi">

EMModel要素。

複合型

<RequestHeader/>

リクエスト・ヘッダー。表4-2を参照。

複合型

<Credential>

Enterprise Managerの資格証明。

複合型

<Name>sysman</Name>

ユーザー名。

文字列

<Password>welcome1

</Password>

パスワード。

文字列

</Credential>

資格証明の終了。

複合型

<AggregateTarget>

EMModelには、2つの集計ターゲットが含まれます。1つはclusterタイプ、もう1つはrac_databaseタイプです。この集計ターゲットはclusterタイプです。これにはクラスタに関する情報が含まれます。

複合型

<Name>CRS30</Name>

クラスタの名前。

文字列

<Type>cluster</Type>

集計ターゲット・タイプ。

文字列(列挙: "cluster"、"rac_database")

<Target>

cluster集計ターゲット内のターゲット数は、クラスタ内のホスト数と同じにします。各ターゲット要素には、クラスタ内の1台のホストに関する情報が含まれます。

複合型

<Name>bjx30</Name>

ホストの名前。

文字列

<Type>host</Type>

ターゲット・タイプ。cluster集計ターゲットでは、hostに設定します。

文字列

<Host>bjx30</Host>

ホストの名前。

文字列

<Credential>

ホストの資格証明。

複合型

<Name>oracle</Name>

ユーザー名。

文字列

<Password>welcome1

</Password>

パスワード。

文字列

</Credential>

資格証明の終了。

複合型

<Property/>

ターゲットのプロパティ。hostターゲット・タイプのプロパティについては、この項の対応する表を参照してください。

複合型

</Target>

ターゲットの終了。

複合型

<Property/>

cluster集計ターゲットのプロパティ。cluster集計ターゲット・タイプのプロパティについては、この項の対応する表を参照してください。

複合型

</AggregateTarget>

AggregateTargetの終了。

複合型

<AggregateTarget>

EMModelには、2つの集計ターゲットが含まれます。1つはclusterタイプ、もう1つはrac_databaseタイプです。この集計ターゲットはrac_databaseタイプです。これにはRACに関する情報が含まれます。

複合型

<Name>RAC30</Name>

RACデータベースの名前。

文字列(長さ<=8)

<Type>rac_database</Type>

集計ターゲット・タイプ。

文字列(列挙: "cluster"または"rac_database")

<Storage>

記憶域要素には、RACの記憶域情報が含まれます。記憶域タイプがASMでない場合は、ノードの追加ジョブ・リクエストに対してこの要素を省略できます。

複合型

<Type>ASM</Type>

記憶域のタイプ。

文字列(列挙: "CFS"または"ASM"。"RAW"はサポートされません。)

<Property/>

記憶域のプロパティ。記憶域のプロパティについては、この項の対応する表を参照してください。

複合型

</Storage>

記憶域の終了。

複合型

<Target>

rac_database集計ターゲット内のターゲット数は、クラスタ・データベース内のデータベース・インスタンス数と同じにします。各ターゲット要素には、RACデータベースの1つのデータベース・インスタンスに関する情報が含まれます。

複合型

<Name>RAC30_RAC301</Name>

ターゲットの名前。これは、<rac_name>_<rac_instance_name>という形式にします。

文字列

<Type>oracle_database</Type>

ターゲット・タイプ。rac_database集計ターゲットでは、oracle_databaseに設定します。

文字列

<Host>bjx30</Host>

ホストの名前。

文字列

<Credential>

ホストの資格証明。

複合型

<Name>oracle</Name>

ユーザー名。

文字列

<Password>welcome1

</Password>

パスワード。

文字列

</Credential>

資格証明の終了。

複合型

<Property/>

ターゲットのプロパティ。oracle_databaseターゲット・タイプのプロパティについては、この項の対応する表を参照してください。

複合型

</Target>

ターゲットの終了。

複合型

<Property/>

rac_database集計ターゲットのプロパティ。rac_database集計ターゲット・タイプのプロパティについては、この項の対応する表を参照してください。

複合型

</AggregateTarget>

AggregateTargetの終了。

複合型

</EMModel>

EMModelの終了。

複合型

表4-2に、リクエスト・ヘッダーの要素のパス・タイプ、説明およびデータ型を示します。

表4-2 リクエスト・ヘッダーの要素

パス・タイプ

説明

データ型

<RequestID/>

リクエストを一意に識別します。これは主にクライアントによって使用されます。Enterprise Managerは、現在このIDを追跡しません。

文字列

<Source/>

リクエスト・ソース。これはリクエストのオペレーティング・システムです。

文字列

<Destination/>

宛先は、このリリースのEnterprise Managerにします。

文字列

<RequestProperty>

<Type>Singleton</Type>

<Property>

<Name>Platform</Name>

<Value>Linux</Value>

</Property>

</RequestProperty>

Platformはオプション・プロパティです。LinuxまたはWindowsのいずれかを指定します。プラットフォームを指定しない場合、デフォルトはLinuxです。プラットフォームは、ユースケースのプロビジョニング時にのみ該当します。

表4-3に、RACの作成のターゲット・タイプ、プロパティ、説明およびデータ型を示します。

表4-3 RACの作成のプロパティ

ターゲット・タイプ

プロパティ

説明

データ型

<Target>

<Type>host</Type>

</Target>

CRS_HOME

Oracle Clusterwareホーム・ディレクトリこのプロパティは、クラスタ内のすべてのホストで同じにする必要があります。

文字列

ORACLE_HOME_NAME

Oracle Clusterwareホーム名。これはオプション・プロパティです。デフォルト値はcluster集計ターゲット名です。

文字列

publicNode

パブリック・ノード名。

文字列

privateNode

プライベート・ノード名。

文字列

vipNode

仮想ノード名。

文字列

<Target>

<Type>oracle_database</Type>

</Target>

ORACLE_HOME

データベース・ホーム・ディレクトリ。このプロパティは、RACデータベース内のすべてのデータベース・インスタンスで同じにする必要があります。

文字列

ORACLE_HOME_NAME

データベース・ホーム名。このプロパティはオプションです。デフォルト値はrac_database集計ターゲット名です。

文字列

db_username

監視資格証明を設定するためのデータベース・ユーザー。このリリースでは、常にSYSにします。

文字列

db_password

データベース・ユーザーのパスワード。このリリースでは、SYSおよびSYSTEMのパスワードです。

文字列

oms_username

Oracle管理サービスのホスト・オペレーティング・システムのユーザー名。

文字列

oms_password

Oracle管理サービスのホスト・オペレーティング・システムのパスワード。

文字列

<Storage>

<Type>ASM</Type>

</Storage>

diskGroupName

ASMディスク・グループ名。

文字列

diskList

ディスク・デバイス・リスト。セパレータとしてカンマ(,)を使用します。

文字列(空白は使用不可)

diskString

ASMディスクのパスを検索します。

文字列(空白は使用不可)

redundancy

冗長性レベル。

文字列(列挙: NORMAL、HIGHまたはEXTERNAL)

asmPassword

ASM SYSDBAパスワード。

文字列

<Storage>

<Type>CFS</Type>

</Storage>

datafileDestination

データファイル・ディレクトリ。

文字列

<AggregateTarget> <Type>cluster</Type>

</AggregateTarget>

softwareImageName

CRSホームのソフトウェア・ライブラリ・イメージの名前。このプロパティはオプションです。デフォルト値は、「Oracle Databaseクローン」タイプの最新のアクティブ・ソフトウェア・ライブラリ・イメージです。

文字列

s_ocrpartitionlocation

OCRの場所。セパレータとしてカンマ(,)を使用します。このプロパティは、Linuxプラットフォームのみに該当します。

文字列(空白は使用不可)

s_votingdisklocation

投票ディスクの場所。セパレータとしてカンマ(,)を使用します。このプロパティは、Linuxプラットフォームのみに該当します。

文字列(空白は使用不可)

RESPONSEFILE_VERSION

レスポンス・ファイルのバージョン。このプロパティはオプションです。デフォルト値は2.2.1.0.0です。このプロパティは、Windowsプラットフォームのみに該当します。

文字列

sl_OHPartitionsAndSpace_valueFromDlg

このプロパティは、OCR/Vディスクの場所におけるディスク・パーティションの分割を指定します。このプロパティは、Windowsプラットフォームのみに該当します。

詳細は、「Windowsプラットフォームでのレスポンス・ファイル・プロパティ」を参照してください。

文字列

ret_PrivIntrList

このプロパティは、使用するインターコネクトを指定します。このプロパティは、Windowsプラットフォームのみに該当します。

詳細は、「Windowsプラットフォームでのレスポンス・ファイル・プロパティ」を参照してください。

文字列

<AggregateTarget>

<Type>rac_database</Type>

</AggregateTarget>

templateName

データベース・テンプレート名。このプロパティはオプションです。デフォルト値はGeneral_Purpose.dbcです。

文字列(パスなしのファイル名)

gdbName

グローバル・データベース名。このプロパティはオプションです。デフォルト値はrac_database集計ターゲット名です。

文字列(長さ<=8)

sid

データベース・インスタンス名。このリリースではgdbNameと同じにします。このプロパティはオプションです。デフォルト値はrac_database集計ターゲット名です。

文字列(長さ<=8)

characterSet

キャラクタ・セット。詳細は、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。このプロパティはオプションです。デフォルト値はUTF8です。

文字列

nationalCharacterSet

各国語キャラクタ・セット。詳細は、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。このプロパティはオプションです。デフォルト値はUTF8です。

文字列

initParams

追加入力のRAW文字列。次に例を示します。

nls_territory=japan, nls_language=japanese

このプロパティはオプションです。デフォルトの値は次のとおりです。

nls_lang=american,nls_territory=american

文字列(空白は使用不可)

softwareImageName

データベース・ホームのソフトウェア・ライブラリ・イメージの名前。このプロパティはオプションです。デフォルト値は、「Oracle Databaseクローン」タイプの最新のアクティブ・ソフトウェア・ライブラリ・イメージです。

文字列

表4–4に、RAC集計ターゲットに関するノードの追加のターゲット・タイプ、プロパティ、説明およびデータ型を示します。

表4-4 ノードの追加のプロパティ(記憶域および集計ターゲット)

ターゲット・タイプ

プロパティ

説明

データ型

<Storage>

<Type>ASM</Type>

</Storage>

asmPassword

ASM SYSDBAパスワード。

文字列

<AggregateTarget>

<Type>cluster</Type>

</AggregateTarget>

s_ocrpartitionlocation

OCRの場所。セパレータとしてカンマ(,)を使用します。このプロパティは、Linuxプラットフォームのみに該当します。この値は、RACの作成ジョブと同じに設定します。

文字列(空白は使用不可)

s_votingdisklocation

投票ディスクの場所。セパレータとしてカンマ(,)を使用します。このプロパティは、Linuxプラットフォームのみに該当します。この値は、RACの作成ジョブと同じに設定します。

文字列(空白は使用不可)

RESPONSEFILE_VERSION

レスポンス・ファイルのバージョン。このプロパティはオプションです。デフォルト値は2.2.1.0.0です。このプロパティは、Windowsプラットフォームのみに該当します。この値は、RACの作成ジョブと同じに設定します。

文字列

sl_OHPartitionsAndSpace_valueFromDlg

このプロパティは、OCR/Vディスクの場所におけるディスク・パーティションの分割を指定します。このプロパティは、Windowsプラットフォームのみに該当します。この値は、RACの作成ジョブと同じに設定します。

文字列

ret_PrivIntrList

このプロパティは、使用するインターコネクトを指定します。このプロパティは、Windowsプラットフォームのみに該当します。この値は、RACの作成ジョブと同じに設定します。

文字列

表4–5に、新規ノードに関するノードの追加のターゲット・タイプ、プロパティ、説明およびデータ型を示します。

表4-5 ノードの追加のプロパティ(新規ノード)

ターゲット・タイプ

プロパティ

説明

データ型

<Target>

<Type>host</Type>

</Target>

CRS_HOME

Oracle Clusterwareホーム・ディレクトリこのプロパティは、クラスタ内のすべてのホストで同じにする必要があります。

文字列

ORACLE_HOME_NAME

Oracle Clusterwareホーム名。このプロパティはオプションです。デフォルト値はcluster集計ターゲット名です。

文字列

publicNode

パブリック・ノード名。

文字列

privateNode

プライベート・ノード名。

文字列

vipNode

仮想ノード名。

文字列

<Target>

<Type>oracle_database</Type>

</Target>

ORACLE_HOME

データベース・ホーム・ディレクトリ。このプロパティは、RACデータベース内のすべてのデータベース・インスタンスで同じにする必要があります。

文字列

ORACLE_HOME_NAME

データベース・ホーム名。このプロパティはオプションです。デフォルト値はrac_database集計ターゲット名です。

文字列

db_username

SYSDBAロールを持つデータベース・ユーザー名。

文字列

db_password

db_usernameユーザーのパスワード。

文字列

oms_username

Oracle管理サービスのホスト・オペレーティング・システムのユーザー名。

文字列

oms_password

Oracle管理サービスのホスト・オペレーティング・システムのパスワード。

文字列

表4-6に、任意の既存ノードに関するノードの追加のターゲット・タイプ、プロパティ、説明およびデータ型を示します。

表4-6 ノードの追加のプロパティ(任意の既存ノード)

ターゲット・タイプ

プロパティ

説明

データ型

<Target>

<Type>host</Type>

</Target>

publicNode

パブリック・ノード名。

文字列

CRS_HOME

Oracle Clusterwareホーム・ディレクトリこのプロパティは、クラスタ内のすべてのホストで同じにする必要があります。

文字列

<Target>

<Type>oracle_database</Type>

</Target>

ORACLE_HOME

データベース・ホーム・ディレクトリ。このプロパティは、RACデータベース内のすべてのデータベース・インスタンスで同じにする必要があります。

文字列

表4-7に、残りのノードに関するノードの削除のターゲット・タイプ、プロパティ、説明およびデータ型を示します。

表4-7 ノードの削除のプロパティ(残りのノード)

ターゲット・タイプ

プロパティ

説明

データ型

<Target>

<Type>host</Type>

</Target>

CRS_HOME(またはORACLE_HOME)

Oracle Clusterwareホーム・ディレクトリ

文字列

<Target> <Type>oracle_database</Type>

</Target>

ORACLE_HOME

データベース・ホーム・ディレクトリ。

文字列

db_username

SYSDBAロールを持つデータベース・ユーザー名。

文字列

db_password

db_usernameユーザーのパスワード。

文字列

oms_username

Oracle管理サービスのホスト・オペレーティング・システムのユーザー名。

文字列

oms_password

Oracle管理サービスのホスト・オペレーティング・システムのパスワード。

文字列

<AggregateTarget>

<Type>rac_database</Type>

</AggregateTarget>

oms_delete_all_targets

ホストおよびエージェントを含む、インスタンス・ホスト上のすべてのターゲットを削除します。このプロパティはオプションです。デフォルト値はFalseです。

文字列(列挙: trueまたはfalse)

Windowsプラットフォームでのレスポンス・ファイル・プロパティ

WindowsプラットフォームでRACの作成ジョブおよびノードの追加ジョブのレスポンス・ファイルを生成する場合は、次のプロパティが必須です。

- sl_OHPartitionsAndSpace_valueFromDlg

- ret_PrivIntrList

次の項では、各レスポンス・ファイル・プロパティについて説明しています。

sl_OHPartitionsAndSpace_valueFromDlgプロパティ

このプロパティは、OCR/Vディスクの場所におけるディスク・パーティションの分割を指定します。これは、場所ごとに次の6つの値で構成されます。

- ディスク番号

- パーティション番号

- パーティション・サイズ(MB)

- フォーマット・タイプ

- 0: なし/RAW

- 1: データ用CFS

- 2: ソフトウェア用CFS

- ドライブ文字

- N/A: RAW

- 使用可能なドライブ文字: CFS

- 使用タイプ

- 0: データ/ソフトウェア専用

- 1: OCRプライマリのみ

- 2: 投票ディスクのみ

- 3: 同じCFSパーティション上のOCRプライマリおよび投票ディスク

- 4: OCRミラーのみ

- 5: 同じCFSパーティション上のOCRミラーおよび投票ディスク

例1

次のシナリオを想定します。

- OCRおよび投票ディスクはディスク1のパーティション2にあります(パーティション2のサイズは10002MB)。

- このパーティションのフォーマットはCFSです。

- OCRと投票ディスクの両方が同じパーティションにあります。

- パーティションのドライブ文字はG:です。

- データ記憶域のみがあり、ソフトウェア記憶域はありません。

sl_OHPartitionsAndSpace_valueFromDlgを次のように指定します。

<Property>
<Name>sl_OHPartitionsAndSpace_valueFromDlg</Name>
<Value>{"1","2","10002","1","G:","3"}</Value>
</Property>

例2

次のシナリオを想定します。

- OCRと投票ディスクが異なるパーティション上にあります。

- OCRはディスク3のパーティション1にあります。このパーティションのサイズは486MB、フォーマットはRAWです。

- 投票ディスクはディスク4のパーティション1にあります。このパーティションのサイズは486MB、フォーマットはRAWです。

sl_OHPartitionsAndSpace_valueFromDlgを次のように指定します。

<Property>
<Name>sl_OHPartitionsAndSpace_valueFromDlg</Name>
<Value>{"3","1","486","0","N/A","1","4","1","486","0","N/A","2"}</Value>
</Property>

ret_PrivIntrListプロパティ

このプロパティは、使用するインターコネクトを指定します。ret_PrivIntrListのエントリは、インタフェースのカンマ区切りリストとして指定します。各エントリは、3つのフィールドを含む、コロン区切りの文字列にします。それらのフィールドを次のように指定します。

- 最初のフィールドはインタフェース名です。

- 2番目のフィールドは、インタフェースのサブネットIPです。

- 3番目のフィールドは、Oracle Clusterwareによる、このインタフェースの使用方法を指定します。パブリック・インタフェースとして使用するか、プライベート・インタフェースとして使用するか、またはクラスタウェアで使用しないことを指定します。このフィールドは、1、2または3の数字で指定します。これらの数字は次の値を表します。

- 1: パブリック

- 2: プライベート

- 3: 不使用

例

次のシナリオを想定します。

- 1つの"Local Area Connection"パブリック・インターコネクトを使用します。

- 1つの"Local Area Connection2"プライベート・インターコネクトを使用します。

ret_PrivIntrListを次のように指定します。

<Property>
<Name>ret_PrivIntrList</Name>
<Value>{"Local Area Connection:123.45.67.0:1","Local Area Connection 2:123.45.89.0:2"}</Value>
</Property>

問合せ可能なプロパティ

この項の表では、次の問合せ可能なプロパティ・タイプのプロパティ名、説明およびデータ型を示します。

- 一般ターゲット

- Oracleデータベース

- Oracleリスナー

- ホスト・ターゲット

- クラスタ

- クラスタ・データベース

- Oracle Enterprise Managerエージェント

- Oracle Enterprise Managerリポジトリのターゲット

- ジョブ

表4-8に、一般ターゲットの問合せ可能なプロパティのプロパティ名、説明およびデータ型を示します。

表4-8 一般ターゲットのプロパティ

問合せパス

説明

データ型

Property(Name:status)

Enterprise Managerターゲット・インスタンスの整数ステータス。(表4-20を参照。)

整数

Property(Name:monitoring agent)

Enterprise Managerターゲット・インスタンスを監視するエージェントのEnterprise Managerターゲット・インスタンス名(タイプoracle_emd)。

文字列

Property(Name:homepage)

Enterprise Managerターゲット・インスタンスのEnterprise ManagerコンソールのホームページURI(/em/console?...などのURLのパス部分)。

URL

Property(Name:version)

Enterprise Managerターゲット・インスタンスのバージョン。

文字列

Property(Name:oracle home)

Enterprise Managerターゲット・インスタンスのOracleホーム。ディレクトリ・パスの形式(パス・セパレータ)については、ここでは詳細に説明しません。

文字列

Property(Name:critical alerts)

Enterprise Managerターゲット・インスタンスに対するクリティカル・アラートの数。

整数

Property(Name:warning alerts)

Enterprise Managerターゲット・インスタンスに対する警告アラートの数。

整数

Property(Name:critical policy violations)

Enterprise Managerターゲット・インスタンスに対するクリティカル・ポリシー違反の数。

整数

Property(Name:warning policy violations)

Enterprise Managerターゲット・インスタンスに対する警告ポリシー違反の数。

整数

Property(Name:compliance score)

Enterprise Managerターゲット・インスタンスの、0から1までの実数としてのコンプライアンス・スコア。

数値

Property(Name:last load time)

1970年1月1日00:00:00 GMTからのミリ秒数で表される、ターゲット・インスタンスの最終データ・ロード時間。

数値

Host

Enterprise Managerターゲット・インスタンスに関連するホストのEnterprise Managerターゲット・インスタンス名(タイプhost)

文字列

表4-9に、Oracleデータベースの問合せ可能なプロパティのプロパティ名、説明およびデータ型を示します。Oracleデータベースのターゲット・タイプはoracle_databaseです。

表4-9 Oracleデータベースのプロパティ

問合せパス

説明

データ型

Property(Name:instance name)

データベース・インスタンスのインスタンス名。

文字列

Property(Name:listener)

データベース・インスタンスのリスナーについてのリスナーEnterprise Managerターゲット・インスタンス名(タイプoracle_listener)。

文字列

Property(Name:is archiving)

Oracleデータベース・インスタンスに対して高可用性アーカイブが有効な場合、この値は1です。そうでない場合、この値は0です。

整数

Property(Name:is flashback logging)

Oracleデータベース・インスタンスに対して高可用性フラッシュバック・ロギングが有効な場合、この値は1です。そうでない場合、この値は0です。

整数

表4-10に、Oracleリスナー・プロパティのプロパティ名、説明およびデータ型を示します。Oracleリスナーのターゲット・タイプはoracle_listenerです。

表4-10 Oracleリスナーのプロパティ

問合せパス

説明

データ型

Property(Name:alias)

Oracleリスナー・インスタンスの別名。

文字列

Property(Name:net address)

Oracleリスナー・インスタンスのNetアドレス。

URI

Property(Name:listener.ora location)

Oracleリスナー・インスタンスのlistener.oraファイルのファイル・ディレクトリの場所。ディレクトリ・パスの形式(パス・セパレータ)については、ここでは詳細に説明しません。

文字列

Property(Name:start name)

Oracleリスナー・インスタンスの開始時間。このタイムスタンプの形式については、ここでは詳細に説明しません。

時間

表4-11に、ホスト・ターゲット・プロパティのプロパティ名、説明およびデータ型を示します。ホストのターゲット・タイプはhostです。

クラスタのドメイン内のターゲットを取得するには、まずTargetサブ要素でクラスタ・ホストをリクエストします。次に、すべてのターゲットを取得し、クラスタ・ホスト・リスト内のホストによって、ターゲットのリストをフィルタにかけます。

表4-11 ホスト・ターゲットのプロパティ

問合せパス

説明

データ型

Property(Name:cluster)

このホスト・インスタンスのクラスタのEnterprise Managerターゲット・インスタンス名(タイプcluster)。

文字列

Property(Name:cpu utilization)

ホストの、0から1までの実数としてのCPU使用率。

数値

Property(Name:memory utilization)

ホストの、0から1までの実数としてのメモリー使用率。

数値

Property(Name:total io rate)

1秒当たりの合計I/O。

数値

表4-12に、クラスタ・プロパティのプロパティ名、説明およびデータ型を示します。Oracle Clusterwareのターゲット・タイプはclusterです。

表4-12 クラスタのプロパティ

問合せパス

説明

データ型

Property(Name:version)

Clusterwareのバージョン。このプロパティ定義では、一般ターゲットのマッピングで定義されたものと同じプロパティが再定義されるだけであることに注意してください。

文字列

Property(Name:cluster database)

クラスタ・データベース(タイプrac_database)。

文字列

Target

クラスタ・ホスト(タイプhost)。

文字列

表4-13に、クラスタ・データベース・プロパティのプロパティ名、説明およびデータ型を示します。Oracleクラスタ・データベースのターゲット・タイプはrac_databaseです。

表4-13 クラスタ・データベースのプロパティ

問合せパス

説明

データ型

Property(Name:cluster)

このデータベース・インスタンスのクラスタのEnterprise Managerターゲット・インスタンス名(タイプcluster)。

文字列

Property(Name:database name)

データベース・インスタンス名。

文字列

Property(Name:is archiving)

クラスタ・データベースに対して高可用性アーカイブが有効な場合、この値は1です。そうでない場合、この値は0です。

整数

Target

タイプoracle_databaseのクラスタ・データベース・インスタンス。

文字列

表4-14に、Oracle Enterprise Managerエージェント・プロパティのプロパティ名、説明およびデータ型を示します。Oracle管理エージェントのターゲット・タイプはoracle_emdです。

表4-14 Oracle Enterprise Managerエージェントのプロパティ

問合せパス

説明

データ型

Property(Name:management service)

Enterprise Managerエージェント・インスタンスのアップロード先のOMS。

文字列

表4-15に、Oracle Enterprise Managerリポジトリのターゲット・プロパティのプロパティ名、説明およびデータ型を示します。Oracle管理リポジトリのターゲット・タイプはoracle_emrepです。

表4-15 Oracle Enterprise Managerリポジトリのターゲット・プロパティ

問合せパス

説明

データ型

Property(Name:agent count)

このリポジトリ・インスタンスのエージェント数。

整数

Property(Name:target count)

このリポジトリ・インスタンスのターゲット数。

整数

Property(Name:

administrator count)

このリポジトリ・インスタンスの管理者数。

整数

Property(Name:session count)

このリポジトリ・インスタンスにおけるアクティブなOracle管理サービス・リポジトリ・セッションの数。

整数

Property(Name:Integer)

このリポジトリ・インスタンスのデータベースのEnterprise Managerデータベース・ターゲット・インスタンス。このプロパティは、表4-18で説明しているように、レスポンスの複合プロパティ要素に拡張されます。これらは、nameおよびvalueサブプロパティによって入力されます。

文字列

Property(Name:tablespace)

このリポジトリ・インスタンスのデータベースで使用される表領域に拡張されます。

文字列

Property(Name:oms)

このEnterprise ManagerリポジトリのOMS。このプロパティは、表4-17で説明しているように、レスポンスの複合プロパティ要素に拡張されます。これらは、nameサブプロパティによって入力されます。

文字列

表4-16に、ジョブ・プロパティのプロパティ名、説明およびデータ型を示します。

表4-16 ジョブのプロパティ

問合せパス

説明

データ型

JobStatus

最新のジョブ実行の整数ステータス(表4-20を参照)。

整数

Property(Name:output)

最新のジョブ実行の最終手順におけるジョブ出力の最後の1024文字。

文字列

複合レスポンス・プロパティ

この項の表では、問合せリクエストへのレスポンス・モデルで返される次の複合プロパティのプロパティ名、説明およびデータ型を示します。

- Oracle管理サービス(OMS)

- データベース・インスタンス

表4-17に、Oracle管理サービスのプロパティ名、説明およびデータ型を示します。複合プロパティのタイプはOMSです。

表4-17 Oracle管理サービス(OMS)の複合プロパティ

問合せパス

説明

データ型

ComplexProperty(Type:oms).

Property(Name:name)

OMS名。

文字列

ComplexProperty(Type:oms).

Property(Name:status)

ピアnameプロパティによって指定されるOMSのOMSサービス・ステータス(起動中の場合は1、停止中の場合は0)。

整数

ComplexProperty(Type:oms).

Property(Name:last error)

ピアnameプロパティによって指定されるOMSの、1970年1月1日00:00:00 GMTからのミリ秒数で表される最終OMSエラーの時間。

数値

ComplexProperty(Type:oms).

Property(Name:files pending load)

ピアnameプロパティによって指定されるOMSの、OMSへのロードが保留中であるファイルの数。

整数

ComplexProperty(Type:oms).

Property(Name:load directory)

ピアnameプロパティによって指定されるOMSの、OMSロード・ディレクトリ。ディレクトリ・パスの形式(パス・セパレータ)については、ここでは詳細に説明しません。

文字列

ComplexProperty(Type:oms).

Property(Name:oldest load file)

ピアnameプロパティによって指定されるOMSの、最も古いロード対象ファイル(分単位)。

数値

表4-18に、データベース・インスタンスのプロパティ名、説明およびデータ型を示します。複合プロパティのタイプはOMSです。

表4-18 データベース・インスタンスの複合プロパティ

レスポンス・パス

説明

データ型

ComplexProperty(Type:database).

Property(Name:name)

Oracleデータベース・インスタンス名。

文字列

ComplexProperty(Type:database).

Property(Name:type)

Oracleデータベース・インスタンス・タイプ(oracle_databaseまたはrac_databaseのいずれか)。

文字列

ステータス・コード

次の表に、次のステータス・タイプのステータス・コードおよび説明を示します。

- Enterprise Manager

- ジョブ

表4-19では、Enterprise Managerのステータス・コードについて説明しています。Enterprise Managerのターゲット・ステータスの詳細は、オンライン・ヘルプで参照できます。オンライン・ヘルプの検索でキーワードとして「ターゲット・ステータス」と入力し、トピックのステータス・アイコンに関する項を選択します。

表4-19 Enterprise Managerのステータス・コード

ステータス・コード

説明

0

ターゲット停止

1

ターゲット起動

2

メトリック・エラー

3

エージェント停止

4

使用不可

5

ブラックアウト

6

保留中/不明

表4-20では、ジョブのステータス・コードについて説明しています。Enterprise Managerのジョブ・ステータスの詳細は、オンライン・ヘルプで参照できます。オンライン・ヘルプの検索でキーワードとして「ジョブ・ステータス」と入力し、トピックのジョブ・ステータスに関する項を選択します。

表4-20 ジョブ・ステータス・コード

ステータス・コード

説明

1

SCHEDULED: 実行がスケジュール済状態です。

2

RUNNING: 実行中です。

3

INITIALIZATION ERROR: 実行中にエラーが発生し、リモート・プロセスが実行されませんでした。

4

FAILED: 実行が失敗しました。

5

SUCCEEDED: 実行が成功しました。

6

SUSPENDED BY USER: ユーザーが実行を一時停止しました。

7

SUSPENDED ON AGENT UNREACHABLE: エージェントが使用不可であるため、実行が一時停止されました。

8

STOPPED: ユーザーが実行を停止しました。

9

SUSPENDED ON LOCK: 実行は共有リソースのロックを待機中です。

10

SUSPENDED ON EVENT: 実行はイベント(通常はエージェントのバウンス)の発生を待機中です。

11

SUSPENDED ON BLACKOUT: ブラックアウトが発生して実行が一時停止中です。

12

STOP PENDING: 実行は一部の実行中の手順が完了するまで待機しており、停止保留中ステータスです。

13

SUSPEND PENDING: 実行は一部の実行中の手順が完了するまで待機しており、一時停止保留中ステータスです。

14

非アクティブ(内部状態)。

15

キュー(内部状態)。

16

失敗、再試行済(内部状態)。

18

SKIPPED: 前回のジョブの実行に時間がかかりすぎたか、エージェントが使用不可だった時間が長すぎたために、実行がスキップされ、実行できませんでした。

20

REASSIGNED: ジョブの元の所有者が削除され、ジョブが新しい所有者に割り当てられていないために、実行が一時停止中です。新しい所有者がコンソールからジョブを明示的に再開する必要があります。

21

SUSPENDED ON MISSING CREDENTIALS: ジョブに必要な資格証明の一部が設定されていないために、実行が一時停止中です。

A チケッティング・コネクタのサンプル

この付録では、Remedy 7ヘルプ・デスクのチケッティング・コネクタのサンプル実装を示します。

例A-1 connectorDeploy.xml

<?xml version="1.0" encoding="UTF-8" ?>
<ManagementConnector xmlns="http://xmlns.oracle.com/sysman/connector">
<Name>Remedy Service Desk Connector</Name>
<Version>11.2.0.1.0</Version>
<EMCompatibleVersion>11.2.0.1.0</EMCompatibleVersion>
<Description>Remedy Integration with Enterprise Manager</Description>
<Category>TicketingConnector</Category>
<SOAPHeaderAuthentication>
<Username required="true">
<VariableName>USERNAME</VariableName>
<DisplayName>Remedy Username</DisplayName>
</Username>
<Password>
<VariableName>PASSWORD</VariableName>
<DisplayName>Remedy Password</DisplayName>
</Password>
<AuthVariable>
<VariableName>AUTHENTICATION</VariableName>
<DisplayName>Authentication</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>LOCALE</VariableName>
<DisplayName>Locale</DisplayName>
</AuthVariable>
<AuthVariable>
<VariableName>TIMEZONE</VariableName>
<DisplayName>Timezone</DisplayName>
</AuthVariable>
<SOAPHeader>
<![CDATA[
<urn:AuthenticationInfo xmlns:urn="urn:HelpDesk_Submit_Service">
<urn:userName>$USERNAME$</urn:userName>
<urn:password>$PASSWORD$</urn:password>
<urn:authentication>$AUTHENTICATION$</urn:authentication>
<urn:locale>$LOCALE$</urn:locale>
<urn:timeZone>$TIMEZONE$</urn:timeZone>
</urn:AuthenticationInfo>
]]>
</SOAPHeader>
</SOAPHeaderAuthentication>
<ConnectivityTestVariable>
<VariableName>TICKET_ID</VariableName>
<DisplayName>Ticket ID</DisplayName>
</ConnectivityTestVariable>
<Service>
<Method>createTicket</Method>
<WebServiceEndpoint>
<![CDATA[http://[midtier_server]/arsys/services/ARService?server=[servername]&webService=HPD_IncidentInterface_Create_WS]]>
</WebServiceEndpoint>
</Service>
<Service>
<Method>updateTicket</Method>
<WebServiceEndpoint>
<![CDATA[http://[midtier_server]/arsys/services/ARService?server=[servername]&webService=HPD_IncidentInterface_WS]]>
</WebServiceEndpoint>
</Service>
<Service>
<Method>getTicket</Method>
<WebServiceEndpoint>
<![CDATA[http://[midtier_server]/arsys/services/ARService?server=[servername]&webService=HPD_IncidentInterface_get_WS]]>
</WebServiceEndpoint>
</Service>
<ExternalURL>
<Pattern>
<![CDATA[http://$WEB_SERVER$/arsys/forms/$ARSERVER_NAME$/$FORM_NAME$/?qual=%27Incident%20Number*%27=%22@Incident_Number@%22]]>
</Pattern>
<ConfigVariable required="true">
<VariableName>WEB_SERVER</VariableName>
<DisplayName>Web Server</DisplayName>
</ConfigVariable>
<ConfigVariable required="true">
<VariableName>FORM_NAME</VariableName>
<DisplayName>HelpDesk Case Form Name</DisplayName>
</ConfigVariable>
<ConfigVariable required="true">
<VariableName>ARSERVER_NAME</VariableName>
<DisplayName>ARServer Name</DisplayName>
</ConfigVariable>
</ExternalURL>
<TemplateRegistration>
<FileName>getTicket_request.xml</FileName>
<InternalName>getTicket</InternalName>
<TemplateName>Get Ticket</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for getTicket method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>getTicket_response.xsl</FileName>
<InternalName>getTicket</InternalName>
<TemplateName>Get Ticket</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the response xsl file for getTicket method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>createTicket_response.xsl</FileName>
<InternalName>createTicket</InternalName>
<TemplateName>Create Ticket Reponse</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the create ticket response template. </Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>templates/Remedy_DefaultCategory.xsl</FileName>
<InternalName>Remedy_DefaultCategory.xsl</InternalName>
<TemplateName>Remedy Default Category </TemplateName>
<TemplateType>OutboundXSL</TemplateType>
<Description>This is the Remdy default category template. </Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>templates/Remedy_DefaultCategory_AutoClose.xsl</FileName>
<InternalName>Remedy_DefaultCategory_AutoClose.xsl</InternalName>
<TemplateName>Remedy Default Category Auto Close</TemplateName>
<TemplateType>OutboundXSL</TemplateType>
<Description>This is the Remdy default category template with autp close function. </Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>templates/Remedy_DefaultCategory_AutoResolve.xsl</FileName>
<InternalName>Remedy_DefaultCategory_AutoResolve.xsl</InternalName>
<TemplateName>Remedy Default Category Auto Resolve</TemplateName>
<TemplateType>OutboundXSL</TemplateType>
<Description>This is the Remdy default category template with autp resolve function. </Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>publishTicket_request.xsl</FileName>
<InternalName>publishTicket</InternalName>
<TemplateName>Publish Ticket Status</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the template for publishTicket operation. </Description>
</TemplateRegistration>
</ManagementConnector>

例A-2 getTicket_request.xml

<?xml version="1.0" encoding="UTF-8" ?>
<urn:Get_By_IncidentId xmlns:urn="urn:HPD_IncidentInterface_get_WS">
<urn:Incident_Number>@TicketId@</urn:Incident_Number>
</urn:Get_By_IncidentId>

例A-3 getTicket_response.xsl

<?xml version='1.0' encoding='UTF-8'?>
<xsl:transform version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:urn="urn:HPD_IncidentInterface_get_WS"
xmlns="http://xmlns.oracle.com/sysman/connector/tt"
targetNamespace="http://xmlns.oracle.com/sysman/connector/tt"
elementFormDefault="qualified">
<xsl:template match="urn:Get_By_IncidentIdResponse">
<getTicketResponse>
<TicketId><xsl:value-of select="urn:Incident_Number/text()"/></TicketId>
</getTicketResponse>
</xsl:template>
</xsl:transform>

例A-4 createTicket_response.xsl

<?xml version="1.0" encoding="UTF-8"?>
<xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:urn="urn:HPD_IncidentInterface_Create_WS"
xmlns="http://xmlns.oracle.com/sysman/connector">
<xsl:template match="urn:HelpDesk_Submit_ServiceResponse">
<CreateTicketResponse>
<TicketId>
<xsl:value-of select="urn:Incident_Number"/>
</TicketId>
<InstanceVariable>
<VariableName>Incident_Number</VariableName>
<VariableValue>
<xsl:value-of select="urn:Incident_Number"/>
</VariableValue>
</InstanceVariable>
</CreateTicketResponse>
</xsl:template>
</xsl:transform>

例A-5 Remedy_DefaultCategory.xsl

<?xml version='1.0' encoding='UTF-8'?>
<xsl:transform version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:ns0="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">

<!--This template creates an incident type ticket with default categorization.
The ticket priority is based on event severity. On update,the ticket summary
is updated with the latest incident message and severity information. -->
<xsl:template match="ns0:EMIncident">
<xsl:choose>
<xsl:when test="normalize-space(ns0:TicketID) = ''">
<urn:HelpDesk_Submit_Service xmlns:urn="urn:HPD_IncidentInterface_Create_WS">
<!-- EDIT THE TAG VALUES BELOW TO CHANGE HOW A TICKET IS FILLED DURING
TICKET CREATION. REFER TO THE REMEDY SERVICE DESK MANUAL FOR DESCRIPTION
OF THESE SERVICEDESK SUPPORT DATAFIELDS-->
<urn:Assigned_Group/>
<urn:Assigned_Group_Shift_Name/>
<urn:Assigned_Support_Company/>
<urn:Assigned_Support_Organization></urn:Assigned_Support_Organization>
<urn:Assignee/>
<urn:Categorization_Tier_1/>
<urn:Categorization_Tier_2/>
<urn:Categorization_Tier_3/>
<urn:CI_Name/>
<urn:Closure_Manufacturer/>
<urn:Closure_Product_Category_Tier1/>
<urn:Closure_Product_Category_Tier2/>
<urn:Closure_Product_Category_Tier3/>
<urn:Closure_Product_Model_Version/>
<urn:Closure_Product_Name/>
<urn:Department/>
<!--FIRST_NAME,LAST_NAME VALUES ARE PICKED FROM THE USERNAME VALUE GIVEN DURING REMEDY SERVICE DESK CONNECTOR CONFIGURATION. EXAMPLE USERNAME:Demo.-->
<urn:First_Name><xsl:value-of select="ns0:HDUser"/></urn:First_Name>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL')">
<urn:Impact>1-Extensive/Widespread</urn:Impact>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL')">
<urn:Impact>2-Significant/Large</urn:Impact>
</xsl:when>
<xsl:otherwise>
<urn:Impact>3-Moderate/Limited</urn:Impact>
</xsl:otherwise>
</xsl:choose>
<urn:Last_Name><xsl:value-of select="ns0:HDUser"/></urn:Last_Name>
<urn:Lookup_Keyword/>
<urn:Manufacturer/>
<urn:Product_Categorization_Tier_1/>
<urn:Product_Categorization_Tier_2/>
<urn:Product_Categorization_Tier_3/>
<urn:Product_Model_Version/>
<urn:Product_Name/>
<urn:Reported_Source>Systems Management</urn:Reported_Source>
<urn:Resolution/>
<urn:Resolution_Category_Tier_1/>
<urn:Resolution_Category_Tier_2/>
<urn:Resolution_Category_Tier_3/>
<urn:Service_Type>Infrastructure Event</urn:Service_Type>
<urn:Status>New</urn:Status>
<urn:Action>CREATE</urn:Action>
<urn:Create_Request/>
<urn:Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary,0, 100)"/>
</urn:Summary>
<urn:Notes>
Incident created by Oracle Enterprise Manager Remedy Service Desk Connector.
-----------------------------------------------------------------------------
EM User: <xsl:value-of select="ns0:NotificationRuleOwner"/>
Incident Information:
<xsl:for-each select="ns0:SystemAttributes/ns0:SourceInfo">
Source Name:<xsl:value-of select="./ns0:SourceObjInfo/ns0:ObjName" />
<xsl:choose>
<xsl:when test="normalize-space(./ns0:SourceObjInfo/ns0:ObjOwner) != ''">
Source Owner:<xsl:value-of select="./ns0:SourceObjInfo/ns0:ObjOwner" />
</xsl:when>
</xsl:choose>
Source Type:<xsl:value-of select="./ns0:SourceObjInfo/ns0:SourceObjType"/>
Source SubType:<xsl:value-of select="./ns0:SourceObjInfo/ns0:SourceObjSubType"/>
Target Name: <xsl:value-of select="./ns0:TargetInfo/ns0:TargetName"/>
Target Type: <xsl:value-of select="./ns0:TargetInfo/ns0:TargetType"/>
Target Type Label: <xsl:value-of select="./ns0:TargetInfo/ns0:TargetTypeLabel"/>
Target URL:<xsl:value-of select="./ns0:TargetInfo/ns0:TargetURL"/>
<xsl:text>&#xa; </xsl:text>
</xsl:for-each>
<!-- LIST ALL THE TARGET PROPERTIES -->
Target Properties:
<xsl:for-each select="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty">
<xsl:text>&#xa; </xsl:text>
<xsl:value-of select="./ns0:Name"/>: <xsl:value-of select="./ns0:Value"/>
</xsl:for-each>
<!-- EDIT THE FOLLOWING CODE TO LIST A SPECIFIC TARGET PROPERTY,
SUCH AS "Line of Business"
<xsl:choose>
<xsl:when test="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty/ns0:Name='Line of Business'">
Line of Business: <xsl:value-of select="ns0:ns0:SystemAttributes/
ns0:SourceInfo/ns0:TargetInfo/ns0:TargetProperty
/ns0:value"/>
</xsl:when>
</xsl:choose>
-->
Severity: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Priority: <xsl:value-of select="ns0:SystemAttributes/ns0:Priority" />
CreationDate: <xsl:value-of select="ns0:SystemAttributes/ns0:CreationDate"/>
LastUpdatedDate:<xsl:value-of select="ns0:SystemAttributes/ns0:LastUpdatedDate"/>
Owner: <xsl:value-of select="ns0:SystemAttributes/ns0:Owner" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:NotificationRuleName) != ''">
Notification Rule: <xsl:value-of select="ns0:NotificationRuleName"/>
</xsl:when>
</xsl:choose>
URL: <xsl:value-of select="ns0:SystemAttributes/ns0:IncidentURL"/>
</urn:Notes>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL') or
(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL') ">
<urn:Urgency>1-Critical</urn:Urgency>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'WARNING')">
<urn:Urgency>2-High</urn:Urgency>
</xsl:when>
<xsl:otherwise>
<urn:Urgency>3-Medium</urn:Urgency>
</xsl:otherwise>
</xsl:choose>
<urn:Work_Info_Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0 , 100)"/>
</urn:Work_Info_Summary>
<urn:Work_Info_Notes>
Incident created by Oracle Enterprise Manager Remedy Service Desk Connector for <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
<urn:Work_Info_Type>Incident Task / Action</urn:Work_Info_Type>
<urn:Work_Info_Date/>
<urn:Work_Info_Source>System Assignment</urn:Work_Info_Source>
<urn:Work_Info_Locked/>
<urn:Work_Info_View_Access>Public</urn:Work_Info_View_Access>
<urn:Middle_Initial/>
<urn:ConnectorGUID>
<xsl:value-of select="ns0:ConnectorGUID"/>
</urn:ConnectorGUID>
</urn:HelpDesk_Submit_Service>
</xsl:when>
<xsl:otherwise>
<urn:HelpDesk_Modify_Service xmlns:urn="urn:HPD_IncidentInterface_WS">
<urn:Categorization_Tier_1></urn:Categorization_Tier_1>
<urn:Categorization_Tier_2></urn:Categorization_Tier_2>
<urn:Categorization_Tier_3></urn:Categorization_Tier_3>
<urn:Closure_Manufacturer></urn:Closure_Manufacturer>
<urn:Closure_Product_Category_Tier1></urn:Closure_Product_Category_Tier1>
<urn:Closure_Product_Category_Tier2></urn:Closure_Product_Category_Tier2>
<urn:Closure_Product_Category_Tier3></urn:Closure_Product_Category_Tier3>
<urn:Closure_Product_Model_Version></urn:Closure_Product_Model_Version>
<urn:Closure_Product_Name></urn:Closure_Product_Name>
<!--EDIT THE Company TAG BELOW TO ADD A Company NAME THAT IS ASSOCIATED WITH FIRST_NAME,LAST_NAME TAGS ON THE REMEDY -->
<urn:Company>My Company</urn:Company>
<urn:Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0 , 100)"/>
</urn:Summary>
<urn:Notes>
Incident updated by Oracle Enterprise Manager Remedy Service Desk Connector.
---------------------------------------------------------------------------
EM User: <xsl:value-of select="ns0:NotificationRuleOwner"/>
Incident Information:

Source Name:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjName" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner) != ''">
Source Owner:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner" />
</xsl:when>
</xsl:choose>
Source Type:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjType"/>
Source SubType:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjSubType"/>

Target Name: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetName"/>
Target Type: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetType"/>
Target Type Label: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetTypeLabel"/>
Target URL:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetURL"/>
<!-- LIST ALL THE TARGET PROPERTIES -->
Target Properties:
<xsl:for-each select="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty">
<xsl:text>&#xa; </xsl:text>
<xsl:value-of select="./ns0:Name"/>: <xsl:value-of select="./ns0:Value"/>
</xsl:for-each>
<!-- EDIT THE FOLLOWING CODE TO LIST A SPECIFIC TARGET PROPERTY,
SUCH AS "Line of Business"
<xsl:choose>
<xsl:when test="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty/ns0:Name='Line of Business'">
Line of Business: <xsl:value-of select="ns0:ns0:SystemAttributes/
ns0:SourceInfo/ns0:TargetInfo/ns0:TargetProperty
/ns0:value"/>
</xsl:when>
</xsl:choose>
-->
Severity: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Priority: <xsl:value-of select="ns0:SystemAttributes/ns0:Priority" />
CreationDate: <xsl:value-of select="ns0:SystemAttributes/ns0:CreationDate"/>
LastUpdatedDate:<xsl:value-of select="ns0:SystemAttributes/ns0:LastUpdatedDate"/>
Owner: <xsl:value-of select="ns0:SystemAttributes/ns0:Owner" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:NotificationRuleName) != ''">
Notification Rule: <xsl:value-of select="ns0:NotificationRuleName"/>
</xsl:when>
</xsl:choose>
URL: <xsl:value-of select="ns0:SystemAttributes/ns0:IncidentURL"/>
</urn:Notes>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL')">
<urn:Impact>1-Extensive/Widespread</urn:Impact>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL')">
<urn:Impact>2-Significant/Large</urn:Impact>
</xsl:when>
<xsl:otherwise>
<urn:Impact>3-Moderate/Limited</urn:Impact>
</xsl:otherwise>
</xsl:choose>
<urn:Manufacturer></urn:Manufacturer>
<urn:Product_Categorization_Tier_1></urn:Product_Categorization_Tier_1>
<urn:Product_Categorization_Tier_2></urn:Product_Categorization_Tier_2>
<urn:Product_Categorization_Tier_3></urn:Product_Categorization_Tier_3>
<urn:Product_Model_Version></urn:Product_Model_Version>
<urn:Product_Name></urn:Product_Name>
<urn:Reported_Source>Systems Management</urn:Reported_Source>
<urn:Resolution></urn:Resolution>
<urn:Resolution_Category/>
<urn:Resolution_Category_Tier_2/>
<urn:Resolution_Category_Tier_3/>
<urn:Resolution_Method/>
<urn:Service_Type>Infrastructure Event</urn:Service_Type>
<urn:Status>Assigned</urn:Status>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL') or
(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL') ">
<urn:Urgency>1-Critical</urn:Urgency>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'WARNING')">
<urn:Urgency>2-High</urn:Urgency>
</xsl:when>
<xsl:otherwise>
<urn:Urgency>3-Medium</urn:Urgency>
</xsl:otherwise>
</xsl:choose>
<urn:Action>MODIFY</urn:Action>
<urn:Work_Info_Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Work_Info_Summary>
<urn:Work_Info_Notes>Incident updated due to change in associated Incident: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
<urn:Work_Info_Type>Incident Task / Action</urn:Work_Info_Type>
<urn:Work_Info_Date/>
<urn:Work_Info_Source>System Assignment</urn:Work_Info_Source>
<urn:Work_Info_Locked>No</urn:Work_Info_Locked>
<urn:Work_Info_View_Access>Public</urn:Work_Info_View_Access>
<urn:Incident_Number>
<xsl:value-of select="ns0:TicketID"/>
</urn:Incident_Number>
<urn:ConnectorGUID>
<xsl:value-of select="ns0:ConnectorGUID"/>
</urn:ConnectorGUID>
</urn:HelpDesk_Modify_Service>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
</xsl:transform>

例A-6 Remedy_DefaultAutoClose.xsl

<?xml version='1.0' encoding='UTF-8'?>
<xsl:transform version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:ns0="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">

<!--
This template creates an incident type ticket within Remedy Service Desk with
default settings. On update, the worklog is updated with the latest event
message and severity information. The template supports auto closing of
tickets, once the ticket is closed it can not be reopened.
-->
<xsl:template match="ns0:EMIncident">
<xsl:choose>
<xsl:when test="normalize-space(ns0:TicketID) = ''" >
<urn:HelpDesk_Submit_Service xmlns:urn="urn:HPD_IncidentInterface_Create_WS">
<!-- EDIT THE TAG VALUES BELOW TO CHANGE HOW A TICKET IS FILLED
DURING TICKET CREATION. REFER TO THE REMEDY SERVICE DESK MANUAL
FOR DESCRIPTION OF THESE HELPDESK SUPPORT DATAFIELDS-->
<urn:Assigned_Group/>
<urn:Assigned_Group_Shift_Name/>
<urn:Assigned_Support_Company/>
<urn:Assigned_Support_Organization></urn:Assigned_Support_Organization>
<urn:Assignee/>
<urn:Categorization_Tier_1/>
<urn:Categorization_Tier_2/>
<urn:Categorization_Tier_3/>
<urn:CI_Name/>
<urn:Closure_Manufacturer/>
<urn:Closure_Product_Category_Tier1/>
<urn:Closure_Product_Category_Tier2/>
<urn:Closure_Product_Category_Tier3/>
<urn:Closure_Product_Model_Version/>
<urn:Closure_Product_Name/>
<urn:Department/>
<!--FIRST_NAME,LAST_NAME VALUES ARE PICKED FROM THE USERNAME VALUE GIVEN DURING REMEDY SERVICE DESK CONNECTOR CONFIGURATION. EXAMPLE USERNAME:Demo.-->
<urn:First_Name><xsl:value-of select="ns0:HDUser"/></urn:First_Name>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL')">
<urn:Impact>1-Extensive/Widespread</urn:Impact>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL')">
<urn:Impact>2-Significant/Large</urn:Impact>
</xsl:when>
<xsl:otherwise>
<urn:Impact>3-Moderate/Limited</urn:Impact>
</xsl:otherwise>
</xsl:choose>
<urn:Last_Name><xsl:value-of select="ns0:HDUser"/></urn:Last_Name>
<urn:Lookup_Keyword/>
<urn:Manufacturer/>
<urn:Product_Categorization_Tier_1/>
<urn:Product_Categorization_Tier_2/>
<urn:Product_Categorization_Tier_3/>
<urn:Product_Model_Version/>
<urn:Product_Name/>
<urn:Reported_Source>Systems Management</urn:Reported_Source>
<urn:Resolution/>
<urn:Resolution_Category_Tier_1/>
<urn:Resolution_Category_Tier_2/>
<urn:Resolution_Category_Tier_3/>
<urn:Service_Type>Infrastructure Event</urn:Service_Type>
<urn:Status>New</urn:Status>
<urn:Action>CREATE</urn:Action>
<urn:Create_Request/>
<urn:Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Summary>
<urn:Notes>
Incident created by Oracle Enterprise Manager Remedy Service Desk Connector.
-----------------------------------------------------------------------------
EM User: <xsl:value-of select="ns0:NotificationRuleOwner"/>
Incident Information:

Source Name:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjName" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner) != ''">
Source Owner:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner" />
</xsl:when>
</xsl:choose>
Source Type:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjType"/>
Source SubType:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjSubType"/>

Target Name: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetName"/>
Target Type: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetType"/>
Target Type Label: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetTypeLabel"/>
Target URL:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetURL"/>
<!-- LIST ALL THE TARGET PROPERTIES -->
Target Properties:
<xsl:for-each select="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty">
<xsl:text>&#xa; </xsl:text>
<xsl:value-of select="./ns0:Name"/>: <xsl:value-of select="./ns0:Value"/>
</xsl:for-each>
<!-- EDIT THE FOLLOWING CODE TO LIST A SPECIFIC TARGET PROPERTY,
SUCH AS "Line of Business"
<xsl:choose>
<xsl:when test="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty/ns0:Name='Line of Business'">
Line of Business: <xsl:value-of select="ns0:ns0:SystemAttributes/
ns0:SourceInfo/ns0:TargetInfo/ns0:TargetProperty
/ns0:value"/>
</xsl:when>
</xsl:choose>
-->
Severity: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Priority: <xsl:value-of select="ns0:SystemAttributes/ns0:Priority" />
CreationDate: <xsl:value-of select="ns0:SystemAttributes/ns0:CreationDate"/>
LastUpdatedDate:<xsl:value-of select="ns0:SystemAttributes/ns0:LastUpdatedDate"/>
Owner: <xsl:value-of select="ns0:SystemAttributes/ns0:Owner" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:NotificationRuleName) != ''">
Notification Rule: <xsl:value-of select="ns0:NotificationRuleName"/>
</xsl:when>
</xsl:choose>
URL: <xsl:value-of select="ns0:SystemAttributes/ns0:IncidentURL"/>
</urn:Notes>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL') or
(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL') ">
<urn:Urgency>1-Critical</urn:Urgency>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'WARNING')">
<urn:Urgency>2-High</urn:Urgency>
</xsl:when>
<xsl:otherwise>
<urn:Urgency>3-Medium</urn:Urgency>
</xsl:otherwise>
</xsl:choose>
<urn:Work_Info_Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Work_Info_Summary>
<urn:Work_Info_Notes>
Incident created by Oracle Enterprise Manager Remedy Service Desk Connector for <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
<urn:Work_Info_Type>Incident Task / Action</urn:Work_Info_Type>
<urn:Work_Info_Date/>
<urn:Work_Info_Source>System Assignment</urn:Work_Info_Source>
<urn:Work_Info_Locked/>
<urn:Work_Info_View_Access>Public</urn:Work_Info_View_Access>
<urn:Middle_Initial/>
<urn:ConnectorGUID>
<xsl:value-of select="ns0:ConnectorGUID"/>
</urn:ConnectorGUID>
</urn:HelpDesk_Submit_Service>
</xsl:when>
<xsl:otherwise>
<urn:HelpDesk_Modify_Service xmlns:urn="urn:HPD_IncidentInterface_WS">
<urn:Categorization_Tier_1></urn:Categorization_Tier_1>
<urn:Categorization_Tier_2></urn:Categorization_Tier_2>
<urn:Categorization_Tier_3></urn:Categorization_Tier_3>
<urn:Closure_Manufacturer></urn:Closure_Manufacturer>
<urn:Closure_Product_Category_Tier1></urn:Closure_Product_Category_Tier1>
<urn:Closure_Product_Category_Tier2></urn:Closure_Product_Category_Tier2>
<urn:Closure_Product_Category_Tier3></urn:Closure_Product_Category_Tier3>
<urn:Closure_Product_Model_Version></urn:Closure_Product_Model_Version>
<urn:Closure_Product_Name></urn:Closure_Product_Name>
<!--EDIT THE Company TAG BELOW TO ADD A Company NAME THAT IS ASSOCIATED WITH FIRST_NAME,LAST_NAME TAGS ON THE REMEDY -->
<urn:Company>My Company</urn:Company>
<urn:Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Summary>
<urn:Notes>
Incident updated by Oracle Enterprise Manager Remedy Service Desk Connector.
---------------------------------------------------------------------------
EM User: <xsl:value-of select="ns0:NotificationRuleOwner"/>
Incident Information:

Source Name:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjName" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner) != ''">
Source Owner:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner" />
</xsl:when>
</xsl:choose>
Source Type:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjType"/>
Source SubType:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjSubType"/>

Target Name: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetName"/>
Target Type: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetType"/>
Target Type Label: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetTypeLabel"/>
Target URL:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetURL"/>
<!-- LIST ALL THE TARGET PROPERTIES -->
Target Properties:
<xsl:for-each select="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty">
<xsl:text>&#xa; </xsl:text>
<xsl:value-of select="./ns0:Name"/>: <xsl:value-of select="./ns0:Value"/>
</xsl:for-each>
<!-- EDIT THE FOLLOWING CODE TO LIST A SPECIFIC TARGET PROPERTY,
SUCH AS "Line of Business"
<xsl:choose>
<xsl:when test="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty/ns0:Name='Line of Business'">
Line of Business: <xsl:value-of select="ns0:ns0:SystemAttributes/
ns0:SourceInfo/ns0:TargetInfo/ns0:TargetProperty
/ns0:value"/>
</xsl:when>
</xsl:choose>
-->
Severity: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Priority: <xsl:value-of select="ns0:SystemAttributes/ns0:Priority" />
CreationDate: <xsl:value-of select="ns0:SystemAttributes/ns0:CreationDate"/>
LastUpdatedDate:<xsl:value-of select="ns0:SystemAttributes/ns0:LastUpdatedDate"/>
Owner: <xsl:value-of select="ns0:SystemAttributes/ns0:Owner" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:NotificationRuleName) != ''">
Notification Rule: <xsl:value-of select="ns0:NotificationRuleName"/>
</xsl:when>
</xsl:choose>
URL: <xsl:value-of select="ns0:SystemAttributes/ns0:IncidentURL"/>
</urn:Notes>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL')">
<urn:Impact>1-Extensive/Widespread</urn:Impact>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL')">
<urn:Impact>2-Significant/Large</urn:Impact>
</xsl:when>
<xsl:otherwise>
<urn:Impact>3-Moderate/Limited</urn:Impact>
</xsl:otherwise>
</xsl:choose>
<urn:Manufacturer></urn:Manufacturer>
<urn:Product_Categorization_Tier_1></urn:Product_Categorization_Tier_1>
<urn:Product_Categorization_Tier_2></urn:Product_Categorization_Tier_2>
<urn:Product_Categorization_Tier_3></urn:Product_Categorization_Tier_3>
<urn:Product_Model_Version></urn:Product_Model_Version>
<urn:Product_Name></urn:Product_Name>
<urn:Reported_Source>Systems Management</urn:Reported_Source>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CLEAR')">
<urn:Resolution>
Incident closed by Oracle Enterprise Manager Remedy
Service Desk Connector due to change in severity of the
associated alert. Severity:
<xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Message:
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Resolution>
</xsl:when>
<xsl:otherwise>
<urn:Resolution></urn:Resolution>
</xsl:otherwise>
</xsl:choose>
<urn:Resolution_Category/>
<urn:Resolution_Category_Tier_2/>
<urn:Resolution_Category_Tier_3/>
<urn:Resolution_Method/>
<urn:Service_Type>Infrastructure Event</urn:Service_Type>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CLEAR')">
<urn:Status>Closed</urn:Status>
</xsl:when>
<xsl:otherwise>
<urn:Status>Assigned</urn:Status>
</xsl:otherwise>
</xsl:choose>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL') or
(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL') ">
<urn:Urgency>1-Critical</urn:Urgency>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'WARNING')">
<urn:Urgency>2-High</urn:Urgency>
</xsl:when>
<xsl:otherwise>
<urn:Urgency>3-Medium</urn:Urgency>
</xsl:otherwise>
</xsl:choose>
<urn:Action>MODIFY</urn:Action>
<urn:Work_Info_Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Work_Info_Summary>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CLEAR')">
<urn:Work_Info_Notes>
Incident closed by Oracle Enterprise Manager Remedy Service Desk Connector due to change in associated Incident: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
</xsl:when>
<xsl:otherwise>
<urn:Work_Info_Notes>Incident updated due to change in associated Incident: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
</xsl:otherwise>
</xsl:choose>
<urn:Work_Info_Type>Incident Task / Action</urn:Work_Info_Type>
<urn:Work_Info_Date/>
<urn:Work_Info_Source>System Assignment</urn:Work_Info_Source>
<urn:Work_Info_Locked>No</urn:Work_Info_Locked>
<urn:Work_Info_View_Access>Public</urn:Work_Info_View_Access>
<urn:Incident_Number>
<xsl:value-of select="ns0:TicketID"/>
</urn:Incident_Number>
<urn:ConnectorGUID>
<xsl:value-of select="ns0:ConnectorGUID"/>
</urn:ConnectorGUID>
</urn:HelpDesk_Modify_Service>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
</xsl:transform>

例A-7 Remedy_DefaultAutoResolve.xsl

<?xml version='1.0' encoding='UTF-8'?>
<xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:ns0="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<!-- This template creates an incident type ticket within Remedy Service
Desk with default settings. On update, the worklog is updated with the latest
incident message and severity information. The ticket is set to status Resolved
if the associated alert has cleared. Ticket can be reopend if a severity
occured with in the grace period. If the ticket is not reopened for 15 days,
ticket will be closed by incident management.
-->
<xsl:template match="ns0:EMIncident">
<xsl:choose>
<xsl:when test="normalize-space(ns0:TicketID) = ''">
<urn:HelpDesk_Submit_Service xmlns:urn="urn:HPD_IncidentInterface_Create_WS">
<!-- EDIT THE TAG VALUES BELOW TO CHANGE HOW A TICKET IS FILLED
DURING TICKET CREATION. REFER TO THE REMEDY SERVICE DESK MANUAL
FOR DESCRIPTION OF THESE HELPDESK SUPPORT DATAFIELDS-->
<urn:Assigned_Group/>
<urn:Assigned_Group_Shift_Name/>
<urn:Assigned_Support_Company/>
<urn:Assigned_Support_Organization></urn:Assigned_Support_Organization>
<urn:Assignee/>
<urn:Categorization_Tier_1/>
<urn:Categorization_Tier_2/>
<urn:Categorization_Tier_3/>
<urn:CI_Name/>
<urn:Closure_Manufacturer/>
<urn:Closure_Product_Category_Tier1/>
<urn:Closure_Product_Category_Tier2/>
<urn:Closure_Product_Category_Tier3/>
<urn:Closure_Product_Model_Version/>
<urn:Closure_Product_Name/>
<urn:Department/>
<!--FIRST_NAME,LAST_NAME VALUES ARE PICKED FROM THE USERNAME VALUE GIVEN DURING REMEDY SERVICE DESK CONNECTOR CONFIGURATION. EXAMPLE USERNAME:Demo.-->
<urn:First_Name><xsl:value-of select="ns0:HDUser"/></urn:First_Name>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL')">
<urn:Impact>1-Extensive/Widespread</urn:Impact>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL')">
<urn:Impact>2-Significant/Large</urn:Impact>
</xsl:when>
<xsl:otherwise>
<urn:Impact>3-Moderate/Limited</urn:Impact>
</xsl:otherwise>
</xsl:choose>
<urn:Last_Name><xsl:value-of select="ns0:HDUser"/></urn:Last_Name>
<urn:Lookup_Keyword/>
<urn:Manufacturer/>
<urn:Product_Categorization_Tier_1/>
<urn:Product_Categorization_Tier_2/>
<urn:Product_Categorization_Tier_3/>
<urn:Product_Model_Version/>
<urn:Product_Name/>
<urn:Reported_Source>Systems Management</urn:Reported_Source>
<urn:Resolution/>
<urn:Resolution_Category_Tier_1/>
<urn:Resolution_Category_Tier_2/>
<urn:Resolution_Category_Tier_3/>
<urn:Service_Type>Infrastructure Event</urn:Service_Type>
<urn:Status>New</urn:Status>
<urn:Action>CREATE</urn:Action>
<urn:Create_Request/>
<urn:Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Summary>
<urn:Notes>
Incident created by Oracle Enterprise Manager Remedy Service Desk Connector.
-----------------------------------------------------------------------------
EM User: <xsl:value-of select="ns0:NotificationRuleOwner"/>
Incident Information:

Source Name:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjName" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner) != ''">
Source Owner:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner" />
</xsl:when>
</xsl:choose>
Source Type:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjType"/>
Source SubType:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjSubType"/>

Target Name: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetName"/>
Target Type: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetType"/>
Target Type Label: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetTypeLabel"/>
Target URL:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetURL"/>
<!-- LIST ALL THE TARGET PROPERTIES -->
Target Properties:
<xsl:for-each select="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty">
<xsl:text>&#xa; </xsl:text>
<xsl:value-of select="./ns0:Name"/>: <xsl:value-of select="./ns0:Value"/>
</xsl:for-each>
<!-- EDIT THE FOLLOWING CODE TO LIST A SPECIFIC TARGET PROPERTY,
SUCH AS "Line of Business"
<xsl:choose>
<xsl:when test="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty/ns0:Name='Line of Business'">
Line of Business: <xsl:value-of select="ns0:ns0:SystemAttributes/
ns0:SourceInfo/ns0:TargetInfo/ns0:TargetProperty
/ns0:value"/>
</xsl:when>
</xsl:choose>
-->
Severity: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Priority: <xsl:value-of select="ns0:SystemAttributes/ns0:Priority" />
CreationDate: <xsl:value-of select="ns0:SystemAttributes/ns0:CreationDate"/>
LastUpdatedDate:<xsl:value-of select="ns0:SystemAttributes/ns0:LastUpdatedDate"/>
Owner: <xsl:value-of select="ns0:SystemAttributes/ns0:Owner" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:NotificationRuleName) != ''">
Notification Rule: <xsl:value-of select="ns0:NotificationRuleName"/>
</xsl:when>
</xsl:choose>
URL: <xsl:value-of select="ns0:SystemAttributes/ns0:IncidentURL"/>
</urn:Notes>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL') or
(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL') ">
<urn:Urgency>1-Critical</urn:Urgency>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'WARNING')">
<urn:Urgency>2-High</urn:Urgency>
</xsl:when>
<xsl:otherwise>
<urn:Urgency>3-Medium</urn:Urgency>
</xsl:otherwise>
</xsl:choose>

<urn:Work_Info_Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Work_Info_Summary>
<urn:Work_Info_Notes>
Incident created by Oracle Enterprise Manager Remedy Service Desk Connector for <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
<urn:Work_Info_Type>Incident Task / Action</urn:Work_Info_Type>
<urn:Work_Info_Date/>
<urn:Work_Info_Source>System Assignment</urn:Work_Info_Source>
<urn:Work_Info_Locked/>
<urn:Work_Info_View_Access>Public</urn:Work_Info_View_Access>
<urn:Middle_Initial/>
<urn:ConnectorGUID>
<xsl:value-of select="ns0:ConnectorGUID"/>
</urn:ConnectorGUID>
</urn:HelpDesk_Submit_Service>
</xsl:when>
<xsl:otherwise>
<urn:HelpDesk_Modify_Status_Service xmlns:urn="urn:HPD_IncidentInterface_WS">
<urn:Categorization_Tier_1></urn:Categorization_Tier_1>
<urn:Categorization_Tier_2></urn:Categorization_Tier_2>
<urn:Categorization_Tier_3></urn:Categorization_Tier_3>
<urn:Closure_Manufacturer></urn:Closure_Manufacturer>
<urn:Closure_Product_Category_Tier1></urn:Closure_Product_Category_Tier1>
<urn:Closure_Product_Category_Tier2></urn:Closure_Product_Category_Tier2>
<urn:Closure_Product_Category_Tier3></urn:Closure_Product_Category_Tier3>
<urn:Closure_Product_Model_Version></urn:Closure_Product_Model_Version>
<urn:Closure_Product_Name></urn:Closure_Product_Name>
<!--EDIT THE Company TAG BELOW TO ADD A Company NAME THAT IS ASSOCIATED WITH FIRST_NAME,LAST_NAME TAGS ON THE REMEDY -->
<urn:Company>My Company</urn:Company>
<urn:Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Summary>
<urn:Notes>
Incident updated by Oracle Enterprise Manager Remedy Service Desk Connector.
---------------------------------------------------------------------------
EM User: <xsl:value-of select="ns0:NotificationRuleOwner"/>
Incident Information:

Source Name:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjName" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner) != ''">
Source Owner:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:ObjOwner" />
</xsl:when>
</xsl:choose>
Source Type:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjType"/>
Source SubType:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:SourceObjInfo/ns0:SourceObjSubType"/>

Target Name: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetName"/>
Target Type: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetType"/>
Target Type Label: <xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetTypeLabel"/>
Target URL:<xsl:value-of select="ns0:SystemAttributes/ns0:SourceInfo/
ns0:TargetInfo/ns0:TargetURL"/>
<!-- LIST ALL THE TARGET PROPERTIES -->
Target Properties:
<xsl:for-each select="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty">
<xsl:text>&#xa; </xsl:text>
<xsl:value-of select="./ns0:Name"/>: <xsl:value-of select="./ns0:Value"/>
</xsl:for-each>
<!-- EDIT THE FOLLOWING CODE TO LIST A SPECIFIC TARGET PROPERTY,
SUCH AS "Line of Business"
<xsl:choose>
<xsl:when test="ns0:SystemAttributes/ns0:SourceInfo/ns0:TargetInfo/
ns0:TargetProperty/ns0:Name='Line of Business'">
Line of Business: <xsl:value-of select="ns0:ns0:SystemAttributes/
ns0:SourceInfo/ns0:TargetInfo/ns0:TargetProperty
/ns0:value"/>
</xsl:when>
</xsl:choose>
-->
Severity: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Priority: <xsl:value-of select="ns0:SystemAttributes/ns0:Priority" />
CreationDate: <xsl:value-of select="ns0:SystemAttributes/ns0:CreationDate"/>
LastUpdatedDate:<xsl:value-of select="ns0:SystemAttributes/ns0:LastUpdatedDate"/>
Owner: <xsl:value-of select="ns0:SystemAttributes/ns0:Owner" />
<xsl:choose>
<xsl:when test="normalize-space(ns0:NotificationRuleName) != ''">
Notification Rule: <xsl:value-of select="ns0:NotificationRuleName"/>
</xsl:when>
</xsl:choose>
URL: <xsl:value-of select="ns0:SystemAttributes/ns0:IncidentURL"/>
</urn:Notes>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL')">
<urn:Impact>1-Extensive/Widespread</urn:Impact>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL')">
<urn:Impact>2-Significant/Large</urn:Impact>
</xsl:when>
<xsl:otherwise>
<urn:Impact>3-Moderate/Limited</urn:Impact>
</xsl:otherwise>
</xsl:choose>
<urn:Incident_Number>
<xsl:value-of select="ns0:TicketID"/>
</urn:Incident_Number>
<urn:Manufacturer></urn:Manufacturer>
<urn:Product_Categorization_Tier_1></urn:Product_Categorization_Tier_1>
<urn:Product_Categorization_Tier_2></urn:Product_Categorization_Tier_2>
<urn:Product_Categorization_Tier_3></urn:Product_Categorization_Tier_3>
<urn:Product_Model_Version></urn:Product_Model_Version>
<urn:Product_Name></urn:Product_Name>
<urn:Reported_Source>Systems Management</urn:Reported_Source>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CLEAR')">
<urn:Resolution>
Incident resolved by Oracle Enterprise Manager Remedy
Service Desk Connector due to change in severity of the
associated alert. Severity:
<xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/>
Message:
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Resolution>
</xsl:when>
<xsl:otherwise>
<urn:Resolution></urn:Resolution>
</xsl:otherwise>
</xsl:choose>
<urn:Resolution_Category/>
<urn:Resolution_Category_Tier_2/>
<urn:Resolution_Category_Tier_3/>
<urn:Resolution_Method/>
<urn:Service_Type>Infrastructure Event</urn:Service_Type>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CLEAR')">
<urn:Status>Resolved</urn:Status>
</xsl:when>
<xsl:otherwise>
<urn:Status>Assigned</urn:Status>
</xsl:otherwise>
</xsl:choose>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CLEAR')">
<urn:Status_Reason>Automated Resolution Reported</urn:Status_Reason>
</xsl:when>
<xsl:otherwise>
<urn:Status_Reason></urn:Status_Reason>
</xsl:otherwise>
</xsl:choose>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'FATAL') or
(ns0:SystemAttributes/ns0:SeverityCode = 'CRITICAL') ">
<urn:Urgency>1-Critical</urn:Urgency>
</xsl:when>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'WARNING')">
<urn:Urgency>2-High</urn:Urgency>
</xsl:when>
<xsl:otherwise>
<urn:Urgency>3-Medium</urn:Urgency>
</xsl:otherwise>
</xsl:choose>
<urn:Action>MODIFY</urn:Action>
<urn:Work_Info_Type>Incident Task / Action</urn:Work_Info_Type>
<urn:Work_Info_Date/>
<urn:Work_Info_Source>System Assignment</urn:Work_Info_Source>
<xsl:choose>
<xsl:when test="(ns0:SystemAttributes/ns0:SeverityCode = 'CLEAR')">
<urn:Work_Info_Notes> Incident resolved by Oracle Enterprise Manager Remedy Service Desk Connector due to change in associated Incident: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
</xsl:when>
<xsl:when test="ns0:ReopenTicket = 'Yes'">
<urn:Work_Info_Notes>Incident reopened because the associated alert re-triggered within the grace period: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
</xsl:when>
<xsl:otherwise>
<urn:Work_Info_Notes>Incident updated due to change in associated Incident: <xsl:value-of select="ns0:SystemAttributes/ns0:Severity"/> severity.
</urn:Work_Info_Notes>
</xsl:otherwise>
</xsl:choose>
<urn:Work_Info_Locked>No</urn:Work_Info_Locked>
<urn:Work_Info_View_Access>Public</urn:Work_Info_View_Access>
<urn:Work_Info_Summary>
<xsl:value-of select="substring(ns0:SystemAttributes/ns0:Summary, 0, 100)"/>
</urn:Work_Info_Summary>
<urn:ConnectorGUID>
<xsl:value-of select="ns0:ConnectorGUID"/>
</urn:ConnectorGUID>
</urn:HelpDesk_Modify_Status_Service>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
</xsl:transform>

例A-8 connectorDeploy.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="connectorCommon.xsd"/>
<xsd:element name="ManagementConnector">
<xsd:annotation>
<xsd:documentation>Deployment Descriptor for Management Connectors</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Name" type="StringT64">
<xsd:annotation>
<xsd:documentation>
The name of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Version" type="VersionT">
<xsd:annotation>
<xsd:documentation>
Version of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="EMCompatibleVersion" type="VersionT">
<xsd:annotation>
<xsd:documentation>
The EM compabilitity version of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Description" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The description of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Category">
<xsd:annotation>
<xsd:documentation>
The category of the connector type. It must be one of the three
values listed next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="EventConnector"/>
<xsd:enumeration value="TicketingConnector"/>
<xsd:enumeration value="ChangeManagementConnector"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<!-- NewTargetType is for EventConnector only. -->
<xsd:element name="NewTargetType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
New target type definition for event connectors. This target type
will be registered with Enterprise Manager and target instances can
be created subsequently, including a default target. These targets
are used to accommodate external events.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="TargetTypeName" type="StringStrictT64">
<xsd:annotation>
<xsd:documentation>
The name of the target type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetTypeDisplayName" type="StringT128">
<xsd:annotation>
<xsd:documentation>
The name of the target type, as shown on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DefaultTargetName" type="StringStrictT256">
<xsd:annotation>
<xsd:documentation>
The name of the default target of the target type. The default
target will be used as a generic bucket to hold external events.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DefaultTargetDisplayName" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The name of the default target of the target type, to be displayed
on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="SOAPHeaderAuthentication"
type="SOAPHeaderAuthenticationType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Specification for SOAP Header authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="HTTPBasicAuthentication"
type="UsernamePasswordAuthenticationType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Specification for HTTP basic authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="UserNameTokenAuthentication"
type="UsernamePasswordAuthenticationType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Specification for Username Token authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ConfigVariable" type="ConfigVariableType"
minOccurs="0" maxOccurs="20">
<xsd:annotation>
<xsd:documentation>
The vaiables used during connector configuration. These variables
are required by external system to complete connector configuration,
which includes regitering with the external system. For instance,
one configuration variable can be the resolution state required by
Microsoft Operation Manager.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ConnectivityTestVariable" type="ConfigVariableType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>
An optional variable used to test connection to an external server.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Service" type="ServiceType" maxOccurs="20">
<xsd:annotation>
<xsd:documentation>
Specification for web services, which define how connector framework
can communicate with external system.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ExternalURL" type="ExternalURLType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Secification for the URL link to the external server, including
the URL pattern and server specific variables. It is used to provide links
to external server for viewing ticket details.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TemplateRegistration" type="TemplateRegistrationType"
minOccurs="0" maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
Specification for template registration. A template is registered
based on the information provided in the element. A connector deployment
descriptor can have an optional list of upto 50 template registratin
elements.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="ServiceType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for a web service.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Method">
<xsd:annotation>
<xsd:documentation>
The name of the web service method. Each connector category has a
predefined set of methods as defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<!-- event connector: -->
<xsd:enumeration value="setup"/>
<xsd:enumeration value="initialize"/>
<xsd:enumeration value="getNewAlerts"/>
<xsd:enumeration value="getUpdatedAlerts"/>
<xsd:enumeration value="acknowledgeAlerts"/>
<xsd:enumeration value="updateAlerts"/>
<xsd:enumeration value="createEvent"/>
<xsd:enumeration value="updateEvent"/>
<xsd:enumeration value="uninitialize"/>
<xsd:enumeration value="cleanup"/>
<!-- ticketing connector: -->
<xsd:enumeration value="createTicket"/>
<xsd:enumeration value="updateTicket"/>
<xsd:enumeration value="getTicket"/>
<!-- change management connector: -->
<xsd:enumeration value="publishCS"/>
<xsd:enumeration value="updateChangeRequest"/>
<xsd:enumeration value="getChangeRequest"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="WebServiceEndpoint" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The web service end point indicating a specific location for accessing
a service.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SOAPAction" type="StringT64" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The SOAP action which carries out the web service call for the method.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SOAPBindingType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The type of SOAP over HTTP binding. Choose from one of the four
options defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="SOAP11HTTP_BINDING"/>
<xsd:enumeration value="SOAP12HTTP_BINDING"/>
<xsd:enumeration value="SOAP11HTTP_MTOM_BINDING"/>
<xsd:enumeration value="SOAP12HTTP_MTOM_BINDING"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="SOAPHeaderAuthenticationType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for SOAP Header Authentication.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Username" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The username of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Password" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The password of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AuthVariable" type="ConfigVariableType" minOccurs="0"
maxOccurs="20">
<xsd:annotation>
<xsd:documentation>
An optional list of extra authentication variables besides username
and password.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SOAPHeader" type="StringT256">
<xsd:annotation>
<xsd:documentation>
A SOAP header string serving as template for the SOAP header. It is
to be updated with user inputs for variables defined above and
bound with a HTTP request.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="UsernamePasswordAuthenticationType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for Username Password authentication.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Username" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The username of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Password" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The password of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
This seciton defines a complext type for configuration variables.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="VariableName" type="StringStrictT32">
<xsd:annotation>
<xsd:documentation>
Name of the variable.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DisplayName" type="StringT64">
<xsd:annotation>
<xsd:documentation>
Name of the variable used for display on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="required" type="xsd:boolean" default="false">
<xsd:annotation>
<xsd:documentation>
A Flag indicating whether or not the variable is mandatory.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="ExternalURLType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for external URL.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Pattern" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The URL pattern used to format links to the external server.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ConfigVariable" type="ConfigVariableType" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
An optional list of configuration variablees representing the details
of the external server. They are used for constructing links to
the server based on the URL pattern.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="TemplateRegistrationType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for template registration metadata
which is used to register templates during connector deployment.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="FileName" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The template file name.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InternalName" type="StringStrictT128">
<xsd:annotation>
<xsd:documentation>
A name representing the template in the connector framework.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TemplateName" type="StringStrictT128">
<xsd:annotation>
<xsd:documentation>
The template display name to be used on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TemplateType">
<xsd:annotation>
<xsd:documentation>
The template type as one of the three options defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="InboundXSL"/>
<xsd:enumeration value="OutboundXSL"/>
<xsd:enumeration value="OutboundXML"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Description" type="StringT512">
<xsd:annotation>
<xsd:documentation>
A description of the template.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

例A-9 EMIncident.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="../common/connectorCommon.xsd"/>
<xsd:element name="EMIncident">
<xsd:annotation>
<xsd:documentation>
This section provides a data structure based on EM incidents for all
ticketing actions.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ConnectorGUID" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
A unique ID to identify the connector that is processing
the incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TicketID" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The ID to identify the ticket created in the external ticketing system.
It is generated in the external system and used to update
the ticket.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="HDUser" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
HelpDesk user name provided from UI during connector configuration.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="NotificationRuleOwner" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The owner of the notification rule which generated the incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="NotificationRuleName" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The name of the notification rule which generated the incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ReopenTicket" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The identifier of the previous ticket that should be re-opened.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ConnectorVariable" type="VariableType"
minOccurs="0" maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
An optinal list of up ro 50 connector variables that contain
name/value pairs.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Property" type="PropertyType" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
An optinal list of up ro 50 property variables as defined in
connectorCommon.xsd.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SystemAttributes"
type="IncidentSystemAttributesType">
<xsd:annotation>
<xsd:documentation>
A list of attributes for incidents as defined by EM event system.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="IncidentSystemAttributesType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for incident attributes provided by
EM event system.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="IncidentID" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The ID of an incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SourceInfo" type="SourceInfoType"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>
The source information of the EM subsystems or componenets that
raises the incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="IncidentURL" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
A URL to the incident on EM.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AutoClose" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>
A flag indicating if an incident is auto closed by the system, or it
has to be manually closed by users.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TicketStatus" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
If an external ticket is associated with the incident,
the status of the ticket as assigned at an external help desk system,
and updated in EM.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Owner" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
User to whom the incident is assigned to resolve the issue.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ResolutionState" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The attribute used to track where the incident is in terms of resolution.
For instance, it can be "new" or "closed".
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Acknowledge" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>
A flag indicating whether or not the incident has been acknowledged.
Acknowledgement is simply a way for an administrator to indicate
that they have viewed the incident and take ownership of it.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Escalated" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>
A flag indicating whether or not the incident has been escalated.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="EscalationLevel" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The hierarchical level of escalation that has been made to this incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Priority" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The priority order in which the issue should be resolved.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Summary" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
A text summary of the incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CreationDate" type="xsd:dateTime">
<xsd:annotation>
<xsd:documentation>
The time when the incident is created by associating event to incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="LastUpdatedDate" type="xsd:dateTime">
<xsd:annotation>
<xsd:documentation>
The time when the incident is last updated. The incident update
includes changes to any of the tracking attributes or changes to
the associated events and event sequence.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Category" type="xsd:string" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
An optional list of categories of the incidents.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="LastModifiedBy" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
User who last modified the incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Severity" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
Severity level of the incident. The value changes based on local language setting.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SeverityCode" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
Internal Severity value of the current event.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

例A-10 connectorCommon.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="externalEvent.xsd"/>
<xsd:complexType name="SourceInfoType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for Source Information.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="SourceObjInfo" type="SourceObjInfoType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
This element defines the data structure for the source object, the EM
subsystem or component, that raises an EM event or an incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetInfo" type="TargetInfoType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The element defines the data structure for an EM target as related
to the connector framework.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="SourceObjInfoType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for Source Object Information.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="ObjID" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The unique ID to identify the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ObjName" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The name of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ObjOwner" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The owner of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SourceObjType" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The type of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SourceObjSubType" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The subtype of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="TargetInfoType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for target information.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TargetGUID" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
A unique GUID for the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetName" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
Name of the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetType" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
Type of the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetTypeLabel" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The display label of the target type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetURL" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The URL of the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetProperty" type="PropertyType" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
An optional list of properties for the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="PropertyType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for a property attribute.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Name" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
A string name defining a property attribute.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Value" type="xsd:string" nillable="true">
<xsd:annotation>
<xsd:documentation>
A non-null string value.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="VariableType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for a general variable.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="VariableName" type="StringStrictT32">
<xsd:annotation>
<xsd:documentation>
Name of the variable. It has to be a string containing 1 or upto
32 upper case or lower case letters or numbers.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="VariableValue" type="StringT2048">
<xsd:annotation>
<xsd:documentation>
Value of the variable. It has to be a string containing 1 or upto
2048 characters.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="GetAlertsResponse">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for responses to a getAlerts request.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Alert" minOccurs="0" maxOccurs="200">
<xsd:annotation>
<xsd:documentation>
The individual alerts contained in the response. A response may have
upto 200 alerts.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="ExternalEvent">
<xsd:annotation>
<xsd:documentation>
Details of the external event in the alert, as defined in
ExternalEvent.xsd.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InstanceVariable" type="VariableType"
minOccurs="0" maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
A list of instance variables for the alert.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ConnectorVariablesType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for connector variables. An element
of type ConnectorVariablesType may have up to 50 connector variables, as
defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="ConnectorVariable" type="VariableType" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
A connector varialbe as a name/value pair.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="StringT64">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
64 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="64"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT128">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
128 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="128"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT256">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
256 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="256"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT512">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
512 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="512"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT2048">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
2048 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="2048"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT16">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
16 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="16"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT32">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
32 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="32"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT64">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
64 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="64"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT128">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
128 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="128"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT256">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
256 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="256"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="VersionT">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
20 bytes. The String can only contain numbers and the period characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="20"/>
<xsd:pattern value="([0-9.])*"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>

例A-11 createTicket_response.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="connectorCommon.xsd"/>
<xsd:element name="CreateTicketResponse">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ticketID" type="StringT128"/>
<xsd:element name="InstanceVariable" type="VariableType" minOccurs="0" maxOccurs="50"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>

例A-12 getTicket_response.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="../common/connectorCommon.xsd"/>
<xsd:element name="getTicketResponse">
<xsd:annotation>
<xsd:documentation>
The response from the external system upon a getTicketRequest request.
It must contain a ticket ID from the output of the request Web Service.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ticketID" type="StringT128">
<xsd:annotation>
<xsd:documentation>
The ticket ID.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>

例A-13 publishTicket.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="../common/connectorCommon.xsd"/>
<xsd:element name="publishTicketStatus">
<xsd:annotation>
<xsd:documentation>
This section defines the request to publish ticket status from Ticketing
system to EM when it is updated.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ConnectorGUID" type="StringStrictT16">
<xsd:annotation>
<xsd:documentation>
The GUID of the connector the request is to be sent to. The GUID
is communicated to the external system in the earlier requests to
create tickets. It is returned in the inbound data to associate
the date with the corresponding ticket.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ticketID" type="StringT128">
<xsd:annotation>
<xsd:documentation>
The ID of the ticket whose status is being updated.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ticketStatus" type="StringT64">
<xsd:annotation>
<xsd:documentation>
The new status of the ticket.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RequestOccurTS" type="StringT64">
<xsd:annotation>
<xsd:documentation>
Time when the inbound call is invoked.
</xsd:documentation>
</xsd:annotation>
</xsd:element> <!-- NOT used xsd:dateTime because anyway sql date format must be used -->
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>

B エラー・メッセージおよびデバッグ

この章では、すべての管理コネクタ固有のエラー・メッセージおよびデバッグ情報を示します。これらのエラーは、レスポンス・モデル内で返されます。

エラー・メッセージ

この項では、コネクタ・フレームワークのすべてのエラー・メッセージについて、エラー・コード、説明、原因および推奨される処置を示します。

CNTR-0001

原因: 認証に失敗しました。Enterprise Managerにログインするための資格証明が正しくありません。

処置: リクエストのEnterprise Manager資格証明要素を修正します。

CNTR-0002

原因: setModelで、リクエストされた集計ターゲット・リストのサイズが0です。この操作はサポートされていません。setModelで、リクエストされた集計ターゲット・リストのサイズが0です。この操作はサポートされていません。

処置: リクエスト・モデルを修正して、1つはclusterタイプ、もう1つはrac_databaseタイプの2つの集計ターゲットを含めます。

CNTR-0003

原因: 現行のcluster集計ターゲットおよびrac_database集計ターゲットで、メンバー・ターゲットの数が異なります。

処置: 現行のcluster集計ターゲットおよびrac_database集計ターゲットのメンバー数を同じにします。

CNTR-0004

原因: getModelのリクエスト・モデルで、ターゲット名またはタイプ要素がNULLです。

処置: リクエスト・モデル内のターゲット名またはターゲット・タイプを修正します。

CNTR-0005

原因: getModelのリクエスト・モデルに、認識されないプロパティがあります。

処置: 認識されないプロパティを削除します。

CNTR-0006

原因: 集計ターゲットの要素の名前またはタイプがNULLです。

処置: リクエスト・モデル内の集計ターゲットの名前またはタイプを修正します。

CNTR-0007

原因: 集計ターゲット・タイプがclusterまたはrac_database以外になっています。

処置: 集計ターゲット・タイプを修正します。このリリースでは、clusterおよびrac_databaseの2つのタイプのみがサポートされています。

CNTR-0008

原因: リクエスト・モデルが無効です。

処置: リクエスト・モデルを修正します。リクエスト・モデル内の集計ターゲットを、0または2つ(1つはclusterタイプ、もう1つはrac_databaseタイプ)にします。集計ターゲットを含める場合、同じホスト・セットに対して、2つの集計ターゲット内のターゲット数を同数にします。cluster集計ターゲット内では、各ターゲットの名前要素とホスト要素を同じにします。

CNTR-0009

原因: リクエスト・モデル内で、cluster集計ターゲットまたはrac_database集計ターゲットが欠落しています。

処置: 欠落している集計ターゲットを追加します。

CNTR-0010

原因: モデルの説明に基づいてソフトウェア・ライブラリ・イメージが見つかりませんでした。

処置: ソフトウェア・ライブラリ・イメージの名前を修正するか、Enterprise Managerソフトウェア・ライブラリでそのイメージを使用可能にします。

CNTR-0011

原因: ノードの追加ジョブの一部の手順を実行する既存のノードが見つかりませんでした。

処置: リクエスト・モデルを修正して、既存のすべてのノードがリクエスト・モデル内に正しく指定されているようにしてください。

CNTR-0012

原因: RACノードに対して資格証明が指定されていません。

処置: RACノードの資格証明を追加します。

CNTR-0013

原因: rac_database集計ターゲットのメンバー・ターゲットの名前が、<rac_name>_<instance_name>のネーミング規則に従っていません。

処置: rac_database集計ターゲットのメンバー・ターゲットの名前を修正します。

CNTR-0014

原因: RAC作成のリクエスト時に記憶域要素が欠落していました。

処置: リクエスト・モデルに記憶域要素を追加します。

CNTR-0015

原因: リクエスト・モデル内のノード数が、現行モデル内のノード数から1を引いた数より小さくなっています。

処置: レスポンス・モデルで、ノードを1つのみ削除します。

CNTR-0016

原因: cluster集計ターゲットおよびrac_database集計ターゲットで、メンバー・ターゲットの数が異なります。

処置: リクエスト・モデルを修正して、cluster集計ターゲットおよびrac_database集計ターゲットの両方に正しいメンバー・ターゲットを指定します。

CNTR-0017

原因: RACデータベースがまだ存在していないときに、リクエスト内に複数のノードが指定されました。

処置: 新規RACデータベースにノードを1つのみ使用するように、リクエスト・モデルを修正します。

CNTR-0018

原因: 集計ターゲットのメンバー・ターゲットが、Enterprise Managerリポジトリのメンバー・ターゲットと一致しません。

処置: リクエスト・モデルで、正しいメンバー・ターゲット名に修正します。

CNTR-0019

原因: 処理が実行されません。現行モデルとリクエストされたモデルの間に、メンバーの違いがありません。Enterprise Manager内の現行モデルのメンバーが、リクエスト内のメンバーと同じです。コネクタでは処理を推察できません。

処置: リクエスト・モデルを修正して、プロビジョニング処理を指定します。

CNTR-0020

原因: リクエスト・モデル内のノード数が、現在のモデル内のノード数に1を加えた数より大きくなっています。

処置: レスポンス・モデルで、ノードを1つのみ追加します。

CNTR-0022

原因: リクエスト・モデルのRAC集計ターゲットのホストにエラーが発生しました。メンバー・ターゲットのホスト属性が、Enterprise Managerリポジトリ内のホスト属性と一致しません。

処置: rac_database集計ターゲットのメンバー・ターゲットのホスト属性を修正します。

CNTR-0023

原因: リクエスト・モデルのOracle Clusterware集計ターゲットのホストにエラーが発生しました。メンバー・ターゲットのホスト属性が、Enterprise Managerリポジトリ内のホスト属性と一致しません。

処置: cluster集計ターゲットのメンバー・ターゲットのホスト属性を修正します。

CNTR-0024

原因: cluster集計ターゲットのメンバー・ターゲットのホスト属性が、rac_database集計ターゲットの対応するメンバー・ターゲットのホスト属性と一致しません。

処置: clusterおよびrac_database集計ターゲットのメンバー・ターゲットのホスト属性を修正します。

CNTR-0025 (Windowsのみ)

原因: cluster集計ターゲットのプロパティに、sl_OHPartitionsAndSpace_valueFromDlgプロパティがありません。

処置: リクエスト・モデルのcluster集計ターゲットのプロパティに、sl_OHPartitionsAndSpace_valueFromDlgプロパティを追加します。

CNTR-0026 (Windowsのみ)

原因: cluster集計ターゲットのプロパティで、ret_PrivIntrListプロパティが欠落しています。

処置: リクエスト・モデルのcluster集計ターゲットのプロパティに、ret_PrivIntrListプロパティを追加します。

デバッグ

コネクタ・フレームワークでは、log4jロギング・ユーティリティを使用して、表B–1に示すメッセージのタイプを記録します。

表B-1 メッセージ・タイプおよび対応するコード名

メッセージ・タイプ

コード・オプション

警告

WARN

エラー

ERROR

デバッグ

DEBUG

情報

INFO

デバッグ・オプションの指定

次のファイルにDEBUGの行を挿入する例を示します。

$ORACLE_HOME/sysman/config/emomslogging.properties

次に示すように、emctlコマンドを使用してデバッグ・レベルを設定します。

emctl set property -name log4j.rootCategory -value "DEBUG, emlogAppender, emtrcAppender" -module emoms

入力を要求された場合にはSYSMANパスワードを入力します。

デバッグ・メッセージの表示

コネクタ・フレームワークからのデバッグ・メッセージは、次のファイルに表示されます。

$INSTANCE_HOME/sysman/log/emoms.trc

C MOMイベント・コネクタのサンプル

この付録では、MOMイベント・コネクタのサンプル実装を示します。

例C-1 connectorDeploy.xml

<?xml version="1.0" encoding="UTF-8" ?>

<ManagementConnector xmlns="http://xmlns.oracle.com/sysman/connector">
<Name>Microsoft Operations Manager Connector</Name>
<Version>12.1.0.1.0</Version>
<EMCompatibleVersion>12.1.0.1.0</EMCompatibleVersion>
<Description>Microsoft Operations Manager Integration with Enterprise Manager</Description>
<Category>EventConnector</Category>
<ConfigVariable required="true">
<VariableName>SETUP_NAME</VariableName>
<DisplayName>MOM Registered Connector Name</DisplayName>
</ConfigVariable>
<ConfigVariable required="true">
<VariableName>RESOLUTION_STATE</VariableName>
<DisplayName>Resolution State</DisplayName>
</ConfigVariable>
<Service>
<Method>setup</Method>
<WebServiceEndpoint>
<![CDATA[http://[server]:1271/ConnectorServiceV2.asmx]]>
</WebServiceEndpoint>
<SOAPAction>http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2/SetupWithResolutionState</SOAPAction>
</Service>
<Service>
<Method>initialize</Method>
<WebServiceEndpoint>
<![CDATA[http://[server]:1271/ConnectorServiceV2.asmx]]>
</WebServiceEndpoint>
<SOAPAction>http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2/Initialize</SOAPAction>
</Service>
<Service>
<Method>createEvent</Method>
<WebServiceEndpoint>
<![CDATA[http://[server]:1271/ConnectorServiceV2.asmx]]>
</WebServiceEndpoint>
<SOAPAction>http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2/InsertAlerts</SOAPAction>
</Service>
<Service>
<Method>updateEvent</Method>
<WebServiceEndpoint>
<![CDATA[http://[server]:1271/ConnectorServiceV2.asmx]]>
</WebServiceEndpoint>
<SOAPAction>http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2/UpdateAlerts</SOAPAction>
</Service>
<Service>
<Method>uninitialize</Method>
<WebServiceEndpoint>
<![CDATA[http://[server]:1271/ConnectorServiceV2.asmx]]>
</WebServiceEndpoint>
<SOAPAction>http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2/Uninitialize</SOAPAction>
</Service>
<Service>
<Method>cleanup</Method>
<WebServiceEndpoint>
<![CDATA[http://[server]:1271/ConnectorServiceV2.asmx]]>
</WebServiceEndpoint>
<SOAPAction>http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2/Cleanup</SOAPAction>
</Service>
<TemplateRegistration>
<FileName>setup_request.xml</FileName>
<InternalName>setup</InternalName>
<TemplateName>Setup</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for setup method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>setup_response.xsl</FileName>
<InternalName>setup</InternalName>
<TemplateName>Setup</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the response xsl file for setup method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>initialize_request.xml</FileName>
<InternalName>initialize</InternalName>
<TemplateName>Initialize</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for initialize method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>createEvent_request.xsl</FileName>
<InternalName>createEvent</InternalName>
<TemplateName>Create Event</TemplateName>
<TemplateType>OutboundXSL</TemplateType>
<Description>This is the request xsl file for createEvent method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>createEvent_response.xsl</FileName>
<InternalName>createEvent</InternalName>
<TemplateName>Create Event</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the response xsl file for createEvent method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>updateEvent_request.xsl</FileName>
<InternalName>updateEvent</InternalName>
<TemplateName>Update Event</TemplateName>
<TemplateType>OutboundXSL</TemplateType>
<Description>This is the request xsl file for updateEvent method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>updateEvent_response.xsl</FileName>
<InternalName>updateEvent</InternalName>
<TemplateName>Update Event</TemplateName>
<TemplateType>InboundXSL</TemplateType>
<Description>This is the response xsl file for updateEvent method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>uninitialize_request.xml</FileName>
<InternalName>uninitialize</InternalName>
<TemplateName>Uninitializ</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for uninitialize method</Description>
</TemplateRegistration>
<TemplateRegistration>
<FileName>cleanup_request.xml</FileName>
<InternalName>cleanup</InternalName>
<TemplateName>Cleanup</TemplateName>
<TemplateType>OutboundXML</TemplateType>
<Description>This is the request xml file for cleanup method</Description>
</TemplateRegistration>
</ManagementConnector>

例C-2 setup_request.xml

<?xml version="1.0" encoding="UTF-8" ?>
<SetupWithResolutionState xmlns="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2">
<forwardeeInfo>
<ForwardeeName>$SETUP_NAME$</ForwardeeName>
</forwardeeInfo>
<resolutionState>$RESOLUTION_STATE$</resolutionState>
</SetupWithResolutionState>

例C-3 setup_response.xsl

<?xml version="1.0" encoding="UTF-8" ?>
<xsl:transform version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:a="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2"
xmlns:ns0="http://xmlns.oracle.com/sysman/connector">
<xsl:template match="/">
<ns0:SetupResponse>
<ns0:ConnectorVariable>
<ns0:VariableName>REGISTRATION_ID</ns0:VariableName>
<ns0:VariableValue>
<xsl:value-of select="a:SetupWithResolutionStateResponse/a:SetupWithResolutionStateResult"/>
</ns0:VariableValue>
</ns0:ConnectorVariable>
</ns0:SetupResponse>
</xsl:template>
</xsl:transform>

例C-4 initialize_request.xml

<?xml version="1.0" encoding="UTF-8" ?>
<Initialize xmlns="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2">
<registrationId>$REGISTRATION_ID$</registrationId>
<dataChangeFlags>NewAlerts UpdatedAlerts</dataChangeFlags>
</Initialize>

例C-5 uninitialize_request.xml

<?xml version="1.0" encoding="UTF-8" ?>
<Uninitialize xmlns="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2">
<registrationId>$REGISTRATION_ID$</registrationId>
<dataChangeFlags>NewAlerts UpdatedAlerts</dataChangeFlags>
</Uninitialize>

例C-6 cleanup_request.xml

<?xml version="1.0" encoding="UTF-8" ?>
<Cleanup xmlns="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2">
<registrationId>$REGISTRATION_ID$</registrationId>
</Cleanup>

例C-7 createEvent_request.xsl

<?xml version='1.0' ?>
<xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:ns0="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2"
xmlns:a="http://xmlns.oracle.com/sysman/connector">
<xsl:template match="a:EMEvent">
<ns0:InsertAlerts>
<ns0:registrationId>
<xsl:for-each select="a:ConnectorVariable">
<xsl:if test="a:VariableName = 'REGISTRATION_ID'"><xsl:value-of select="a:VariableValue"/></xsl:if>
</xsl:for-each>
</ns0:registrationId>
<ns0:alerts>
<ns0:AlertInsert>
<ns0:Name><xsl:value-of select="a:SystemAttributes/a:EventClass"/></ns0:Name>
<ns0:ComputerName>
<xsl:choose>
<xsl:when test="normalize-space(a:SystemAttributes/a:SourceInfo/a:TargetInfo/a:TargetName) != ''">
<xsl:value-of select="a:SystemAttributes/a:SourceInfo/a:TargetInfo/a:TargetName"/>
</xsl:when>
<xsl:otherwise>N/A</xsl:otherwise>
</xsl:choose>
</ns0:ComputerName>
<ns0:ComputerDomain></ns0:ComputerDomain>
<ns0:Description>
Received event reported by Oracle Enterprise Manager:

Occurred Date: <xsl:choose><xsl:when test="normalize-space(a:SystemAttributes/a:OccurredDate) != ''"><xsl:value-of select="a:SystemAttributes/a:OccurredDate"/></xsl:when><xsl:otherwise>N/A</xsl:otherwise></xsl:choose>
Reported Date: <xsl:choose><xsl:when test="normalize-space(a:SystemAttributes/a:ReportedDate) != ''"><xsl:value-of select="a:SystemAttributes/a:ReportedDate"/></xsl:when><xsl:otherwise>N/A</xsl:otherwise></xsl:choose>
Event Class: <xsl:value-of select="a:SystemAttributes/a:EventClass"/>
Event Name: <xsl:value-of select="a:SystemAttributes/a:EventName"/>
Target Type: <xsl:value-of select="a:SystemAttributes/a:SourceInfo/a:TargetInfo/a:TargetType"/>
Target Name: <xsl:value-of select="a:SystemAttributes/a:SourceInfo/a:TargetInfo/a:TargetName"/>
Severity: <xsl:value-of select="a:SystemAttributes/a:Severity"/>
Message: <xsl:value-of select="a:SystemAttributes/a:Message"/>
URL: <xsl:value-of select="a:SystemAttributes/a:EventURL"/>
Event Context:
<xsl:for-each select="a:EventContextAttributes">
<xsl:choose>
<xsl:when test="a:StringAttribute"><xsl:value-of select="a:StringAttribute/a:Name"/>: <xsl:value-of select="a:StringAttribute/a:Value"/></xsl:when>
<xsl:when test="a:NumberAttribute"><xsl:value-of select="a:NumberAttribute/a:Name"/>: <xsl:value-of select="a:NumberAttribute/a:Value"/></xsl:when>
</xsl:choose>
</xsl:for-each>
</ns0:Description>
<ns0:Severity>
<xsl:choose>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'CLEAR'">Success</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'INFORMATIONAL'">Information</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'WARNING'">Warning</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'MINOR_WARNING'">Warning</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'CRITICAL'">CriticalError</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'FATAL'">CriticalError</xsl:when>
<xsl:otherwise>Error</xsl:otherwise>
</xsl:choose>
</ns0:Severity>
<CustomField1></CustomField1>
<CustomField2></CustomField2>
<CustomField3></CustomField3>
<CustomField4></CustomField4>
<CustomField5></CustomField5>
<ns0:RuleId>00000000-0000-0000-0000-000000000000</ns0:RuleId>
<ns0:Source>
<xsl:value-of select="a:SystemAttributes/a:SourceInfo/a:TargetInfo/a:TargetType"/>: <xsl:value-of select="a:SystemAttributes/a:SourceInfo/a:TargetInfo/a:TargetName"/>
</ns0:Source>
<ns0:TimeRaised>
<xsl:choose>
<xsl:when test="normalize-space(a:SystemAttributes/a:OccurredDate) != ''">
<xsl:value-of select="a:SystemAttributes/a:OccurredDate"/>
</xsl:when>
<xsl:when test="normalize-space(a:SystemAttributes/a:ReportedDate) != ''">
<xsl:value-of select="a:SystemAttributes/a:ReportedDate"/>
</xsl:when>
<xsl:otherwise>N/A</xsl:otherwise>
</xsl:choose>
</ns0:TimeRaised>
<ns0:ResolutionState>0</ns0:ResolutionState>
<ns0:ServerRole></ns0:ServerRole>
<ns0:ServerRoleInstance></ns0:ServerRoleInstance>
<ns0:Component></ns0:Component>
<ns0:ComponentInstance></ns0:ComponentInstance>
</ns0:AlertInsert>
</ns0:alerts>
</ns0:InsertAlerts>
</xsl:template>
</xsl:transform>

例C-8 createEvent_response.xsl

<?xml version="1.0" encoding="UTF-8" ?>
<xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:a="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2"
xmlns:ns0="http://xmlns.oracle.com/sysman/connector">
<xsl:template match="a:InsertAlertsResponse/a:InsertAlertsResult">
<ns0:EMEventResponse>
<xsl:choose>
<xsl:when test="a:InsertedAlerts/a:SuccessfulAlertInsert/a:NewAlertId">
<ns0:SuccessFlag>true</ns0:SuccessFlag>
<ns0:ExternalEventId>
<xsl:value-of select="a:InsertedAlerts/a:SuccessfulAlertInsert/a:NewAlertId"/>
</ns0:ExternalEventId>
</xsl:when>
<xsl:otherwise>
<ns0:SuccessFlag>false</ns0:SuccessFlag>
<ns0:ErrorMessage>
<xsl:value-of select="a:FailedAlerts/a:FailedAlertInsert/a:Error"/>
</ns0:ErrorMessage>
</xsl:otherwise>
</xsl:choose>
</ns0:EMEventResponse>
</xsl:template>
</xsl:transform>

例C-9 updateEvent_request.xsl

<?xml version='1.0' ?>
<xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:ns0="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2"
xmlns:a="http://xmlns.oracle.com/sysman/connector">
<xsl:template match="a:EMEvent">
<ns0:UpdateAlerts>
<ns0:registrationId>
<xsl:for-each select="a:ConnectorVariable">
<xsl:if test="a:VariableName = 'REGISTRATION_ID'"><xsl:value-of select="a:VariableValue"/></xsl:if>
</xsl:for-each>
</ns0:registrationId>
<ns0:updatedAlerts>
<ns0:AlertUpdate>
<ns0:AlertId><xsl:value-of select="a:ExternalEventID"/></ns0:AlertId>
<ns0:OwnerNameUseExisting>true</ns0:OwnerNameUseExisting>
<ns0:SeverityUseExisting>false</ns0:SeverityUseExisting>
<xsl:variable name="MOMSeverity">
<xsl:choose>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'CLEAR'">Success</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'INFORMATIONAL'">Information</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode =
'WARNING'">Warning</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'MINOR_WARNING'">Warning</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'CRITICAL'">CriticalError</xsl:when>
<xsl:when test="a:SystemAttributes/a:SeverityCode = 'FATAL'">CriticalError</xsl:when>
<xsl:otherwise>Error</xsl:otherwise>
</xsl:choose>
</xsl:variable>
<ns0:Severity>
<xsl:value-of select="$MOMSeverity"/>
</ns0:Severity>
<xsl:choose>
<xsl:when test="$MOMSeverity = 'Success'">
<ns0:ResolutionStateUseExisting>false</ns0:ResolutionStateUseExisting>
<ns0:ResolutionState>255</ns0:ResolutionState>
</xsl:when>
<xsl:otherwise>
<ns0:ResolutionStateUseExisting>true</ns0:ResolutionStateUseExisting>
<ns0:ResolutionState>0</ns0:ResolutionState>
</xsl:otherwise>
</xsl:choose>
<ns0:CustomField1UseExisting>true</ns0:CustomField1UseExisting>
<ns0:CustomField2UseExisting>true</ns0:CustomField2UseExisting>
<ns0:CustomField3UseExisting>true</ns0:CustomField3UseExisting>
<ns0:CustomField4UseExisting>true</ns0:CustomField4UseExisting>
<ns0:CustomField5UseExisting>true</ns0:CustomField5UseExisting>
<ns0:LastModifiedByUseExisting>true</ns0:LastModifiedByUseExisting>
<ns0:RepeatCountUseExisting>true</ns0:RepeatCountUseExisting>
<ns0:RepeatCount>0</ns0:RepeatCount>
<ns0:TicketIDUseExisting>true</ns0:TicketIDUseExisting>
<ns0:TimeOfFirstEventUseExisting>true</ns0:TimeOfFirstEventUseExisting>
<ns0:TimeOfLastEventUseExisting>true</ns0:TimeOfLastEventUseExisting>
<ns0:ProblemStateUseExisting>true</ns0:ProblemStateUseExisting>
<ns0:AlertHistory>
<ns0:AlertHistoryInsert>
<ns0:AlertId><xsl:value-of select="a:ExternalEventID"/></ns0:AlertId>
<ns0:OwnerNameUseExisting>true</ns0:OwnerNameUseExisting>
<ns0:CommentUseExisting>false</ns0:CommentUseExisting>
<ns0:Comment>
Event has been updated in Oracle Enterprise Manager
Occurred Date: <xsl:choose><xsl:when test="normalize-space(a:SystemAttributes/a:OccurredDate) != ''"><xsl:value-of select="a:SystemAttributes/a:OccurredDate"/></xsl:when><xsl:otherwise>N/A</xsl:otherwise></xsl:choose>
Reported Date: <xsl:choose><xsl:when test="normalize-space(a:SystemAttributes/a:ReportedDate) != ''"><xsl:value-of
select="a:SystemAttributes/a:ReportedDate"/></xsl:when><xsl:otherwise>N/A</xsl:otherwise></xsl:choose>
Message: <xsl:value-of select="a:SystemAttributes/Message"/>
Changed 'Severity' to '<xsl:value-of select="$MOMSeverity"/>'
</ns0:Comment>
<xsl:choose>
<xsl:when test="$MOMSeverity = 'Success'">
<ns0:ResolutionStateUseExisting>false</ns0:ResolutionStateUseExisting>
<ns0:ResolutionState>255</ns0:ResolutionState>
</xsl:when>
<xsl:otherwise>
<ns0:ResolutionStateUseExisting>true</ns0:ResolutionStateUseExisting>
<ns0:ResolutionState>0</ns0:ResolutionState>
</xsl:otherwise>
</xsl:choose>
<ns0:CustomField1UseExisting>true</ns0:CustomField1UseExisting>
<ns0:CustomField2UseExisting>true</ns0:CustomField2UseExisting>
<ns0:CustomField3UseExisting>true</ns0:CustomField3UseExisting>
<ns0:CustomField4UseExisting>true</ns0:CustomField4UseExisting>
<ns0:CustomField5UseExisting>true</ns0:CustomField5UseExisting>
<ns0:LastModifiedByUseExisting>true</ns0:LastModifiedByUseExisting>
<ns0:TicketIDUseExisting>true</ns0:TicketIDUseExisting>
</ns0:AlertHistoryInsert>
</ns0:AlertHistory>
</ns0:AlertUpdate>
</ns0:updatedAlerts>
</ns0:UpdateAlerts>
</xsl:template>
</xsl:transform>

例C-10 updateEvent_response.xsl

<?xml version="1.0" encoding="UTF-8" ?>
<xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:a="http://www.microsoft.com/EnterpriseManagement/Mom/Connector/V2"
xmlns:ns0="http://xmlns.oracle.com/sysman/connector">
<xsl:template match="a:UpdateAlertsResponse">
<ns0:EMEventResponse>
<xsl:choose>
<xsl:when test="a:UpdateAlertsResult/a:UpdatedAlerts/a:guid">
<ns0:SuccessFlag>true</ns0:SuccessFlag>
<ns0:ExternalEventId>
<xsl:value-of select="a:UpdateAlertsResult/a:UpdatedAlerts/a:guid"/>
</ns0:ExternalEventId>
</xsl:when>
<xsl:otherwise>
<ns0:SuccessFlag>false</ns0:SuccessFlag>
<ns0:ErrorMessage>
<xsl:value-of select="a:UpdateAlertsResult/a:FailedUpdatedAlerts/a:FailedAlertUpdate/a:Error"/>
</ns0:ErrorMessage>
</xsl:otherwise>
</xsl:choose>
</ns0:EMEventResponse>
</xsl:template>
</xsl:transform>

例C-11 connectorDeploy.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="connectorCommon.xsd"/>
<xsd:element name="ManagementConnector">
<xsd:annotation>
<xsd:documentation>Deployment Descriptor for Management Connectors</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Name" type="StringT64">
<xsd:annotation>
<xsd:documentation>
The name of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Version" type="VersionT">
<xsd:annotation>
<xsd:documentation>
Version of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="EMCompatibleVersion" type="VersionT">
<xsd:annotation>
<xsd:documentation>
The EM compabilitity version of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Description" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The description of the connector type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Category">
<xsd:annotation>
<xsd:documentation>
The category of the connector type. It must be one of the three
values listed next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="EventConnector"/>
<xsd:enumeration value="TicketingConnector"/>
<xsd:enumeration value="ChangeManagementConnector"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<!-- NewTargetType is for EventConnector only. -->
<xsd:element name="NewTargetType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
New target type definition for event connectors. This target type
will be registered with Enterprise Manager and target instances can
be created subsequently, including a default target. These targets
are used to accommodate external events.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="TargetTypeName" type="StringStrictT64">
<xsd:annotation>
<xsd:documentation>
The name of the target type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetTypeDisplayName" type="StringT128">
<xsd:annotation>
<xsd:documentation>
The name of the target type, as shown on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DefaultTargetName" type="StringStrictT256">
<xsd:annotation>
<xsd:documentation>
The name of the default target of the target type. The default
target will be used as a generic bucket to hold external events.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DefaultTargetDisplayName" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The name of the default target of the target type, to be displayed
on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="SOAPHeaderAuthentication"
type="SOAPHeaderAuthenticationType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Specification for SOAP Header authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="HTTPBasicAuthentication"
type="UsernamePasswordAuthenticationType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Specification for HTTP basic authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="UserNameTokenAuthentication"
type="UsernamePasswordAuthenticationType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Specification for Username Token authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ConfigVariable" type="ConfigVariableType"
minOccurs="0" maxOccurs="20">
<xsd:annotation>
<xsd:documentation>
The vaiables used during connector configuration. These variables
are required by external system to complete connector configuration,
which includes regitering with the external system. For instance,
one configuration variable can be the resolution state required by
Microsoft Operation Manager.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ConnectivityTestVariable" type="ConfigVariableType"
minOccurs="0">
<xsd:annotation>
<xsd:documentation>
An optional variable used to test connection to an external server.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Service" type="ServiceType" maxOccurs="20">
<xsd:annotation>
<xsd:documentation>
Specification for web services, which define how connector framework
can communicate with external system.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ExternalURL" type="ExternalURLType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
Secification for the URL link to the external server, including
the URL pattern and server specific variables. It is used to provide links
to external server for viewing ticket details.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TemplateRegistration" type="TemplateRegistrationType"
minOccurs="0" maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
Specification for template registration. A template is registered
based on the information provided in the element. A connector deployment
descriptor can have an optional list of upto 50 template registratin
elements.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="ServiceType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for a web service.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Method">
<xsd:annotation>
<xsd:documentation>
The name of the web service method. Each connector category has a
predefined set of methods as defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<!-- event connector: -->
<xsd:enumeration value="setup"/>
<xsd:enumeration value="initialize"/>
<xsd:enumeration value="getNewAlerts"/>
<xsd:enumeration value="getUpdatedAlerts"/>
<xsd:enumeration value="acknowledgeAlerts"/>
<xsd:enumeration value="updateAlerts"/>
<xsd:enumeration value="createEvent"/>
<xsd:enumeration value="updateEvent"/>
<xsd:enumeration value="uninitialize"/>
<xsd:enumeration value="cleanup"/>
<!-- ticketing connector: -->
<xsd:enumeration value="createTicket"/>
<xsd:enumeration value="updateTicket"/>
<xsd:enumeration value="getTicket"/>
<!-- change management connector: -->
<xsd:enumeration value="publishCS"/>
<xsd:enumeration value="updateChangeRequest"/>
<xsd:enumeration value="getChangeRequest"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="WebServiceEndpoint" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The web service end point indicating a specific location for accessing
a service.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SOAPAction" type="StringT64" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The SOAP action which carries out the web service call for the method.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SOAPBindingType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The type of SOAP over HTTP binding. Choose from one of the four
options defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="SOAP11HTTP_BINDING"/>
<xsd:enumeration value="SOAP12HTTP_BINDING"/>
<xsd:enumeration value="SOAP11HTTP_MTOM_BINDING"/>
<xsd:enumeration value="SOAP12HTTP_MTOM_BINDING"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="SOAPHeaderAuthenticationType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for SOAP Header Authentication.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Username" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The username of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Password" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The password of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="AuthVariable" type="ConfigVariableType" minOccurs="0"
maxOccurs="20">
<xsd:annotation>
<xsd:documentation>
An optional list of extra authentication variables besides username
and password.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SOAPHeader" type="StringT256">
<xsd:annotation>
<xsd:documentation>
A SOAP header string serving as template for the SOAP header. It is
to be updated with user inputs for variables defined above and
bound with a HTTP request.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="UsernamePasswordAuthenticationType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for Username Password authentication.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Username" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The username of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Password" type="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
The password of the authentication.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ConfigVariableType">
<xsd:annotation>
<xsd:documentation>
This seciton defines a complext type for configuration variables.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="VariableName" type="StringStrictT32">
<xsd:annotation>
<xsd:documentation>
Name of the variable.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DisplayName" type="StringT64">
<xsd:annotation>
<xsd:documentation>
Name of the variable used for display on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="required" type="xsd:boolean" default="false">
<xsd:annotation>
<xsd:documentation>
A Flag indicating whether or not the variable is mandatory.
</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="ExternalURLType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for external URL.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Pattern" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The URL pattern used to format links to the external server.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ConfigVariable" type="ConfigVariableType" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
An optional list of configuration variablees representing the details
of the external server. They are used for constructing links to
the server based on the URL pattern.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="TemplateRegistrationType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for template registration metadata
which is used to register templates during connector deployment.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="FileName" type="StringT256">
<xsd:annotation>
<xsd:documentation>
The template file name.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InternalName" type="StringStrictT128">
<xsd:annotation>
<xsd:documentation>
A name representing the template in the connector framework.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TemplateName" type="StringStrictT128">
<xsd:annotation>
<xsd:documentation>
The template display name to be used on UI.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TemplateType">
<xsd:annotation>
<xsd:documentation>
The template type as one of the three options defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="InboundXSL"/>
<xsd:enumeration value="OutboundXSL"/>
<xsd:enumeration value="OutboundXML"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Description" type="StringT512">
<xsd:annotation>
<xsd:documentation>
A description of the template.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

例C-12 EMEvent.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified"
xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
jaxb:version="2.0"
xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc"
jaxb:extensionBindingPrefixes="xjc">

<xsd:annotation>
<xsd:appinfo>
<jaxb:globalBindings>
<xjc:simple />
</jaxb:globalBindings>
</xsd:appinfo>
</xsd:annotation>
<xsd:include schemaLocation="connectorCommon.xsd"/>
<xsd:element name="EMEvent" type="EMEventType" />
<xsd:complexType name="EMEventType">
<xsd:sequence>
<xsd:element name="ConnectorGUID" type="xsd:string"/>
<xsd:element name="ExternalEventID" type="xsd:string"
minOccurs="0"/>
<xsd:element name="NotificationRuleOwner" type="xsd:string"/>
<xsd:element name="NotificationRuleName" type="xsd:string"/>
<xsd:element name="ConnectorVariable" type="VariableType"
minOccurs="0" maxOccurs="50"/>
<xsd:element name="Property" type="PropertyType" minOccurs="0"
maxOccurs="50"/>
<xsd:element name="SystemAttributes"
type="EventSystemAttributesType"/>
<xsd:element name="EventClassSpecificAttributes">
<xsd:complexType>
<xsd:sequence>
<xsd:choice minOccurs="0" maxOccurs="200">
<xsd:element name="StringAttribute" type="StringValueType"/>
<xsd:element name="NumberAttribute" type="StringValueType"/>
<xsd:element name="RawAttribute" type="StringValueType"/>
<xsd:element name="DateAttribute" type="DateValueType"/>
</xsd:choice>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="EventContextAttributes">
<xsd:complexType>
<xsd:sequence>
<xsd:choice minOccurs="0" maxOccurs="200">
<xsd:element name="StringAttribute" type="StringValueType"/>
<xsd:element name="NumberAttribute" type="StringValueType"/>
</xsd:choice>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="EventSystemAttributesType">
<xsd:sequence>
<xsd:element name="EventClass" type="xsd:string"/>
<xsd:element name="EventID" type="xsd:string"/>
<xsd:element name="SequenceID" type="xsd:string"/>
<xsd:element name="OccurredDate" type="xsd:dateTime" minOccurs="0"/>
<xsd:element name="ReportedDate" type="xsd:dateTime"/>
<xsd:element name="DisplayTZ" type="xsd:string"/>
<xsd:element name="EventName" type="xsd:string"/>
<xsd:element name="Severity" type="xsd:string"/>
<xsd:element name="SeverityCode" type="xsd:string"/>
<xsd:element name="SourceInfo" type="SourceInfoType"/>
<xsd:element name="Message" type="xsd:string" minOccurs="0"/>
<xsd:element name="ActionMessage" type="xsd:string" minOccurs="0"/>
<xsd:element name="EventURL" type="xsd:string"/>
<xsd:element name="AutoClose" type="xsd:boolean"/>
<xsd:element name="EventCategory" type="xsd:string" minOccurs="0"
maxOccurs="50"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="StringValueType">
<xsd:sequence>
<xsd:element name="Name" type="xsd:string"/>
<xsd:element name="Value" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="DateValueType">
<xsd:sequence>
<xsd:element name="Name" type="xsd:string"/>
<xsd:element name="Value" type="xsd:dateTime"/>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>

例C-13 connectorCommon.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="externalEvent.xsd"/>
<xsd:complexType name="SourceInfoType">
<xsd:annotation>
<xsd:documentation>
This section defines a complext type for Source Information.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="SourceObjInfo" type="SourceObjInfoType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
This element defines the data structure for the source object, the EM
subsystem or component, that raises an EM event or an incident.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetInfo" type="TargetInfoType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The element defines the data structure for an EM target as related
to the connector framework.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="SourceObjInfoType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for Source Object Information.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="ObjID" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The unique ID to identify the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ObjName" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The name of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ObjOwner" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The owner of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SourceObjType" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The type of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="SourceObjSubType" type="xsd:string" minOccurs="0">
<xsd:annotation>
<xsd:documentation>
The subtype of the source object.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="TargetInfoType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for target information.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="TargetGUID" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
A unique GUID for the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetName" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
Name of the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetType" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
Type of the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetTypeLabel" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The display label of the target type.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetURL" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
The URL of the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="TargetProperty" type="PropertyType" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
An optional list of properties for the target.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="PropertyType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for a property attribute.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Name" type="xsd:string">
<xsd:annotation>
<xsd:documentation>
A string name defining a property attribute.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Value" type="xsd:string" nillable="true">
<xsd:annotation>
<xsd:documentation>
A non-null string value.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="VariableType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for a general variable.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="VariableName" type="StringStrictT32">
<xsd:annotation>
<xsd:documentation>
Name of the variable. It has to be a string containing 1 or upto
32 upper case or lower case letters or numbers.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="VariableValue" type="StringT2048">
<xsd:annotation>
<xsd:documentation>
Value of the variable. It has to be a string containing 1 or upto
2048 characters.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="GetAlertsResponse">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for responses to a getAlerts request.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="Alert" minOccurs="0" maxOccurs="200">
<xsd:annotation>
<xsd:documentation>
The individual alerts contained in the response. A response may have
upto 200 alerts.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="ExternalEvent">
<xsd:annotation>
<xsd:documentation>
Details of the external event in the alert, as defined in
ExternalEvent.xsd.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="InstanceVariable" type="VariableType"
minOccurs="0" maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
A list of instance variables for the alert.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ConnectorVariablesType">
<xsd:annotation>
<xsd:documentation>
This section defines a complex type for connector variables. An element
of type ConnectorVariablesType may have up to 50 connector variables, as
defined next.
</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="ConnectorVariable" type="VariableType" minOccurs="0"
maxOccurs="50">
<xsd:annotation>
<xsd:documentation>
A connector varialbe as a name/value pair.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="StringT64">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
64 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="64"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT128">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
128 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="128"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT256">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
256 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="256"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT512">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
512 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="512"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringT2048">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
2048 bytes.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="2048"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT16">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
16 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="16"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT32">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
32 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="32"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT64">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
64 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="64"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT128">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
128 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="128"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="StringStrictT256">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
256 bytes. The String can only contain lower or upper case letters, numbers,
and the underscore characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="256"/>
<xsd:pattern value="([a-zA-Z0-9_])*"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="VersionT">
<xsd:annotation>
<xsd:documentation>
This section defines a simple type for a String with maximum length of
20 bytes. The String can only contain numbers and the period characters.
</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
<xsd:maxLength value="20"/>
<xsd:pattern value="([0-9.])*"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>

例C-14 EMEventResponse.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">
<xsd:include schemaLocation="../common/connectorCommon.xsd"/>
<xsd:element name="EMEventResponse">
<xsd:annotation>
<xsd:documentation>
The response from external server for an EM event it has received.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="SuccessFlag" type="xsd:boolean">
<xsd:annotation>
<xsd:documentation>
The flag to indicate whether or not the event has been successfully
inserted or updated at the external system.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:choice>
<xsd:element name="ExternalEventId" type="StringT128">
<xsd:annotation>
<xsd:documentation>
The ID to identify the event created in the external event system.
It is returned by the external system when the event is successfully
inserted or updated.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ErrorMessage" type="StringT2048">
<xsd:annotation>
<xsd:documentation>
The error message returned by the external system when the event
fails to be inserted or updated.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:choice>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>

例C-15 setupResponse.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">

<xsd:include schemaLocation="../common/connectorCommon.xsd"/>
<xsd:element name="InitializeResponse" type="ConnectorVariablesType">
<xsd:annotation>
<xsd:documentation>
The response for an initialize reqeust. It contains a list of
connector variables, which are name/value pairs.
</xsd:documentation>
</xsd:annotation>
</xsd:element>

</xsd:schema>

例C-16 initializeResponse.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">

<xsd:include schemaLocation="../common/connectorCommon.xsd"/>
<xsd:element name="InitializeResponse" type="ConnectorVariablesType">
<xsd:annotation>
<xsd:documentation>
The response for an initialize reqeust. It contains a list of
connector variables, which are name/value pairs.
</xsd:documentation>
</xsd:annotation>
</xsd:element>

</xsd:schema>

例C-17 uninitialize_response.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xmlns.oracle.com/sysman/connector"
targetNamespace="http://xmlns.oracle.com/sysman/connector"
elementFormDefault="qualified">

<xsd:include schemaLocation="../common/connectorCommon.xsd"/>
<xsd:element name="UninitializeResponse" type="ConnectorVariablesType">
<xsd:annotation>
<xsd:documentation>
The response for an uninitialize reqeust. It contains a list of
connector variables, which are name/value pairs.
</xsd:documentation>
</xsd:annotation>
</xsd:element>

</xsd:schema>

用語集

この用語集では、様々なイベント・タイプを定義しています。

イベント名

タイプ

説明

Name

StringT64

コネクタ・タイプの名前

Version

VersionT

コネクタ・タイプのバージョン

EMCompatibleVersion

VersionT

コネクタ・タイプのEM互換性バージョン

Description

StringT256

コネクタ・タイプの説明

Category

-

コネクタ・タイプのカテゴリ。次に示す3つの値のいずれかである必要があります。

NewTargetType

-

イベント・コネクタの新しいターゲット・タイプ定義。このターゲット・タイプがEnterprise Managerに登録されると、デフォルト・ターゲットを含め、ターゲット・インスタンスが作成できるようになります。これらのターゲットは、外部イベントに対応するために使用されます。

TargetTypeName

StringStrictT64

ターゲット・タイプの名前

TargetTypeDisplayName

StringT128

UIに表示されるターゲット・タイプの名前

DefaultTargetName

StringStrictT256

ターゲット・タイプのデフォルト・ターゲットの名前。デフォルト・ターゲットは、外部イベントを格納する汎用バケットとして使用されます。

DefaultTargetDisplayName

StringT256

UIに表示される、ターゲット・タイプのデフォルト・ターゲットの名前。

SOAPHeaderAuthentication

SOAPHeaderAuthenticationType

SOAPヘッダー認証の仕様。

HTTPBasicAuthentication

UsernamePasswordAuthenticationType

HTTP Basic認証の仕様。

UserNameTokenAuthentication

UsernamePasswordAuthenticationType

ユーザー名トークン認証の仕様。

ConfigVariable

ConfigVariableType

コネクタ構成時に使用される変数。これらの変数は、外部システムへの登録を含め、外部システムでコネクタ構成を完了するのに必要です。たとえば、ある構成変数をMicrosoft Operation Managerで必要な解決状態にできます。

ConnectivityTestVariable

ConfigVariableType

外部サーバーへの接続のテストに使用されるオプションの変数。

Service

ServiceType

コネクタ・フレームワークが外部システムと通信する方法を定義する、Webサービスの仕様。

ExternalURL

ExternalURLType

URLパターンやサーバー固有の変数など、外部サーバーへのURLリンクの仕様。チケットの詳細を表示するため、外部サーバーへのリンクを提供するのに使用されます。

TemplateRegistration

TemplateRegistrationType

テンプレート登録の仕様。テンプレートは、この要素に指定した情報に基づいて登録されます。コネクタ・デプロイメント記述子には、最大50個のテンプレート登録要素で構成されるオプションのリストを指定できます。

Method

-

Webサービス・メソッドの名前。次に定義するように、各コネクタ・カテゴリには事前定義された一連のメソッドがあります。

WebServiceEndpoint

StringT256

サービスにアクセスするための特定の場所を示すWebサービス・エンドポイント。

SOAPAction

StringT64

メソッドのWebサービス・コールを実行するSOAPアクション

SOAPBindingType

-

SOAP over HTTPバインディングのタイプ。次に定義する4つのオプションのいずれかを選択します。

Username

ConfigVariableType

認証のユーザー名。

Password

ConfigVariableType

認証のパスワード

AuthVariable

ConfigVariableType

ユーザー名およびパスワードに加えて、追加の認証変数のオプション・リスト

SOAPHeader

StringT256

SOAPヘッダーのテンプレートとして機能するSOAPヘッダー文字列。前述で定義し、HTTPリクエストにバインドされた変数に対するユーザー入力で更新されます。

VariableName

StringStrictT32

変数の名前

DisplayName

StringT64

UIでの表示に使用される変数の名前。

Pattern

StringT256

外部サーバーへのリンクの書式設定に使用されるURLパターン。

FileName

StringT256

テンプレート・ファイル名

InternalName

StringStrictT128

コネクタ・フレームワークのテンプレートを表す名前

TemplateName

StringStrictT128

UIで使用されるテンプレート表示名。

TemplateType

-

次に定義する3つのオプションのいずれかであるテンプレート・タイプ。

Description

StringT512

テンプレートの説明

索引

A  C  D  E  H  I  J  M  N  O  Q  S  U

A

「ターゲットの追加」ページ, データ変換コネクタ, 3.3.3

データ交換コネクタのアーキテクチャ, 3.1

自動チケッティング, ヘルプ・デスク・コネクタ, 1.1

C

コネクタ・フレームワーク

イベント・コネクタ, 2.1

D

データ交換

インバウンド・セッション用OBAMアーティファクト, 3.4.3

データ交換コネクタ, 3.4.2.2, 3.4.2.2

「ターゲットの追加」ページ, 3.3.3

アーキテクチャ, 3.1

ログのチェック, 3.6.4

データ交換ハブの作成, 3.3.1

データ交換ハブ, 3.2.1

データ・フローのヒント, 3.6.3

非正規化されたメッセージ形式, 3.2.3.2

EM-BAMデータ・オブジェクト, 3.4.2.1

EM-BAM EMS定義, 3.4.2.1

OBAMアーティファクトのインポート, 3.4.2.1

インバウンド・アラート・スキーマ, 3.3.9.3

インバウンド・インジケータ・スキーマ, 3.3.9.1

インバウンドJMSトピック, 3.3.8

インバウンド・メッセージ・スキーマ, 3.3.9

JNDI詳細, 3.6.3

メッセージ例のデフォルト, 3.3.9.2

正規化されたメッセージ形式, 3.2.3.1

通知メソッド, 3.6.2

通知ルール, 3.6.2

修飾XMLメッセージの例, 3.3.9.1

「ビジネス・イベント/インジケータの選択」ページ, 3.3.7

「セッションのセットアップ」ページ, 3.3.3, 3.3.7

設定, 3.3

データ・フローの設定, 3.4.2

非修飾XMLメッセージの例, 3.3.9.1

JNDIの更新, 3.4.2.2

非正規化されたメッセージ形式, アウトバウンド・メッセージ・スキーマ, 3.3.5.2

E

EM-BAM

データ・オブジェクト, 3.4.2.1, 3.4.2.2

EMS定義, 3.4.2.1

エンタープライズ・リンク計画, 3.4.2.2

EM-BAMデータ・オブジェクト, 3.4.2.2 EM-BAMエンタープライズ・リンク計画, 3.4.2.2 イベント・コネクタ

必要なメタデータ・ファイル, 2.1

H

ヘルプ・デスク・コネクタ

自動チケッティング, 1.1

手動チケッティング, 1.1

メタデータ・ファイル, 1.1

I

OBAMアーティファクトのインポート, 3.4.2.1

インバウンド・アラート・スキーマ, 3.3.9.3

インバウンド・インジケータ・スキーマ, 3.3.9.1

J

JNDI詳細, データ交換コネクタ, 3.6.3

M

手動チケッティング, ヘルプ・デスク・コネクタ, 1.1

メッセージ例のデフォルト, 3.3.9.2

メタデータ・ファイル

ヘルプ・デスク・コネクタ, 1.1

イベント・コネクタに必要, 2.1

N

正規化されたアラート・メッセージ, アウトバウンド・メッセージ・スキーマ, 3.3.5.1

正規化されたメッセージ形式, アウトバウンド・メッセージ・スキーマ, 3.3.5.1

正規化されたメトリック・データ・メッセージ, アウトバウンド・メッセージ・スキーマ, 3.3.5.1

正規化されたメトリック・メッセージ, アウトバウンド・メッセージ・スキーマ, 3.3.5.1

正規化されたセキュリティ・フィルタ・メッセージ, アウトバウンド・メッセージ・スキーマ, 3.3.5.1

正規化されたターゲット・メッセージ, アウトバウンド・メッセージ・スキーマ, 3.3.5.1

通知メソッド, データ交換コネクタ, 3.6.2

通知ルール

データ交換コネクタ, 3.6.2

O

OBAM

インバウンド・セッション用アーティファクト, 3.4.3

EM-BAMデータ・オブジェクト, 3.4.2.1, 3.4.2.2

EM-BAM EMS定義, 3.4.2.1

EM-BAMエンタープライズ・リンク計画, 3.4.2.2

アーティファクトのインポート, 3.4.2.1

データ・フローの設定, 3.4.2

JNDIの更新, 3.4.2.2

アウトバウンド・メッセージ・スキーマ

非正規化されたメッセージ形式, 3.3.5.2

正規化されたアラート・メッセージ, 3.3.5.1

正規化されたメッセージ形式, 3.3.5.1

正規化されたメトリック・データ・メッセージ, 3.3.5.1

正規化されたメトリック・メッセージ, 3.3.5.1

正規化されたセキュリティ・フィルタ・メッセージ, 3.3.5.1

正規化されたターゲット・メッセージ, 3.3.5.1

Q

修飾XMLメッセージの例, 3.3.9.1

S

「ビジネス・イベント/インジケータの選択」ページ, データ交換コネクタ, 3.3.7

セッションの設定ページ, データ交換コネクタ, 3.3.3, 3.3.7

U

非修飾XMLメッセージの例, 3.3.9.1

JNDIの更新, 3.4.2.2

Copyright © 2012, Oracle and/or its affiliates. All rights reserved.