| Oracle Enterprise Manager Connectors統合ガイド 10gリリース4（10.2.0.4） E05925-03 |
|
 戻る |
 次へ |
この章では、ヘルプ・デスク・コネクタを作成し、Enterprise Managerと統合するために必要な情報を提供します。この章の内容は次のとおりです。
ヘルプ・デスク・コネクタ構成のテスト
Oracle Enterprise Manager 10gには、Management Connectorフレームワーク（Connectorフレームワークとも呼ばれる）が導入され、開発者はメタデータ（XMLおよびXSL）に基いてヘルプ・デスク・コネクタを作成できます。
このフレームワークで作成されるヘルプ・デスク・コネクタには、次の機能が継承されます。
自動チケッティング: Enterprise Manager内でアラートがトリガーされた場合は常に自動的にチケットをオープンまたは更新するよう、コネクタに記述できます。チケットのオープンを必要とする一連のアラートと、それを条件付けるアラートの重大度を指定できます。これは、アラートに対する通知の送信基準を定義するユーザー定義ルールである「通知ルール」で指定できます。
手動チケッティング: Enterprise Manager内のオープン・アラートに基づき、Enterprise Managerコンソールから手動でチケットをオープンできます。コネクタにより、アラートおよびチケット・テンプレートに基づいて、チケットに詳細が移入されます。
ユーザー独自のヘルプ・デスク・システムでこれらのチケッティング機能を使用するには、一連のメタデータ・ファイルを提供する必要があります。表2-1にヘルプ・デスク・コネクタの作成に必要なメタデータ・ファイルのカテゴリをリストします。
表2-1 メタデータ・ファイルのカテゴリ
| カテゴリ | タイプ | 説明 |
|---|---|---|
|
コネクタ記述子 |
XML |
チケッティング・システムの統合をカスタマイズできます。このファイル内での構成UIページの作成方法をXMLで記述します。 |
|
チケット・テンプレート |
XSLT |
イベントのコンテキスト内でのチケットの記入方法を記述します。チケット・テンプレートでは、XSLT言語で、チケットの作成および更新時のEnterprise Managerのアラート・データ・フィールドから対応するチケット・データ・フィールドへのマッピングを説明してします。 |
|
レスポンス変換 |
XSLT |
チケッティング・システムWebサービスのレスポンス・データを、チケットConnectorフレームワークに対応した形式に正規化します。 |
この項では、ヘルプ・デスク・コネクタを作成するために定義が必要な、様々なXMLファイルおよびXSLファイルの詳細を説明します。
次の場所にあるメタデータ・ファイルの例を参照することをお薦めします。
$OMS_HOME/sysman/connector/Remedy_Connector
|
注意: この場所にあるファイルは変更しないでください。 |
コネクタ記述子XMLファイルを定義し、コネクタ・メタデータおよびコネクタの構成プロパティ（Webサービスのエンドポイント、認証スキーマおよびチケットのURLパターンなど）を記述します。このXMLファイルで、コネクタに対して構成ページを動的に作成する方法を定義します。
例2-1は、connectorType.XSDファイルに準拠しています。ハイライトされた要素を適切な値に置換すると、テンプレートとして使用できます。
|
注意: サンプル・ファイルは、次のディレクトリにあります。
Remedy Connectorの記述子XMLファイルは、 |
<?xml version='1.0' encoding='UTF-8'?> <ManagementConnector xmlns="http://xmlns.oracle.com/sysman/connector"> <Name>specify the connector name</Name> <Version>specify the 5-digit version, e.g., 1.0.0.0.0</Version> <Description>specify a short description</Description> <!-- Category is fixed to TicketingConnector. --> <Category>TicketingConnector</Category> <TicketingConnector> <!-- authentication element is optional. If authentication is required, the SOAP header should match the Data element in this section. Other elements are displayed on the default UI to collect data to generate the Data element. --> <Authentication> <Username> <AttributeName>specify the username_element_name</AttributeName> <DisplayName>specify the label</DisplayName> </Username> <Password> <AttributeName>specify the password_element_name</AttributeName> <DisplayName>specify the display label</DisplayName> </Password> <Attribute> <AttributeName>specify attribute other than username and password</AttributeName> <DisplayName>specify display label</DisplayName>
</Attribute>
<!-- Attribute element can repeat. -->
<Data>
<![CDATA[
specify how authentication element should appear in SOAP header
]]>
</Data>
</Authentication>
<TicketingService>
<Method>createTicket</Method>
<WebServiceEndpoint>
<![CDATA[specify URL]]>
</WebServiceEndpoint>
<SOAPAction>specify the SOAP action</SOAPAction>
<Namespace>specify the namespace</Namespace>
<NamespacePrefix>specify the namespace prefix</NamespacePrefix>
</TicketingService>
<TicketingService>
<Method>updateTicket</Method>
<WebServiceEndpoint>
<![CDATA[specify the URL]>
</WebServiceEndpoint>
<SOAPAction>specify the SOAP action</SOAPAction>
<Namespace>specify the namespace</Namespace>
<NamespacePrefix>specify the namespace prefix</NamespacePrefix>
</TicketingService>
<!-- BaseURL element is for the default UI for ticketing connectors, the following value should not be changed. -->
<BaseURL>/em/console/connector/ticket/ticketConnectorConfig</BaseURL>
<!-- ExternalURL is used to generate the ticket URL. -->
<ExternalURL>
<!-- Strings in brackets ([]) are user variables, i.e., the values to be
collected from UI. Strings in {} are substitution variables, i.e., the values to
be collected from the web service response (they need to have the same element
names as the ones from the response XML. The following is an example. -->
<Pattern>
<![CDATA[specify the URL as http://[Web
Server]/arsys/servlet/ViewFormServlet?form=[HelpDesk Case Form
Name]&server=[ARServer Name]&eid={Case_ID}]]>
</Pattern>
<UserVariable>specify the Web server</UserVariable>
<UserVariable>specify the HelpDesk Case Form Name</UserVariable>
<UserVariable>specify the ARServer Name</UserVariable>
<SubstitutionVariable>specify the Case_ID</SubstitutionVariable>
</ExternalURL>
</TicketingConnector>
</ManagementConnector>
表2-2では、ファイルを分割して、各セクションの実行内容を説明します。
表2-2 コネクタ記述子XMLファイルの説明
| メタデータ・ファイル・セクション | 説明 |
|---|---|
<Authentication>
<Username>
<AttributeName> |
（オプション）このセクションでは、チケッティング・システムWebサービスの認証スキーマを記述できます。 「管理コネクタの構成」ページ（図2-2）は、このセクションに基づいて生成されます。 ユーザー名、パスワードおよび追加のテキスト・フィールドは、このセクションに基づいて移入されます。
|
<TicketingService>
<Method>createTicket</Method>
<WebServiceEndpoint>
<
<getTicketRequest>
<ticketID> … </ticketID>
</getTicketRequest>
これはManagement Connectorフレームワークにより生成され、XSLT変換ファイルgetTicket_request.xslでコネクタ準拠XMLデータに変換する必要があります。Remedy Connectorの変換ファイルは、次の場所にあります。
$ORACLE_HOME/sysman/connector/<Remedy_Connector>/getTicket_request.xsl
このXSLTファイルのコンテンツは、次のとおりです。
<?xml version='1.0' encoding='UTF-8'?>
<xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:template match="getTicketRequest">
<urn:GetListBy_Case_ID xmlns:urn="urn:HelpDesk_Query_Service">
<urn:Case_ID>
<xsl:value-of select="ticketID/text()"/>
</urn:Case_ID>
</urn:GetListBy_Case_ID>
</xsl:template>
</xsl:transform>
Remedy以外のヘルプ・デスク・コネクタでは、このXSLTファイルを変更し、前述のRemedy Connectorと類似した場所に置く必要があります。このファイルは、次に示すRemedyシステムのケースのように、汎用getTicketリクエストをチケッティング・システムで受入れ可能なデータに変換する必要があります。
<urn:GetListBy_Case_ID xmlns:urn="urn:HelpDesk_Query_Service" >
<urn:Case_ID>HD0000000016686</urn:Case_ID>
</urn:GetListBy_Case_ID>
XMLスキーマgetTicket_response.xsdで定義される、管理コネクタ・フレームワークで受入れ可能な汎用getTicketレスポンスは、次のとおりです。
$ORACLE_HOME/sysman/connector/common/schema
このファイルのコンテンツは、次のとおりです。
<?xml version="1.0" encoding="US-ASCII" ?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <xsd:element name="getTicketResponse"> <xsd:complexType> <xsd:sequence> <xsd:element name="ticketID" type="xs:string"/> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>
このスキーマでは、ヘルプ・デスク・コネクタ用の汎用getTicketレスポンスのサンプルは、次のとおりです。
<getTicketResponse>
<ticketID> … </ticketID>
</getTicketResponse>
getTicket_response.xsl変換ファイルを使用して、コネクタ準拠getTicketレスポンスを汎用XMLデータに再変換します。Remedy Connectorの変換ファイルは、次の場所にあります。
$ORACLE_HOME/sysman/connector/<Remedy_Connector>/getTicket_response.xsl
Remedy Connector用のXSLTファイルのコンテンツは、次のとおりです。
<?xml version='1.0' encoding='UTF-8'?>
<xsl:transform version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:urn="urn:HelpDesk_Query_Service"
xmlns="http://xmlns.oracle.com/sysman/connector/tt"
targetNamespace="http://xmlns.oracle.com/sysman/connector/tt"
elementFormDefault="qualified">
<xsl:template match="urn:getListValues">
<getTicketResponse>
<ticketID><xsl:value-of select="urn:Case_ID/text()"/></ticketID>
</getTicketResponse>
</xsl:template>
</xsl:transform>
Remedy以外のヘルプ・デスク・コネクタでは、このgetTicket_response.xslファイルを変更し、前述のRemedy Connectorと類似した場所に置く必要があります。
外部チケッティング・システムとEnterprise Manager間の接続を確立するプロトコルとしてHTTPSを選択している場合は、この項で説明している手順に従ってください。
外部チケッティング・システムに対する証明書リクエスト・ファイルを作成し、たとえばVeriSignなどの認証局に送信します。
|
注意: 証明書リクエスト・ファイルは、外部チケッティング・システムに使用されているWebサーバーに依存します。 |
証明書の取得後、外部チケッティング・システムに使用されているWebサーバーにインポートします。インポート・メカニズムは、外部チケッティング・システムに使用されているWebサーバーによって異なります。
|
注意: Oracle Wallet Managerは、OMS上の$ORACLE_HOME/binで参照できます。詳細は、『Oracle Application Server管理者ガイド』を参照してください。 |
スーパー管理者として、次のコマンドとともにorapki utilityを使用して、ウォレットを作成します。
orapki wallet create -wallet client -auto_login
|
注意: orapkiは、OMS上の$ORACLE_HOME/binで参照できます。 |
次のコマンドを使用して、信頼できる証明書をウォレットに追加します。
orapki wallet add -wallet client -trusted_cert -cert verisignCert.cer
ウォレットのコンテンツを表示するには、次のコマンドを実行します。
orapki wallet display -wallet client
ewallet.p12という名前のファイルが有効であることを確認します。
Oracle Wallet Managerで、クライアント証明書ewallet.p12を開きます。
信頼できる証明書の選択へ進み、メイン・メニューで「操作」を選択します。
「すべての信頼できる証明書のエクスポート」を選択します。
ファイルをcertdb.txtという名前で保存します。
certdb.txtを、コネクタのホーム・ルート・ディレクトリ（$OMS_HOME/sysman/connector）に配置します。
コネクタのホーム・ルート・ディレクトリにすでにcertdb.txtが存在する場合は、このファイルを開き、作成したcertdb.txtファイルのコンテンツを既存のコンテンツに追加します。
これで、Java SSLでこのファイルを使用し、情報を取得できるようになります。
|
関連項目: Oracleウォレットの作成の詳細は、『Oracle Database Advanced Security管理者ガイド』の、orapkiを使用したOracleウォレットの作成および表示に関する項を参照してください。 |
『Oracle Enterprise Managerアドバンスト構成』の「Remedyコネクタの構成」の章。
