UserCriteria - スコープ指定

UserCriteria API を使用すると、スクリプトを使用してユーザー基準レコードを作成、変更、または削除できます。

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

スコープ指定の UserCriteria - create(オブジェクト columnValues, ブーリアン standardUpdate)

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

表 : 1. パラメーター

名前	タイプ	説明
columnValues	オブジェクト	列に対する鍵と値のペアおよびその値。
standardUpdate	ブーリアン	エンジンとワークフローの実行を有効にするには true に設定します。

表 : 2. 返される内容

タイプ	説明
文字列	作成されたユーザー基準の 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()

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

表 : 3. パラメーター

名前	タイプ	説明
なし

表 : 4. 返される内容

タイプ	説明
ブーリアン	true の場合、ユーザー基準は削除されます。 false の場合、削除するユーザー基準が見つかりません。

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

出力：

true

スコープ指定の UserCriteria - read(文字列 columns)

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

表 : 5. パラメーター

名前	タイプ	説明
columns	文字列	カタログアイテム属性のアレイ。

表 : 6. 返される内容

タイプ	説明
オブジェクト	カタログアイテムの属性と値のペアのマッピング。

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)

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

表 : 7. パラメーター

名前	タイプ	説明
active	ブーリアン	true の場合、ユーザー基準はアクティブです。 false の場合、ユーザー基準は非アクティブです。

表 : 8. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setAdvanced(ブーリアン advanced)

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

表 : 9. パラメーター

名前	タイプ	説明
advanced	ブーリアン	true の場合、ユーザー基準に詳細スクリプトがあります。 false の場合、ユーザー基準に詳細スクリプトはありません。

表 : 10. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setCompanies(文字列 companies)

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

表 : 11. パラメーター

名前	タイプ	説明
companies	文字列	ユーザー基準に設定する会社の sys_id のカンマ区切りリスト。

表 : 12. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setDepartments(文字列 departments)

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

表 : 13. パラメーター

名前	タイプ	説明
departments	文字列	ユーザー基準に設定する部門の sys_id のカンマ区切りリスト。

表 : 14. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setGroups(文字列 groups)

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

表 : 15. パラメーター

名前	タイプ	説明
groups	文字列	ユーザー基準に設定するグループの sys_id のカンマ区切りリスト。

表 : 16. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setLocations(文字列 locations)

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

表 : 17. パラメーター

名前	タイプ	説明
locations	文字列	ユーザー基準に設定する場所の sys_id のカンマ区切りリスト。

表 : 18. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setMatchAll(ブーリアン match_all)

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

表 : 19. パラメーター

名前	タイプ	説明
なし	match_all	true の場合、ユーザー基準のプロパティとして設定されたすべての条件を満たす必要があります。 false の場合、ユーザー基準のプロパティとして設定された条件のうち最低 1 つを満たす必要があります。

表 : 20. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setName(文字列 name)

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

表 : 21. パラメーター

名前	タイプ	説明
name	文字列	ユーザー基準の名前

表 : 22. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setRoles(文字列 roles)

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

表 : 23. パラメーター

名前	タイプ	説明
roles	文字列	ユーザー基準に設定するロールの sys_id のカンマ区切りリスト。

表 : 24. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - setScript(文字列 script)

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

表 : 25. パラメーター

名前	タイプ	説明
スクリプト	文字列	詳細なユーザー基準に設定するスクリプト。

表 : 26. 返される内容

タイプ	説明
なし

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)

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

表 : 27. パラメーター

名前	タイプ	説明
users	文字列	ユーザー基準に設定するユーザーの sys_id のカンマ区切りリスト。

表 : 28. 返される内容

タイプ	説明
なし

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

スコープ指定の UserCriteria - update(オブジェクト columnValues, 文字列 reason)

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

表 : 29. パラメーター

名前	タイプ	説明
columnValues	オブジェクト	列名と値のペアのマッピング。
reason	文字列	カタログアイテムを更新する理由。

表 : 30. 返される内容

タイプ	説明
文字列	作成されたユーザー基準の sys_id を返します。

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

出力：

31bea3d53790200044e0bfc8bcbe5dec

スコープ指定の UserCriteria - UserCriteria()

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

var uc = new sn_uc.UserCriteria();

スコープ指定の UserCriteria - UserCriteria(文字列 sys_id)

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

表 : 31. パラメーター

名前	タイプ	説明
sys_id	文字列	ユーザー基準の sys_id。

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