---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CatalogClientScript - スコープ指定

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

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分

CatalogClientScript API は、カタログクライアントスクリプトレコードを作成、変更、または削除するためのメソッドを提供します。

スコープ対象のアプリケーションでこのクラスを使用するには、`sn_sc` 名前空間識別子を使用します。デフォルトで有効になっている Service Catalog Scoped API プラグイン (ID：com.glideapp.servicecatalog.scoped.api) は、CatalogClientScript API にアクセスするために必要です。

## CatalogClientScript - CatalogClientScript() {#ariaid-title2}

CatalogClientScript クラスのインスタンスを作成します。
{#r_CCSS-CatalogClientScript__table_hlv_q2c_1z__entry__3}

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

{#r_CCSS-CatalogClientScript__table_hlv_q2c_1z}  

    var catalogClientScript = new sn_sc.CatalogClientScript();

## CatalogClientScript - addScript(文字列スクリプト) {#ariaid-title3}

カタログクライアントスクリプトにスクリプトを追加します。
{#r_CCSS-addScript_S__table_m1v_1ds_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| スクリプト | 文字列 | カタログクライアントスクリプトに追加するスクリプト |
[表 : 2. パラメーター]

{#r_CCSS-addScript_S__table_m1v_1ds_sy} {#r_CCSS-addScript_S__table_n1v_1ds_sy__entry__2}

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

{#r_CCSS-addScript_S__table_n1v_1ds_sy}  
この例では、このメソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.addScript("function onLoad(){Enter the script}");

## CatalogClientScript - appliesToCatalogItem (ブールフラグ) {#ariaid-title4}

カタログクライアントスクリプトがカタログアイテムで実行されるかどうかを指定します。
{#r_CCSS-appliesToCatalogItem_B__table_zsm_rzr_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フラグ | ブーリアン | true の場合、カタログクライアントスクリプトはカタログアイテムで実行されます。false の場合、カタログクライアントスクリプトはカタログアイテムで実行されません。 |
[表 : 4. パラメーター]

{#r_CCSS-appliesToCatalogItem_B__table_zsm_rzr_sy} {#r_CCSS-appliesToCatalogItem_B__table_atm_rzr_sy__entry__2}

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

{#r_CCSS-appliesToCatalogItem_B__table_atm_rzr_sy}  

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToCatalogItem(true);

## CatalogClientScript - appliesToCatalogTask (ブールフラグ) {#ariaid-title5}

カタログクライアントスクリプトがカタログ タスクで実行されるかどうかを指定します。
{#r_CCSS-appliesToCatalogTask_B__table_tqp_n2s_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フラグ | ブーリアン | true の場合、カタログクライアントスクリプトはカタログ タスクで実行されます。false の場合、カタログクライアントスクリプトはカタログ タスクでは実行されません。 |
[表 : 6. パラメーター]

{#r_CCSS-appliesToCatalogTask_B__table_tqp_n2s_sy} {#r_CCSS-appliesToCatalogTask_B__table_uqp_n2s_sy__entry__2}

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

{#r_CCSS-appliesToCatalogTask_B__table_uqp_n2s_sy}  
この例では、このメソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToCatalogTask(true);

## CatalogClientScript - appliesToRequestedItem (ブールフラグ) {#ariaid-title6}

カタログクライアントスクリプトが要求されたアイテムで実行されるかどうかを指定します。
{#r_CCSS-appliesToRequestedItem_B__table_rsq_p1s_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フラグ | ブーリアン | true の場合、カタログクライアントスクリプトは要求されたアイテムで実行されます。false の場合、カタログクライアントスクリプトは要求されたアイテムで実行されません。 |
[表 : 8. パラメーター]

{#r_CCSS-appliesToRequestedItem_B__table_rsq_p1s_sy} {#r_CCSS-appliesToRequestedItem_B__table_ssq_p1s_sy__entry__2}

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

{#r_CCSS-appliesToRequestedItem_B__table_ssq_p1s_sy}  
この例では、メソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToRequestedItem(true);

## CatalogClientScript - appliesToTargetRecord (ブールフラグ) {#ariaid-title7}

カタログクライアントスクリプトが要求されたアイテムで実行されるかどうかを指定します。
{#r_CCSS-appliesToTargetRecord_B__table_hwy_44l_5z__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フラグ | ブーリアン | true の場合、カタログクライアントスクリプトはターゲット レコードで実行されます。false の場合、カタログクライアントスクリプトはターゲット レコードで実行されません。 |
[表 : 10. パラメーター]

{#r_CCSS-appliesToTargetRecord_B__table_hwy_44l_5z} {#r_CCSS-appliesToTargetRecord_B__table_iwy_44l_5z__entry__2}

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

{#r_CCSS-appliesToTargetRecord_B__table_iwy_44l_5z}  
この例では、メソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToTargetRecord(true);

## CatalogClientScript - create(ブール値 standardUpdate) {#ariaid-title8}

定義済みのカタログ クライアント スクリプトを catalog_script_client テーブルに挿入します。
{#r_CCSS-create_B__table_kj1_xbs_kx__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| standardUpdate | ブーリアン | エンジンとワークフローの実行を有効にするかどうかを示すフラグです。 有効な値： * true：エンジンとワークフローを有効にします。 * false：エンジンとワークフローを有効にしません。 {#r_CCSS-create_B__ul_nnx_xwn_kpb} |
[表 : 12. パラメーター]

{#r_CCSS-create_B__table_kj1_xbs_kx} {#r_CCSS-create_B__table_lj1_xbs_kx__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | カタログクライアントスクリプトの sys_id です。 |
[表 : 13. 返される内容]

{#r_CCSS-create_B__table_lj1_xbs_kx}  
この例では、メソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setAttributes({"name": "My Catalog Item", "applies_to": "item", "ui_type": "desktop", "type": "onLoad"});
    catalogClientScript.appliesToCatalogItem(true);
    catalogClientScript.appliesToRequestedItem(true);
    catalogClientScript.appliesToCatalogTask(true);
    catalogClientScript.appliesToTargetRecord(true);
    var catalogClientScriptId = catalogClientScript.create();
    gs.info(catalogClientScriptId);

出力:

    039c516237b1300054b6a3549dbe5dfc

## CatalogClientScript - deleteRecord(文字列 sys_id, ブール値 standardUpdate) {#ariaid-title9}

定義済みのカタログクライアントスクリプトを削除します。
{#r_CCSS-deleteRecord_S_B__table_jdv_hsz_qy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sys_id | 文字列 | カタログクライアントスクリプトの sys_id です。 |
| standardUpdate | ブーリアン | エンジンとワークフローの実行を有効にするかどうかを示すフラグです。 有効な値： * true：エンジンとワークフローを有効にします。 * false：エンジンとワークフローを有効にしません。 {#r_CCSS-deleteRecord_S_B__ul_nnx_xwn_kpb} |
[表 : 14. パラメーター]

{#r_CCSS-deleteRecord_S_B__table_jdv_hsz_qy} {#r_CCSS-deleteRecord_S_B__table_kdv_hsz_qy__entry__2}

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

{#r_CCSS-deleteRecord_S_B__table_kdv_hsz_qy}  
次の例は、カタログクライアントスクリプトを削除する方法を示しています。

    var sys_id = "039c516237b1300054b6a3549dbe5dfc"; 
    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.deleteRecord("039c516237b1300054b6a3549dbe5dfc");

## CatalogClientScript - setAttributes (マップ属性) {#ariaid-title10}

カタログクライアントスクリプトの属性値を定義します。
{#r_CCSS-setAttributes_M__table_fyy_tyr_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 属性 | マップ | フィールドと値のペアのマッピングを持つ JSON オブジェクト |
[表 : 16. パラメーター]

{#r_CCSS-setAttributes_M__table_fyy_tyr_sy} {#r_CCSS-setAttributes_M__table_gyy_tyr_sy__entry__2}

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

{#r_CCSS-setAttributes_M__table_gyy_tyr_sy}  
この例では、メソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setAttributes({"name": "My Catalog Item", "applies_to": "catalog_item", "ui_type": "desktop", "type": "onLoad"});

## CatalogClientScript - setCatalogItem(文字列 sys_id) {#ariaid-title11}

カタログアイテムをカタログクライアントスクリプトに関連付けます。
{#r_CCSS-setCatalogItem_S__table_v3g_zds_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sys_id | 文字列 | カタログアイテムの sys_id です。 |
[表 : 18. パラメーター]

{#r_CCSS-setCatalogItem_S__table_v3g_zds_sy} {#r_CCSS-setCatalogItem_S__table_w3g_zds_sy__entry__2}

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

{#r_CCSS-setCatalogItem_S__table_w3g_zds_sy}  
この例は、カタログアイテムを現在のカタログクライアントスクリプトに関連付ける方法を示しています。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setCatalogItem("039c516237b1300054b6a3549dbe5dfc");

## CatalogClientScript - setOnChangeVariable(文字列 sys_id) {#ariaid-title12}

変数値が更新されたときにカタログクライアントスクリプトを実行します。
{#r_CCSS-setOnChangeVariable_S__table_m3r_3cs_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sys_id | 文字列 | 変数の sys_id です。 |
[表 : 20. パラメーター]

{#r_CCSS-setOnChangeVariable_S__table_m3r_3cs_sy} {#r_CCSS-setOnChangeVariable_S__table_n3r_3cs_sy__entry__2}

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

{#r_CCSS-setOnChangeVariable_S__table_n3r_3cs_sy}  
この例では、メソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setOnChangeVariable("039c516237b1300054b6a3549dbe5dfc");

## CatalogClientScript - setVariableSet(文字列 sys_id) {#ariaid-title13}

変数セットをカタログクライアントスクリプトに関連付けます。
{#r_CCSS-setVariableSet_S__table_cvz_tbs_sy__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sys_id | 文字列 | 変数セットの sys_id です。 |
[表 : 22. パラメーター]

{#r_CCSS-setVariableSet_S__table_cvz_tbs_sy} {#r_CCSS-setVariableSet_S__table_dvz_tbs_sy__entry__2}

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

{#r_CCSS-setVariableSet_S__table_dvz_tbs_sy}  
この例では、メソッドを呼び出す方法を示します。

    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.setVariableSet("039c516237b1300054b6a3549dbe5dfc");