보고서 개발 developing-reports

이러한 보고서는 보고 프레임워크를 기반으로 구축됩니다.

• 구성 요소 보고서
• 페이지 활동 보고서
• 사용자 보고서
• 워크플로우 상속 보고서

다음 보고서는 개별 원칙을 기반으로 하므로 확장할 수 없습니다.

• 디스크 사용량
• 상태 검사
• 워크플로우 보고서

이는 전적으로 CQ5 QueryBuilder에서 실행한 쿼리에서 반환되는 결과 세트를 기반으로 합니다.

결과 세트는 보고서에 표시되는 데이터를 정의합니다. 결과 세트의 각 행은 보고서의 표 형식 뷰에 있는 행에 해당합니다.

결과 세트에서 실행할 수 있는 작업은 RDBMS 개념과 유사합니다. 그룹화 및 집계.

대부분의 데이터 검색 및 처리는 서버측에서 수행됩니다.

사전 처리된 데이터를 표시할 책임은 전적으로 클라이언트에게 있습니다. 작은 처리 작업(예: 셀 콘텐츠에 링크 만들기)만 클라이언트측에서 실행됩니다.

의 정의를 유지합니다. 쿼리 는 기본 데이터 결과 세트를 제공합니다.

모든 열( columnbase)이 보고서에 추가되었습니다.

사용 가능한 차트 유형과 현재 활성화된 차트 유형을 정의합니다.

사용자가 보고서의 특정 측면을 구성할 수 있는 편집 대화 상자를 정의합니다.

의 일부로 정의됩니다. reportbase 구성 요소.

을(를) 기반으로 함 CQ QueryBuilder.

보고서의 기반으로 사용되는 데이터를 검색합니다. 결과 세트(테이블)의 각 행은 쿼리에서 반환된 대로 노드에 연결됩니다. 특정 정보 개별 열 그런 다음 이 데이터 세트에서 추출됩니다.

일반적으로 다음으로 구성됩니다.

• 루트 경로.

  검색할 저장소의 하위 트리를 지정합니다.

  성능에 미치는 영향을 최소화하려면 쿼리를 저장소의 특정 하위 트리로 제한(시도)하는 것이 좋습니다. 루트 경로는 다음 위치에 사전 정의될 수 있습니다. 보고서 템플릿 또는에서 사용자에 의해 설정됨 구성(편집) 대화 상자.

• 하나 이상의 기준.

  이는 (초기) 결과 세트를 생성하기 위해 적용되며, 예를 들어 노드 유형에 대한 제한 또는 속성 제한을 포함합니다.

기본 결과 집합에서 값 추출 및 유도

예를 들어 두 속성 간의 차이를 계산하여 두 속성 값을 단일 값으로 처리할 수 있습니다.

추출된 값 해결. 이 작업은 다양한 방법으로 수행할 수 있습니다.

예를 들어, 경로는 (각각의 더 사람이 읽을 수 있는 콘텐츠에서처럼) 제목에 매핑될 수 있습니다 jcr:title 속성)을 참조하십시오.

다양한 지점에서 필터 적용.

필요한 경우 조합 값 생성.

예를 들어, 사용자에게 표시되는 텍스트, 정렬에 사용할 값 및 링크를 만드는 데 사용되는 (클라이언트측에서) 추가 URL로 구성됩니다.

propertyConstraints

특정 값을 가진 특정 속성이 있는 노드로 결과 세트를 제한합니다. 여러 개의 구속을 지정한 경우 노드는 모든 구속을 만족해야 합니다(AND 작업).

예:

N:propertyConstraints
 [
 N:0
 P:sling:resourceType
 P:foundation/components/textimage
 N:1
 P:jcr:modifiedBy
 P:admin
 ]

모두 반환 textimage 에서 마지막으로 수정한 구성 요소 admin 사용자.

nodeTypes

결과 집합을 지정된 노드 유형으로 제한하는 데 사용됩니다. 여러 노드 유형을 지정할 수 있습니다.

mandatoryProperties

다음을 포함하는 노드로 결과 집합 제한 모두 지정한 속성입니다. 속성 값이 다음에 대해 고려되지 않습니다.

settings

활성 차트에 대한 정의를 저장합니다.

• active

  여러 설정을 정의할 수 있으므로 이 옵션을 사용하여 현재 활성화된 설정을 정의할 수 있습니다. 이러한 노드는 노드 배열로 정의됩니다. 이러한 노드에 대해 강제 명명 규칙이 없지만 표준 보고서는 종종 를 사용합니다 0, 1… x), 각 속성은 다음 속성을 갖습니다.

  • id

    활성 차트에 대한 식별. 차트 중 하나의 ID와 일치해야 합니다. definitions.

definitions

보고서에 사용할 수 있는 차트 유형을 정의합니다. 다음 definitions 사용할 대상 은 active 설정.

노드 배열을 사용하여 정의를 지정합니다(다시 이라고도 함) 0, 1… x), 각 속성은 다음과 같은 속성을 갖습니다.

• id

  차트의 식별.

• type

  사용 가능한 차트 유형. 다음 중에서 선택:

  • pie
    파이 차트 현재 데이터에서만 생성됩니다.

  • lineseries
    일련의 선(실제 스냅샷을 나타내는 점을 연결함). 내역 데이터에서만 생성됩니다.

• 차트 유형에 따라 추가 등록 정보를 사용할 수 있습니다.

  • 차트 유형에 대해 pie:

    • maxRadius ( Double/Long)

      파이 차트에 허용되는 최대 반경. 따라서 차트에 허용되는 최대 크기(범례 없음). 다음과 같은 경우 무시됨 fixedRadius 이(가) 정의되었습니다.

    • minRadius ( Double/Long)

      파이 차트에 허용되는 최소 반경입니다. 다음과 같은 경우 무시됨 fixedRadius 이(가) 정의되었습니다.

    • fixedRadius ( Double/Long) 원형 차트의 고정 반경을 정의합니다.

  • 차트 유형에 대해 lineseries:

    • totals ( Boolean)

      True이면 추가 줄에 합계 표시되어야 합니다.
      기본값: false

    • series ( Long)

      표시할 라인/시리즈의 수입니다.
      기본값: 9 (또한 허용되는 최대값입니다.)

    • hoverLimit ( Long)

      팝업이 표시될 최대 집계된 스냅샷 수(각 수평선에 점이 표시되어 고유한 값을 나타냄) 즉, 사용자가 차트 범례에서 고유 값 또는 해당 레이블을 마우스로 가리키면 표시됩니다.

      기본값: 35 (즉, 현재 차트 설정에 35개 이상의 고유 값을 적용할 수 있는 경우에는 팝업이 전혀 표시되지 않습니다.)

      동시에 표시할 수 있는 추가 팝업은 10개로 제한됩니다(범례 텍스트를 마우스로 가리키면 여러 팝업이 표시될 수 있음).

title

/libs/cq/reporting/components/commons/title

보고서 제목을 정의하는 텍스트 필드.

description

/libs/cq/reporting/components/commons/description

보고서 설명을 정의하는 텍스트 영역입니다.

processing

/libs/cq/reporting/components/commons/processing

보고서의 처리 모드에 대한 선택기(수동으로/자동으로 데이터 로드).

scheduling

/libs/cq/reporting/components/commons/scheduling

기록 차트의 스냅샷을 예약하기 위한 선택기입니다.

rootPath

이렇게 하면 보고서가 저장소의 특정 섹션(트리 또는 하위 트리)으로 제한되는데, 이것은 성능 최적화에 권장됩니다. 루트 경로는 rootPath 의 속성 report 각 보고서 페이지의 노드(페이지 생성 시 템플릿에서 가져옴).

다음을 통해 지정할 수 있습니다.

• 다음 보고서 템플릿 ( 구성 대화 상자의 고정 값 또는 기본값으로).
• 사용자(이 매개 변수 사용)

property

실제 셀 값을 계산하는 데 사용할 속성을 정의합니다.

속성이 문자열로 정의된 경우[], 여러 속성을 차례로 스캔하여 실제 값을 찾습니다.

예를 들어 다음과 같은 경우:

property = [ "jcr:lastModified", "jcr:created" ]

해당 값 추출기(여기서 제어):

• 사용 가능한 jcr:lastModified 속성이 있는지 확인하고 있는 경우 이 속성을 사용합니다.
• 사용 가능한 jcr:lastModified 속성이 없으면 jcr:created의 콘텐츠가 대신 사용됩니다.

subPath

결과가 쿼리에서 반환된 노드에 없는 경우 subPath 는 속성이 있는 위치를 정의합니다.

secondaryProperty

실제 셀 값을 계산하는 데 사용해야 하는 두 번째 속성입니다. 이 정의는 특정 열 유형(비교 및 정렬 가능)에만 사용됩니다.

예를 들어 워크플로 인스턴스 보고서가 있는 경우 지정된 속성은 시작 시간과 종료 시간 사이의 시간 차이(밀리초)의 실제 값을 저장하는 데 사용됩니다.

secondarySubPath

다음과 같은 경우 subPath와 유사 secondaryProperty 를 사용합니다.

resolver

사용할 확인자를 정의합니다. 다음 해결자를 사용할 수 있습니다.

• const

  값을 다른 값에 매핑합니다. 예를 들어, 다음과 같은 상수를 확인하는 데 사용됩니다. en 해당 값으로 English.

• default

  기본 해결자입니다. 이것은 실제로 아무것도 해결하지 않는 더미 해결자입니다.

• page

  해당 페이지의 경로에 대한 경로 값을 확인합니다. 더 정확히 말하면 해당 페이지에 대한 경로 값 jcr:content 노드. 예를 들어, /content/.../page/jcr:content/par/xyz 이(가) (으)로 확인됨 /content/.../page/jcr:content.

• path

  필요에 따라 하위 경로를 추가하고 노드의 속성에서 실제 값을 가져와 경로 값 확인(에 의해 정의됨) resolverConfig)을 클릭하여 제품에서 사용할 수 있습니다. 예: path / /content/.../page/jcr:content 을(를) 의 콘텐츠로 확인할 수 있습니다. jcr:title 즉, 페이지 경로가 페이지 제목으로 확인됩니다.

• pathextension

  경로 앞에 추가하고 확인된 경로에 있는 노드의 속성에서 실제 값을 가져와 값을 확인합니다. (예: 값) de 다음과 같은 경로 앞에 붙을 수 있습니다. /libs/wcm/core/resources/languages, 속성에서 값 가져오기 language를 클릭하여 국가 코드를 확인합니다 de 언어 설명으로 German.

resolverConfig

해결자에 대한 정의를 제공합니다. 사용 가능한 옵션은 다음에 따라 다릅니다. resolver 선택됨:

• const

  속성을 사용하여 해결할 상수를 지정합니다. 속성의 이름은 확인할 상수를 정의하고, 속성의 값은 확인된 값을 정의합니다.

  예를 들어 이름= 1 및 값 =One 1에서 1로 확인됩니다.

• default

  사용 가능한 구성이 없습니다.

• page

  • propertyName (옵션)

    값 확인에 사용해야 하는 속성의 이름을 정의합니다. 지정하지 않으면 기본값은 jcr:title (페이지 제목)이 사용됩니다. page 확인자: 즉, 첫 번째 경로가 페이지 경로로 확인된 다음 페이지 제목으로도 확인됩니다.

• path

  • propertyName (옵션)

    값 확인에 사용해야 하는 속성의 이름을 지정합니다. 지정하지 않으면 기본값은 jcr:title 를 사용합니다.

  • subPath (옵션)

    이 속성을 사용하여 값을 확인하기 전에 경로에 추가할 접미사를 지정할 수 있습니다.

• pathextension

  • path (필수)

    앞에 추가할 경로를 정의합니다.

  • propertyName (필수)

    실제 값이 있는 해결된 경로의 속성을 정의합니다.

  • i18n (선택 사항, 부울 입력)

    해결된 값이 다음이 되어야 하는지 여부를 결정합니다. 다국어화됨 (즉, CQ5의 국제화 서비스).

preprocessing

전처리는 선택 사항이며 처리 단계에 (별도로) 바인딩할 수 있습니다 적용 또는 applyAfter:

• apply

  초기 전처리 단계(처리 큐 표시 단계 3).

• applyAfter

  사전 처리 후 적용(처리 큐 표시의 9단계).

원래 값:

원래 값에 대한 사전 처리 정의가 다음에서 지정됩니다. apply 및/또는 applyAfter 직접.

집계된 상태의 값:

필요한 경우, 각각의 응집에 대해 별개의 정의가 제공될 수 있다.

집계된 값에 대한 명시적 사전 처리를 지정하려면 사전 처리 정의가 각각 상주해야 합니다 aggregated 하위 노드( apply/aggregated, applyAfter/aggregated). 개별 합계에 대한 명시적 사전 처리가 필요한 경우 사전 처리 정의는 각 합계의 이름이 있는 하위 노드에 있습니다(예: apply/aggregated/min/max 또는 기타 집계).

패턴 찾기 및 바꾸기
찾으면 지정된 패턴(정규 표현식으로 정의됨)이 다른 패턴으로 바뀝니다. 예를 들어, 이 패턴을 사용하여 원본의 하위 문자열을 추출할 수 있습니다.

데이터 유형 포맷터

숫자 값을 상대 문자열로 변환합니다. 예를 들어 "1시간의 시간 차이를 나타내는 값은 다음과 같은 문자열로 확인됩니다. 1:24PM (1 hour ago).

pattern

하위 문자열을 찾는 데 사용되는 정규 표현식입니다.

replace

원래 문자열의 대체 문자열로 사용되는 문자열 또는 문자열 표현입니다. 종종 정규 표현식에 의해 위치한 문자열의 하위 문자열을 나타냅니다. pattern.

노드의 경우 definitions/data/preprocessing/apply (다음 두 가지 속성 포함)

• pattern: (.*)(/jcr:content)(/|$)(.*)
• replace: $1

문자열은 다음과 같이 도착합니다.

• /content/geometrixx/en/services/jcr:content/par/text

다음 네 개의 섹션으로 분류됩니다.

• $1 - (.*) - /content/geometrixx/en/services
• $2 - (/jcr:content) - /jcr:content
• $3 - (/|$) - /
• $4 - (.*) - par/text

및 가 로 표시된 문자열로 대체되었습니다. $1:

• /content/geometrixx/en/services

format

데이터 형식 포맷터:

• duration

  기간은 정의된 두 날짜 사이의 시간 범위입니다. 예를 들어, 2/13/11 11:23h에서 시작하여 1시간 후 2/13/11 12:23h에 끝나는 1시간이 걸린 워크플로 작업의 시작 및 끝입니다.

  숫자 값(밀리초로 해석됨)을 기간 문자열로 변환합니다. 예: 30000 은(는) 로 포맷되었습니다. 30s.

• datedelta

  Datadelta는 과거 날짜부터 "지금"까지의 시간 범위입니다(따라서 나중에 보고서를 볼 경우 다른 결과가 표시됨).

  숫자 값(일 단위 시간 차이로 해석됨)을 상대적 날짜 문자열로 변환합니다. 예를 들어 1의 형식은 하루 전으로 지정됩니다.

type

다음은 표준 옵션으로 사용할 수 있습니다.

• string

• number

• int

• date

• diff

• timeslot

  합계에 필요한 날짜 중 일부를 추출하는 데 사용됩니다(예: 연도별 그룹화하여 각 연도의 데이터를 집계함).

• sortable

  정렬 및 표시에 다른 값(다른 속성에서 가져옴)을 사용하는 값에 사용됩니다.

또한 위의 모든 값은 다중 값으로 정의할 수 있습니다. 예: string[] 는 문자열의 배열을 정의합니다.

값 추출기는 열 유형에 의해 선택됩니다. 열 유형에 값 추출기를 사용할 수 있는 경우 이 추출기가 사용됩니다. 그렇지 않으면 기본값 추출기가 사용됩니다.

형식은 매개 변수를 사용할 수 있습니다(선택적). 예를 들어, timeslot:year 날짜 필드에서 연도를 추출합니다. 매개 변수가 있는 형식:

• timeslot - 값은 의 해당 상수와 비슷합니다. java.utils.Calendar.

  • timeslot:year - Calendar.YEAR
  • timeslot:month-of-year - Calendar.MONTH
  • timeslot:week-of-year - Calendar.WEEK_OF_YEAR
  • timeslot:day-of-month - Calendar.DAY_OF_MONTH
  • timeslot:day-of-week - Calendar.DAY_OF_WEEK
  • timeslot:day-of-year - Calendar.DAY_OF_YEAR
  • timeslot:hour-of-day - Calendar.HOUR_OF_DAY
  • timeslot:minute-of-hour - Calendar.MINUTE

groupable

보고서를 이 열로 그룹화할 수 있는지 여부를 정의합니다.

filters

필터 정의.

• filterType

  사용 가능한 필터는 다음과 같습니다.

  • string

    문자열 기반 필터입니다.

• id

  필터 식별자.

• phase

  사용 가능한 단계:

  • raw

    필터가 원시 데이터에 적용됩니다.

  • preprocessed

    필터가 사전 처리된 데이터에 적용됩니다.

  • resolved

    필터는 해결된 데이터에 적용됩니다.

aggregates

합계 정의.

• text

  집계의 텍스트 이름입니다. If text 을 지정하지 않으면 집계의 기본 설명이 사용됩니다. 예를 들어, minimum 다음에 사용됩니다. min 합계.

• type

  집계 유형. 사용 가능한 합계는 다음과 같습니다.

  • count

    행 수를 계산합니다.

  • count-nonempty

    비어 있지 않은 행의 수를 계산합니다.

  • min

    최소값을 제공합니다.

  • max

    최대값을 제공합니다.

  • average

    평균 값을 제공합니다.

  • sum

    모든 값의 합계를 제공합니다.

  • median

    중간값을 제공합니다.

  • percentile95

    모든 값의 95번째 백분위수를 사용합니다.

aggregate

유효 aggregate 값은 와 동일합니다. type 아래에 aggregates (참조 열별 정의(정의 - 필터/합계) ).

설정 type 열의 속성 definition 노드 대상 generic.

다음을 참조하십시오 /libs/cq/reporting/components/userreport/genericcol/definitions

열의 아래에 (표준) 대화 상자 정의를 지정합니다. definition 노드.

다음을 참조하십시오 /libs/cq/reporting/components/userreport/genericcol/definitions/dialog

• 대화 상자의 필드는 해당 구성 요소 속성의 경로 등 동일한 이름을 참조해야 합니다.

  예를 들어, 대화 상자를 통해 일반 열의 유형을 구성할 수 있도록 하려면 ./definitions/type.

• UI/대화 상자를 사용하여 정의된 속성이 columnbase 구성 요소.

구성 편집을 정의합니다.

다음을 참조하십시오 /libs/cq/reporting/components/userreport/genericcol/cq:editConfig

표준 AEM 방법론을 사용하여 (추가적인) 열 속성을 정의합니다.

구성 요소 인스턴스와 열 인스턴스 둘 다에 정의된 속성의 경우 열 인스턴스의 값이 우선합니다.

일반 열에 사용할 수 있는 등록 정보는 다음과 같습니다.

• jcr:title - 열 이름
• definitions/aggregates - 집계
• definitions/filters - 필터
• definitions/type- 열 유형(선택기/콤보 상자 또는 숨겨진 필드를 사용하여 대화 상자에서 정의해야 함)
• definitions/data/resolver 및 definitions/data/resolverConfig (그러나 아님) definitions/data/preprocessing 또는 .../clientFilter) - 해결 프로그램 및 구성
• definitions/queryBuilder - 쿼리 빌더 구성
• defaults/aggregate - 기본 집계

원본 열의 새 인스턴스가 사용자 보고서, 대화 상자로 정의된 속성은 아래에서 유지됩니다.

/etc/reports/userreport/jcr:content/report/columns/genericcol/settings/generic

/etc/designs/reports/<yourReport> 보고서가 아래에 있는 경우 적합 /apps/cq/reporting

/etc/designs/<yourProject>/reports/<*yourReport*> 를 사용하는 보고서용 /apps/<yourProject>/reports 패턴

components

보고서에서 허용되는 모든 구성 요소 및/또는 구성 요소 그룹.

sling:resourceType

값이 있는 속성 cq/reporting/components/repparsys.

설정 sling:resourceType 끝 cq/reporting/components/reportpage

사용할 디자인 표시

만들기 report 컨테이너를 참조하는 하위 노드( reportbase가 있는 ) 구성 요소 sling:resourceType 속성

시간대 은 시간대의 내역 데이터가 생성되는 시간을 정의합니다. 이는 기록 차트가 전 세계의 각 사용자에 대해 동일한 데이터를 표시하도록 하기 위한 것입니다.

로케일 사용할 로케일을 정의합니다. 시간대 기록 데이터. 로케일은 로케일별 일정 설정(예: 첫 번째 요일이 일요일인지 월요일인지 여부)을 결정하는 데 사용됩니다.

스냅샷 경로 기록 차트에 대한 스냅샷이 저장되는 루트 경로를 정의합니다.

보고서 경로 보고서가 있는 경로를 정의합니다. 스냅샷 서비스에서 실제로 스냅샷을 생성할 보고서를 결정하는 데 사용됩니다.

일별 스냅샷 일별 스냅숏을 만드는 시간을 정의합니다. 지정한 시간이 서버의 로컬 시간대에 있습니다.

시간별 스냅샷 시간별 스냅샷을 생성할 각 시간의 분을 정의합니다.

행 수(최대) 각 스냅샷에 대해 저장되는 최대 행 수를 정의합니다. 이 값은 합리적으로 선택해야 합니다. 너무 높으면 저장소 크기에 영향을 주고 너무 낮으면 내역 데이터가 처리되는 방식 때문에 데이터가 정확하지 않을 수 있습니다.

가짜 데이터, 활성화된 경우 다음을 사용하여 가짜 내역 데이터를 만들 수 있습니다. fakedata 선택기: 비활성화되면 fakedata 선택기에서 예외가 발생합니다.

데이터가 가짜이기 때문에 전용 테스트 및 디버깅 목적으로 사용됩니다.

사용 fakedata 선택기가 보고서를 암시적으로 완료하므로 기존 데이터가 모두 손실됩니다. 데이터를 수동으로 복원할 수 있지만, 이렇게 하면 많은 시간이 소요될 수 있습니다.

스냅샷 사용자 는 스냅샷 촬영에 사용할 수 있는 선택적 사용자를 정의합니다.

기본적으로 보고서를 완료한 사용자에 대해 스냅샷이 작성됩니다. 대신 사용되는 대체 사용자를 지정하려는 상황(예: 게시 시스템에서 이 사용자가 존재하지 않으며 해당 계정이 복제되지 않음)이 있을 수 있습니다.

또한 사용자를 지정하면 보안 위험이 발생할 수 있습니다.

스냅샷 사용자 적용, 활성화된 경우 아래에 지정된 사용자가 모든 스냅샷을 만듭니다. 스냅샷 사용자. 이 경우 올바르게 처리되지 않을 경우 심각한 보안 문제가 발생할 수 있습니다.