동적 자바스크립트 필터

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

    • 지정된 값 대신 보고서 시각화 기준의 일부로 구성할 수 있는 동적 조건을 JavaScript에서 생성합니다.

    동적 조건문을 사용하여 보고서를 만들려면 필터의 조건부 값 문에 JavaScript URL을 배치합니다. JavaScript 명령을 필드에 직접 입력할 수 있지만 명령문보다 긴 스크립트의 경우 스크립트를 자체 기록에 배치해야 합니다. 그런 다음 보고서 조건의 값 필드에 있는 해당 레코드에서 함수를 호출합니다.

    동적 자바스크립트 필터 추가

    보고서 시각화 필터 기준의 일부로 평가할 동적 JavaScript 문을 추가합니다.

    시작하기 전에

    필요한 역할: itil, report_user, report_group, report_global, report_admin 또는 admin. 의미 있는 보고서를 작성하려면 보고하려는 데이터에 액세스할 수 있는 권한이 있어야 합니다.

    이 태스크 정보

    JavaScript 필터는 한 줄 문 또는 더 긴 스크립트일 수 있습니다. 더 긴 JavaScript 문의 경우 올바른 형식 및 데이터 형식을 반환하고, 보고서에서 필터링해야 하는 특정 데이터를 준수하고, 클라이언트 호출이 가능한 스크립트 포함을 만듭니다. 자세한 내용은 스크립트 포함을 참조하십시오.

    프로시저

    1. 다음으로 이동 모두 > 보고서 > 보기/실행레이블이 표시됩니다.
    2. 동적 필터를 추가할 보고서 시각화를 엽니다.
    3. 필터 아이콘()을 선택하여 조건 작성기를 확장합니다.
    4. 필터 조건을 생성합니다.
      이러한 필드 유형 및 연산자 조합을 사용하여 동적 JavaScript 문을 지정할 수 있습니다.
      주:
      • "between" 연산자는 동일하거나 다른 JavaScript URL을 지원할 수 있는 두 개의 필드를 제공합니다.
      • "is" 연산자는 예상 형식의 데이터 요소 배열을 반환할 수 있습니다. 이 경우 연산자는 "is one of" 연산자로 처리됩니다.
      필드 유형 허용되는 연산자 예상 반환 데이터 유형
      시스템 ID(GUID) "is", "is not", "is one of", "starts with", "ends with", "contains", "does not contain", "between", "greater than or is", "less than or is". 전체 또는 부분 sys_id 값의 텍스트 표현입니다.

      "is one of" 연산자의 경우 예상되는 반환 형식은 쉼표로 구분된 sys_id 값 목록 또는 결과에 포함되어야 하는 각 sys_id 포함하는 배열입니다.
      자유 텍스트 문자열 "is", "is not", "is one of", "starts with", "ends with", "contains", "does not contain", "between", "greater than or is", "less than or is" 하나 이상의 텍스트 문자입니다. "is one of" 연산자의 경우 예상 결과는 쉼표로 구분된 문자열 값 목록 또는 "is one of" 검색 값 필드에 포함할 각 값을 포함하는 배열입니다.
      참조 "다음으로 시작", "다음으로 끝남", "포함", "포함하지 않음" 테이블 또는 데이터 소스의 이 필드에 있는 값의 일부 또는 일부를 나타낼 수 있는 하나 이상의 텍스트 문자입니다.
      문자열(다른 테이블 참조) "포함", "다음으로 시작", "다음으로 끝남", "포함하지 않음" 테이블 또는 데이터 소스의 이 필드에 있는 값의 일부 또는 일부를 나타낼 수 있는 하나 이상의 텍스트 문자입니다.
      사용자 입력 "다음과 같음", "일치하지 않음" 테이블 또는 데이터 소스의 이 필드에 대한 일부 기록의 전체 값을 나타낼 수 있는 텍스트 문자입니다.
      테이블 이름 "is", "is not", "is one of", "starts with", "ends with", "contains", "does not contain", "between", "greater than or is", "less than or is" 시스템의 전체 또는 부분 테이블 이름에 대한 텍스트 표현입니다. "is one of" 연산자의 경우 예상되는 반환 형식은 쉼표로 구분된 Table Name 값 목록 또는 결과에 포함되어야 하는 각 Table Name을 포함하는 배열입니다.
      템플릿 값 "다음과 같음", "일치하지 않음" 인스턴스에 있는 템플릿에 따라 값을 충족하는 텍스트 문자입니다.
      도메인 ID "다음으로 시작", "다음으로 끝남", "포함", "포함하지 않음" 테이블 또는 데이터 소스의 도메인 필드에 있는 값의 일부 또는 일부를 나타낼 수 있는 하나 이상의 텍스트 문자입니다.
      사용자 역할 "다음과 같음", "일치하지 않음" 사용자 역할 문자열 값의 텍스트 표현입니다.
      도메인 경로 "다음으로 시작", "다음으로 끝남", "포함", "포함하지 않음", "같음", "일치하지 않음", "다음 중 하나", "보다 작거나 같음", "보다 크거나 같음", "사이" 테이블 또는 데이터 소스의 이 필드에 있는 값의 일부 또는 일부를 나타낼 수 있는 하나 이상의 텍스트 문자입니다. "is one of" 연산자의 경우 쉼표로 구분된 텍스트 값 목록 또는 포함해야 하는 각 값을 포함하는 배열 개체입니다.
      번역된 텍스트 "is", "is not", "is one of", "starts with", "ends with", "contains", "does not contain", "between", "greater than or is", "less than or is" 텍스트 값입니다.

      "is one of" 연산자의 경우 예상되는 반환 형식은 쉼표로 구분된 텍스트 값 목록 또는 텍스트 값 배열입니다.
      번역된 필드
      HTML "포함", "포함하지 않음" 이 보고서 기준에서 선택한 필드의 데이터에 해당할 수 있는 텍스트 값입니다.
      HTML 템플릿
      이메일 스크립트 "포함", "포함하지 않음" 이메일 스크립트 필드에 있어야 하는(또는 없어야 하는) 값을 나타내는 텍스트 값입니다.
      스크립트(일반) "포함", "포함하지 않음" 스크립트 필드에 있어야 하거나 없어야 하는 값을 나타내는 텍스트 값입니다.
      스크립트(서버 측)
      스크립트
      약식 테이블 이름 "다음과 같음", "일치하지 않음" 텍스트 값(40자 미만)

      "is one of" 연산자의 경우 예상되는 반환 형식은 쉼표로 구분된 텍스트 값 목록 또는 짧은 테이블 이름을 나타내는 각 텍스트 문자를 포함하는 배열입니다.
      필드 이름 "is", "is not", "is one of", "starts with", "ends with", "contains", "does not contain", "between", "greater than or is", "less than or is" 전체 또는 일부 필드 이름 값의 텍스트 표현입니다.

      "is one of" 연산자의 경우 예상되는 반환 형식은 쉼표로 구분된 필드 이름 값 목록 또는 결과에 포함되어야 하는 각 필드 이름을 포함하는 배열입니다.
    5. 필드 유형과 연산자를 선택하고 JavaScript 문을 입력합니다.
      • 한 줄 JavaScript 문의 경우 javascript:<JavaScript_Statement>; 형식을 사용합니다.
      • 스크립트 포함을 호출하는 JavaScript 문의 경우에는 javascript:new <Record_Name>().<Function_Name>() 형식을 사용합니다. 여기서 Record_Name 는 스크립트 포함의 레코드 이름에 해당하고 Function_Name 는 필터에서 비교한 값을 반환하는 스크립트 포함의 함수입니다.
      주:
      Javascript URL에는 계산을 수행하고 결과를 반환하는 함수에 전달된 하나 이상의 매개 변수도 포함될 수 있습니다. 예를 들어, 스크립트 포함 기록에 두 개의 매개 변수를 전달하는 JavaScript 함수는 javascript:new TextJSFilter().getGroupIDs("Professional Services","Sales");로 작성될 수 있습니다.

    다음에 수행할 작업

    필요한 JavaScript 문과 조건을 추가하고 보고서의 나머지 부분을 구성한 후 보고서를 테스트하여 예상 결과가 반환되고 표시되는지 확인합니다.