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

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기4분
  • 클라이언트측 스크립트는 양식에 동적 효과와 유효성 검사를 추가할 수 있습니다. 스크립트는 서비스 카탈로그 항목 또는 변수 세트에 적용할 수 있으며, 이를 통해 관리자는 다른 양식에서 제공되는 것과 동일한 기능을 사용할 수 있습니다.

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

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

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

    카탈로그 클라이언트 스크립트를 생성할 때는 다음 고려사항을 염두에 두어야 합니다.

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