UserCriteria :スコープ指定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：9分

    • UserCriteria API は、スクリプトを使用してユーザー基準レコードを作成、変更、および削除するメソッドを提供します。

    スコープ対象のアプリケーションでこのクラスを使用するには、 sn_uc 名前空間識別子を使用します。この API にアクセスするには、ユーザー基準スコープ付き API プラグイン (ID:com.glideapp.user_criteria.scoped.api) を有効にする必要があります。

    UserCriteria:UserCriteria()

    UserCriteria クラスのインスタンスを作成します。

    var uc = new sn_uc.UserCriteria();

    UserCriteria:UserCriteria(文字列 sys_id)

    指定されたsys_idで UserCriteria クラスのインスタンスを作成します。

    表 : 1. パラメーター
    名前 タイプ 説明
    sys_id 文字列 ユーザー基準のsys_id。 
    var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");

    UserCriteria - create(Object columnValues, Boolean standardUpdate)

    user_criteriaテーブルに指定された値を持つユーザー基準を作成します。columnValues で指定された値は、セッターを介して指定された値を上書きします。

    表 : 2. パラメーター
    名前 タイプ 説明
    列値 オブジェクト 列とその値のキーと値のペア。
    標準更新 ブーリアン エンジンとワークフローの実行を有効にするには、true に設定します。
    表 : 3. 返される内容
    タイプ 説明
    文字列 作成されたユーザー基準のsys_id。 
    var uc = new sn_uc.UserCriteria(); 
uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
uc.setActive(true); 
uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
var UserCriteriaId = uc.create();
gs.info(UserCriteriaId);

    出力：

    41bea3d53790200044e0bfc8bcbe5dec

    UserCriteria:deleteRecord()

    現在のユーザー基準を削除します。

    表 : 4. パラメーター
    名前 タイプ 説明
    なし
    表 : 5. 返される内容
    タイプ 説明
    ブーリアン true の場合、ユーザー基準は削除されます。

    false の場合、削除するユーザー基準が見つかりません。

    		 
    var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");
uc.deleteRecord();

    出力：

    true

    UserCriteria - read(文字列列)

    カタログアイテムの属性と値のペアのマッピングを表示します。

    表 : 6. パラメーター
    名前 タイプ 説明
    columns 文字列 カタログアイテム属性のアレイ。
    表 : 7. 返される内容
    タイプ 説明
    オブジェクト カタログアイテムの属性と値のペアのマッピング。 
    var uc = new sn_uc.UserCriteria("7b8a6927ef732100438236caa5c0fb89");
var obj = uc.read(["company","name"]);
gs.info(JSON.stringify(obj));

    出力：

    Script: {"name":"All ACME Corporation employees","company":"e7c1f3d53790200044e0bfc8bcbe5deb,227cdfb03710200044e0bfc8bcbe5d6b,86c1f3193790200044e0bfc8bcbe5d95,98c37b193790200044e0bfc8bcbe5dbe,81f95197ac1d55eb35432fd1e068385e,df7d53303710200044e0bfc8bcbe5dac,81fdf9ebac1d55eb4cb89f136a082555,4b7d13f03710200044e0bfc8bcbe5db6,81f87336ac1d55eb06002def816d139f,81fbfe03ac1d55eb286d832de58ae1fd,81fca4cbac1d55eb355b4b6db0e3c80f,187d13f03710200044e0bfc8bcbe5df2,81fd65ecac1d55eb42a426568fc87a63,31bea3d53790200044e0bfc8bcbe5dec,81f75fcaac1d55eb2b0781d6f2c3c260"}

    UserCriteria:setActive(ブール値、active)

    ユーザー基準がアクティブかどうかを指定します。

    表 : 8. パラメーター
    名前 タイプ 説明
    アクティブ ブーリアン true の場合、ユーザー基準はアクティブです。

    false の場合、ユーザー基準は非アクティブです。
    表 : 9. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setActive(true);

    UserCriteria:setAdvanced(ブール詳細)

    ユーザー基準に詳細スクリプトがあるかどうかを指定します。

    表 : 10. パラメーター
    名前 タイプ 説明
    詳細 ブーリアン true の場合、ユーザー基準には詳細スクリプトがあります。

    false の場合、ユーザー基準に詳細スクリプトがありません。
    表 : 11. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setAdvanced(true);

    UserCriteria:setCompanies(文字列 companies)

    ユーザー基準の会社プロパティを設定します。

    表 : 12. パラメーター
    名前 タイプ 説明
    会社 文字列 ユーザー基準に設定する会社sys_idsのカンマ区切りリスト。
    表 : 13. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");

    UserCriteria:setDepartments(文字列 departments)

    ユーザー基準の部門プロパティを設定します。

    表 : 14. パラメーター
    名前 タイプ 説明
    部門 文字列 ユーザー基準に設定する部門sys_idsのカンマ区切りリスト。
    表 : 15. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setDepartments("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");

    UserCriteria:setGroups(文字列グループ)

    ユーザー基準のグループプロパティを設定します。

    表 : 16. パラメーター
    名前 タイプ 説明
    グループ 文字列 ユーザー基準に設定するグループsys_idsのカンマ区切りリスト。
    表 : 17. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setGroups("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");

    UserCriteria:setLocations(文字列 locations)

    ユーザー基準の場所プロパティを設定します。

    表 : 18. パラメーター
    名前 タイプ 説明
    場所 文字列 ユーザー基準に設定する場所sys_idsのカンマ区切りリスト。
    表 : 19. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setLocations("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");

    UserCriteria:setMatchAll(Boolean match_all)

    ユーザー基準のmatch_allプロパティを設定します。

    表 : 20. パラメーター
    名前 タイプ 説明
    なし match_all true の場合、ユーザー基準のプロパティとして設定されているすべての条件が満たされる必要があります。

    false の場合、ユーザー基準のプロパティとして設定された条件が少なくとも 1 つ満たされている必要があります。
    表 : 21. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setMatchAll(true);

    UserCriteria:setName(文字列名)

    ユーザー基準の名前プロパティを設定します。

    表 : 22. パラメーター
    名前 タイプ 説明
    name 文字列 ユーザー基準の名前
    表 : 23. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setName("Property1");

    UserCriteria:setRoles(文字列ロール)

    ユーザー基準のロールプロパティを設定します。

    表 : 24. パラメーター
    名前 タイプ 説明
    ロール 文字列 ユーザー基準に設定するロールsys_idsのカンマ区切りリスト。
    表 : 25. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setRoles("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");

    UserCriteria:setScript(文字列スクリプト)

    ユーザー基準のスクリプトを設定します。

    表 : 26. パラメーター
    名前 タイプ 説明
    スクリプト 文字列 高度なユーザー基準のために設定するスクリプト。
    表 : 27. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setScript("function scriptTest() {
  var retVal;
  if (gs.getUser().getRecord().getDisplayValue('department') == 'Product Management') {
      retVal = true;
  } else {
      retVal = false;
  }
  return retVal;
}");

    UserCriteria:setUsers(文字列 users)

    ユーザー基準のユーザープロパティを設定します。

    表 : 28. パラメーター
    名前 タイプ 説明
    ユーザー 文字列 ユーザー基準に設定するユーザー sys_idsのカンマ区切りリスト。
    表 : 29. 返される内容
    タイプ 説明
    なし 
    var uc = new sn_uc.UserCriteria();
uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");

    UserCriteria:update(Object columnValues, String reason)

    現在のカタログアイテムを指定された値で更新します。

    表 : 30. パラメーター
    名前 タイプ 説明
    列値 オブジェクト 列名と値のペアのマッピング。
    理由 文字列 カタログアイテムを更新する理由。
    表 : 31. 返される内容
    タイプ 説明
    文字列 作成されたユーザー基準のsys_idを返します。 
    var uc = new sn_uc.UserCriteria();
uc.update("name": "Updated name", "The existing name is not relevant. Setting a relevant name");

    出力:

    31bea3d53790200044e0bfc8bcbe5dec