テストとデバッグ

一時停止プロダクションの回復

プロダクションは、シャットダウン・シーケンスの最後で同期メッセージが残っているキューがあると中断中ステータスになります。この場合、中断中のプロダクションを再開して、これらのメッセージを処理することもできます。

ただし、中断中ステータスの原因となった問題を解決していない場合は、中断中のプロダクションを再開しても、以前のメッセージが解放されないまま、別の同期メッセージがキューに追加されるだけなので、プロダクションが単に中断中ステータスに戻るだけとなる可能性があります。

中断中のプロダクションは停止できます。これは開発の初期段階でのみ行うことをお勧めします。導入済みで稼働中のインストール環境では実行しないでください。

このような場合は、より抜本的なアクションをとり、中断中ステータスになったプロダクションを完全にクリーンアップすることが必要になる場合があります。この状況に備え、Ensemble には CleanProduction() メソッドが用意されています。

問題を解決するためにあらゆる手段を講じたが効果がないので、配信されていない同期メッセージを破棄してでも、中断中のプロダクションを停止する必要があると判断した場合は、以下の手順が有効です。

1. Ensemble, プロダクション構成 ページで、リボン・バーの [開始] をクリックして、中断中のプロダクションを開始します。これにより、そのプロダクションのステータス表示が [実行中] に変わります。

2. 次に [停止] をクリックして、問題が引き続き存在しているかどうかを確認します。プロダクションが正常に停止する場合は、プロダクションをクリーンアップする必要はありません。プロダクションのステータスが中断中に戻る場合は、次の手順に進んでください。

3. ターミナル・セッションから以下のようにしてプロダクションを停止します。

   1. 以下のコマンドを入力して、該当のネームスペースに移動します。

        ZN "EnsSpace"

      

      ここで EnsSpace は、中断中のプロダクションが実行されている Ensemble ネームスペースの名前です。

   2. 以下のコマンドを入力します。

        Do ##class(Ens.Director).CleanProduction()

      

4. Ensemble, プロダクション構成 ページで、プロダクションの [ステータス] が [停止] になっていることを確認します。

トラブル・プロダクションの回復

Ensemble が停止しても、プロダクションが適切にシャットダウンしなかった場合に、そのプロダクションは [問題発生] ステータスになります。先にプロダクションを停止せずに Ensemble の再開またはマシンの再起動を実行すると、このステータスが発生する可能性があります。

この場合は、[回復] コマンドが Ensemble, プロダクション構成 ページに表示されます。[回復] をクリックすると、障害が発生しているプロダクションのインスタンスが終了し、クリーンアップされるので、新しいインスタンスを実行できるようになります。

または、コマンド・ラインを使用してプロダクションを回復しなければならない場合があります。前述した “Ens.Director の使用によるプロダクションの開始および停止” を参照してください。

テスト・サービスの使用

Ensemble, テスト・サービス ページを使用すると、アクティブなネームスペースで実行中の Ensemble プロダクションのビジネス・プロセスまたはビジネス・オペレーションをテストできます。テスト・サービスには、管理ポータル内の以下の場所から移動できます。

• Ensemble メニューで [テスト] をクリックします。

• Ensemble, プロダクション構成 ページの構成ダイアグラムで、左ペインにあるビジネス・プロセスまたはビジネス・オペレーションをクリックして、[アクション] タブの [テスト] をクリックします。

ここで、テスト・サービスを使用するには：

1. 適切なプロダクションが動作していることを確認します。"Ensemble の管理" を参照してください。

2. そのプロダクションに対してテストが有効になっていることを確認します。通常通り、Ensemble, プロダクション にアクセスします。プロダクションが選択されている状態で、[テスト使用可能] チェック・ボックスにチェックを付け、[適用] をクリックしてから、[OK] をクリックします。

3. 管理ポータルで、[Ensemble]、[テスト]、[ビジネス・ホスト] の順にクリックして、Ensemble, テスト・サービス ページを表示します。

   このページには、テストの対象として [ビジネスプロセス] と [ビジネスオペレーション] のどちらかを選択可能なオプションがあります。

4. 必要に応じて、[ビジネスプロセス] と [ビジネスオペレーション] のどちらかを選択します。

5. ドロップダウン・リストからテスト対象を選択します。

6. 送信するメッセージのタイプを選択します。ページに以下のフィールドが表示されます。

   • [現在のプロダクション] — 現在実行中のプロダクションの名前 (表示専用)。

   • [ターゲット] — 前の [テスト・サービス] ページで選択したビジネス・プロセスまたはビジネス・オペレーション (表示専用)。

   • [要求タイプ] — 要求メッセージのリストから選択します。指定されているターゲットで有効な要求タイプのみが、サポートされているタイプのサブクラスも含め、表示されます。

7. 選択したメッセージのプロパティに関する値を入力します。

   要求メッセージにプロパティが含まれていない場合は、何も表示されません。

   仮想ドキュメント・メッセージ (HL7、X12) をテストする場合、テキスト・メッセージを貼り付けることができる自由形式のボックスがあります。このボックスの下に、メッセージのオブジェクト・プロパティを入力できます。

8. [実行] をクリックして入力した値が含まれた要求を送信し、結果を表示します。

   テスト・サービスによる要求の試行に時間がかかる場合は、[待機中] のページに以下の表示専用情報が表示されます。

   • [ターゲット] — 要求に関連付けられているセッション ID

   • [要求タイプ] — 選択されたターゲットの要求タイプ。

   • [セッション ID] — 要求に関連付けられているセッション ID

   • [送信済み要求] — 要求が送信された日時。

   • [受信済み応答] — 待機中のステータスと、作業が進行中であることを示すグラフィック進行バー。

   最後に、要求によって生成された応答の出力値が [結果] ページに表示されます。エラーがあれば、その完全なエラー・メッセージ・テキストと共に表示されます。

テストの完了後は、次のいずれかのコマンドを実行できます。

• [完了] をクリックすると、Ensemble ホーム・ ページに戻ります。

• [トレース] をクリックすると、[ビジュアル・トレース] ページが表示されて、プロダクション内でのメッセージの経路を視覚的にたどることができます。

EnsLib.Testing パッケージ内のクラスとメソッドを使用することもできます。詳細は、"クラス・リファレンス" の EnsLib.Testing.ServiceOpens in a new tab のエントリを参照してください。