CatalogClientScript - 범위 지정됨

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기8분

    • CatalogClientScript API는 카탈로그 클라이언트 스크립트 기록을 생성, 수정 또는 삭제할 수 있는 메서드를 제공합니다.

    범위가 지정된 애플리케이션에서 이 클래스를 사용하려면 sn_sc 네임스페이스 식별자를 사용합니다. CatalogClientScript API에 접근하려면 기본적으로 활성화되어 있는 Service Catalog Scoped API 플러그인(ID: com.glideapp.servicecatalog.scoped.api)이 필요합니다.

    CatalogClientScript - CatalogClientScript()

    CatalogClientScript 클래스의 인스턴스를 만듭니다.

    표 1. 매개변수
    이름 유형 설명
    없음 
    var catalogClientScript = new sn_sc.CatalogClientScript();

    CatalogClientScript - addScript(문자열 스크립트)

    카탈로그 클라이언트 스크립트에 스크립트를 추가합니다.

    표 2. 매개변수
    이름 유형 설명
    스크립트 문자열 카탈로그 클라이언트 스크립트에 추가할 스크립트입니다.
    표 3. 반환
    유형 설명
    void

    이 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

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

    CatalogClientScript - appliesToCatalogItem(부울 플래그)

    카탈로그 클라이언트 스크립트가 카탈로그 항목에서 실행되는지 여부를 지정합니다.

    표 4. 매개변수
    이름 유형 설명
    플래그 부울 true이면 카탈로그 항목에서 카탈로그 클라이언트 스크립트가 실행됩니다. false인 경우 카탈로그 클라이언트 스크립트가 카탈로그 항목에서 실행되지 않습니다.
    표 5. 반환
    유형 설명
    void 
    var catalogClientScript = new sn_sc.CatalogClientScript();
catalogClientScript.appliesToCatalogItem(true);

    CatalogClientScript - appliesToCatalogTask(부울 플래그)

    카탈로그 클라이언트 스크립트가 카탈로그 작업에서 실행되는지 여부를 지정합니다.

    표 6. 매개변수
    이름 유형 설명
    플래그 부울 true인 경우, 카탈로그 클라이언트 스크립트가 카탈로그 작업에서 실행됩니다. false인 경우 카탈로그 작업은 카탈로그 클라이언트 스크립트가 실행되지 않습니다.
    표 7. 반환
    유형 설명
    void

    이 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

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

    CatalogClientScript - appliesToRequestedItem(부울 플래그)

    요청된 항목에서 카탈로그 클라이언트 스크립트가 실행되는지 여부를 지정합니다.

    표 8. 매개변수
    이름 유형 설명
    플래그 부울 true일 경우 요청된 항목에서 카탈로그 클라이언트 스크립트가 실행됩니다. false일 경우 요청된 항목에서 카탈로그 클라이언트 스크립트가 실행되지 않습니다.
    표 9. 반환
    유형 설명
    void

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    CatalogClientScript - appliesToTargetRecord(부울 플래그)

    요청된 항목에서 카탈로그 클라이언트 스크립트가 실행되는지 여부를 지정합니다.

    표 10. 매개변수
    이름 유형 설명
    플래그 부울 true이면 대상 기록에서 카탈로그 클라이언트 스크립트가 실행됩니다. false인 경우 대상 기록에서 카탈로그 클라이언트 스크립트가 실행되지 않습니다.
    표 11. 반환
    유형 설명
    void

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    CatalogClientScript - create(부울 standardUpdate)

    정의된 카탈로그 클라이언트 스크립트를 catalog_script_client 테이블에 삽입합니다.

    표 12. 매개변수
    이름 유형 설명
    표준 업데이트 부울 엔진 및 워크플로우 실행을 활성화할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 엔진 및 워크플로우를 사용합니다.
    • false: 엔진 및 워크플로우를 활성화하지 않습니다.
    표 13. 반환
    유형 설명
    문자열 카탈로그 클라이언트 스크립트의 Sys_id입니다.

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    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)

    정의된 카탈로그 클라이언트 스크립트를 삭제합니다.

    표 14. 매개변수
    이름 유형 설명
    sys_id 문자열 카탈로그 클라이언트 스크립트의 Sys_id입니다.
    표준 업데이트 부울 엔진 및 워크플로우 실행을 활성화할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 엔진 및 워크플로우를 사용합니다.
    • false: 엔진 및 워크플로우를 활성화하지 않습니다.
    표 15. 반환
    유형 설명
    void

    다음 예는 카탈로그 클라이언트 스크립트를 삭제하는 방법을 보여줍니다.

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

    CatalogClientScript - setAttributes(맵 속성)

    카탈로그 클라이언트 스크립트의 속성 값을 정의합니다.

    표 16. 매개변수
    이름 유형 설명
    속성 맵 필드와 값 쌍에 대한 매핑이 있는 JSON 객체입니다.
    표 17. 반환
    유형 설명
    void

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    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)

    카탈로그 항목을 카탈로그 클라이언트 스크립트와 연결합니다.

    표 18. 매개변수
    이름 유형 설명
    sys_id 문자열 카탈로그 항목의 Sys_id입니다.
    표 19. 반환
    유형 설명
    void

    이 예시에서는 카탈로그 항목을 현재 카탈로그 클라이언트 스크립트와 연결하는 방법을 보여줍니다.

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

    CatalogClientScript - setOnChangeVariable(문자열 sys_id)

    변수 값이 업데이트되면 카탈로그 클라이언트 스크립트를 실행합니다.

    표 20. 매개변수
    이름 유형 설명
    sys_id 문자열 변수의 Sys_id입니다.
    표 21. 반환
    유형 설명
    void

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    CatalogClientScript - setVariableSet(문자열 sys_id)

    변수 세트를 카탈로그 클라이언트 스크립트와 연결합니다.

    표 22. 매개변수
    이름 유형 설명
    sys_id 문자열 변수 세트의 Sys_id입니다.
    표 23. 반환
    유형 설명
    void

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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