この章では、Oracle SOA Suite for healthcare integrationのレポート機能について説明します。構成可能なレポートには、ヘルスケア統合アプリケーションによるメッセージ処理のリアルタイムのステータスが、指定した条件に基づいて表示されます。
この章には次のトピックが含まれます:
Oracle SOA Suite for healthcare integrationのユーザー・インタフェースのレポート・ページには、Oracle Healthcareのコンポーネントで処理されるメッセージのステータスがリアルタイムで表示されます。すべてのメッセージを表示したり、様々な条件(エンドポイント、日付範囲、ドキュメント情報、およびペイロード・フィールドを含む)によって表示するメッセージを絞り込むことができます。
Oracle Healthcareのユーザー・インタフェースには、いくつかのレポートが事前に定義されています。ワイヤ・メッセージ・レポート、関連付けられていないワイヤ・メッセージ・レポート、ビジネス・メッセージ・レポート、アプリケーション・メッセージ・レポートおよび関連付けられていないアプリケーション・メッセージ・レポートがそれに当たります。さらに詳細な条件に基づいたレポートを追加で作成し、表示されるメッセージのタイプを絞り込めます。
各レポートは4つのセクションに分かれています。
レポート構成バー
メッセージ・リスト
メッセージ・フローの図による表示
選択したメッセージのメッセージ詳細
レポートで複数のメッセージを選択すると、選択したメッセージの情報の概要がフロー・ダイアグラムのかわりに表示されます。
Oracle Healthcareには、次のレポート・タイプに基づいて事前定義済レポートのセットが用意されており、レポート・ホームページの右上端にあるプラス記号のアイコンをクリックするとアクセスできます。
一般ビジネス・メッセージ・レポート: 最初から、または指定された時間範囲に交換されたビジネス・メッセージがすべてリストされます。これらのレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。
一般アプリケーション・メッセージ・レポート: 交換されたすべてのアプリケーション・メッセージがリストされます。このレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。
一般ワイヤ・メッセージ・レポート: 交換されたすべてのワイヤ・メッセージがリストされます。このレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。
関連付けられていないアプリケーション・メッセージ・レポート: 関連付けられたビジネス・メッセージを除くアプリケーション・メッセージを表示するアプリケーション・メッセージ・レポートがすべてリストされます。これらのレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。
関連付けられていないワイヤ・メッセージ・レポート: 関連付けられたビジネス・メッセージを除くワイヤ・メッセージを表示するワイヤ・メッセージ・レポートがすべてリストされます。これらのレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。
関連付けられていないメッセージ・レポートの詳細は、9.4項「関連付けられていないメッセージのレポートの作業」を参照してください。
図9-1に示すように、カスタマイズされたレポートは、Oracle Healthcareコンソールで、それぞれのレポート・タイプの下に表示されます。
図9-2に、「レポート」タブに表示されている一般ビジネス・メッセージ・レポートの例を示します。
図9-3に、「レポート」タブに表示されている一般ワイヤ・メッセージ・レポートの例を示します。
図9-4に、「レポート」タブに表示されている一般アプリケーション・メッセージ・レポートの例を示します。
メッセージ・リストでは、各メッセージに、メッセージの処理情報を表すアイコンが表示されます。封筒のアイコンは通常処理を、緑色の矢印が表示された封筒のアイコンはメッセージが再発行されたことを、Xの付いた赤い四角形が表示された封筒のアイコンはエラーを示します。
レポートの作成や既存レポートの編集には、3つのメッセージ・レポート・フィルタ・エディタ(ワイヤ、ビジネスおよびアプリケーション)を使用します。レポート・エディタでは、時間範囲、エンドポイント、プロトコル、状態、メッセージ・ステータス、およびドキュメント定義情報など、レポートに表示するメッセージに関して様々な条件を定義できます。また、相関フィールド、SOAコンポジット・フィールド、メッセージIDなどを含む詳細オプションも使用できます。
図9-5に、ビジネス・メッセージ・レポート・カスタマイザの例を示します。
大部分のフィルタでは、フィルタに指定した値の評価方法を指定する演算子を選択する必要があります。また、検索時に大/小文字の区別をするかどうかも指定できます。ほとんどのフィルタは、指定した値に対し、「任意」、「次と等しい」、「相似」、「次と等しくない」、または「相似でない」の演算子をサポートしています。「相似」および「相似でない」演算子に関しては、値にSQLのワイルドカード文字を使用できます。SQLのワイルドカード文字には次のものが含まれます。
% (パーセント): ゼロ字以上の任意の文字を表します。
_ (アンダースコア): 1つの文字を表します。
[charlist]: 文字のリストで、任意の値はリスト内のいずれかの文字です。
[^charlist]または[!charlist]: 文字のリストで、任意の値はリスト内の文字ではありません。
ほとんどの文字列ベースの条件では、フィールドの隣の「大/小文字を区別しない」を選択または選択解除することにより、検索で大/小文字を区別するかどうかを指定できます。フィルタ条件リスト内のセクション間を移動するには、「フィルタ条件」の横にあるリンクを使用します。
メッセージのエラーがOracle SOA Suite for healthcare integrationの内部的なものである場合、問題を修正してメッセージを再送信できます。たとえば、適切に構成されていないエンドポイントにメッセージを送信した場合は、エラーを修正し、アプリケーション・メッセージまたはワイヤ・メッセージの再発行機能を使用します。
アウトバウンド・メッセージのアプリケーション・メッセージを再発行すると、メッセージがクローニングされた後、新しいメッセージのステータスがRESUBMITTEDになり、クローンの配信が試行されます。また、元のアプリケーション・メッセージのRESUBMIT_COUNTが1つ増えます。クローニングされたメッセージのRESUBMIT_REF_TOも、元のアプリケーション・メッセージのIDに設定されます。再発行されたアプリケーション・メッセージがバッチ・メッセージの一部である場合、関連付けられたワイヤ・メッセージの状態もRESUBMITTEDに設定されます。このタイプのメッセージの再発行は、ドキュメントの構成が最重要ではなく、メッセージの設定を更新して再構成する必要がある場合に役立ちます。
インバウンド・メッセージのアプリケーション・メッセージを再発行すると、メッセージのステータスがRESUBMITTEDに設定され、バックエンド・アプリケーションへのメッセージ配信が再度試行されます。このタイプのメッセージの再発行は、バックエンド・アプリケーションが停止したため配信を再試行する必要がある場合に役立ちます。
アウトバウンド・メッセージのワイヤ・メッセージを再発行すると、メッセージのステータスがRESUBMITTEDに設定され、以前に処理されたメッセージのみ再配信が試行されます。再パッケージングまたは他のメッセージ変換は実行されません。これは、問題がデリバリ・エンドポイントにある場合(受信者のサーバーが停止したためメッセージを受信できない場合など)に役立ちます。
インバウンド・メッセージのワイヤ・メッセージを再発行すると、ワイヤ・メッセージがクローニングされた後、新しいメッセージのステータスがRESUBMITTEDになり、メッセージの配信が試行されます。また、元のワイヤ・メッセージのRESUBMIT_COUNTが1つ増えます。クローニングされたメッセージのRESUBMIT_REF_TOも、元のワイヤ・メッセージのIDに設定されます。ビジネス・メッセージおよびアプリケーション・メッセージのメッセージ・ステータスもRESUBMITTEDに設定されます。エンドポイントでは機能確認を予期していますが、リモート・エンドポイントに機能確認は返されません。これは、ドキュメント設定が適切でないために、メッセージを再度変換して検証する必要がある場合に役立ちます。
Oracle SOA Suite for healthcare integrationでは、すぐに使用できるように、いくつかの事前定義済レポートが用意されています。これらのレポートはフィルタ処理できますが、基準となるのは、「デザイナ」→「管理」→「設定」→「UI」→「レポート」→「時間範囲」で構成できる時間範囲のみです。詳細は、13.2項「ユーザー・インタフェース設定の構成」を参照してください。追加のレポートを作成し、エンドポイント、メッセージID、ドキュメント・プロパティ、コンポジット・プロパティ、トランスポート・プロトコル・プロパティ、主要なペイロード・フィールドなどの基準で、さらにメッセージを絞り込むことが可能です。また、事前定義済レポートに基づいて、それらを変更したり、新規レポートとして保存することもできます。
事前定義済のビジネス・メッセージ・レポートがありますが、ユーザー独自の要件に合せてレポートを追加作成できます。
ビジネス・メッセージ・レポートを作成するには
Oracle SOA Suite for healthcare integrationのユーザー・インタフェースで「レポート」タブをクリックします。
レポートが開いていない場合には、レポートのようこそページが表示されます。
右上にあるプラス記号のアイコンをクリックして、「レポートの作成」を選択します。
図9-7に示すように、「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「一般ビジネス・メッセージ・レポート」を選択して、「作成」をクリックします。
レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。
メッセージ・レポート・フィルタ・カスタマイザで、表9-1で説明されているいずれかのフィルタ条件を入力します。
注意: 最初にワイヤ/ビジネス/アプリケーション・メッセージ・レポートを作成(または新規ファイルとして保存してクローニング)すると、そのレポートを初めて開いたときに検索が自動的に実行されません。明示的に「検索」ボタンをクリックする必要があります。 |
フィルタ条件リスト内のセクション間を素早く移動するには、「フィルタ条件」の横にあるリンクを使用します。
注意: ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。 |
表9-1 ビジネス・メッセージ・レポート・カスタマイザのオプション
フィルタ | 説明 |
---|---|
レポートの名前。 |
|
レポートの簡単な説明。 |
|
検索条件がANDまたはOR演算子のいずれによって連結されているかを示すインジケータ。ANDを使用するには「次の条件のすべてと一致」を選択し、ORを使用するには「次の条件のいずれかと一致」を選択します。 |
|
表示するメッセージのビジネス・メッセージID。演算子を選択し、メッセージIDに適切な値を入力します。 |
|
任意 |
日付範囲によってレポートを絞り込まずに、すべての日付および時間のメッセージが表示されます。 |
最後 |
最近の日付または時間の範囲でレポートを絞り込みます。たとえば、過去12時間、過去5日、または過去2週間を選択できます。スライド・スケールのポインタを動かして時間範囲を選択します。「UI設定」で、有効化された時間スライダ期間を変更できます。 |
範囲 |
指定した日付の範囲でレポートを絞り込みます。「開始」または「終了」フィールド、もしくは両方のフィールドで、日時を示されている書式(MM/DD/YYYY HH:MM:SS AM/PM)で指定するか、「日付および時間を選択」アイコンをクリックします。 特定の日付よりも後のすべてのメッセージを検索するには、「開始」フィールドの日付のみ入力します。特定の日付よりも前のすべてのメッセージを検索するには、「終了」フィールドの日付のみ入力します。日付の範囲内のすべてのメッセージを検索するには、「開始」および「終了」フィールドの両方に日付を入力します。特定の時間の範囲を除外するには、除外する範囲の最初の日付を「終了」フィールドに入力し、除外する範囲の最後の日付を「開始」フィールドに入力します。この除外範囲を使用するには、「次の条件のいずれかと一致」インジケータを選択する必要があります。検索すると、受信したすべてのメッセージが返されます。 開始および終了日の両方について、指定した日付を検索に含める場合は「包含」を選択するか、それらの日付を検索から除外するには除外の選択を解除します。 |
表示するメッセージの方向。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから方向(インバウンドまたはアウトバウンド)を選択します。 |
|
メッセージの受信元またはメッセージの配信先のエンドポイント。演算子を選択し、定義済エンドポイントの名前を入力します。 |
|
表示するメッセージの状態。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから1つ以上のメッセージの状態を選択します。 |
|
ドキュメント |
次の3つのフィールドでドキュメントのプロパティを指定できます。これらの3つのフィールドは、レポート表の「ドキュメント・タイプ」列に表示される内容を制御します。いずれのフィールドでも、検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。 |
表示するメッセージのドキュメント・プロトコル。演算子を選択し、ドキュメント・プロトコルを入力します。HL7メッセージの場合は「HL7」と入力します。 |
|
表示するメッセージのドキュメント・プロトコルのバージョン。演算子を選択し、バージョンを入力します。たとえば、HL7 2.6メッセージの場合は「2.6」と入力します。 |
|
表示するメッセージのドキュメント・プロトコルのタイプ。演算子を選択し、バージョンを入力します。たとえば、HL7 ADT_A04メッセージの場合は「ADT_A04」と入力します。 |
|
メッセージのフィールドのコンテンツによって検索を絞り込む名前と値のペア。入力した各フィールド名について、対応するフィールドの値を入力します。それぞれの名前または値について、演算子を選択します。 これらのフィールドは、ドキュメント定義のXPathページで定義されている場合のみ使用できます。「名前」フィールドには、XPathページで指定されている、メッセージ内のフィールドを表す名前を入力します。「値」フィールドには、対応するフィールドで検索の対象とする値を入力します。 ドキュメント定義を作成する際、メッセージ内で最大3つのフィールドをペイロード・キー・フィールドとして指定できます。これらのフィールドは、一意の名前と、メッセージ内のフィールドの位置を示すXPath式によって定義されます。たとえば、HL7 A03メッセージのPIDセグメント内の姓フィールドをLastNameと名付け、XPath式を指定します。ドキュメント定義の相関フィールドも同様に定義できます。 ドキュメント定義で相関フィールドまたはペイロード・キー・フィールドのいずれかを指定している場合、これらのフィールドをビジネス・メッセージ・レポートのフィルタとして使用できます。フィルタ・エディタでは、これらのフィルタは名前と値のペアとして定義されます。ドキュメント定義の作成時にフィールドに名付けた一意の名前を指定し、次にレポートに含めるメッセージでのそのフィールドの値を指定します。 |
|
ドキュメント |
|
表示するメッセージで使用されているドキュメント定義。演算子を選択し、定義済ドキュメント定義の名前を入力します。 |
|
交換の一意の識別子。この番号は、メッセージの追跡、伝送の重複または欠落の検出、または順序が正しくないメッセージの検出に使用されます。 |
|
グループの一意の識別子。この番号は、監査、グループの重複または欠落の検出、または順序が正しくないメッセージの検出に使用されます。この番号は機能確認によって参照されます。 |
|
トランザクション・セットの一意の識別子。トランザクション・セット確認のために、機能確認によってこの番号が参照されます。 |
|
コンポジット |
|
Oracle SOAコンポジット・アプリケーションによって使用されるトランスポート・プロトコルの名前。 |
|
Oracle SOAコンポジット・アプリケーションによって使用されるトランスポート・プロトコルのバージョン。 |
|
実行コンテキストのID。ECIDを使用してエンドツーエンドのメッセージ追跡を実行できます。 |
|
Oracle SOAコンポジット・インスタンスのID。 |
|
Oracle JDeveloperのOracle SOAコンポジット・アプリケーションの名前。 |
|
Oracle SOAコンポジット・アプリケーションのヘルスケア統合サービス・バインディング・コンポーネントの名前。 |
|
Oracle SOAコンポジット・アプリケーションのヘルスケア統合参照バインディング・コンポーネントの名前。 |
|
Oracle SOAコンポジット・アプリケーションがデプロイされているWebLogicドメインの名前。 |
|
Oracle JDeveloperのOracle SOAコンポジット・アプリケーションのバージョン。 |
|
相関 |
|
相関を開始する相関フィールドの名前。このフィールドおよび他の相関フィールドは、ドキュメント定義の相関ページで定義されている場合のみ使用できます。使用方法の詳細は、表9-1の「ペイロード・キー・フィールド」を参照してください。 |
|
上記のフィールドの値。 |
|
相関の2番目のフィールドの名前。 |
|
上記のフィールドの値。 |
|
エラー |
|
レポートに表示するエラー・メッセージのエラー・コード。 |
|
レポートに表示するエラー・メッセージのテキスト。 |
|
メッセージ |
|
レポートに表示するアプリケーション・メッセージの一意の識別子。 |
|
レポートに表示するメッセージの一意のプロトコル・メッセージ識別子。 |
|
変換する前の元のメッセージのサイズ。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、数値を入力します。 |
|
変換後のメッセージのサイズ。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、数値を入力します。 |
レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。
レポート・フィルタの指定後、次のいずれかを実行します。
フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。
レポートのフィルタ条件に加えた変更を保存するには、「保存」をクリックします。
注意: 標準レポート(一般ビジネス・メッセージ・レポートなど)に行った変更は保存できません。「新規ファイルとして保存」ボタンをクリックすることは可能です(このボタンは、レポート名が標準の形式から変更された場合にのみ有効化されます)。 |
図9-8に、過去24時間にIn_Patient_Admissionエンドポイントで交換されたすべてのビジネス・メッセージがリストされているカスタムのビジネス・メッセージ・レポートを示します。
列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。
事前定義済のワイヤ・メッセージ・レポートとは別に、外部エンドポイントと交換するワイヤ・メッセージを対象としたカスタムのワイヤ・メッセージ・レポートを作成できます。ほとんどのワイヤ・メッセージにはビジネス・メッセージが関連付けられており、レポートの「メッセージ・フロー」ダイアグラムに反映されます。
ワイヤ・メッセージ・レポートを作成するには
9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。
「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「一般ワイヤ・メッセージ・レポート」を選択して、「作成」をクリックします。
図9-9に示すように、レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。
メッセージ・レポート・フィルタ・カスタマイザで、表9-2で説明されているいずれかのフィルタ条件を入力します。
注意: ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。 |
表9-2 ワイヤ・メッセージ・レポート・フィルタ・カスタマイザのオプション
フィルタ | 説明 |
---|---|
レポートの名前。 |
|
レポートの簡単な説明。 |
|
表示するメッセージのワイヤ・メッセージID。演算子を選択し、メッセージIDの全体または一部を入力します。 |
|
任意 |
日付範囲によってレポートを絞り込まずに、すべての日付および時間のメッセージが表示されます。 |
最後 |
最近の日付または時間の範囲でレポートを絞り込みます。たとえば、過去12時間、過去5日、または過去2週間を選択できます。スライド・スケールのポインタを動かして時間範囲を選択します。 |
範囲 |
指定した日付の範囲でレポートを絞り込みます。「開始」または「終了」フィールド、もしくは両方のフィールドで、日時を示されている書式(MM/DD/YYYY HH:MM:SS AM/PM)で指定するか、「日付および時間を選択」アイコンをクリックします。 特定の日付よりも後のすべてのメッセージを検索するには、「開始」フィールドの日付のみ入力します。特定の日付よりも前のすべてのメッセージを検索するには、「終了」フィールドの日付のみ入力します。日付の範囲内のすべてのメッセージを検索するには、「開始」および「終了」フィールドの両方に日付を入力します。特定の時間の範囲を除外するには、除外する範囲の最初の日付を「終了」フィールドに入力し、除外する範囲の最後の日付を「開始」フィールドに入力します。この除外範囲を使用するには、「次の条件のいずれかと一致」インジケータを選択する必要があります。検索すると、受信したすべてのメッセージが返されます。 開始および終了日の両方について、指定した日付を検索に含める場合は「包含」を選択するか、それらの日付を検索から除外するには除外の選択を解除します。 |
表示するメッセージの方向。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから方向(インバウンドまたはアウトバウンド)を選択します。 |
|
表示するメッセージのトランスポート・プロトコル。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、定義されたトランスポート・プロトコルの名前を入力します。検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。 |
|
トランスポート・プロトコル・バージョン |
表示するメッセージのトランスポート・プロトコルのバージョン。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、定義されたトランスポート・プロトコル・バージョンの名前を入力します。検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。 |
URL |
表示するメッセージのTCPエンドポイントURL。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、定義されたURL値を入力します。検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。 |
表示するメッセージの状態。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、右のフィールドをクリックして、リストから1つ以上のメッセージの状態を選択します。 |
|
メッセージ・サイズ(バイト) |
表示するメッセージのサイズ(バイト単位)。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義されたメッセージ・サイズを入力します。 |
再発行数 |
(表示される)メッセージが再発行された回数。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義された回数を入力します。 |
最終再発行日 |
(表示される)メッセージが最後に再発行された日付。「任意」、「最後」または「範囲」の各オプションから選択します。 |
レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。
レポート・フィルタの指定後、次のいずれかを実行します。
フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。
レポートのフィルタ条件に加えた変更を保存するには、「新規ファイルとして保存」をクリックします。
図9-10に、過去24時間のインバウンド・ワイヤ・メッセージがすべてリストされているカスタムのワイヤ・メッセージ・レポートを表示します。
列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。
事前定義済のアプリケーション・メッセージ・レポートとは別に、ファブリック/コンポジット・レイヤーと交換するアプリケーション・メッセージを対象としたカスタムのアプリケーション・メッセージ・レポートを作成できます。Oracle Healthcareランタイムに送信されてくるアプリケーション・メッセージのほとんどが、対応するビジネス・メッセージとなり、レポートの「メッセージ・フロー」ダイアグラムに反映されます。
ワイヤ・メッセージ・レポートを作成するには
9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。
「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「一般アプリケーション・メッセージ・レポート」を選択して、「作成」をクリックします。
図9-11に示すように、レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。
メッセージ・レポート・フィルタ・カスタマイザで、表9-3で説明されているいずれかのフィルタ条件を入力します。
注意: ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。 |
表9-3 アプリケーション・メッセージ・レポート・フィルタ・カスタマイザのオプション
フィルタ | 説明 |
---|---|
レポートの名前。 |
|
レポートの簡単な説明。 |
|
表示するメッセージのワイヤ・メッセージID。演算子を選択し、メッセージIDの全体または一部を入力します。 |
|
任意 |
日付範囲によってレポートを絞り込まずに、すべての日付および時間のメッセージが表示されます。 |
最後 |
最近の日付または時間の範囲でレポートを絞り込みます。たとえば、過去12時間、過去5日、または過去2週間を選択できます。スライド・スケールのポインタを動かして時間範囲を選択します。 |
範囲 |
指定した日付の範囲でレポートを絞り込みます。「開始」または「終了」フィールド、もしくは両方のフィールドで、日時を示されている書式(MM/DD/YYYY HH:MM:SS AM/PM)で指定するか、「日付および時間を選択」アイコンをクリックします。 特定の日付よりも後のすべてのメッセージを検索するには、「開始」フィールドの日付のみ入力します。特定の日付よりも前のすべてのメッセージを検索するには、「終了」フィールドの日付のみ入力します。日付の範囲内のすべてのメッセージを検索するには、「開始」および「終了」フィールドの両方に日付を入力します。特定の時間の範囲を除外するには、除外する範囲の最初の日付を「終了」フィールドに入力し、除外する範囲の最後の日付を「開始」フィールドに入力します。この除外範囲を使用するには、「次の条件のいずれかと一致」インジケータを選択する必要があります。検索すると、受信したすべてのメッセージが返されます。 開始および終了日の両方について、指定した日付を検索に含める場合は「包含」を選択するか、それらの日付を検索から除外するには除外の選択を解除します。 |
表示するメッセージの方向。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから方向(インバウンドまたはアウトバウンド)を選択します。 |
|
表示するメッセージの状態。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、右のフィールドをクリックして、リストから1つ以上のメッセージの状態を選択します。 |
|
メッセージ・サイズ(バイト) |
表示するメッセージのサイズ(バイト単位)。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義されたメッセージ・サイズを入力します。 |
ドキュメント |
|
表示するメッセージのドキュメント・プロトコル。演算子を選択し、ドキュメント・プロトコルを入力します。HL7メッセージの場合は「HL7」と入力します。 |
|
表示するメッセージのドキュメント・プロトコルのバージョン。演算子を選択し、バージョンを入力します。たとえば、HL7 2.6メッセージの場合は「2.6」と入力します。 |
|
表示するメッセージのドキュメント・プロトコルのタイプ。演算子を選択し、バージョンを入力します。たとえば、HL7 ADT_A04メッセージの場合は「ADT_A04」と入力します。 |
|
表示するメッセージで使用されているドキュメント定義。演算子を選択し、定義済ドキュメント定義の名前を入力します。 |
|
コンポジット |
|
実行コンテキストのID。ECIDを使用してエンドツーエンドのメッセージ追跡を実行できます。 |
|
Oracle SOAコンポジット・アプリケーションがデプロイされているWebLogicドメインの名前。 |
|
Oracle JDeveloperのOracle SOAコンポジット・アプリケーションの名前。 |
|
Oracle JDeveloperのOracle SOAコンポジット・アプリケーションのバージョン。 |
|
Oracle SOAコンポジット・インスタンスのID。 |
|
Oracle SOAコンポジット・アプリケーションのヘルスケア統合サービス・バインディング・コンポーネントの名前。 |
|
Oracle SOAコンポジット・アプリケーションのOracle Healthcare参照バインディング・コンポーネントの名前。 |
|
再発行数 |
(表示される)メッセージが再発行された回数。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義された回数を入力します。 |
最終再発行日 |
(表示される)メッセージが最後に再発行された日付。「任意」、「最後」または「範囲」の各オプションから選択します。 |
レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。
レポート・フィルタの指定後、次のいずれかを実行します。
フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。
レポートのフィルタ条件に加えた変更を保存するには、「新規ファイルとして保存」をクリックします。
図9-12に、過去24時間に交換されたアプリケーション・メッセージで、ステータスが完了のものがすべてリストされているカスタムのアプリケーション・メッセージ・レポートを示します。
列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。
「レポート」タブをクリックしたときに自動的に表示されるレポートを1つ選択できます。これがデフォルト・レポートです。
デフォルト・レポートを指定するには:
Oracle SOA Suite for healthcare integrationのユーザー・インタフェースで「レポート」タブをクリックします。レポートが開いていない場合には、レポートのようこそページが表示されます。
「選択済みレポート」フィールドの隣の下向きの矢印をクリックし、デフォルトに設定するレポートを選択します。
「適用」をクリックします。
選択したレポートが表示されます。次回「レポート」タブを選択すると、このレポートが自動的に表示されます。
レポートを作成した後は、メッセージ・レポート・フィルタ・カスタマイザを使用して、レポートのフィルタ条件を変更できます。また、既存のレポートをテンプレートとして使用してレポートを作成できます。
レポートを構成するには:
表示されているレポートはいつでも手動でリフレッシュできますが、レポートを一定の間隔で自動的に更新されるように指定できます。自動リフレッシュ率は、現在のセッションについてのみアクティブ化され、構成されます。レポートを閉じた後に再度開くと、自動リフレッシュ・オプションは無効になります。
レポートをリフレッシュし、自動リフレッシュ率を設定する手順は次のとおりです。
監視するレポートが表示されていない場合は、メインのレポート・ページの右上にあるプラス・アイコンをクリックし、構成するレポートを選択します。
レポートをリフレッシュするには、右上のリフレッシュ・アイコンをクリックします。
自動リフレッシュ・オプションを有効にするには、次のようにします。
レポート・ツールバーのリフレッシュ・アイコンの右側にある下向きの矢印をクリックします。
レポートを自動的にリフレッシュする時間間隔を秒単位で指定し、「自動リフレッシュ」チェック・ボックスを選択します。
自動リフレッシュを無効にするには、「自動リフレッシュ」チェック・ボックスの選択を解除します。
管理者ロールの場合には、ユーザーが作成したレポートを削除できます。事前定義済のレポートも削除できますが、削除アクションは元に戻せないため、注意が必要です。
レポートを削除するには:
メインのレポート・ページで右上のプラス・アイコンをクリックし、「レポートの削除」を選択します。
「ビジネス・メッセージ・レポートの削除」ダイアログが表示されます。
デフォルトで、ユーザーが作成したレポートのみがリストに表示されます。事前定義済レポートを含めるには、「標準グループを含める」を選択します。これは、「すべて」、「過去24時間」、「過去2週間」など、前のバージョンのOracle Healthcareコンソールからインポートされた標準レポートにのみ関係があります。
レポートのリストで、削除するレポートの隣のチェック・ボックスを選択します。
「選択したレポートの削除」をクリックするか、または「取消」をクリックして、レポートを削除せずにダイアログ・ボックスを閉じます。
レポートを開くと、最初に、「レポート」タブにレポート条件に一致するメッセージのリストが表示されます。このリストには、各メッセージの概要情報が表示されます。次のものが含まれます。
メッセージID
作成日時
Direction
エンドポイント
状態
ドキュメント・タイプ
次に示すように、リスト内のメッセージを選択して詳細な情報を表示することや、複数のメッセージのサマリーを表示することが可能です。
メッセージのドキュメント・タイプを表示する権限がない場合、一部の詳細情報は非表示になります。必要な権限がない限り、情報をダウンロードするオプションは使用不可になっています。
ビジネス・メッセージには、エンドポイント名、メッセージの方向、メッセージID、状態、トランスポート・プロトコルを含めたドキュメント・プロトコルのインスタンス情報と、ドキュメント・プロトコル、およびメッセージの詳細が含まれています。
ビジネス・メッセージ・インスタンスを表示するには:
レポート・ページにレポートを表示します。
メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-15に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。
メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「ビジネス・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
図9-16に示すようなメッセージの詳細が表示されます。
ビジネス・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。
情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。
注意: このオプションは、すべてのセクションで有効なわけではありません。 |
メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。
ワイヤ・メッセージは、エンドポイントと送受信されるデータのネイティブ・フォーマットです。ワイヤ・メッセージの詳細には、メッセージID、通信およびプロトコル情報(トランスポート・バインディングおよびヘッダー詳細など)、ペイロード・メッセージ・コンテンツ、パック・メッセージ・コンテンツ、およびセキュリティ情報が含まれます。
ワイヤ・メッセージを表示するには:
レポート・ページにレポートを表示します。
メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-17に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。
メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「ワイヤ・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
図9-18に示すようなメッセージの詳細が表示されます。
ワイヤ・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。
情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。
注意: このオプションは、すべてのセクションで有効なわけではありません。 |
メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。
アプリケーション・メッセージは、バックエンド・コンポジット・アプリケーションがメッセージを送受信した場合に、SOAコンポジットに関連する情報(コンポジット名、バージョン、インスタンスIDなど)を提供します。
アプリケーション・メッセージを表示するには:
レポート・ページにレポートを表示します。
メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-19に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。
メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「アプリケーション・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
図9-20に示すようなメッセージの詳細が表示されます。
アプリケーション・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。
情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。
注意: このオプションは、すべてのセクションで有効なわけではありません。 |
メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。
Oracle Healthcareレポートでは、各メッセージが、Oracle Enterprise Managerのコンポジットのフロー・トレースにリンクされています。リンクをクリックすると、自動的にOracle Enterprise Managerの該当するフローのトレース・ページが開かれます。
Oracle Enterprise Managerのフロー・トレースを表示するには:
レポート・ページにレポートを表示します。
メッセージのリストで、フロー・トレースを表示するメッセージを選択します。
メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。
メッセージ・フロー・ダイアグラムの「コンポジット」をクリックします。
Oracle Enterprise Managerのログイン・ページが別のブラウザ・タブまたはウィンドウに表示されます。
Oracle Enterprise Managerのログイン情報を入力し、「ログイン」をクリックします。
図9-22に示すように、選択したメッセージのフロー・トレースが表示されます。
レポートのメッセージ・リストで、複数のメッセージを選択して情報の概要を表示できます。これにより、処理されたメッセージ数、使用されたエンドポイント数およびドキュメント・タイプ、エラー数、処理済メッセージ数など、選択したすべてのメッセージの概要をつかめます。
複数のメッセージの概要を表示するには:
レポート・ページにレポートを表示します。
メッセージのリストで、サマリー・データを表示する複数のメッセージを選択するには、削除する最初のメッセージをクリックして[Shift]を押し、該当する範囲の最後のメッセージをクリックします。
図9-23に示すように、選択したメッセージの概要がリストの下に表示されます。
ここで、選択したメッセージをパージまたは再発行できます。
詳細は、「複数のメッセージを再発行するには:」または「リポジトリからメッセージをパージするには:」を参照してください。
ワイヤ・メッセージおよびアプリケーション・メッセージに、ビジネス・メッセージが関連付けられていない場合があります。これらのメッセージは関連付けられていないメッセージとして分類され、関連付けられていないワイヤ・メッセージ・レポートや関連付けられていないアプリケーション・メッセージ・レポートで表示できます。
外部エンドポイントからメッセージが大量に着信すると、Oracle Healthcareランタイムの処理能力に過剰な負荷がかかります。そうしたメッセージは、一時的にバックログとして扱われ、「処理中」とマークされます。そのため、それらのワイヤ・メッセージには、ビジネス・メッセージが関連付けられません。インバウンドのHL7 MLLPエンドポイントにより即時確認が生成された場合も、ワイヤ・メッセージにはビジネス・メッセージが関連付けられません。
関連付けられていないワイヤ・メッセージ・レポートは、一般ワイヤ・メッセージ・レポートと同じような方法で作成できます。
関連付けられていないワイヤ・メッセージ・レポートを作成するには
9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。
「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「関連付けられていないワイヤ・メッセージ・レポート」を選択して、「作成」をクリックします。
レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。
メッセージ・レポート・フィルタ・カスタマイザで、表9-2で説明されているいずれかのフィルタ条件を入力します。
注意: ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。 |
レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。
レポート・フィルタの指定後、次のいずれかを実行します。
フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。
レポートのフィルタ条件に加えた変更を保存するには、「保存」をクリックします。
図9-24に、過去24時間のアウトバウンドの関連付けられていないワイヤ・メッセージがすべてリストされている、関連付けられていないワイヤ・メッセージ・レポートを表示します。
列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。
関連付けられていないワイヤ・メッセージは、関連付けられていないワイヤ・メッセージ・レポートから表示できます。
ワイヤ・メッセージを表示するには:
レポート・ページで、関連付けられていないワイヤ・メッセージ・レポートを表示します。
メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-25に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。
注意: メッセージ・フローで無効化されているため、使用できない「ビジネス・メッセージ」アイコンや「アプリケーション・メッセージ」アイコンがレンダリングされます。 |
メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「ワイヤ・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
関連付けられていないワイヤ・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。
情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。ただし、メッセージにはビジネス・メッセージが関連付けられていないため、ペイロードにはデータがありません。
注意: このオプションは、すべてのセクションで有効なわけではありません。 |
メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。
ファブリック/コンポジット・レイヤーからアプリケーション・メッセージが大量に発生すると、Oracle Healthcareランタイムの処理能力に過剰な負荷がかかります。そうしたメッセージは、一時的にバックログとして扱われ、「処理中」とマークされます。そのため、それらのアプリケーション・メッセージには、関連するビジネス・メッセージがありません。ファブリック/コンポジット・レイヤーからのアウトバウンド・メッセージにより、重大なエラーが発生した場合にも、アプリケーション・メッセージにはビジネス・メッセージが関連付けられません。
関連付けられていないアプリケーション・メッセージ・レポートは、一般アプリケーション・メッセージ・レポートと同じような方法で作成できます。
関連付けられていないアプリケーション・メッセージ・レポートを作成するには
9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。
「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「関連付けられていないアプリケーション・メッセージ・レポート」を選択して、「作成」をクリックします。
レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。
メッセージ・レポート・フィルタ・カスタマイザで、表9-3で説明されているいずれかのフィルタ条件を入力します。
注意: ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。 |
レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。
レポート・フィルタの指定後、次のいずれかを実行します。
フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。
レポートのフィルタ条件に加えた変更を保存するには、「保存」をクリックします。
列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。
関連付けられていないアプリケーション・メッセージは、関連付けられていないアプリケーション・メッセージ・レポートから表示できます。
アプリケーション・メッセージを表示するには:
レポート・ページで、関連付けられていないアプリケーション・メッセージ・レポートを表示します。
メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。
注意: メッセージ・フローで無効化されているため、使用できない「ビジネス・メッセージ」アイコンがレンダリングされます。 |
メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「アプリケーション・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
関連付けられていないワイヤ・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。
情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。ただし、メッセージにはビジネス・メッセージが関連付けられていないため、ペイロードにはデータがありません。
注意: このオプションは、すべてのセクションで有効なわけではありません。 |
メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。
メッセージの処理時にエラーが発生すると、メッセージ・リストのメッセージのアイコンに赤い四角が表示されます。エラー・メッセージを選択すると、エラーに関する詳細な情報が表示されます。
このレポートには、エラー・メッセージ、コード、重大度、レベル、および説明を含めた、メッセージ処理時のエラーに関する情報が含まれます。
エラー・メッセージを表示するには:
「レポート」タブからワイヤ・メッセージおよびアプリケーション・メッセージを再発行できます。メッセージ・トランザクションでエラーが発生した場合、レポート機能を使用して、エラーの内容を確認して修正します。問題を修正した後、メッセージを再発行します。メッセージは1つずつ再発行したり、グループ化して再発行できます。
メッセージを再発行するには:
表示したレポートのメッセージのリストで、再発行するメッセージを選択します。
次のいずれかを行います:
「再発行」を選択した後、「関連アプリケーション・メッセージ」または「関連ワイヤ・メッセージ」を選択します。
選択したメッセージを右クリックして、コンテキスト・メニュー・アイテムを使用します。
メッセージ・フロー・ダイアグラムで「ワイヤ・メッセージ」または「アプリケーション・メッセージ」を右クリックし、「ワイヤ・メッセージの再発行」または「アプリケーション・メッセージの再発行」を選択します。
表示される確認ダイアログで「OK」をクリックします。
メッセージ・リストのメッセージのエラー・アイコンが、メッセージの再発行を示す緑色の矢印に変更されます。
複数のメッセージを再発行するには:
表示したレポートのメッセージのリストで、再発行する複数のメッセージを選択します。
図9-29に示すように、選択したメッセージの概要がメッセージ・リストの下に表示されます。
「選択項目の概要」の上の黄色いバーで、「再発行」をクリックした後、「関連アプリケーション・メッセージ」または「関連ワイヤ・メッセージ」を選択します。ツールバーの「再発行」メニューを使用することも、選択したメッセージを右クリックして、コンテキスト・メニュー・アイテムを使用することもできます。
表示される確認ダイアログで「OK」をクリックします。
Healthcare integrationリポジトリに格納する必要のなくなったメッセージをパージできます。パージするメッセージがバッチ・プロセスの一部である場合、バッチ内のすべてのメッセージが削除されます。
メッセージは1つずつパージしたり、グループ化してパージできます。
リポジトリからメッセージをパージするには:
表示したレポートのメッセージのリストで、削除する1つまたは複数のメッセージを選択します。
「パージ」をクリックします。
表示される確認ダイアログで「はい」をクリックします。
注意: ビジネス・メッセージを削除すると、順序付けマネージャの表の対応するエントリも削除されます。 |