---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# StateManagementScriptableApi - グローバル

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

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：14分

StateManagementScriptableApi は、構成アイテム (CI) の運用状況を操作し、CI アクションを適用するための一連のメソッドを提供します。

StateManagementScriptableApi メソッドは、許可されていない CI アクション、互換性のある CI アクション、および許可されていない運用上の移行によって指定された制限と許可に準拠します。メソッドが制限付き操作を実行しようとすると、操作はブロックされ、エラーが記録され、必要に応じてタスクが作成されます。

StateManagementScriptableApi メソッドは静的メソッドです。SNC を使用してメソッドにアクセスします `。StateManagementScriptableApi` グローバルオブジェクト。

## StateManagementScriptableApi - addBulkCIAction(文字列 requestorId, 文字列 sysIdList, 文字列 ciActionName, 文字列 ciActionListOld, 文字列 leaseTime) {#ariaid-title2}

CI アクションを CI のリストに追加します。
{#SMSA-addBulkCIAction_S_S_S_S_S__table_g5l_w4s_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestorId | 文字列 | ワークフローコンテキストのsys_id、または registerOperator() メソッドから返された GUID。 |
| sysIdList | 文字列 | CI sys_idsのカンマ区切りリスト。 |
| ciActionName | 文字列 | CI アクション名。 |
| ciActionListOld | 文字列 | (オプション)すべての CI を含める必要がある古い CI アクションのカンマ区切りリスト。 |
| leaseTime | 文字列 | (オプション)指定された CI アクションに対してリースが有効な期間。「HH:MM:SS」形式で表されます。 |
[表 : 1. パラメーター]

{#SMSA-addBulkCIAction_S_S_S_S_S__table_g5l_w4s_px} {#SMSA-addBulkCIAction_S_S_S_S_S__table_h5l_w4s_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | の名前と値のペアを含む JSON 形式の文字列 * 結果:リスト内のすべての CI に対してアクションが設定されている場合は true。それ以外の場合は false です。 * エラー:エラーのリスト。 {#SMSA-addBulkCIAction_S_S_S_S_S__ul_ewf_5vl_px} |
[表 : 2. 返される内容]

{#SMSA-addBulkCIAction_S_S_S_S_S__table_h5l_w4s_px}

## StateManagementScriptableApi - extendCIActionLease( 文字列 requestorId, 文字列 ciSysId, 文字列 ciActionName, 文字列 leaseTime) {#ariaid-title3}

登録されたユーザーの CI アクションリース時間を延長します。前のリース期間が切れている場合は、新しいリース時間が開始されます。
{#SMSA-extendCIActionLease_S_S_S_S__table_f24_j3s_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestorId | 文字列 | ワークフローコンテキストのsys_id、または registerOperator() メソッドから返された GUID。 |
| ciSysId | 文字列 | CI のsys_id。 |
| ciActionName | 文字列 | CI アクション名。 |
| leaseTime | 文字列 | 指定された CI アクションに対してリースが有効な期間。「HH:MM:SS」形式で表されます。 |
[表 : 3. パラメーター]

{#SMSA-extendCIActionLease_S_S_S_S__table_f24_j3s_px} {#SMSA-extendCIActionLease_S_S_S_S__table_g24_j3s_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | の名前と値のペアを含む JSON 形式の文字列 * 結果:リース時間が設定されている場合は true。 * エラー:エラーのリスト。 {#SMSA-extendCIActionLease_S_S_S_S__ul_ewf_5vl_px} |
[表 : 4. 返される内容]

{#SMSA-extendCIActionLease_S_S_S_S__table_g24_j3s_px}

## StateManagementScriptableApi - getCIActions(文字列 ciSysId) {#ariaid-title4}

指定された CI のアクティブな CI アクションのリストを返します。
{#SMSA-getCIActions_S__table_ql1_fws_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ciSysId | 文字列 | CI のSys_id。 |
[表 : 5. パラメーター]

{#SMSA-getCIActions_S__table_ql1_fws_px} {#SMSA-getCIActions_S__table_rl1_fws_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 名前と値のペアを含む JSON 形式の文字列。 可能な値： * ciActions:CI または no_active_action のアクティブな CI アクションのカンマ区切りリスト。 * errors:エラーのリスト。 {#SMSA-getCIActions_S__ul_ewf_5vl_px} |
[表 : 6. 返される内容]

{#SMSA-getCIActions_S__table_rl1_fws_px}  
次の例は、構成アイテムのリストのアクティブなアクションを取得する方法を示しています。

    // Store sys_ids of configuration items for which to get data
    var CIArray = ["a9c0c8d2c6112276018f7705562f9cb0","0c43bc4fc61122750182c132411702f2","46bbf419a9fe1981009802288c1eb79d","46a4381ca9fe1981005c3e99af3cd164","0c43bcbdc61122750182c132e9b6565d"];

    var output = '';

    // looping above array to fetch each sys_id and passing to method
    for(var i=0; i < CIArray.length; i++) {

      // passing sys_id of CI stored in array to method
      output = SNC.StateManagementScriptableApi.getCIActions(CIArray[i]);

      // print a JSON formatted string with name-value pairs
      gs.print(output);
    }

出力：

    {"ciActions":["no_active_action"],"result":true}
    {"ciActions":["no_active_action"],"result":true}
    {"ciActions":["no_active_action"],"result":true}
    {"ciActions":["no_active_action"],"result":true}
    {"ciActions":["no_active_action"],"result":true}

## StateManagementScriptableApi - getOperationalState(文字列 ciSysId) {#ariaid-title5}

CI の運用ステータスを返します。
{#SMSA-getCIOperationalState_S__table_n5f_1ns_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ciSysId | 文字列 | CI のSys_id。 |
[表 : 7. パラメーター]

{#SMSA-getCIOperationalState_S__table_n5f_1ns_px} {#SMSA-getCIOperationalState_S__table_o5f_1ns_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 名前と値のペアを含む JSON 形式の文字列。 可能な値： * ciActions:operational_statusフィールドの文字列選択値、 または UNKNOWN。 * errors:エラーのリスト。 {#SMSA-getCIOperationalState_S__ul_ewf_5vl_px} |
[表 : 8. 返される内容]

{#SMSA-getCIOperationalState_S__table_o5f_1ns_px}  
次の例は、指定された構成アイテムのリストの運用ステータスを取得する方法を示しています。

    // Store sys_ids of configuration items for which to get the operational state.
    var CIArray = ["0c43bc4fc61122750182c132411702f2","46bbf419a9fe1981009802288c1eb79d","46a4381ca9fe1981005c3e99af3cd164","0c43bcbdc61122750182c132e9b6565d","a9c0c8d2c6112276018f7705562f9cb0"];

    var output = '';

    // Loop the array to fetch each sys_id and pass to the method.
    for(var i=0;i<CIArray.length;i++) {
      // Pass sys_id of CI stored in array to the method  
      output = SNC.StateManagementScriptableApi.getOperationalState(CIArray[i]); 

      // prints a JSON formatted string with name-value pairs
      gs.print(output);
    }

出力：

    *** Script: {"operationalState":"Operational","result":true}
    *** Script: {"operationalState":"Operational","result":true}
    *** Script: {"operationalState":"Operational","result":true}
    *** Script: {"operationalState":"Operational","result":true}
    ci_state_management                        : INVALID_SYS_ID: Invalid sys_id [a9c0c8d2c6112276018f7705562f9cb0]: no thrown error
    *** Script: {"errors":[{"error":"INVALID_SYS_ID","message":"Invalid sys_id [a9c0c8d2c6112276018f7705562f9cb0]"}],"operationalState":"unknown","result":false}

## StateManagementScriptableApi - isCompatibleCIAction(文字列 actionName, 文字列 otherActionName) {#ariaid-title6}

指定された 2 つのアクションに互換性があるかどうかを判断します。
{#SMSA-isCompatibleCIAction_S_S__table_fkl_v1t_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| actionName | 文字列 | CI アクション名 |
| その他のアクション名 | 文字列 | CI アクション名 |
[表 : 9. パラメーター]

{#SMSA-isCompatibleCIAction_S_S__table_fkl_v1t_px} {#SMSA-isCompatibleCIAction_S_S__table_gkl_v1t_px__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 指定された 2 つの CI アクションに互換性がある場合は true を返します。 |
[表 : 10. 返される内容]

{#SMSA-isCompatibleCIAction_S_S__table_gkl_v1t_px}

## StateManagementScriptableApi - isLeaseExpired(文字列 requestorId, 文字列 ciSysId, 文字列 ciActionName) {#ariaid-title7}

指定された CI アクションの要求者のリースが期限切れかどうかを判断します。
{#SMSA-isLeaseExpired_S_S_S__table_ot5_v5r_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestorId | 文字列 | ワークフローコンテキストのsys_id、または registerOperator() メソッドから返された GUID。 |
| ciSysId | 文字列 | CI のsys_id。 |
| ciActionName | 文字列 | CI アクションの名前。 |
[表 : 11. パラメーター]

{#SMSA-isLeaseExpired_S_S_S__table_ot5_v5r_px} {#SMSA-isLeaseExpired_S_S_S__table_pt5_v5r_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | の名前と値のペアを含む JSON 形式の文字列 * 結果:ユーザーのリース期間が切れている場合は true。 * エラー:エラーのリスト。 {#SMSA-isLeaseExpired_S_S_S__ul_ewf_5vl_px} |
[表 : 12. 返される内容]

{#SMSA-isLeaseExpired_S_S_S__table_pt5_v5r_px}

## StateManagementScriptableApi - isNotAllowedAction(文字列 ciType, 文字列 opsLabel, 文字列 actionName) {#ariaid-title8}

CI のタイプに応じて、CI アクションが運用ステータスに対して許可されていないかどうかを判断します。
{#SMSA-isNotAllowedAction_S_S_S__table_lzz_cxs_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ciType | 文字列 | CI タイプ |
| opsLabel | 文字列 | 運用ステータス |
| actionName | 文字列 | CI アクション名 |
[表 : 13. パラメーター]

{#SMSA-isNotAllowedAction_S_S_S__table_lzz_cxs_px} {#SMSA-isNotAllowedAction_S_S_S__table_mzz_cxs_px__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 指定された運用ステータスの指定された CI タイプに対してアクションが許可されていない場合に true を返します。 |
[表 : 14. 返される内容]

{#SMSA-isNotAllowedAction_S_S_S__table_mzz_cxs_px}

## StateManagementScriptableApi - isNotAllowedOpsTransition(文字列 ciType, 文字列 opsLabel, 文字列 transitionOpsLabel) {#ariaid-title9}

CI のタイプについて、運用ステータスの移行が許可されていないかどうかを判断します。
{#SMSA-isNotAllowedOpsTransition_S_S_S__table_erm_mys_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ciType | 文字列 | CI タイプ |
| opsLabel | 文字列 | 開始運用ステータスのラベル。 |
| transitionOpsLabel | 文字列 | 終了運用ステータスのラベル。 |
[表 : 15. パラメーター]

{#SMSA-isNotAllowedOpsTransition_S_S_S__table_erm_mys_px} {#SMSA-isNotAllowedOpsTransition_S_S_S__table_frm_mys_px__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 指定された CI タイプで指定された運用ステータスの移行が許可されていない場合は true を返します。 |
[表 : 16. 返される内容]

{#SMSA-isNotAllowedOpsTransition_S_S_S__table_frm_mys_px}

## StateManagementScriptableApi:isValidRequestor(文字列 requestorId) {#ariaid-title10}

指定された要求者が有効でアクティブなワークフローユーザーか登録済みユーザーかを判別します。
{#SMSA-isValidRequestor_S__table_dr5_5sr_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestorId | 文字列 | registerOperator() メソッドから返されたワークフローコンテキストまたは GUID のSys_id。 |
[表 : 17. パラメーター]

{#SMSA-isValidRequestor_S__table_dr5_5sr_px} {#SMSA-isValidRequestor_S__table_er5_5sr_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | JSON 形式の名前と値のペア。 可能な値： * result:requestorId が有効な場合は true 。 * エラー:エラーのリスト。 |
[表 : 18. 返される内容]

{#SMSA-isValidRequestor_S__table_er5_5sr_px}  
この例では、 isValidRequestor() メソッドを使用して、オペレーターが登録ユーザーであるかどうかを確認する方法を示します。

    var output = SNC.StateManagementScriptableApi.registerOperator();
    var jsonUtil = new JSON();
    var result = jsonUtil.decode(output);
    var requestorId = result.requestorId; // Fetching requestorId

    output = SNC.StateManagementScriptableApi.isValidRequestor(requestorId);
    gs.info(output);

出力：

    {"result":true}

## StateManagementScriptableApi:registerOperator() {#ariaid-title11}

ワークフロー以外のユーザーのオペレーターを登録します。
{#SMSA-registerOperator__table_l5c_hvl_px__entry__3}

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

{#SMSA-registerOperator__table_l5c_hvl_px} {#SMSA-registerOperator__table_m5c_hvl_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | の名前と値のペアを含む JSON 形式の文字列 * requestorid:CI アクション/運用状況の設定に使用される登録済みユーザー GUID。 * 結果:正常に登録された場合は true。 * エラー:エラーのリスト。 {#SMSA-registerOperator__ul_ewf_5vl_px} |
[表 : 20. 返される内容]

{#SMSA-registerOperator__table_m5c_hvl_px}  


    var output = SNC.StateManagementScriptableApi.registerOperator();
    var jsonUntil = new JSON();
    var result = jsonUntil.decode(output);
    var requestorId = result.requestorId;

## StateManagementScriptableApi - removeBulkCIAction(文字列 requestorId, 文字列 sysIdList, 文字列 ciActionName) {#ariaid-title12}

CI のリストの CI アクションを削除します。
{#SMSA-removeBulkCIAction_S_S_S__table_iz1_2vs_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestorId | 文字列 | ワークフローコンテキストのsys_id、または registerOperator() メソッドから返された GUID。 |
| sysIdList | 文字列 | CI sys_idsのカンマ区切りリスト |
| ciActionName | 文字列 | CI アクション名 |
[表 : 21. パラメーター]

{#SMSA-removeBulkCIAction_S_S_S__table_iz1_2vs_px} {#SMSA-removeBulkCIAction_S_S_S__table_jz1_2vs_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | の名前と値のペアを含む JSON 形式の文字列 * 結果:リスト内のすべての CI に対してアクションが削除された場合は true。それ以外の場合は false です。 * エラー:エラーのリスト。 {#SMSA-removeBulkCIAction_S_S_S__ul_ewf_5vl_px} |
[表 : 22. 返される内容]

{#SMSA-removeBulkCIAction_S_S_S__table_jz1_2vs_px}

## StateManagementScriptableApi - setBulkCIOperationalState(String requestorId, String sysIdList, String opsLabel, String opsStateListOld) {#ariaid-title13}

CI のリストの運用ステータスを設定します。
{#SMSA-setBulkCIOpState_S_S_S_S__table_hgf_5ks_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestorId | 文字列 | ワークフローコンテキストのsys_id、または registerOperator() メソッドから返された GUID。 |
| sysIdList | 文字列 | CI sys_idsのカンマ区切りリスト。 |
| opsLabel | 文字列 | これはoperational_status選択肢の文字列ラベルです。 |
| opsStateListOld | 文字列 | (オプション)古い CI のカンマ区切りリストには、すべての CI が含まれている必要があることが示されています。 |
[表 : 23. パラメーター]

{#SMSA-setBulkCIOpState_S_S_S_S__table_hgf_5ks_px} {#SMSA-setBulkCIOpState_S_S_S_S__table_igf_5ks_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | の名前と値のペアを含む JSON 形式の文字列 * 結果:リスト内のすべての CI に対してステータスが設定されている場合は true。それ以外の場合は false です。 * エラー:エラーのリスト。 {#SMSA-setBulkCIOpState_S_S_S_S__ul_ewf_5vl_px} |
[表 : 24. 返される内容]

{#SMSA-setBulkCIOpState_S_S_S_S__table_igf_5ks_px}  

    var output = SNC.StateManagementScriptableApi.registerOperator();
    var jsonUntil = new JSON();
    var result = jsonUtil.decode(output);
    var requestorId = result.requestorId;

    // list of sys_ids to update
    var sys_ids;

    // Set list of sys_ids's Operational State to 'Repair in Progress'
    output = SNC.StateManagementScriptableApi.setBulkCIOperationalState(requestorId, sys_ids,'Repair in Progress');
    gs.print(output);

## StateManagementScriptableApi - unregisterOperator(文字列 requestorId) {#ariaid-title14}

ワークフロー以外のユーザーのオペレーターの登録を解除します。
{#SMSA-unregisterOperator_S__table_pwv_2xl_px__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requestorId | 文字列 | registerOperator() メソッドから返されたワークフローコンテキストまたは GUID のSys_id。 |
[表 : 25. パラメーター]

{#SMSA-unregisterOperator_S__table_pwv_2xl_px} {#SMSA-unregisterOperator_S__table_qwv_2xl_px__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | JSON 形式の名前と値のペア。 可能な値： * 結果:登録解除に成功した場合は true * エラー:エラーのリスト。 |
[表 : 26. 返される内容]

{#SMSA-unregisterOperator_S__table_qwv_2xl_px}  
この例では、 unregisterOperator() メソッドを使用して登録済みユーザーの登録を解除する方法を示します。

    var output = SNC.StateManagementScriptableApi.registerOperator();
    var jsonUtil = new JSON();
    var result = jsonUtil.decode(output);
    var requestorId = result.requestorId; // Fetching requestorId

    output = SNC.StateManagementScriptableApi.unregisterOperator(requestorId);
    gs.info(output); 

出力：

    {"result":true}