UIActions オブジェクト

UIActions オブジェクトをワークフロー・スクリプトで使用すると、ALM ユーザ・インタフェース内のアクションを実行できます。次のオブジェクトを利用できます。

オブジェクト

説明

UIActions.SwitchTab

イベントがトリガされると、指定されたタブに切り替わります。

構文:UIActions.SwitchTab "<Tab Label>"

例:テスト計画モジュールで、[ステータス]フィールドの値が変化した後に[添付]タブが表示されます。

Sub Test_FieldChange(FieldName)
 On Error Resume Next
 If FieldName="TS_STATUS" Then
  UIActions.SwitchTab "Attachments"
 End If
 On Error GoTo 0
End Sub
UIActions.FocusEntity

指定されたエンティティ ID に基づいて、現在のモジュール内でフォーカスのあるエンティティを変更します。

構文:UIActions.FocusEntity "<id of the entity>", [true/false]

オプションのブール値パラメータは、指定した ID がツリー内のフォルダに属しているかどうかを示します(標準設定値は false です)。

例:テスト計画モジュールで、このイベントがトリガされた後に、[テスト ID]値が 1 のテストにフォーカスが置かれます。

Function ActionCanExecute(ActionName)
 On Error Resume Next
 If ActionName = "UserDefinedActions.TestPlan_Action1" Then
  UIActions.FocusEntity "1"
 End IF
ActionCanExecute = DefaultRes
 On Error GoTo 0
End Function
UIActions.FocusField

イベントがトリガされると、指定されたフィールドに移動します。このオブジェクトは、[詳細]ダイアログ・ボックス内のフィールドでのみ機能し、グリッド・ビューでは機能しません。

構文:UIActions.FocusField "<Field Name>"

例:不具合モジュールで、[終了日]値の設定後に[コメント]フィールドにフォーカスが置かれます。

Sub Bug_FieldChange(FieldName)
 On Error Resume Next
 If FieldName = "BG_CLOSING_DATE" Then
  UIActions.FocusField "BG_DEV_COMMENTS"
 End IF
 On Error GoTo 0
End Sub