---
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


---

# UserCriteria :スコープ指定

# UserCriteria :スコープ指定 {#ariaid-title1}

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

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

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

## UserCriteria:UserCriteria() {#ariaid-title2}

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

    var uc = new sn_uc.UserCriteria();

## UserCriteria:UserCriteria(文字列 sys_id) {#ariaid-title3}

指定されたsys_idで UserCriteria クラスのインスタンスを作成します。
{#r_UCS-UserCriteria_S__table_dxz_fz2_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sys_id | 文字列 | ユーザー基準のsys_id。 |
[表 : 1. パラメーター]

{#r_UCS-UserCriteria_S__table_dxz_fz2_vz}  

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

## UserCriteria - create(Object columnValues, Boolean standardUpdate) {#ariaid-title4}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 列値 | オブジェクト | 列とその値のキーと値のペア。 |
| 標準更新 | ブーリアン | エンジンとワークフローの実行を有効にするには、true に設定します。 |
[表 : 2. パラメーター]

{#r_UCS-create_O_B__table_ncp_prf_vz} {#r_UCS-create_O_B__table_ocp_prf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 作成されたユーザー基準のsys_id。 |
[表 : 3. 返される内容]

{#r_UCS-create_O_B__table_ocp_prf_vz}  

    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() {#ariaid-title5}

現在のユーザー基準を削除します。
{#r_UCS-deleteRecord__table_erq_jlf_vz__entry__3}

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

{#r_UCS-deleteRecord__table_erq_jlf_vz} {#r_UCS-deleteRecord__table_frq_jlf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | true の場合、ユーザー基準は削除されます。 false の場合、削除するユーザー基準が見つかりません。 |
[表 : 5. 返される内容]

{#r_UCS-deleteRecord__table_frq_jlf_vz}  

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

出力：

    true

## UserCriteria - read(文字列列) {#ariaid-title6}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| columns | 文字列 | カタログアイテム属性のアレイ。 |
[表 : 6. パラメーター]

{#r_UCS-read_S__table_rnk_bpf_vz} {#r_UCS-read_S__table_snk_bpf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | カタログアイテムの属性と値のペアのマッピング。 |
[表 : 7. 返される内容]

{#r_UCS-read_S__table_snk_bpf_vz}  

    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) {#ariaid-title7}

ユーザー基準がアクティブかどうかを指定します。
{#r_UCS-setActive_B__table_lc1_x3f_vz__entry__3}

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

{#r_UCS-setActive_B__table_lc1_x3f_vz} {#r_UCS-setActive_B__table_mc1_x3f_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 9. 返される内容]

{#r_UCS-setActive_B__table_mc1_x3f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setActive(true); 

## UserCriteria:setAdvanced(ブール詳細) {#ariaid-title8}

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

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

{#r_UCS-setAdvanced_B__table_eps_xff_vz} {#r_UCS-setAdvanced_B__table_fps_xff_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 11. 返される内容]

{#r_UCS-setAdvanced_B__table_fps_xff_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setAdvanced(true); 

## UserCriteria:setCompanies(文字列 companies) {#ariaid-title9}

ユーザー基準の会社プロパティを設定します。
{#r_UCS-setCompanies_S__table_qrr_gff_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 会社 | 文字列 | ユーザー基準に設定する会社sys_idsのカンマ区切りリスト。 |
[表 : 12. パラメーター]

{#r_UCS-setCompanies_S__table_qrr_gff_vz} {#r_UCS-setCompanies_S__table_rrr_gff_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 13. 返される内容]

{#r_UCS-setCompanies_S__table_rrr_gff_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria:setDepartments(文字列 departments) {#ariaid-title10}

ユーザー基準の部門プロパティを設定します。
{#r_UCS-setDepartments_S__table_k24_ddf_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 部門 | 文字列 | ユーザー基準に設定する部門sys_idsのカンマ区切りリスト。 |
[表 : 14. パラメーター]

{#r_UCS-setDepartments_S__table_k24_ddf_vz} {#r_UCS-setDepartments_S__table_l24_ddf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 15. 返される内容]

{#r_UCS-setDepartments_S__table_l24_ddf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setDepartments("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria:setGroups(文字列グループ) {#ariaid-title11}

ユーザー基準のグループプロパティを設定します。
{#r_UCS-setGroups_S__table_zzq_j3f_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| グループ | 文字列 | ユーザー基準に設定するグループsys_idsのカンマ区切りリスト。 |
[表 : 16. パラメーター]

{#r_UCS-setGroups_S__table_zzq_j3f_vz} {#r_UCS-setGroups_S__table_a1r_j3f_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 17. 返される内容]

{#r_UCS-setGroups_S__table_a1r_j3f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setGroups("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria:setLocations(文字列 locations) {#ariaid-title12}

ユーザー基準の場所プロパティを設定します。
{#r_UCS-setLocations_S__table_hrs_42f_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 場所 | 文字列 | ユーザー基準に設定する場所sys_idsのカンマ区切りリスト。 |
[表 : 18. パラメーター]

{#r_UCS-setLocations_S__table_hrs_42f_vz} {#r_UCS-setLocations_S__table_irs_42f_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 19. 返される内容]

{#r_UCS-setLocations_S__table_irs_42f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setLocations("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria:setMatchAll(Boolean match_all) {#ariaid-title13}

ユーザー基準のmatch_allプロパティを設定します。
{#r_UCS-setMatchAll_B__table_wvg_gkf_vz__entry__3}

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

{#r_UCS-setMatchAll_B__table_wvg_gkf_vz} {#r_UCS-setMatchAll_B__table_xvg_gkf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 21. 返される内容]

{#r_UCS-setMatchAll_B__table_xvg_gkf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setMatchAll(true); 

## UserCriteria:setName(文字列名) {#ariaid-title14}

ユーザー基準の名前プロパティを設定します。
{#r_UCS-setName_S__table_qzy_vhf_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | ユーザー基準の名前 |
[表 : 22. パラメーター]

{#r_UCS-setName_S__table_qzy_vhf_vz} {#r_UCS-setName_S__table_rzy_vhf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 23. 返される内容]

{#r_UCS-setName_S__table_rzy_vhf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setName("Property1"); 

## UserCriteria:setRoles(文字列ロール) {#ariaid-title15}

ユーザー基準のロールプロパティを設定します。
{#r_UCS-setRoles_S__table_wxt_h1f_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ロール | 文字列 | ユーザー基準に設定するロールsys_idsのカンマ区切りリスト。 |
[表 : 24. パラメーター]

{#r_UCS-setRoles_S__table_wxt_h1f_vz} {#r_UCS-setRoles_S__table_xxt_h1f_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 25. 返される内容]

{#r_UCS-setRoles_S__table_xxt_h1f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setRoles("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria:setScript(文字列スクリプト) {#ariaid-title16}

ユーザー基準のスクリプトを設定します。
{#r_UCS-setScript_S__table_elp_zgf_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| スクリプト | 文字列 | 高度なユーザー基準のために設定するスクリプト。 |
[表 : 26. パラメーター]

{#r_UCS-setScript_S__table_elp_zgf_vz} {#r_UCS-setScript_S__table_flp_zgf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 27. 返される内容]

{#r_UCS-setScript_S__table_flp_zgf_vz}  

    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) {#ariaid-title17}

ユーザー基準のユーザープロパティを設定します。
{#r_UCS-setUsers_S__table_npm_qbf_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ユーザー | 文字列 | ユーザー基準に設定するユーザー sys_idsのカンマ区切りリスト。 |
[表 : 28. パラメーター]

{#r_UCS-setUsers_S__table_npm_qbf_vz} {#r_UCS-setUsers_S__table_opm_qbf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 29. 返される内容]

{#r_UCS-setUsers_S__table_opm_qbf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria:update(Object columnValues, String reason) {#ariaid-title18}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 列値 | オブジェクト | 列名と値のペアのマッピング。 |
| 理由 | 文字列 | カタログアイテムを更新する理由。 |
[表 : 30. パラメーター]

{#r_UCS-update_O_S__table_nrg_fmf_vz} {#r_UCS-update_O_S__table_org_fmf_vz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 作成されたユーザー基準のsys_idを返します。 |
[表 : 31. 返される内容]

{#r_UCS-update_O_S__table_org_fmf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.update("name": "Updated name", "The existing name is not relevant. Setting a relevant name"); 

出力:

    31bea3d53790200044e0bfc8bcbe5dec