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

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • 클라이언트측 스크립트는 폼에 동적 효과와 유효성 검사를 추가할 수 있습니다. 스크립트는 서비스 카탈로그 항목 또는 변수 세트에 적용될 수 있으며, 이에 따라 관리자는 다른 양식에서 사용 가능한 기능을 동일하게 사용할 수 있습니다.

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

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

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

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

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