위젯 옵션 스키마

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • 위젯 인스턴스를 사용하면 사용자가 페이지에 추가하는 각 위젯을 고유하게 구성할 수 있습니다. 옵션 스키마를 사용하여 위젯의 매개변수를 정의합니다.

    인스턴스 옵션 저장

    위젯을 개발할 때 옵션 스키마를 편집하여 위젯에 대한 매개변수를 만들거나 인스턴스 옵션을 저장할 테이블을 만들 수 있습니다. 기존 옵션 스키마를 편집하는 경우 정의된 모든 인스턴스 옵션은 sp_instance 테이블의 추가 옵션, JSON 형식 필드에 JSON 형식으로 저장됩니다. 다음과 같은 필드 유형을 사용할 수 있습니다.

    • 문자열
    • 부울
    • 정수
    • 참조
    • 선택
    • Field_list(테이블에 따라 다름)
    • Field_name(테이블에 따라 다름)
    • Glide_list

    옵션 스키마에서 지원되지 않는 다른 필드 유형을 사용하려면 사용자 지정 위젯 옵션 스키마를 저장할 확장 테이블을 만듭니다. 테이블을 사용하면 다음을 수행할 수 있습니다.

    • 고급 커스터마이제이션이 있는 필드를 포함한 모든 ServiceNow 필드 유형을 옵션 스키마에 추가합니다.
    • 복잡한 옵션 스키마를 정의합니다.
    • 인스턴스 옵션을 검색하고 필터링합니다.
    주:
    테이블에서 옵션을 저장하면 더 복잡한 옵션을 정의할 수 있지만, 이 방법은 옵션 스키마를 편집하는 것보다 유지보수가 더 어렵습니다. 불필요한 테이블을 생성하고 위젯에 추가 서버 호출을 추가하지 않도록 하기 위해 가급적이면 기존 옵션 스키마를 편집하십시오. 복잡하거나 검색 가능한 옵션이 필요할 때만 테이블에 옵션을 저장하십시오.

    위젯에서 옵션 사용

    options 전역 변수를 사용하여 클라이언트 스크립트와 서버 스크립트 모두에서 위젯의 옵션에 액세스합니다. options.optionName을 사용하여 위젯 클라이언트 스크립트 또는 서버 스크립트의 모든 옵션 값에 액세스할 수 있습니다.

    클라이언트 스크립트 
    function() {
  /* widget controller */
  var c = this;
    console.log(c.options.text_color) //Outputs the text_color option for this instance
}
    서버 스크립트 
    (function() {
     $sp.log(options.text_color) //Logs the value of the text_color option to the browser console.
})();

    기본 옵션 정의

    인스턴스에 옵션 값이 설정되기 전에 해당 옵션 변수에 액세스할 때 정의되지 않은 값으로 나타납니다. 위젯 서버 스크립트를 사용하여 옵션의 기본값을 지정합니다.

    (function() {
  options.text_color=options.text_color||"blue";
  options.maximum_entry_count=options.maximum_entry_count||5;
})

    위젯 옵션 스키마 편집

    위젯 인스턴스를 사용하면 사용자가 페이지에 추가하는 각 위젯을 고유하게 구성할 수 있습니다. 옵션 스키마를 편집하여 위젯의 기본 매개변수를 정의합니다.

    시작하기 전에

    새 위젯을 복제하거나 작성해야 합니다.

    필요한 역할: admin 또는 sp_admin

    프로시저

    1. 다음으로 이동 모두 > 서비스 포털 > 서비스 포털 구성 > 위젯 편집기.
    2. 옵션 스키마를 구성할 위젯을 선택합니다.
    3. 메뉴 아이콘( 메뉴 아이콘)을 클릭하고 옵션 스키마 편집을 선택합니다.
      이 옵션은 위젯을 편집할 수 있는 권한이 있는 사용자에게만 표시됩니다.
    4. +를 클릭하여 위젯 옵션을 추가합니다.
    5. 레이블, 이름, 유형, 힌트 및 양식 섹션을 정의합니다.

      선택한 유형에 따라 더 많은 필드가 표시됩니다.

      유연한 위젯 옵션을 추가하면 재사용 가능한 위젯을 더 많이 만들 수 있습니다. 사용자가 각 위젯 옵션을 이해할 수 있도록 기본값을 추가할 수 있습니다. 양식 섹션을 선택하지 않으면 기본값은 기타 옵션으로 설정됩니다.

      위젯 옵션 다음과 같이 필드가 완료된 스키마 양식: 레이블=시간대, 이름=영역, 유형=문자열, 힌트=공백, 기본값=아메리카/덴버
    6. 저장을 클릭합니다.
      정의한 옵션 스키마는 sp_widget 테이블의 옵션 스키마 필드에 JSON 형식으로 저장됩니다. 이 옵션 스키마를 기반으로 위젯의 각 인스턴스는 개별적으로 정의된 인스턴스 옵션을 사용할 수 있습니다.
    7. 디자이너의 페이지에 서비스 포털 위젯을 추가하여 옵션 스키마를 테스트합니다.
      1. 다음으로 이동 서비스 포털 > 서비스 포털 구성 > 서비스 포털 디자이너.
      2. 위젯을 페이지에 추가하고 위젯 인스턴스에서 편집 아이콘을 클릭하여 인스턴스 옵션을 봅니다.
      3. 위젯 인스턴스 옵션을 구성합니다.
      4. sp_instance 테이블의 인스턴스 기록으로 이동하여 구성을 봅니다.
        인스턴스 옵션은 추가 옵션, JSON 형식 필드에 JSON 형식으로 저장됩니다.

    테이블에 인스턴스 옵션 저장

    기존 옵션 스키마를 편집하는 대신 위젯 인스턴스 옵션을 저장할 테이블을 생성합니다. 테이블을 위젯 옵션 스키마로 사용하는 경우 모든 ServiceNow 필드 유형을 사용하여 사용자 지정 필드를 정의하고, 필드에 필터를 추가하고, 인스턴스 옵션을 검색 또는 쿼리할 수 있습니다.

    시작하기 전에

    필요한 역할: admin 또는 sp_admin

    이 태스크 정보

    사용자 지정 옵션 스키마를 정의하려면 sp_instance 확장 테이블에 필드를 추가한 다음 확장 테이블을 데이터 소스로 사용하도록 위젯을 설정합니다. 확장 테이블을 사용하면 다음을 수행할 수 있습니다.

    • 고급 커스터마이제이션이 있는 필드를 포함한 모든 ServiceNow 필드 유형을 옵션 스키마에 추가합니다.
    • 복잡한 위젯 옵션을 정의합니다.
    • 인스턴스 옵션을 검색하고 필터링합니다.
    주:
    테이블에서 옵션을 저장하면 더 복잡한 옵션을 정의할 수 있지만, 이 방법은 옵션 스키마를 편집하는 것보다 유지보수가 더 어렵습니다. 불필요한 테이블을 생성하고 위젯에 추가 서버 호출을 추가하지 않도록 하기 위해 가급적이면 기존 옵션 스키마를 편집하십시오. 복잡하거나 검색 가능한 옵션이 필요할 때만 테이블에 옵션을 저장하십시오.

    프로시저

    1. 사용자 지정 옵션 스키마를 저장하기 위해 sp_instance 테이블을 확장하는 테이블을 생성합니다.
      1. 다음으로 이동 시스템 정의 > 테이블.
      2. 새로 만들기를 클릭합니다.
      3. 레이블과 이름을 정의합니다.
      4. 테이블 확장 필드에서 필요한 필드를 제공하는 sp_instance 테이블을 선택합니다.
        인스턴스 테이블 설명
        인스턴스 [sp_instance] 기본 인스턴스 필드를 포함합니다.
        테이블이 있는 인스턴스 [sp_instance_table] sp_instance 필드와 테이블 및 필터와 같은 테이블 데이터를 표시하는 필드가 포함됩니다.
      5. 양식을 저장합니다.
    2. 확장 테이블에서 사용자 지정 필드를 정의합니다.
      열 목록에 새 열을 추가하여 옵션 스키마에 사용할 필드 유형을 정의할 수 있습니다.
    3. 확장 테이블을 데이터 소스로 사용하도록 위젯을 업데이트합니다.
      1. 다음으로 이동 서비스 포털 > 위젯.
      2. 사용자 지정 옵션을 생성할 위젯을 엽니다.
      3. 데이터 테이블 필드에서 sp_instance 확장 테이블을 선택합니다.
        카드 목록 데이터 테이블 필드에서 선택된 인스턴스 확장 테이블입니다.
    4. 원하는 필드를 표시하도록 확장 테이블 양식을 구성합니다.
      양식에 구성된 필드는 인스턴스 옵션으로 사용할 수 있습니다.
      1. 확장 테이블 양식으로 이동합니다. <인스턴스>/<your_extenstion_table>.do.
      2. 헤더 메뉴를 마우스 오른쪽 버튼으로 클릭하고 구성 > 양식 레이아웃.
      3. 양식에 필드를 추가합니다.
      4. 저장을 클릭합니다.
    5. 원하는 필드를 인스턴스 옵션으로 표시하도록 위젯을 구성합니다.
      1. 다음으로 이동 서비스 포털 > 위젯.
      2. 확장 테이블이 데이터 소스로 설정된 위젯을 엽니다.
      3. 필드 슬러시버킷을 사용하여 인스턴스 옵션으로 표시할 필드를 선택합니다.
        내 사용자 지정 필드가 선택됨 열로 이동되었습니다.
      4. 양식을 저장합니다.

    다음에 수행할 작업

    디자이너의 페이지에 서비스 포털 위젯을 추가하여 옵션 스키마를 테스트합니다. 위젯 인스턴스에서 편집 아이콘을 클릭하여 인스턴스 옵션을 봅니다. 위젯 인스턴스 옵션을 구성한 후 sp_instance 확장 테이블의 인스턴스 기록으로 이동하여 구성을 봅니다.