카탈로그 클라이언트 스크립트

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분
  • 클라이언트측 스크립트는 폼에 동적 효과와 유효성 검사를 추가할 수 있습니다. 스크립트는 서비스 카탈로그 항목이나 변수 세트에 적용하여 관리자가 다른 양식에서 사용 가능한 것과 동일한 기능을 사용할 수 있도록 합니다.

    클라이언트 측 스크립트를 사용하여 다음을 수행할 수 있습니다.

    • 변수 값을 가져오거나 설정합니다.
    • 변수를 숨기거나 표시합니다.
    • 변수를 필수로 설정할지 여부를 결정합니다.
    • 양식 제출을 확인합니다.
    • 카트에 항목을 추가합니다.
    • 즉시 주문하십시오.

    카탈로그 클라이언트 스크립트 고려 사항

    카탈로그 클라이언트 스크립트를 만들 때는 다음 사항을 고려해야 합니다.

    • 카탈로그 클라이언트 스크립트는 사용자가 서비스 카탈로그에서 항목을 주문할 때 실행됩니다. 카탈로그 클라이언트 스크립트는 사용자가 해당 항목을 요청할 때 카탈로그 항목에 대한 변수 또는 변수 세트가 표시될 때도 실행할 수 있습니다.
    • 카탈로그 클라이언트 스크립트를 사용하여 변수에 액세스할 수 있으려면 변수 이름이 있어야 합니다. 이름이 없는 변수는 사용 가능한 변수 목록에 나타나지 않습니다.
    • 요청된 항목 또는 카탈로그 작업 양식에서 표준 클라이언트 스크립트를 사용하는 경우 변수와 이름이 같은 필드를 적어둡니다. 테이블 필드와 같은 이름의 변수가 모두 양식에 있는 경우 스크립트를 사용하여 액세스할 때 테이블 필드가 일치합니다. 이 경우 변수의 이름을 variables.variable name으로 지정하여 구체적으로 해결하십시오. 예: g_form.setValue('variables.replacement', 'false');
    • 기록 생성자를 사용하여 서비스 카탈로그에서 다른 유형의 기록으로 변수를 전달하는 경우, 이러한 변수는 변경 요청 양식의 변경 변수 편집기 UI 포매터와 같은 변수 편집기를 통해 해당 기록에 표시됩니다. setDisplay, setMandatory, setValuegetValue와 같은 표준 클라이언트 스크립트 메서드를 사용하여 이러한 변수를 조작할 수 있습니다.
    • 카탈로그 클라이언트 스크립트는 마법사에 포함된 카탈로그 항목에 사용할 수 있습니다.
    • g_form.refreshSlushbucket(fieldName) API를 사용하여 목록 수집기 변수를 업데이트할 수 있습니다.

    카탈로그 클라이언트 스크립트 차이점

    카탈로그 클라이언트 스크립트는 표준 클라이언트 스크립트와 매우 유사하지만 몇 가지 중요한 차이점이 있습니다.

    • 스크립트에 대한 인시던트와 같은 테이블을 선택하는 대신, 카탈로그 항목이나 변수 세트를 선택합니다. 시스템에 카탈로그 항목 수가 많을 수 있으므로 표준 클라이언트 스크립트 양식에서 사용하는 선택 목록 대신 참조 필드를 사용하여 카탈로그 항목 또는 변수 세트를 선택해야 합니다.
    • onChange() 카탈로그 클라이언트 스크립트를 사용할 때는 필드 대신 특정 변수에 연결됩니다. 선택한 카탈로그 항목 또는 변수 세트에서 명명된 변수를 사용하여 변수 이름 선택 목록이 자동으로 채워집니다.

    카탈로그 클라이언트 스크립트 생성

    다음 절차에 따라 카탈로그 클라이언트 스크립트를 만드십시오.

    프로시저

    1. 다음으로 이동 모두 > 서비스 카탈로그 > 카탈로그 관리 > 카탈로그 클라이언트 스크립트.
      현재 사용자 지정 카탈로그 클라이언트 스크립트 목록이 나타납니다.
    2. 새로 만들기를 클릭합니다.
    3. 필드에 적절한 정보를 입력합니다(표 참조).
      필드 설명
      이름 카탈로그 클라이언트 스크립트의 고유한 이름을 입력합니다.
      적용 대상 이 클라이언트 스크립트가 적용되는 항목 유형을 선택합니다.
      • 카탈로그 항목: 카탈로그 항목 필드를 활성화합니다.
      • 변수 세트: 변수 세트 필드를 활성화합니다.
      활성 클라이언트 스크립트를 사용하려면 확인란을 선택합니다. 스크립트를 사용 중지하려면 확인란 선택을 취소합니다.
      UI 유형 이를 데스크톱, 모바일 또는 둘 다에 적용할지 여부입니다.
      스크립트 서비스 카탈로그 항목에서 실행할 클라이언트 스크립트를 입력합니다.
      유형 스크립트를 실행할 시기( onLoad 또는 onSubmit)를 선택합니다.
      카탈로그 항목 또는 변수 세트 목록에서 카탈로그 항목 또는 변수 세트를 선택합니다. 사용 가능한 필드 이름과 옵션은 적용 대상 필드의 선택 항목에 따라 달라집니다.
      카탈로그 항목 뷰에 적용 서비스 카탈로그의 주문 화면 내에 표시된 카탈로그 항목에 카탈로그 클라이언트 스크립트를 적용하려면 확인란을 선택합니다. 요청자 뷰에서 사용할 수 있습니다.
      요청 항목에 적용 항목이 요청된 후 요청된 항목 양식에 카탈로그 클라이언트 스크립트를 적용하려면 이 확인란을 선택합니다. 이행자 뷰에서 사용할 수 있습니다. VEditor 를 참조하십시오.
      카탈로그 작업에 적용 항목에 대한 카탈로그 작업 양식이 표시될 때 카탈로그 클라이언트 스크립트를 적용하려면 확인란을 선택합니다. 이행자 뷰에서 사용할 수 있습니다. VEditor 를 참조하십시오.
      대상 기록에 적용 기록 생성자를 통해 작업 확장 테이블에 대해 생성된 기록에서 카탈로그 UI 정책을 지원하려면 이 확인란을 선택합니다. 기본 변수 편집기 를 참조하십시오 .
    4. 제출을 클릭합니다.

    카탈로그 클라이언트 스크립트 예시

    일반적인 작업을 수행하는 클라이언트 스크립트의 예입니다.

    변수 값 가져오기

    다음 구문을 사용하여 카탈로그 변수의 값을 가져옵니다. 변수에는 이름이 있어야 합니다. variable_name 변수 이름으로 바꿉니다.

    g_form.getValue('variable_name');

    사용자가 변수에 입력할 수 있는 문자 수 제한

    항목이 주문될 때가 아니라 변수가 표시될 때 실행되는 스크립트의 예입니다.

    function onLoad(){
      var sd = g_form.getControl('short_description');
      sd.maxLength=80;
    }