CatCategory - スコープ対象

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：8分

    • CatCategory API は、スクリプトを使用してサービスカタログカテゴリを作成および変更できるメソッドを提供します。

    この API は sn_sc 名前空間で実行されます。

    重要:
    この API はアクセス可能です。ただし、推奨される実装は サービスカタログ REST API です。

    CatCategory - availableForUserCriteria(文字列 action, アレイ criteriaIDs)

    Available For ユーザー基準を現在のカタログカテゴリに追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    action 文字列 実行するアクション。
    • add：ユーザー基準を [利用可能] リストに追加します。
    • delete：ユーザー基準を [利用可能] リストから削除します。
    criteriaIDs アレイ ユーザー基準 sys_id のアレイ
    表 : 2. 返される内容
    タイプ 説明
    なし 
    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
item.availableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

    CatCategory - canView(ブール isMobile, 文字列 userSysId)

    指定されたユーザーが指定されたカテゴリをモバイルデバイスまたはデスクトップで表示できるかどうかを決定します。

    表 : 3. パラメーター
    名前 タイプ 説明
    isMobile ブーリアン モバイルデバイスまたはデスクトップでユーザーのアクセスを検証するかどうかを示すフラグ。
    • true：モバイルで検証します。
    • false：デスクトップで検証します。
    userSysId 文字列 検証するユーザーの sys_id。
    表 : 4. 返される内容
    タイプ 説明
    ブーリアン ユーザーが関連するカテゴリを表示できるかどうかを示すフラグ。
    • true：ユーザーはカテゴリを表示できます。
    • false：ユーザーはカテゴリを表示できません。
    		 
    var scopedCategoryObj = new sn_sc.CatCategory('7b1262b9530033007444ddeeff7b12ae');
scopedCategoryObj.canView(false, '62826bf03710200044e0bfc8bcbe5df1');

    CatCategory - create(ブール standardUpdate)

    定義されたカテゴリを挿入します。

    表 : 5. パラメーター
    名前 タイプ 説明
    standardUpdate ブーリアン エンジンとワークフローの実行を有効にするかどうかを示すフラグです。
    有効な値：
    • true：エンジンとワークフローを有効にします。
    • false：エンジンとワークフローを有効にしません。
    表 : 6. 返される内容
    タイプ 説明
    文字列 挿入された変数レコードの sys_id です。 
    var categoryCreate = new sn_sc.CatCategory();
categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
var categorySysId = categoryCreate.create();
var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

    CatCategory - deleteRecord(ブール standardUpdate)

    CatCategory クラスが最初にインスタンス化されたカテゴリレコードを削除します。

    表 : 7. パラメーター
    名前 タイプ 説明
    standardUpdate ブーリアン エンジンとワークフローの実行を有効にするかどうかを示すフラグです。
    有効な値：
    • true：エンジンとワークフローを有効にします。
    • false：エンジンとワークフローを有効にしません。
    表 : 8. 返される内容
    タイプ 説明
    なし 
    var categoryDelete = new sn_sc.CatCategory(categorySysId);
categoryDelete.deleteRecord();
var category = new sn_sc.CatCategory(categorySysId);
values = category.read({"title" : "", "sc_catalog":""}, false);
global.Assert.assertEquals("", values.title,"Category should title");

    CatCategory - getID()

    現在のカテゴリの sys_id を返します。

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 返される内容
    タイプ 説明
    文字列 現在のカテゴリの sys_id。

    例：

    var cart = new sn_sc.CatCategory("2809952237b1300054b6a3549dbe5dd4");
var categoryID = cart.getID();
gs.info(categoryID);

    出力：

    2809952237b1300054b6a3549dbe5dd4

    CatCategory - notAvailableForUserCriteria(文字列 action, アレイ[] criteriaIDs)

    Not Available For ユーザー基準を現在のカタログカテゴリに追加します。

    表 : 11. パラメーター
    名前 タイプ 説明
    action 文字列 実行するアクション。
    • add：ユーザー基準を [利用不可] リストに追加します。
    • delete：ユーザー基準を [利用不可] リストから削除します。
    表 : 12. 返される内容
    タイプ 説明
    なし 
    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
item. notAvailableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

    CatCategory - read(オブジェクト columns, ブール standardUpdate)

    カテゴリのマッピングを返します。

    表 : 13. パラメーター
    名前 タイプ 説明
    列 オブジェクト 値を希望する列のセットです。
    standardUpdate ブーリアン エンジンとワークフローの実行を有効にするかどうかを示すフラグです。
    有効な値：
    • true：エンジンとワークフローを有効にします。
    • false：エンジンとワークフローを有効にしません。
    表 : 14. 返される内容
    タイプ 説明
    オブジェクト 列名と値のマッピング。 
    var category = new sn_sc.CatCategory("a96277509f300200b407b89a442e704e");
var values = category.read({"title" : ""}, true);
gs.log(values.title);

    CatCategory - setAttributes(オブジェクト attributes)

    このカテゴリの属性値を定義します。

    表 : 15. パラメーター
    名前 タイプ 説明
    属性 オブジェクト 新しいフィールドと値のペアの属性。
    表 : 16. 返される内容
    タイプ 説明
    なし 
    var categoryCreate = new sn_sc.CatCategory();
categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
var categorySysId = categoryCreate.create();
var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

    CatCategory - setTableName(文字列 tableName)

    このカテゴリのテーブル名を定義します。

    表 : 17. パラメーター
    名前 タイプ 説明
    tableName 文字列 sc_category を拡張するテーブルの名前。
    表 : 18. 返される内容
    タイプ 説明
    なし 
    var categoryRead = new sn_sc.CatCategory(categorySysId);
categoryRead.setTableName("test_category");
var values = categoryRead.read({"title" : "", "sc_catalog":"", "test": ""}, false);
gs.info(categorySysId);
gs.info(values.title);
gs.info(values.test);
global.Assert.assertEquals("testValue", values.test,"Category extends sc_category and stores its extended value");

    CatCategory - update(オブジェクト columnValues, ブール standardUpdate)

    現在のカテゴリを指定された名前/値ペアで更新します。

    表 : 19. パラメーター
    名前 タイプ 説明
    columnValues オブジェクト 列名と値のマッピング。
    standardUpdate ブーリアン エンジンとワークフローの実行を有効にするかどうかを示すフラグです。
    有効な値：
    • true：エンジンとワークフローを有効にします。
    • false：エンジンとワークフローを有効にしません。
    表 : 20. 返される内容
    タイプ 説明
    なし 
    var categoryUpdate = new sn_sc.CatCategory(categorySysId);
categoryUpdate.update({"title" : "test changed scoped category"}, true);
values = categoryUpdate.read({"title" : "", "sc_catalog":""}, false);
global.Assert.assertEquals("test changed scoped category", values.title,"Category should title");