보고서 개발 developing-reports

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

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

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

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

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

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

결과 집합에서 실행할 수 있는 작업은 RDBMS 개념과 비슷합니다. 주로 grouping 및 aggregation ​입니다.

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

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

데이터의 기본 결과 집합을 전달하는 query의 정의를 유지합니다.

보고서에 추가된 모든 열(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
 ]

admin 사용자가 마지막으로 수정한 모든 textimage 구성 요소를 반환합니다.

nodeTypes

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

mandatoryProperties

지정된 속성이 모두 ​인 노드로 결과 집합을 제한합니다. 속성 값이 다음에 대해 고려되지 않습니다.

settings

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

• active

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

  • id

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

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

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

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

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

property

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

속성이 String[] (으)로 정의된 경우 실제 값을 찾기 위해 여러 속성을 차례로 검사합니다.

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

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

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

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

subPath

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

secondaryProperty

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

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

secondarySubPath

secondaryProperty을(를) 사용하는 경우 subPath와 비슷합니다.

resolver

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

• const

  값을 다른 값에 매핑합니다. 예를 들어 해당 값 English에 대한 en과(와) 같은 상수를 확인하는 데 사용됩니다.

• default

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

• page

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

• path

  필요한 경우 하위 경로를 추가하고 확인된 경로에서 노드의 속성(resolverConfig(으)로 정의됨)에서 실제 값을 가져와서 경로 값을 확인합니다. 예를 들어 /content/.../page/jcr:content의 path을(를) jcr:title 속성의 콘텐츠로 확인할 수 있습니다. 이는 페이지 경로가 페이지 제목으로 확인됨을 의미합니다.

• pathextension

  경로 앞에 추가하고 확인된 경로에 있는 노드의 속성에서 실제 값을 가져와 값을 확인합니다. 예를 들어 language 속성에서 값을 가져와 /libs/wcm/core/resources/languages 같은 경로 앞에 de 값을 추가하여 국가 코드 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

전처리는 선택 사항이며 처리 단계 apply 또는 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

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

• type

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

  • count

    행 수를 계산합니다.

  • count-nonempty

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

  • min

    최소값을 제공합니다.

  • max

    최대값을 제공합니다.

  • average

    평균 값을 제공합니다.

  • sum

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

  • median

    중간값을 제공합니다.

  • percentile95

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

aggregate

유효한 aggregate 값은 aggregates의 type과(와) 같습니다(열 특정 정의(정의 - 필터/집계) 참조).

열의 definition 노드의 type 속성을 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 아래에 있는 경우에 적합합니다.

/apps/<yourProject>/reports 패턴을 사용하는 보고서에 대한 /etc/designs/<yourProject>/reports/<*yourReport*>

components

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

sling:resourceType

값이 cq/reporting/components/repparsys인 속성입니다.

sling:resourceType을(를) cq/reporting/components/reportpage(으)로 설정

사용할 디자인 표시

sling:resourceType 속성이 있는 컨테이너( reportbase) 구성 요소를 참조하는 report 자식 노드를 만듭니다.

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

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

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

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

일별 스냅숏 ​은(는) 일별 스냅숏을 만들 시간을 정의합니다. 지정한 시간이 서버의 로컬 시간대에 있습니다.

시간별 스냅숏 ​은(는) 시간별 스냅숏이 만들어지는 각 시간의 분을 정의합니다.

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

가짜 데이터(사용하도록 설정된 경우) fakedata 선택기를 사용하여 가짜 내역 데이터를 만들 수 있습니다. 사용하지 않도록 설정된 경우 fakedata 선택기를 사용하면 예외가 발생합니다.

데이터가 가짜이므로 테스트 및 디버깅을 위해 only ​을(를) 사용해야 합니다.

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

스냅숏 사용자 ​는 스냅숏을 만드는 데 사용할 수 있는 선택적 사용자를 정의합니다.

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

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

스냅숏 사용자 적용(사용하도록 설정된 경우), 스냅숏 사용자 ​에 지정된 사용자로 모든 스냅숏을 만듭니다. 이 경우 올바르게 처리되지 않을 경우 심각한 보안 문제가 발생할 수 있습니다.