カタログ検索 - スコープ対象

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • CatalogSearch API は、カタログアイテムを検索できるようにするメソッドを提供します。

    スコープ対象のアプリケーションでこのクラスを使用するには、 sn_sc 名前空間識別子を使用します。CatalogSearch API にアクセスするには、デフォルトで有効になっているサービスカタログスコープ付き API プラグイン (ID:com.glideapp.servicecatalog.scoped.api) が必要です。

    カタログ検索:CatalogSearch()

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

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    var catSearchGR = new sn_sc.CatalogSearch().search('', '', 'Apple', false, true);
    catSearchGR.query();
    while(catSearchGR.next()) {
      gs.info(catSearchGR.getValue('name'));
    }

    カタログ検索 - 検索 (文字列 catalogID、文字列 categoryID、文字列用語、ブール mobile、ブール noDepthSearch)

    検索用語に基づいてカタログアイテムを検索します。検索は、カタログカテゴリレベルに絞り込むことができます。

    表 : 2. パラメーター
    名前 タイプ 説明
    カタログ ID 文字列 検索するカタログの識別子。
    カテゴリ ID 文字列 検索するカタログカテゴリの識別子。
    用語 文字列 検索用語。
    mobile ブーリアン モバイル用に公開されているカタログアイテムを検索するかどうかを示すフラグ。
    有効な値:
    • true:モバイルカタログアイテムを検索します。
    • false:モバイルカタログアイテムを検索しません。
    深さ検索なし ブーリアン サブカテゴリを検索するかどうかを示すフラグ。
    有効な値:
    • true:サブカテゴリを検索しません。
    • false:サブカテゴリを検索します。
    表 : 3. 返される内容
    タイプ 説明
    GlideRecord 検索結果に一致するsc_cat_itemの GlideRecord を返します。

    この例では、すべてのカタログとすべてのカテゴリで「ServiceNow」という用語を検索する方法を示しています。

    var now_GR = new sn_sc.CatalogSearch().search('', '', 'ServiceNow', false, false);
    now_GR.query();
    while(now_GR.next()) {
      gs.log(now_GR.name);
    }

    出力:

    ServiceNow T-shirt