Integratorでの使用方法について説明します。Integratorには、JMS宛先を統合するための、単純で透過的な方法が用意されています。この章では、XMLペイロードを使用するJMSメッセージの処理について説明します。バッチ・モードでのテキスト・ペイロードの処理の説明は、第24章「JMS」を参照してください。MQなど)に適用されます。これらのほとんどのナレッジ・モジュールには、メッセージを確実に配信するためのトランザクション処理が含まれます。JMSメッセージの構造JMSメッセージの構造の詳細は、24.1.1.1項「JMSメッセージの構造」を参照してください。Integratorでは、JMS宛先によって配信されるXMLメッセージの処理が可能です。XMLトピック・テクノロジを介して処理されます。XMLトピック・テクノロジでは、各メッセージ・ペイロードに完全なXMLデータ構造が含まれます。Driverを使用して、モデルとして表示されるリレーショナル・スキーマ(XMLスキーマ)にマップされます。注意:この方法は、XMLファイルの処理と非常に似ています。XMLでは、メッセージ・ペイロードがXMLファイルです。XMLの参照情報」を参照してください。XMLトピックまたはキューのデータ・サーバーとして定義されます。XML形式のメッセージを配信する各トピックまたはキューに対して、データ・サーバーと物理スキーマの1つのペアが宣言されます。XMLメッセージの構造は、データ・モデルとして表示されるリレーショナル構造(XMLスキーマと呼ぶ)にマップされます。このモデル内の各データストアは、XMLファイルの一部(一般的には要素タイプ)を表します。XMLメッセージの消費または生成時には、モデル全体を1つの単位として使用およびロードする必要があります。XMLメッセージの処理単位はパッケージです。モデル内でメッセージのプロパティまたはヘッダー・フィールドを宣言したり、インタフェース内で列として使用することはできません。メッセージ・セレクタでの使用やKMオプションを介した設定は可能です。受信XMLメッセージの処理は、パッケージ単位で次のように実行されます。この操作では、メッセージの読取りおよびXMLスキーマの生成が行われます。通常、メッセージに最初にアクセスするインタフェースによって実行されます。一連のインタフェースにより、XMLスキーマのデータストアがソースとして使用されます。このデータを使用できるのは、セッションの終了、新規の同期化アクションによる別のメッセージの読取り、またはJMS読取りのコミットの実行が発生するまでです。この操作では、メッセージ消費の検証およびXMLスキーマの削除が行われます。XMLメッセージからデータを抽出する最後のインタフェースで実行する必要があります。XMLメッセージの生成XMLメッセージを生成するには、パッケージが次のタスクを実行できるように設計されている必要があります。この操作では、生成するXMLメッセージに対応する空のXMLスキーマが作成されます。この操作は、通常、構造をロードする最初のインタフェースで実行されます。一連のインタフェースによって、XMLスキーマにデータがロードされます。この操作では、XMLスキーマがXMLメッセージに変換され、JMS宛先に送信されます。この操作は、通常、スキーマをロードする最後のインタフェースで実行されます。XML宛先のメッセージをフィルタ処理できます。このタイプのフィルタでは、メッセージのプロパティまたはヘッダー・フィールドのみを使用できます。Integratorで読み取られる情報量が削減されます。XMLスキーマから抽出されたデータを使用して、インタフェースでデータをフィルタ処理することもできます。Integratorで処理されます。Integratorには、XMLメッセージを処理するためのナレッジ・モジュール(KM)が用意されています。これらのリストを表25-1に示します。SQL-92標準準拠ステージング領域からJMS準拠のメッセージのキューまたはトピックへ、XML形式でデータを統合します。SQL-92標準準拠データベースへ、データをロードします。インストールおよび構成JMSナレッジ・モジュールの使用を開始する前に、この項の情報を必ず読んでください。システム要件および動作要件インストールを実行する前に、システム要件および動作要件のドキュメントを読んで、使用する環境がインストールする製品の最低インストール要件を満たすことを確認する必要があります。(OTN)からアクセスできます。テクノロジ固有の要件JMS宛先へのアクセスは、通常、JNDIサービス経由で行われます。JNDIおよびJMSの構成および固有の要件は、接続先のJMSプロバイダによって異なります。詳細は、JMSプロバイダ固有のドキュメントを参照してください。XMLデータベースに接続するための要件をリストします。Integratorには、JMSプロバイダ専用のドライバは含まれていません。このプロバイダの接続性要件は、JMSプロバイダのドキュメントを参照してください。XMLドライバを介して行われます。Integratorとともにインストールされます。XMLコンテンツを説明するDTDファイルの場所は、システム管理者に問い合せてください。トポロジの設定トポロジの設定には次が含まれます。XMLデータ・サーバーは、ローカル・ネットワーク経由でアクセス可能な1つのJMSプロバイダまたはルーターに対応します。XMLデータ・サーバーには、JMSキューXMLとJMSトピックXMLの2タイプがあります。JMSキューXMLデータ・サーバーは、JMSルーター内の単一のキューに接続してXMLメッセージを統合するために使用されます。JMSトピックXMLデータ・サーバーは、JMSルーター内の単一のトピックに接続してXMLメッセージを統合するために使用されます。JMSドライバにより、XMLコンテンツを含むメッセージがメモリー内のリレーショナル・スキーマにロードされます。このスキーマは、XMLメッセージの階層構造を表し、リレーショナル構造をアンロードしてJMSメッセージに戻すことができます。Integrator開発者ガイド』のデータ・サーバーの作成に関する項に記載されている標準の手順で、JMSキューXMLテクノロジまたはJMSトピックXMLテクノロジ用のデータ・サーバーを作成します。XML固有の情報を指定する必要があります。詳細は、5.3.1項「XMLデータ・サーバーの作成」を参照してください。この項では、JMSキューXMLまたはJMSトピックXMLデータ・サーバーの定義に関する必須または固有のフィールドのみについて説明します。Integratorに表示されるデータ・サーバーの名前。ここでは使用しません。これらのフィールドは空のままにします。認証モードをリストから選択します。JNDIディレクトリに接続するためのユーザー名を入力します(オプション)。このユーザーのパスワード(オプション)。リストから「JNDI」プロトコルを選択します(オプション)。JNDIプロバイダに接続するための初期コンテキスト・ファクトリjavaクラスの名前。URLのプロパティの説明は、表25-2を参照してください。JMSキュー(またはトピック)の接続ファクトリに対応するJNDIリソースの論理名。注意:メッセージ・キューにアクセスする場合はQueueConnectionFactory、トピックにアクセスする場合はTopicConnectionFactoryを指定します。これらのパラメータはJNDIディレクトリ固有のものです。説明d<DTDファイルの場所>UNC形式のDTDファイルの場所(相対または絶対)。パス名にはスラッシュ"/"を使用し、ファイル・パスにはバックスラッシュ"\"を使用しないでください。このパラメータは必須です。re<ルート要素>スキーマのルート表として選択する要素の名前。この値では大/小文字が区別されます。このパラメータは、WSDLファイルの特定のメッセージ定義をリバース・エンジニアリングする場合や、使用可能なルート要素がXSDファイル内に複数存在する場合に使用できます。falsetrueの場合は、XMLファイルが読取り専用モードで開きます。s<スキーマ名>XMLファイルのロード先となるリレーショナル・スキーマの名前。この値は、このデータ・サーバーに添付されている物理スキーマの設定値と一致する必要があります。このパラメータは必須です。false大/小文字を区別するモードまたは区別しないモードで、XMLファイルがロードされます。大/小文字を区別しないモードの場合は、DTDファイル内のすべての要素名を区別できることが必要です(たとえば、同じファイルにAbcとabcを含めることはできません)。大/小文字を区別するパラメータは、スキーマの永続パラメータです。スキーマの作成後に変更することはできません。大/小文字を区別しないモードでXMLファイルを開く場合、XMLファイルの大/小文字は保持されます。JMSXML_ROWSEPARATOR5B23245D異なるXMLコンテンツの行セパレータ(改行)として使用される文字列の16進コード。デフォルト値の5B23245Dは、文字列[#$]に相当します。JMS_DESTINATIONJNDIキュー名またはトピック名JMSキューまたはトピックのJNDI名。このパラメータは必須です。tnaブール値(true|false非ASCIIを変換します。非ASCII文字を保持するにはfalseに設定します。デフォルトはtrueです。このパラメータは必須ではありません。例LDAPディレクトリをJNDIプロバイダとして使用する場合は、次のパラメータを使用する必要があります。XML物理スキーマを作成します。name>プロパティで定義されたスキーマ名を使用してください。XMLデータ・サーバーに必要な物理スキーマは、1つのみです。Integrator開発者ガイド』の論理スキーマの作成に関する項に記載されている標準の手順で、この物理スキーマ用の論理スキーマを作成し、特定のコンテキストで関連付けます。XMLを使用してプロジェクトを設定するには、標準の手順に従います。Integrator開発者ガイド』の統合プロジェクトの作成に関する項を参照してください。XMLでの作業を開始するにあたり、使用するプロジェクトに次のナレッジ・モジュールをインポートすることをお薦めします。Integrator開発者ガイド』のモデルの作成に関する項に記載されている標準の手順で、JMSキューXMLまたはJMSトピックXMLモデルを作成します。JMSキューXMLまたはJMSトピックXMLの各モデルは一連のデータストアに対応し、各データストアはXMLファイルのエントリ・レベルを表します。これらのモデルには、JMSメッセージの構造を説明するデータストアが含まれます。各モデルには、1つのトピックまたはキューのメッセージ構造が含まれます。このモデルの構造は、標準のリバース・エンジニアリングを使用して、データ・サーバー定義で指定されたDTDまたはXMLファイルからリバース・エンジニアリングされます。XMLでは、XMLドライバの機能のみを使用する標準のリバース・エンジニアリングがサポートされています。Integrator開発者ガイド』のモデルのリバース・エンジニアリングに関する項に記載されている通常の手順を行います。Integratorにより、XMLデータから生成された表に、次の列が自動的に追加されます。親子関係に使用されます。親子関係に使用されます。XMLファイルでのデータの表示順序を取得できます。これらの追加の列により、スキーマに格納されたリレーショナル構造でのXML階層構造のマッピングが可能になります。XMLの参照情報」を参照してください。インタフェースの設計インタフェースまたはチェック用に選択したKMによって、このインタフェースまたはチェックの機能およびパフォーマンスが決まります。この項に示す推奨事項は、XMLメッセージに関連する様々な状況でのKMの選択に役立ちます。XMLは、インタフェースのソースまたはターゲットとして使用できます。SQL-92標準準拠データベースにロードできます。XMLと別のタイプのデータ・サーバー間でデータをロードするためのLKMの選択は、正常なデータ抽出を行うためにきわめて重要です。SQLが用意されています。このLKMは、エージェントを使用して、選択されたメッセージをソース・キューまたはトピックから読み取り、動的に作成される一時ステージング表に結果を書き込みます。メッセージを確実に配信するために、メッセージ消費者(またはサブスクライバ)では、IKMによってデータが実際にターゲットに統合されるまで、読取りをコミットしません。JMSメッセージである場合は、このLKMの使用を検討してください。JMSプロバイダからXMLメッセージをロードするには、次の手順に従う必要があります。LKMオプションをYesに設定する必要があります。このオプションによって、キューまたはトピックから取得されるメッセージから、XMLスキーマが作成およびロードされます。最後のインタフェースで、JMS_COMMITをYesに設定して、メッセージの消費をコミットする必要があります。このナレッジ・モジュールのJMS固有のオプションは、表25-3を参照してください。Appendが用意されています。SQL-92標準準拠ステージング領域からJMS準拠のメッセージのキューまたはトピックへ、XML形式でデータを統合します。このIKMを使用するには、ステージング領域がターゲットと異なる必要があります。XMLターゲットにXMLデータを統合するには、次の手順に従う必要があります。(XMLファイルのルート要素に対応するモデルの表)の値を指定し、さらにINITIALIZE_XML_SCHEMAオプションをYesに設定する必要があります。XMLモデルの階層ツリー表示の最上位にあるデータストアに対応します。そのため、ROOT_TABLEパラメータには、このデータストアのリソース名の値を使用する必要があります。インタフェースによるデータストアのロードは、階層の順序に従って、階層の最上位から下位へ行う必要があります。XMLスキーマ階層の最上位より下のレベルをロードするインタフェースでは、現在の階層レベルを上位のレベルとリンクする外部キー列をロードする必要があります。階層の2番目のレベル(ルート表の下のレベル)をロードする場合、外部キー列を0(ゼロ)に設定する必要があります。これは、ルート表の初期化時にIKMによってルート表の主キーに設定される値が0であるためです。最後のインタフェースでは、XMLスキーマをJMSプロバイダに送信する必要があります。そのために、SYNCHRO_JMS_TO_XMLパラメータをYesに設定します。例XMLファイル形式によって次のデータストア階層のスキーマが生成されるとします。...)この階層では、GEOGRAPHY_DIMがルート表で、そのGEOGRAPHY_DIMPK列が初期化時に0に設定されます。この表は、GEOGRAPHY_DIM、COUNTRY、REGIONの順にロードする必要があります。XML階層の2番目のレベル(COUNTRY)のロード時に、このレベルをルート表のレベルとリンクするFKフィールドが0に設定されていることを確認します。上のモデルでは、COUNTRYのロード時に、0に設定されているCOUNTRY.GEOGRAPHY_DIMFKをロードする必要があります。REGIONのレコードをCOUNTRYレベルにリンクする必要があります。COUNTRY.COUNTRYPK)、REGION.COUNTRYFK列をロードします。XMLの参照情報」を参照してください。このIKMのJMS固有のKMオプションは、表25-3を参照してください。XMLメッセージ固有のオプションは太字で表記されています。XMLのLKMおよびIKMのKMオプションは、表25-3を参照してください。XMLメッセージ固有のオプションは太字で表記されています。ほとんどのオプションはLKMとIKMで同じですが、次の点のみ異なります。INITIALIZE_XML_SCHEMAおよびROOT_TABLEオプションは、IKMのみで使用できます。DELETE_TEMPORARY_OBJECTSおよびJMS_COMMITオプションは、LKMのみで使用できます。XML)上でメッセージ消費をコミットするには、JMS_COMMITをYesに設定します。説明CLIENTID読取りサブスクライバ識別文字列。公開には使用されません。セッションは永続的です。切断後もサブスクライバ定義がルーター上に残ることを示します。INITIALIZE_XML_SCHEMA書込み空のXMLスキーマを初期化します。スキーマをロードする最初のインタフェースで、このオプションをYESに設定する必要があります。永続メッセージはサーバーに残り、サーバーのクラッシュ時にリカバリされます。0の場合、メッセージの有効期限が切れることはありません。この有効期限を過ぎると、メッセージは期限切れとみなされ、トピックまたはキューからなくなります。インタフェースの開発時には、このパラメータをゼロに設定することをお薦めします。0(最低)から9(最高)。JMSTYPE書込みメッセージの名前(オプション)。すべてのメッセージが取得されます。SQL構文のメッセージ・セレクタ。メッセージ・セレクタの詳細は、24.7.1項「JMSプロパティの使用」を参照してください。MESSAGETIMEOUTが0の場合、タイムアウトは発生しません。MESSAGETIMEOUTおよびMESSAGEMAXNUMBERの両方をゼロにすることはできません。=0の場合、MESSAGETIMEOUTの値として1が使用されます。このタイムアウト値が小さすぎると、インタフェースによってメッセージが取得されない可能性があります。デフォルト値は1000です。この値が小さすぎると、インタフェースによってトピックまたはキューにあるメッセージの一部のみが取得される場合があります。ROOT_TABLE書込みXMLモデル階層のルートであるデータストアのリソース名。TextMessage)。SYNCHRO_XML_TO_JMS書込みXMLスキーマからXMLメッセージを生成し、このメッセージを送信します。スキーマXMLへの書込みを行う最後のインタフェースで、このオプションをYESに設定する必要があります。reserved.法律上の注意点ライブラリ。