Rational ClearQuest Web でのフックの使用法

Rational® ClearQuest® Web ソフトウェアは、 フックのフル機能のサブセットをサポートします。このサブセットはスキーマ開発者が セットアップできます。

Rational ClearQuest スキーマに 作成したフックは、Rational ClearQuest サーバーが稼働するコンピュータで実行されます。 Rational ClearQuest Web でフックを使用する際は、次の点に注意してください。
次のタイプのフックがサポートされます。

Value Changed フィールド フックに関する 特別な考慮事項

Value Changed フックを使用する際は、Value Changed フックが適切なタイミングで 実行されること、またその結果が Rational ClearQuest Web クライアントの ユーザーに表示されることを確認してください。

Value Changed フィールド フックは、 ブラウザが Rational ClearQuest サーバーと通信すると実行されます。 この通信は、ユーザーがフォーム フィールドの値を変更した直後に 発生することがあります (たとえば、ドロップダウン リストから項目を選択したときなど)。それ以外の状況では、 ユーザーが新しい値を保管した後でのみ通信が行われます。

次の両方の条件がそろうと、Value Changed フックは 即時に実行されます。
  • フックが設定されているフィールドのフォーム コントロールが次のいずれかのタイプの場合。
    • ドロップダウン リスト ボックス
    • ドロップダウン コンボ ボックス
    • コンボ ボックス
  • フォーム コントロール プロパティに少なくとも 1 つの Web 依存先フィールドが設定されている場合。

Value Changed フックは、ユーザーが ListView コントロールや Attachments コントロールなど、 その他のタイプのコントロールの値を変更した場合には、後で実行されます (ユーザーがフォームで [保存] ボタンを クリックするまで実行されません)。ドロップダウン リスト ボックス、ドロップ ダウン コンボ ボックス、コンボ ボックスに Web 依存先フィールドがない場合でも実行されます。ブラウザでフォーム内のタブを移動しただけでは、 ブラウザと Rational ClearQuest サーバーとの通信は発生しません。

Value Changed フックが 適切なタイミングで実行されることを確認したら、次は、Value Changed フックを実行したときに、 レコード内のほかの (ターゲット) フィールドの値または選択リストに対する変更が、 フックの実行が完了した時点でユーザーに表示されることを確認してください。そのような変更が行われると、 ターゲット フィールドが、Value Changed フックがあるフィールドの フォーム コントロールのプロパティで Web 依存先フィールドとして 宣言されている場合のみ、その変更内容がブラウザに表示されます。

フォーム コントロールが ドロップダウン リスト ボックス、ドロップ ダウン コンボ ボックス、コンボ ボックスのいずれかであり、そこに含まれる フィールドに Value Changed フックが設定されていて、そのフックが Rational ClearQuest Web で 即時に実行され、以下のいずれかの目的で作成されている場合、次の点に注意してください。

  • ターゲット フィールドの値の変更またはターゲット フィールドの選択リストの無効化

    Valued Changed フックが、1 つまたは 複数のターゲット フィールドの値を変更するか選択リストを無効にすると、 ブラウザは、それらのフィールドがフォーム コントロールで Web 依存先フィールドとして設定されている場合、 ターゲット フィールドの新しい値を最新表示します。そのようなフィールドは、ユーザーがフォーム コントロールの 値を変更すると更新されます。

    ListView コントロールを Web 依存先フィールドとして 設定することは可能ですが、この設定は Rational ClearQuest Web の ListView コントロールでは機能しません。

  • 必須ターゲット フィールドの変更

    ソース フックが、1 つ以上のターゲット フィールドが必須であるかだけを変更する場合、すべてのターゲット フィールドをフォーム コントロールの Web 依存先フィールドとして設定する必要はありません。ブラウザは、 Web 依存先フィールドのみでなく、フォームにあるすべての必須フィールドの詳細を最新表示します。

    Value Changed フックを 即時に実行させるには、フォーム コントロールに少なくとも 1 つの Web 依存先フィールドが必要です。 Web 依存先フィールドには任意のフィールドを選択できますが、最良のパフォーマンスのためには、 選択リストが長くないフィールドを選択してください。


フィードバック