동적 JavaScript 필터

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분

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

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

    동적 JavaScript 필터 추가

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

    시작하기 전에

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

    이 태스크 정보

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

    프로시저

    1. 다음 작업 중 하나를 수행합니다.
      • 로 완전히 마이그레이션 플랫폼 분석되지 않은 업그레이드된 인스턴스에서 다음으로 이동합니다. 모두 > 보고서 > 보기/실행.
      • 새 인스턴스 또는 완전히 마이그레이션 플랫폼 분석된 인스턴스에서 다음으로 이동합니다. 모두 > 플랫폼 분석 관리 > 사용량 및 거버넌스 > 보고서.
    2. 동적 필터를 추가할 보고서 시각화를 엽니다.
    3. 필터 아이콘()을 선택하여 조건 작성기를 확장합니다.
    4. 필터 조건을 구성합니다.
      이러한 필드 유형 및 연산자 조합을 사용하여 동적 JavaScript 문을 지정할 수 있습니다.
      주:
      • "between" 연산자는 동일하거나 다른 JavaScript URL을 지원할 수 있는 두 개의 필드를 제공합니다.
      • "is" 연산자는 예상 형식의 데이터 요소 배열을 반환할 수 있습니다. 이 경우 연산자는 "다음 중 하나" 연산자로 처리됩니다.
      필드 유형 허용되는 연산자 예상 반환 데이터 유형
      시스템 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 값의 텍스트 표현입니다.

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

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

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

      "다음 중 하나" 연산자의 경우 예상되는 반환 형식은 쉼표로 구분된 필드 이름 값 목록 또는 결과에 포함되어야 하는 각 필드 이름을 포함하는 배열입니다.
    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 문과 조건을 추가하고 보고서의 나머지 부분을 구성한 후 보고서를 테스트하여 예상한 결과를 반환하고 표시하는지 확인합니다.