TaskStateUtil - グローバル

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：7分

    • TaskStateUtil スクリプトインクルードは、タスクタイプのテーブルステータス属性を処理するためのメソッドを提供します。

    このスクリプトインクルードは、主にステータスの変更に基づいてアクティブフィールドを設定するために、タスクアクティブ状況管理ビジネスルールによって使用されます。構成は task.state 辞書要素で定義されます。ステータス値はテーブルによって異なるため、通常は辞書オーバーライドを使用します。

    任意のサーバースクリプトで TaskStateUtil スクリプトインクルードを呼び出して、テーブルの非アクティブ状況、デフォルトの作業状況、またはデフォルトのクローズ状況を決定できます。

    必要な属性は planned_task テーブルで定義されているため、すべての計画タスクタイプがサポートされます。他のタスクタイプにも属性を追加し、最終的にベースタスクテーブルに追加する予定です。この機能を今すぐ活用したい場合は、自由に行ってかまいません。

    これらの属性は、task.state 辞書要素または拡張されたタスクテーブルの辞書オーバーライドで定義できます。
    表 : 1. 関連する属性
    属性 定義
    close_states セミコロンで区切られたアクティブでない状態値のリストで、タスクをアクティブまたは非アクティブのどちらに設定するかを識別するために使用されます。
    default_close_state オプション。タスクを自動的にクローズするビジネスルールを定義する場合に、デフォルトのクローズステータスのステータス値を定義する属性。

    デフォルト:3。属性が定義されていない場合は、通常 [完了してクローズ] になります。
    default_work_state オプション。作業用にタスクを自動的に設定するビジネスルールを定義する場合に、デフォルトの作業ステータスのステータス値を定義する属性。

    デフォルト:2。属性が定義されていない場合は、通常 [対応中] になります。

    TaskStateUtil - TaskStateUtil(GlideRecord task)

    TaskStateUtil オブジェクトを作成します。

    表 : 2. パラメーター
    名前 タイプ 説明
    task GlideRecord タスクテーブルから取得された GlideRecord である必要があります。 
    var stateUtil = new TaskStateUtil(current);

    TaskStateUtil - ATTR_DEFAULT_WORK

    デフォルトの作業ステータスを識別する属性の名前。

    表 : 3. フィールド
    名前 タイプ 説明
    ATTR_DEFAULT_WORK 文字列 デフォルトの作業ステータスを識別します。値：default_work_state

    TaskStateUtil - ATTR_DEFAULT_CLOSE

    デフォルトのクローズステータスを識別する属性の名前。

    表 : 4. フィールド
    名前 タイプ 説明
    ATTR_DEFAULT_CLOSE 文字列 デフォルトのクローズステータスを識別します。値：default_close_state

    TaskStateUtil - ATTR_INACTIVE_STATES

    非アクティブステータスを識別する属性の名前。

    表 : 5. フィールド
    名前 タイプ 説明
    ATTR_INACTIVE_STATES 文字列 非アクティブステータスを識別します。値：close_states

    TaskStateUtil - SYSTEM_DEFAULT_CLOSE

    タスクテーブルのデフォルトのクローズステータスの値は [完了してクローズ] です。

    表 : 6. フィールド
    名前 タイプ 説明
    SYSTEM_DEFAULT_CLOSE 整数 タスクテーブルのデフォルトのクローズステータスの値は [完了してクローズ] です。値：3

    TaskStateUtil - SYSTEM_DEFAULT_WORK

    タスクテーブルのデフォルトの作業ステータスの値は [対応中] です。

    表 : 7. フィールド
    名前 タイプ 説明
    SYSTEM_DEFAULT_WORK 整数 タスクテーブルのデフォルトの作業ステータスの値は [対応中] です。値：2

    TaskStateUtil - SYSTEM_INACTIVE_STATES

    タスクテーブルのデフォルトの非アクティブステータスの値は、[完了してクローズ]、[未解決でクローズ]、 [スキップ項目をクローズ] です。

    表 : 8. フィールド
    名前 タイプ 説明
    SYSTEM_INACTIVE_STATES 整数アレイ タスクテーブルのデフォルトの非アクティブステータスの値は、[完了してクローズ]、[未解決でクローズ]、 [スキップ項目をクローズ] です。値：3、4、7

    TaskStateUtil - getDefaultCloseState

    デフォルトのクローズ済みステータスの値を返します。

    default_close_state 属性が指定されていない場合、デフォルトのクローズ済みステータス値は 3 です。

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 返される内容
    タイプ 説明
    数字 クローズ済みステータスを表すステータス値。 
    var stateUtil = new TaskStateUtil(current);
//get the close state
var defaultCloseState =  stateUtil.getDefaultCloseState();
current.state = defaultCloseState;

    TaskStateUtil - getDefaultWorkState()

    デフォルトの作業ステータスの値を返します。

    default_work_state 属性が指定されていない場合、デフォルトの作業ステータス値は 2 です。

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    数字 作業ステータスを表すステータス値。 
    var stateUtil = new TaskStateUtil(current);
//get the work state
var defaultWorkState =  stateUtil.getDefaultWorkState();
current.state = defaultWorkState;

    TaskStateUtil - getInactiveStates

    非アクティブステータス値のリストを返します。

    表 : 13. パラメーター
    名前 タイプ 説明
    なし
    表 : 14. 返される内容
    タイプ 説明
    アレイ 非アクティブなステータス値のアレイ。 
    var stateUtil = new TaskStateUtil(current);
//get the inactive state values
var inactiveStates = stateUtil.getInactiveStates();

    TaskStateUtil - isStateInactive(文字列 state)

    指定されたステータスのアクティブステータスを返します。

    表 : 15. パラメーター
    名前 タイプ 説明
    state 文字列 チェックするステータス値。
    表 : 16. 返される内容
    タイプ 説明
    ブーリアン ステータスが非アクティブの場合は true。 
    var stateUtil = new TaskStateUtil(current);
var previousStateInactive = stateUtil.isStateInactive(previous.state);
var currentStateInactive = stateUtil.isStateInactive(current.state);

    TaskStateUtil - runMarkClosed

    mark closed ビジネスルールを実行するかどうかを決定します。

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 返される内容
    タイプ 説明
    ブーリアン ビジネスルールの実行を可能にすべきかどうか。

    TaskStateUtil - runTaskCloser

    task closer ビジネスルールを実行するかどうかを決定します。

    表 : 19. パラメーター
    名前 タイプ 説明
    なし
    表 : 20. 返される内容
    タイプ 説明
    ブーリアン ビジネスルールの実行を可能にすべきかどうかを決定します。

    TaskStateUtil - runTaskReopener

    task reopener ビジネスルールを実行するかどうかを決定します。

    表 : 21. パラメーター
    名前 タイプ 説明
    なし
    表 : 22. 返される内容
    タイプ 説明
    ブーリアン ビジネスルールの実行を可能にすべきかどうか。

    TaskStateUtil - setDefaultWorkState(文字列 defaultWorkState)

    ユーザーが独自のデフォルトの作業ステータスを指定できるようにします。

    表 : 23. パラメーター
    名前 タイプ 説明
    defaultWorkState 文字列 デフォルトの作業ステータスに使用する値。
    表 : 24. 返される内容
    タイプ 説明
    TaskStateUtil メソッドのチェーンを可能にする自己参照。