---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# TaskStateUtil - グローバル

# TaskStateUtil - グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分

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

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

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

必要な属性は planned_task テーブルで定義されているため、すべての計画タスクタイプがサポートされます。他のタスクタイプにも属性を追加し、最終的にベースタスクテーブルに追加する予定です。この機能を今すぐ活用したい場合は、自由に行ってかまいません。  
これらの属性は、task.state 辞書要素または拡張されたタスクテーブルの辞書オーバーライドで定義できます。{#c_TaskStateUtil__table_hv2_51h_1s__entry__2}

| 属性 | 定義 |
|-|-|
| close_states | セミコロンで区切られたアクティブでない状態値のリストで、タスクをアクティブまたは非アクティブのどちらに設定するかを識別するために使用されます。 |
| default_close_state | オプション。タスクを自動的にクローズするビジネスルールを定義する場合に、デフォルトのクローズステータスのステータス値を定義する属性。 デフォルト:3。属性が定義されていない場合、通常は完了してクローズされます。 |
| default_work_state | オプション。作業用にタスクを自動的に設定するビジネスルールを定義する場合に、デフォルトの作業ステータスのステータス値を定義する属性。 デフォルト:2。属性が定義されていない場合、通常は対応中です。 |
[表 : 1. 関連する属性]

{#c_TaskStateUtil__table_hv2_51h_1s}

## TaskStateUtil - TaskStateUtil(GlideRecord task) {#ariaid-title2}

TaskStateUtil オブジェクトを作成します。
{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| task | GlideRecord | タスクテーブルから取得された GlideRecord である必要があります。 |
[表 : 2. パラメーター]

{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s}  

    var stateUtil = new TaskStateUtil(current);

## TaskStateUtil - ATTR_DEFAULT_WORK {#ariaid-title3}

デフォルトの作業ステータスを識別する属性の名前。
{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs__entry__3}

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

{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs}

## TaskStateUtil - ATTR_DEFAULT_CLOSE {#ariaid-title4}

デフォルトのクローズステータスを識別する属性の名前。
{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs__entry__3}

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

{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs}

## TaskStateUtil - ATTR_INACTIVE_STATES {#ariaid-title5}

非アクティブステータスを識別する属性の名前。
{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs__entry__3}

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

{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs}

## TaskStateUtil - SYSTEM_DEFAULT_CLOSE {#ariaid-title6}

タスクテーブルのデフォルトのクローズステータスの値は \[完了してクローズ\] です。
{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs__entry__3}

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

{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs}

## TaskStateUtil - SYSTEM_DEFAULT_WORK {#ariaid-title7}

タスクテーブルのデフォルトの作業ステータスの値は \[対応中\] です。
{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs__entry__3}

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

{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs}

## TaskStateUtil - SYSTEM_INACTIVE_STATES {#ariaid-title8}

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

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

{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs}

## TaskStateUtil - getDefaultCloseState {#ariaid-title9}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 9. パラメーター]

{#r_TaskStateUtilGetDefaultCloseState__table_nft_hgh_1s} {#r_TaskStateUtilGetDefaultCloseState__table_oft_hgh_1s__entry__2}

| タイプ | 説明 |
|-|-|
| 数字 | クローズ済みステータスを表すステータス値。 |
[表 : 10. 返される内容]

{#r_TaskStateUtilGetDefaultCloseState__table_oft_hgh_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the close state
    var defaultCloseState =  stateUtil.getDefaultCloseState();
    current.state = defaultCloseState;

## TaskStateUtil - getDefaultWorkState() {#ariaid-title10}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 11. パラメーター]

{#r_TaskStateUtilGetDefaultWorkState__table_cjr_22h_1s} {#r_TaskStateUtilGetDefaultWorkState__table_djr_22h_1s__entry__2}

| タイプ | 説明 |
|-|-|
| 数字 | 作業ステータスを表すステータス値。 |
[表 : 12. 返される内容]

{#r_TaskStateUtilGetDefaultWorkState__table_djr_22h_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the work state
    var defaultWorkState =  stateUtil.getDefaultWorkState();
    current.state = defaultWorkState;

## TaskStateUtil - getInactiveStates {#ariaid-title11}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 13. パラメーター]

{#r_TaskStateUtilGetInactiveStates__table_jtf_zgh_1s} {#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s__entry__2}

| タイプ | 説明 |
|-|-|
| アレイ | 非アクティブなステータス値のアレイ。 |
[表 : 14. 返される内容]

{#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the inactive state values
    var inactiveStates = stateUtil.getInactiveStates();

## TaskStateUtil - isStateInactive(文字列 state) {#ariaid-title12}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| state | 文字列 | チェックするステータス値。 |
[表 : 15. パラメーター]

{#r_TaskStateUtilIsStateInactive_String__table_bzq_ndh_1s} {#r_TaskStateUtilIsStateInactive_String__table_czq_ndh_1s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | ステータスが非アクティブの場合は true。 |
[表 : 16. 返される内容]

{#r_TaskStateUtilIsStateInactive_String__table_czq_ndh_1s}  

    var stateUtil = new TaskStateUtil(current);
    var previousStateInactive = stateUtil.isStateInactive(previous.state);
    var currentStateInactive = stateUtil.isStateInactive(current.state);

## TaskStateUtil - runMarkClosed {#ariaid-title13}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 17. パラメーター]

{#r_TaskStateUtilrunMarkClosed__table_xvr_nbq_2s} {#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | ビジネスルールの実行を可能にすべきかどうか。 |
[表 : 18. 返される内容]

{#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s}

## TaskStateUtil - runTaskCloser {#ariaid-title14}

task closer ビジネスルールを実行するかどうかを決定します。
{#r_TaskStateUtil-runTaskCloser__table_ad5_rrj_xs__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 19. パラメーター]

{#r_TaskStateUtil-runTaskCloser__table_ad5_rrj_xs} {#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | ビジネスルールの実行を可能にすべきかどうかを決定します。 |
[表 : 20. 返される内容]

{#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs}

## TaskStateUtil - runTaskReopener {#ariaid-title15}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 21. パラメーター]

{#r_TaskStateUtilrunTaskReopener__table_ldl_4bq_2s} {#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | ビジネスルールの実行を可能にすべきかどうか。 |
[表 : 22. 返される内容]

{#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s}

## TaskStateUtil - setDefaultWorkState(文字列 defaultWorkState) {#ariaid-title16}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| defaultWorkState | 文字列 | デフォルトの作業ステータスに使用する値。 |
[表 : 23. パラメーター]

{#r_TSU-setDefaultWorkState_S__table_g1l_jcq_2s} {#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s__entry__2}

| タイプ | 説明 |
|-|-|
| TaskStateUtil | メソッドのチェーンを可能にする自己参照。 |
[表 : 24. 返される内容]

{#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s}