CatalogClientScript - Scoped

  • Release version: Zurich
  • Updated July 31, 2025
  • 3 minutes to read

    • 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.

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

    CatalogClientScript - addScript(String script)

    Adds a script to the catalog client script.

    Table 2. Parameters
    Name Type Description
    script String Script to be added to the catalog client script.
    Table 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.

    Table 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.
    Table 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.

    Table 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.
    Table 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.

    Table 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.
    Table 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.

    Table 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.
    Table 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.

    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.
    Table 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.

    Table 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.
    Table 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.

    Table 16. Parameters
    Name Type Description
    attributes Map A JSON object that has mapping for the field and value pairs.
    Table 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.

    Table 18. Parameters
    Name Type Description
    sys_id String Sys_id of the catalog item.
    Table 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.

    Table 20. Parameters
    Name Type Description
    sys_id String Sys_id of the variable.
    Table 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.

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

    This example shows how to call the method.

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