CatalogClientScript - Scoped

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 10분
  • The CatalogClientScript API provides methods that enable you to create, modify, or delete catalog client script records.

    To use this class in a scoped application, use the sn_sc namespace identifier. The Service Catalog Scoped API plugin (ID: com.glideapp.servicecatalog.scoped.api) that is enabled by default is required to access the CatalogClientScript API.

    CatalogClientScript - CatalogClientScript()

    Creates an instance of the CatalogClientScript class.

    표 1. Parameters
    Name Type Description
    None
    var catalogClientScript = new sn_sc.CatalogClientScript();

    CatalogClientScript - addScript(String script)

    Adds a script to the catalog client script.

    표 2. Parameters
    Name Type Description
    script String Script to be added to the catalog client script.
    표 3. Returns
    Type Description
    void

    This example shows how to call this method.

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

    CatalogClientScript - appliesToCatalogItem(Boolean flag)

    Specifies if the catalog client script runs on a catalog item.

    표 4. Parameters
    Name Type Description
    flag Boolean If true, the catalog client script runs on the catalog item. If false, the catalog client script does not run on the catalog item.
    표 5. Returns
    Type Description
    void
    var catalogClientScript = new sn_sc.CatalogClientScript();
    catalogClientScript.appliesToCatalogItem(true);

    CatalogClientScript - appliesToCatalogTask(Boolean flag)

    Specifies if the catalog client script runs on a catalog task.

    표 6. Parameters
    Name Type Description
    flag Boolean If true, the catalog client script runs on the catalog task. If false, the catalog client script does not run on the catalog task.
    표 7. Returns
    Type Description
    void

    This example shows how to call this method.

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

    CatalogClientScript - appliesToRequestedItem(Boolean flag)

    Specifies if the catalog client script runs on a requested item.

    표 8. Parameters
    Name Type Description
    flag Boolean If true, the catalog client script runs on the requested item. If false, the catalog client script does not run on the requested item.
    표 9. Returns
    Type Description
    void

    This example shows how to call the method.

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

    CatalogClientScript - appliesToTargetRecord(Boolean flag)

    Specifies if the catalog client script runs on a requested item.

    표 10. Parameters
    Name Type Description
    flag Boolean If true, the catalog client script runs on the target record. If false, the catalog client script does not run on the target record.
    표 11. Returns
    Type Description
    void

    This example shows how to call the method.

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

    CatalogClientScript - create(Boolean standardUpdate)

    Inserts the defined catalog client script in the catalog_script_client table.

    표 12. Parameters
    Name Type Description
    standardUpdate Boolean Flag that indicates whether to enable the running of engines and workflow.
    Valid values:
    • true: Enable engines and workflow.
    • false: Do not enable engines and workflow.
    표 13. Returns
    Type Description
    String Sys_id of the catalog client script.

    This example shows how to call the method.

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

    Output:

    039c516237b1300054b6a3549dbe5dfc

    CatalogClientScript - deleteRecord(String sys_id, Boolean standardUpdate)

    Deletes the defined catalog client script.

    표 14. Parameters
    Name Type Description
    sys_id String Sys_id of the catalog client script.
    standardUpdate Boolean Flag that indicates whether to enable the running of engines and workflow.
    Valid values:
    • true: Enable engines and workflow.
    • false: Do not enable engines and workflow.
    표 15. Returns
    Type Description
    void

    The following example shows how to delete a catalog client script.

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

    CatalogClientScript - setAttributes(Map attributes)

    Defines attribute values for the catalog client script.

    표 16. Parameters
    Name Type Description
    attributes Map A JSON object that has mapping for the field and value pairs.
    표 17. Returns
    Type Description
    void

    This example shows how to call the method.

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

    CatalogClientScript - setCatalogItem(String sys_id)

    Associates a catalog item with the catalog client script.

    표 18. Parameters
    Name Type Description
    sys_id String Sys_id of the catalog item.
    표 19. Returns
    Type Description
    void

    This example shows how to associate a catalog item with the current catalog client script.

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

    CatalogClientScript - setOnChangeVariable(String sys_id)

    Runs the catalog client script when a variable value is updated.

    표 20. Parameters
    Name Type Description
    sys_id String Sys_id of the variable.
    표 21. Returns
    Type Description
    void

    This example shows how to call the method.

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

    CatalogClientScript - setVariableSet(String sys_id)

    Associates a variable set with the catalog client script.

    표 22. Parameters
    Name Type Description
    sys_id String Sys_id of the variable set.
    표 23. Returns
    Type Description
    void

    This example shows how to call the method.

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