- 개발 사용 안내서 개요
- 개발자를 위한 소개
- 플랫폼
- 구성 요소
- 헤드리스 환경 관리
- 개발 도구
- 개인화
- AEM 확장
- 테스트
- 우수 사례
- 모바일 웹
보고서 개발
AEM에서는 보고 프레임워크를 기반으로 하는 표준 보고서 중에서 선택할 수 있습니다.
프레임워크를 사용하여 이러한 표준 보고서를 확장하거나 완전히 새로운 보고서를 개발할 수 있습니다. 보고 프레임워크는 기존 CQ5 개념 및 원칙과 긴밀하게 통합되어 있으므로 개발자는 CQ5에 대한 기존 지식을 보고서 개발을 위한 발판으로 사용할 수 있습니다.
AEM과 함께 제공되는 표준 보고서의 경우:
-
이러한 보고서는 보고 프레임워크를 기반으로 구축됩니다.
-
다음 보고서는 개별 원칙을 기반으로 하므로 확장할 수 없습니다.
자습서 Creating Your Own Report - An Example에서는 아래 원칙 중 몇 개를 사용할 수 있는지 보여줍니다.
표준 보고서를 참조하여 다른 구현 예를 볼 수도 있습니다.
다음 표기법 아래의 예와 정의에서 사용됩니다.
-
각 라인은 다음과 같은 노드 또는 속성을 정의합니다.
-
N:<name> [<nodeType>]
<*name*> 이름과 <*nodeType*>노드 유형의 노드를 설명합니다.
P:<name> [<propertyType]
<*name*> 이름과 <*propertyType*> 속성 유형의 속성을 설명합니다.
P:<name> = <value>
<value> 값으로 설정해야 하는 속성 <name>에 대해 설명합니다.
- 들여쓰기는 노드 사이의 계층 종속성을 표시합니다.
- 항목을 | 는 가능한 항목의 목록을 나타냅니다.예를 들어 유형 또는 이름은 다음과 같습니다.
예:String|String[]은 속성이 String 또는 String[]일 수 있음을 의미합니다.
[]배열을 나타냅니다.예: [] 쿼리 정의에서와 같이 문자열 또는 노드 배열.
별도로 명시되어 있지 않는 한 기본 유형은 다음과 같습니다.
- 노드 -
nt:unstructured - 속성 -
String
보고 프레임워크
보고 프레임워크는 다음 원칙을 기반으로 합니다.
-
CQ5 QueryBuilder에서 실행하는 쿼리에서 반환된 결과 집합을 기반으로 합니다.
-
결과 세트는 보고서에 표시되는 데이터를 정의합니다. 결과 세트의 각 행은 보고서의 표 형식 보기에 있는 행에 해당합니다.
-
결과 세트에서 실행할 수 있는 작업은 RDBMS 개념과 유사합니다.기본적으로 그룹화 및 집계입니다.
-
대부분의 데이터 검색 및 처리는 서버측에서 수행됩니다.
-
클라이언트는 전처리 데이터를 표시하는 전적인 책임을 집니다. 간단한 처리 작업(예: 셀 컨텐츠에서 링크 만들기)만 클라이언트측에서 실행됩니다.
보고 프레임워크(표준 보고서의 구조로 표시됨)는 처리 큐에서 제공하는 다음 구성 블록을 사용합니다.
보고서 페이지
보고서 페이지:
- 표준 CQ5 페이지입니다.
- 보고서](#report-template)에 대해 구성된 [표준 CQ5 템플릿을 기반으로 합니다.
보고서 기준
reportbase 구성 요소는 다음과 같은 보고서의 기초를 형성합니다.
-
데이터의 기본 결과 집합을 제공하는 쿼리의 정의를 보유합니다.
-
보고서에 추가된 모든 열(
columnbase)을 포함하는 수정된 단락 시스템입니다. -
사용 가능한 차트 유형과 현재 활성 상태인 차트 유형을 정의합니다.
-
사용자가 보고서의 특정 측면을 구성할 수 있는 편집 대화 상자를 정의합니다.
열 기준
각 열은 다음과 같은 columnbase 구성 요소의 인스턴스입니다.
- 각 보고서의 parsys(
reportbase)에서 사용하는 단락입니다. - 기본 결과 세트;즉, 이 결과 집합 내에서 참조되는 특정 데이터와 처리 방법을 정의합니다.
- 추가 정의 포함;사용 가능한 집계 및 필터와 모든 기본값을 함께 사용합니다.
쿼리 및 데이터 검색
쿼리:
-
reportbase구성 요소의 일부로 정의됩니다. -
은 CQ QueryBuilder을 기반으로 합니다.
-
보고서의 기반으로 사용되는 데이터를 검색합니다. 결과 집합(테이블)의 각 행은 쿼리에서 반환한 노드에 연결됩니다. 그런 다음 이 데이터 세트에서 개별 열에 대한 특정 정보가 추출됩니다.
-
일반적으로 다음 항목으로 구성됩니다.
-
루트 경로입니다.
검색할 저장소의 하위 트리를 지정합니다.
성능 영향을 최소화하려면 쿼리를 저장소의 특정 하위 트리로 제한하는 것이 좋습니다(시도). 루트 경로는 보고서 템플릿에서 사전 정의되거나 구성(편집) 대화 상자에서 사용자가 설정할 수 있습니다.
-
이러한 항목은 (초기) 결과 집합을 만들기 위해 지정됩니다.여기에는 노드 유형에 대한 제한 사항 또는 속성 제한이 포함됩니다.
-
여기에서 중요한 점은 쿼리의 결과 세트에서 반환되는 각 단일 노드가 보고서에서 단일 행을 생성하는 데 사용된다는 것입니다(따라서 1:1 관계).
개발자는 보고서에 대해 정의된 쿼리가 해당 보고서에 적합한 노드 집합을 반환하도록 해야 합니다. 하지만 노드 자체에서 필요한 정보를 모두 보유할 필요는 없으며 부모 및/또는 하위 노드에서도 파생될 수 있습니다. 예를 들어 사용자 보고서에 사용되는 쿼리는 노드 유형을 기준으로 노드를 선택합니다(이 경우 rep:user). 그러나 이 보고서의 대부분의 열은 이러한 노드에서 직접 데이터를 가져오지 않고 하위 노드 profile에서 데이터를 가져옵니다.
처리 큐
쿼리는 보고서의 행으로 표시할 데이터 결과 집합을 반환합니다. 결과 세트의 각 행은 보고서에 표시하기 위해 클라이언트로 전송되기 전에(서버측) 여러 단계에서 처리됩니다.
이를 통해 다음을 수행할 수 있습니다.
-
기본 결과 집합에서 값을 추출하고 추출합니다.
예를 들어 두 속성 간의 차이를 계산하여 두 속성 값을 단일 값으로 처리할 수 있습니다.
-
추출된 값 해결;이것은 다양한 방법으로 할 수 있다.
예를 들어, 경로는 제목에 매핑할 수 있습니다(각 jcr:title 속성의 보다 사람이 읽을 수 있는 내용).
-
다양한 지점에서 필터 적용
-
필요한 경우 복합 값을 만듭니다.
예를 들어, 사용자에게 표시되는 텍스트로 구성된 경우 정렬에 사용할 값과 링크를 만드는 데 사용되는 추가 URL(클라이언트측)을 나타냅니다.
처리 큐워크플로
다음 워크플로우는 처리 큐를 나타냅니다.
처리 큐 단계
자세한 단계 및 요소는 다음과 같습니다.
-
초기 쿼리(reportbase)에서 반환된 결과를 값 추출기를 사용하여 기본 결과 세트로 변환합니다.
값 추출기는 열 유형에 따라 자동으로 선택됩니다. 기본 JCR 쿼리에서 값을 읽고 이러한 JCR 쿼리에서 결과 집합을 만드는 데 사용됩니다.이후 추가 처리가 적용될 수 있습니다. 예를 들어
diff유형의 경우 값 extractor는 두 개의 속성을 읽고 결과 세트에 추가되는 단일 값을 계산합니다. 값 추출기를 구성할 수 없습니다. -
원시 데이터를 포함하는 초기 결과 세트에 대해 초기 필터링(raw 단계)이 적용됩니다.
-
값은 사전 처리된;입니다.apply 단계에 대해 정의된 바와 같습니다.
-
사전 처리 단계에 할당된 필터링 ** (사전 처리된 값에 할당됨)은 사전 처리된 값에 대해 실행됩니다.
-
값이 확인됩니다.정의된 해결 프로그램에 따라).
-
해결 단계에 ** 지정됨)은 해결된 값에 대해 실행됩니다.
-
데이터는 그룹화되고 집계된 입니다.
-
배열 데이터는 (문자열 기반) 목록으로 변환하여 결정됩니다.
다중 값 결과를 표시할 수 있는 목록으로 변환하는 암시적 단계입니다.다중 값 JCR 속성을 기반으로 하는 (집계되지 않은) 셀 값에 필요합니다.
-
값이 다시 사전 처리된;을(를) afterApply 단계에 대해 정의됨.
-
데이터가 정렬됩니다.
-
처리된 데이터가 클라이언트로 전송됩니다.
기본 데이터 결과 집합을 반환하는 초기 쿼리는 reportbase 구성 요소에 정의됩니다.
처리 큐의 다른 요소는 columnbase 구성 요소에 정의됩니다.
보고서 구성 및 구성
보고서를 구성하고 구성하는 데 다음 사항이 필요합니다.
- 보고서 구성 요소 정의에 사용할 위치
-
reportbase구성 요소 - 하나 이상의
columnbase구성 요소 - 페이지 구성 요소
- 보고서 디자인
- 보고서 템플릿
보고서 구성 요소위치
기본 보고 구성 요소는 /libs/cq/reporting/components 아래에 있습니다.
그러나 이러한 노드를 업데이트하지 말고 /apps/cq/reporting/components 아래에 사용자 고유의 구성 요소 노드를 만들거나 보다 적절한 /apps/<yourProject>/reports/components 아래에 설정하는 것이 좋습니다.
여기서(예):
N:apps
N:cq [nt:folder]
N:reporting|reports [sling:Folder]
N:components [sling:Folder]
이 아래에서 보고서의 루트를 만들고 이 아래에서 보고서 기본 구성 요소와 열 기본 구성 요소를 만듭니다.
N:apps
N:cq [nt:folder]
N:reporting|reports [sling:Folder]
N:components [sling:Folder]
N:<reportname> [sling:Folder]
N:<reportname> [cq:Component] // report base component
N:<columnname> [cq:Component] // column base component
페이지 구성 요소
보고서 페이지는 /libs/cq/reporting/components/reportpage의 sling:resourceType을 사용해야 합니다.
사용자 지정된 페이지 구성 요소는 필요하지 않습니다(대부분의 경우).
보고서 기본 구성 요소
각 보고서 유형에는 /libs/cq/reporting/components/reportbase에서 파생된 컨테이너 구성 요소가 필요합니다.
이 구성 요소는 보고서의 컨테이너 역할을 하며 다음에 대한 정보를 제공합니다.
- 쿼리 정의입니다.
- 보고서 구성을 위한 (선택 사항) 대화 상자.
- 보고서에 통합된 Charts입니다.
N:<reportname> [cq:Component]
P:sling:resourceSuperType = "cq/reporting/components/reportbase"
N:charting
N:dialog [cq:Dialog]
N:queryBuilder
쿼리 정의
N:queryBuilder
N:propertyConstraints
[
N:<name> // array of nodes (name irrelevant), each with the following properties:
P:name
P:value
]
P:nodeTypes [String|String[]]
P:mandatoryProperties [String|String[]
]
-
propertyConstraints특정 값이 있는 특정 속성을 갖는 노드로 결과 집합을 제한하는 데 사용할 수 있습니다. 여러 제약 조건을 지정한 경우 노드는 모든 제약 조건(AND 작업)을 충족해야 합니다.
예:
N:propertyConstraints [ N:0 P:sling:resourceType P:foundation/components/textimage N:1 P:jcr:modifiedBy P:admin ]admin사용자가 마지막으로 수정한 모든textimage구성 요소를 반환합니다. -
nodeTypes결과 집합을 지정된 노드 유형으로 제한하는 데 사용됩니다. 여러 노드 유형을 지정할 수 있습니다.
-
mandatoryProperties결과 집합을 지정된 속성의 모두가 있는 노드로 제한하는 데 사용할 수 있습니다. 속성 값은 고려되지 않습니다.
모두 선택 사항이며 필요에 따라 결합할 수 있지만, 둘 중 적어도 하나를 정의해야 합니다.
차트 정의
N:charting
N:settings
N:active [cq:WidgetCollection]
[
N:<name> // array of nodes, each with the following property
P:id // must match the id of a child node of definitions
]
N:definitions [cq:WidgetCollection]
[
N:<name> // array of nodes, each with the following properties
P:id
P:type
// additional, chart type specific configurations
]
-
settings활성 차트에 대한 정의를 보유합니다.
-
active여러 설정을 정의할 수 있으므로 이 설정을 사용하여 현재 활성 상태인 설정을 정의할 수 있습니다. 노드 배열로 정의됩니다(이러한 노드에 대한 필수 이름 지정 규칙은 없지만, 표준 보고서에서는 종종
0,1을 사용합니다.x). 각 속성:-
id활성 차트에 대한 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)Total을 보여주는 추가 라인이 표시되어야 하는 경우 true입니다.
기본값:false -
series(Long)표시할 라인/시리즈 수입니다.
default:9(허용되는 최대 한도이기도 함) -
hoverLimit(Long)사용자가 차트 범례에서 고유한 값 또는 해당 레이블을 마우스로 가리키면 팝업을 표시할 팝업을 각 가로 행에 표시하는 점으로 집계된 최대 스냅샷 수(개별 값을 나타내는 점)입니다.
default:
35(즉, 현재 차트 설정에 35개 이상의 고유 값을 적용할 수 있는 경우 팝업이 표시되지 않습니다.)동시에 표시할 수 있는 팝업은 10개로 제한됩니다(범례 텍스트를 마우스로 가리키면 여러 팝업이 표시될 수 있음).
-
-
-
구성 대화 상자
모든 보고서에는 구성 대화 상자가 있어 사용자가 보고서에 대한 다양한 매개 변수를 지정할 수 있습니다. 이 대화 상자는 보고서 페이지가 열릴 때 편집 단추를 통해 액세스할 수 있습니다.
이 대화 상자는 표준 CQ 대화 상자이며 이와 같이 구성할 수 있습니다(자세한 내용은 CQ.Dialog 참조).
예제 대화 상자의 모양은 다음과 같습니다.
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0"
jcr:primaryType="cq:Dialog"
height="{Long}424">
<items jcr:primaryType="cq:WidgetCollection">
<props jcr:primaryType="cq:Panel">
<items jcr:primaryType="cq:WidgetCollection">
<title
jcr:primaryType="cq:Widget"
path="/libs/cq/reporting/components/commons/title.infinity.json"
xtype="cqinclude"/>
<description
jcr:primaryType="cq:Widget"
path="/libs/cq/reporting/components/commons/description.infinity.json"
xtype="cqinclude"/>
<rootPath
jcr:primaryType="cq:Widget"
fieldLabel="Root path"
name="./report/rootPath"
rootPath=""
rootTitle="Repository root"
xtype="pathfield"/>
<processing
jcr:primaryType="cq:Widget"
path="/libs/cq/reporting/components/commons/processing.infinity.json"
xtype="cqinclude"/>
<scheduling
jcr:primaryType="cq:Widget"
path="/libs/cq/reporting/components/commons/scheduling.infinity.json"
xtype="cqinclude"/>
</items>
</props>
</items>
</jcr:root>
미리 구성된 여러 구성 요소가 제공됩니다.이 속성은 cqinclude 값이 있는 xtype 속성을 사용하여 대화 상자에서 참조할 수 있습니다.
-
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내역 차트에 대한 스냅샷을 예약하는 선택기입니다.
참조된 구성 요소는 .infinity.json 접미어를 사용하여 포함되어야 합니다(위 예 참조).
루트 경로
또한 보고서에 대한 루트 경로를 정의할 수 있습니다.
-
rootPath성능 최적화를 위해 권장되는 저장소의 특정 섹션(트리 또는 하위 트리)으로 보고서를 제한합니다. 루트 경로는 각 보고서 페이지의
report노드의rootPath속성에 의해 지정됩니다(페이지 생성 시 템플릿에서 가져옴).다음 방법으로 지정할 수 있습니다.
- 보고서 템플릿(고정 값 또는 구성 대화 상자의 기본값으로).
- 사용자(이 매개 변수 사용)
열 기본 구성 요소
각 열 유형에는 /libs/cq/reporting/components/columnbase에서 파생된 구성 요소가 필요합니다.
열 구성 요소는 다음 조합을 정의합니다.
- 열 특정 쿼리 구성
- 해상도 및 사전 처리.
- 열 특정 정의(필터 및 집계와 같은)
definitions하위 노드). - 열 기본값.
- 서버에서 반환된 데이터에서 표시할 정보를 추출하는 클라이언트 필터.
- 또한 열 구성 요소는
cq:editConfig의 적절한 인스턴스를 제공해야 합니다. 이벤트 및 작업이(가) 필요합니다. - 일반 열에 대한 구성입니다.
N:<columnname> [cq:Component]
P:componentGroup
P:jcr:title
P:sling:resourceSuperType = "cq/reporting/components/columnbase"
N:cq:editConfig [cq:EditConfig] // <a href="#events-and-actions">Events and Actions</a>
N:defaults // <a href="#column-default-values">Column Default Values</a>
N:definitions
N:queryBuilder // <a href="#column-specific-query">Column Specific Query</a>
P:property [String|String[]] // Column Specific Query
P:subPath // Column Specific Query
P:secondaryProperty [String|String[]] // Column Specific Query
P:secondarySubPath // Column Specific Query
N:data
P:clientFilter [String] // <a href="#client-filter">Client Filter</a>
P:resolver // <a href="#resolvers-and-preprocessing">Resolvers and Preprocessing</a>
N:resolverConfig // Resolvers and Preprocessing
N:preprocessing // Resolvers and Preprocessing
P:type // <a href="#column-specific-definitions">Column Specific Definitions</a>
P:groupable [Boolean] // Column Specific Definitions
N:filters [cq:WidgetCollection] // Column Specific Definitions
N:aggregates [cq:WidgetCollection] // Column Specific Definitions
새 보고서 정의도 참조하십시오.
열 특정 쿼리
개별 열에 사용할 특정 데이터 추출(보고서 데이터 결과 세트)을 정의합니다.
N:definitions
N:queryBuilder
P:property [String|String[]]
P:subPath
P:secondaryProperty [String|String[]]
P:secondarySubPath
-
property실제 셀 값을 계산하는 데 사용할 속성을 정의합니다.
속성이 String[]으로 정의된 경우 여러 속성을 스캔하여 실제 값을 찾습니다.
예를 들면 다음과 같습니다.
property = [ "jcr:lastModified", "jcr:created" ]해당 값 추출기(여기에서 제어)는 다음과 같습니다.
- 사용할 수 있는 jcr:lastModified 속성이 있는지 확인하고 있는 경우 사용합니다.
- 사용할 수 있는 jcr:lastModified 속성이 없으면 jcr:created의 내용이 대신 사용됩니다.
-
subPath쿼리가 반환하는 노드에 결과가 없으면
subPath은 속성이 실제로 있는 위치를 정의합니다. -
secondaryProperty실제 셀 값을 계산하는 데도 사용해야 하는 두 번째 속성을 정의합니다.특정 열 유형(diff 및 정렬 가능)에만 사용됩니다.
예를 들어 워크플로우 인스턴스 보고서의 경우 지정된 속성을 사용하여 시작 시간과 종료 시간 사이의 시간 차이(밀리초)의 실제 값을 저장합니다.
-
secondarySubPathsecondaryProperty이(가) 사용될 때 subPath와 유사합니다.
대부분의 경우 property만 사용됩니다.
클라이언트 필터
클라이언트 필터는 서버에서 반환된 데이터에서 표시할 정보를 추출합니다.
이 필터는 전체 서버측 처리가 적용된 후 클라이언트측에서 실행됩니다.
N:definitions
N:data
P:clientFilter [String]
clientFilter 는 다음과 같은 JavaScript 함수로 정의됩니다.
- 입력으로 하나의 매개 변수를 받습니다.서버에서 반환된 데이터(완전히 미리 처리됨)
- 출력에서 필터링된(처리된) 값을 반환합니다.입력 정보에서 추출되거나 파생된 데이터
다음 예제에서는 구성 요소 경로에서 해당 페이지 경로를 추출합니다.
function(v) {
var sepPos = v.lastIndexOf('/jcr:content');
if (sepPos < 0) {
return v;
}
return v.substring(sepPos + '/jcr:content'.length, v.length);
}
해상도 및 사전 처리
처리 큐는 다양한 해상도를 정의하고 사전 처리를 구성합니다.
N:definitions
N:data
P:resolver
N:resolverConfig
N:preprocessing
N:apply
N:applyAfter
-
resolver사용할 해결 프로그램을 정의합니다. 다음 해상도를 사용할 수 있습니다.
-
const값을 다른 값으로 매핑;예를 들어, 이 값은
en와 같은 상수를 해당 값English으로 확인하는 데 사용됩니다. -
default기본 해결 프로그램. 이 확인기는 실제로 아무 것도 해결하지 못하는 더미 확인기입니다.
-
page적절한 페이지의 경로에 대한 경로 값을 확인합니다.보다 정확하게 해당
jcr:content노드에 연결합니다. 예를 들어/content/.../page/jcr:content/par/xyz은(는)/content/.../page/jcr:content로 확인됩니다. -
path선택적으로 하위 경로를 추가하고 처리된 경로에서 노드의 속성(예:
resolverConfig에 의해 정의)에서 실제 값을 가져와 경로 값을 해결합니다. 예를 들어/content/.../page/jcr:content의path을jcr:title속성의 내용으로 확인할 수 있습니다. 이는 페이지 경로가 페이지 제목으로 확인됨을 의미합니다. -
pathextension경로를 프리pending하고 해결된 경로의 노드 속성에서 실제 값을 가져와 값을 확인합니다. 예를 들어,
de값은/libs/wcm/core/resources/languages속성language의 값을 가져와 언어 설명German에 대한 국가 코드de를 확인하기 위한 경로 앞에 추가할 수 있습니다.
-
-
resolverConfig해결 프로그램에 대한 정의를 제공합니다.사용 가능한 옵션은 선택한
resolver에 따라 다릅니다.-
const확인할 상수를 지정하려면 속성을 사용합니다. 속성 이름은 확인할 상수를 정의합니다.속성 값은 해결된 값을 정의합니다.
예를 들어 Name=
1및 Value=One의 속성은 1을 1로 확인합니다. -
default구성을 사용할 수 없습니다.
-
page-
propertyName(옵션)값을 확인하는 데 사용할 속성의 이름을 정의합니다. 지정하지 않으면 jcr:title(페이지 제목)의 기본값이 사용됩니다.
page해결 프로그램의 경우, 이 경로는 먼저 페이지 경로로 확인되고 이후 페이지 제목으로 확인됨을 의미합니다.
-
-
path-
propertyName(옵션)값을 확인하는 데 사용할 속성의 이름을 지정합니다. 지정하지 않으면
jcr:title의 기본값이 사용됩니다. -
subPath(옵션)이 속성은 값이 확인되기 전에 경로에 추가할 접미사를 지정하는 데 사용할 수 있습니다.
-
-
pathextension-
path(mandatory)프리펜드할 경로를 정의합니다.
-
propertyName(필수)실제 값이 있는 해결된 경로에서 속성을 정의합니다.
-
i18n(선택 사항;부울 유형)해결된 값이 국제화됨(즉, CQ5의 국제화 서비스 사용)이어야 하는지 여부를 결정합니다.
-
-
-
preprocessing사전 처리는 선택 사항이며 처리 단계에 apply 또는 applyAfter:
-
apply초기 사전 처리 단계(처리 큐 표현에서 3단계)).
-
applyAfter사전 처리 후 적용(단계 9(처리 큐 표현).
-
해상도
해상도는 필요한 정보를 추출하는 데 사용됩니다. 다양한 해상도의 예는 다음과 같습니다.
Const
다음은 VersionCreated의 관련 값을 New version created 문자열로 확인합니다.
/libs/cq/reporting/components/auditreport/typecol/definitions/data을(를) 참조하십시오.
N:data
P:resolver=const
N:resolverConfig
P:VersionCreated="New version created"
페이지
해당 페이지의 jcr:content(child) 노드에서 jcr:description 속성에 대한 경로 값을 확인합니다.
/libs/cq/reporting/components/compreport/pagecol/definitions/data을(를) 참조하십시오.
N:data
P:resolver=page
N:resolverConfig
P:propertyName="jcr:description"
경로
다음 사항은 /content/.../page의 경로를 jcr:title 속성의 내용으로 해결합니다. 이는 페이지 경로가 페이지 제목으로 확인됨을 의미합니다.
/libs/cq/reporting/components/auditreport/pagecol/definitions/data을(를) 참조하십시오.
N:data
P:resolver=path
N:resolverConfig
P:propertyName="jcr:title"
P:subPath="/jcr:content"
경로 확장
다음은 경로 확장명이 /libs/wcm/core/resources/languages인 값 de인 다음 속성 language의 값을 가져와 국가 코드 de을 언어 설명 German으로 확인합니다.
/libs/cq/reporting/components/userreport/languagecol/definitions/data을(를) 참조하십시오.
N:data
P:resolver=pathextension
N:resolverConfig
P:path="/libs/wcm/core/resources/languages"
P:propertyName="language"
사전 처리
preprocessing 정의는 다음 중 하나에 적용할 수 있습니다.
-
원래 값:
원래 값에 대한 사전 처리 정의는
apply및/또는applyAfter에 직접 지정됩니다. -
집계된 상태의 값:
필요한 경우 각 집계에 대해 별도의 정의를 제공할 수 있습니다.
집계된 값에 대한 명시적 사전 처리를 지정하려면 사전 처리 정의는 각
aggregated하위 노드(apply/aggregated,applyAfter/aggregated)에 있어야 합니다. 개별 집계에 대한 명시적 사전 처리가 필요한 경우 사전 처리 정의는 각 집적(예:apply/aggregated/min/max또는 기타 집적)의 이름이 있는 하위 노드에 있습니다.
사전 처리 중에 사용할 다음 중 하나를 지정할 수 있습니다.
-
패턴 찾기 및
바꾸기패턴을 찾으면 지정된 패턴(정규 표현식으로 정의됨)이 다른 패턴으로 바뀝니다.예를 들어 원본 하위 문자열을 추출하는 데 사용할 수 있습니다. -
숫자 값을 상대 문자열로 변환합니다.예를 들어, "1시간의 시간 차이를 나타내는 값"은
1:24PM (1 hour ago)과 같은 문자열로 확인됩니다.
예:
N:definitions
N:data
N:preprocessing
N:apply|applyAfter
P:pattern // regex
P:replace // replacement for regex
// and/or
P:format // data type formatter
사전 처리 - 패턴 찾기 및 바꾸기
전처리를 위해 pattern(정규 표현식 또는 regex로 정의됨)을 지정한 다음 replace 패턴으로 대체할 수 있습니다.
-
pattern하위 문자열을 찾는 데 사용되는 정규 표현식.
-
replace원래 문자열을 대체하기 위해 사용할 문자열 또는 문자열 표현입니다. 보통 표현식
pattern에 의해 위치한 문자열의 하위 문자열을 나타내는 경우가 많습니다.
교체 예를 다음과 같이 분류할 수 있습니다.
-
다음 두 속성이 있는
definitions/data/preprocessing/apply노드의 경우:pattern:(.*)(/jcr:content?lang=ko)(/|$?lang=ko)(.*)replace:$1
-
다음으로 도착하는 문자열:
/content/geometrixx/en/services/jcr:content/par/text
-
4개의 섹션으로 분할됩니다.
$1-(.*)-/content/geometrixx/en/services$2-(/jcr:content?lang=ko)-/jcr:content$3-(/|$?lang=ko)-/$4-(.*)-par/text
-
그리고
$1로 표시되는 문자열로 대체됩니다./content/geometrixx/en/services
사전 처리 - 데이터 유형 포맷
이러한 형식은 숫자 값을 상대 문자열로 변환합니다.
예를 들어 min, avg 및 max 집계를 허용하는 시간 열에 이 값을 사용할 수 있습니다. min/ avg/ max 집계는 시간 차이(예:10 days ago), 데이터 형식이 필요합니다. 이에 대해 datedelta 형식이 min/ avg/ max 집계된 값에 적용됩니다. 또한 count 집계를 사용할 수 있으면 포맷터가 필요하지 않으며 원래 값도 필요하지 않습니다.
현재 사용 가능한 데이터 유형 형식은 다음과 같습니다.
-
format데이터 유형 형식:
-
duration지속 시간은 정의된 두 날짜 사이의 시간 범위입니다. 예를 들어 11:23h에서 시작하여 1시간 후 12:23h로 끝나는 워크플로우 작업2/13/11 시작 및 종료 시간2/13/11.
밀리초 값으로 해석되는 숫자 값을 지속 시간 문자열로 변환합니다.예를 들어
30000의 형식은 *30s* 형식입니다. -
datedeltaDatadelta는 "지금"까지 과거 날짜의 시간 범위이므로 나중에 보고서를 보면 다른 결과가 나타납니다.
숫자 값(일 단위 시간 차로 해석됨)을 상대 날짜 문자열로 변환합니다. 예를 들어 1은 1일 전으로 서식이 지정됩니다.
-
다음 예제에서는 min 및 max 집계에 대한 datedelta 서식을 정의합니다.
N:definitions
N:data
N:preprocessing
N:apply
N:aggregated
N:min
P:format = "datedelta"
N:max
P:format = "datedelta"
열 특정 정의
열 특정 정의는 해당 열에 사용할 수 있는 필터와 집계를 정의합니다.
N:definitions
P:type
P:groupable [Boolean]
N:filters [cq:WidgetCollection]
[
N:<name> // array of nodes (names irrelevant) with the following properties:
P:filterType
P:id
P:phase
]
N:aggregates [cq:WidgetCollection]
[
N:<name> // array of nodes (names irrelevant) with the following properties:
P:text
P:type
]
-
type다음은 표준 옵션으로 사용할 수 있습니다.
-
string -
number -
int -
date -
diff -
timeslot합계에 필요한 날짜의 일부를 추출하는 데 사용됩니다(예: 매년 집계된 데이터를 가져오려면 연도별 그룹).
-
sortable정렬 및 표시하기 위해 서로 다른 값(다른 속성에서 가져온 값)을 사용하는 값에 사용됩니다.
게다가 위의 값은 다중 값으로 정의할 수 있습니다.예를 들어string[]은 문자열 배열을 정의합니다.
값 추출기가 열 유형에 의해 선택됩니다. 열 유형에 값 추출기를 사용할 수 있는 경우 이 추출기가 사용됩니다. 그렇지 않으면 기본 값 추출기가 사용됩니다.
유형은 매개 변수를 사용할 수 있습니다(선택 사항). 예를 들어
timeslot:year은 날짜 필드에서 연도를 추출합니다. 매개 변수를 사용한 유형:-
timeslot- 이 값은 의 해당 상수와 비교할 수java.utils.Calendar있습니다.timeslot:year-Calendar.YEARtimeslot:month-of-year-Calendar.MONTHtimeslot:week-of-year-Calendar.WEEK_OF_YEARtimeslot:day-of-month-Calendar.DAY_OF_MONTHtimeslot:day-of-week-Calendar.DAY_OF_WEEKtimeslot:day-of-year-Calendar.DAY_OF_YEARtimeslot:hour-of-day-Calendar.HOUR_OF_DAYtimeslot: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 백분위수를 가져옵니다.
-
-
열 기본값
열의 기본값을 정의하는 데 사용됩니다.
N:defaults
P:aggregate
-
aggregate유효한
aggregate값은aggregates아래의type과 동일합니다( 열 특정 정의(정의 - 필터 / 집계) 참조).
이벤트 및 작업
구성 편집은 리스너가 감지하고 이러한 이벤트가 발생한 후 적용할 작업을 정의하는 데 필요한 이벤트를 정의합니다. 배경 정보는 구성 요소 개발 소개을 참조하십시오.
필요한 모든 작업을 수행할 수 있도록 다음 값을 정의해야 합니다.
N:cq:editConfig [cq:EditConfig]
P:cq:actions [String[]] = "insert", "delete"
P:cq:dialogMode = "floating"
P:cq:layout = "auto"
N:cq:listeners [cq:EditListenersConfig]
P:aftercreate = "REFRESH_INSERTED"
P:afterdelete = "REFRESH_SELF"
P:afteredit = "REFRESH_SELF"
P:afterinsert = "REFRESH_INSERTED"
P:aftermove = "REFRESH_SELF"
P:afterremove = "REFRESH_SELF"
일반 열
일반 열은 (대부분의) 열 정의가 구성 요소 노드가 아니라 열 노드의 인스턴스에 저장되는 확장입니다.
개별 일반 구성 요소에 대해 사용자 정의하는 (표준) 대화 상자를 사용합니다. 이 대화 상자에서는 보고서 사용자가 메뉴 옵션 열 속성…을 사용하여 보고서 페이지에서 일반 열의 열 속성을 정의할 수 있습니다.).
예: 사용자 보고서의 일반 열/libs/cq/reporting/components/userreport/genericcol을(를) 참조하십시오.
열을 일반으로 만들려면:
-
열의
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(ordefinitions/data/preprocessing.../clientFilter이 아님) - 확인자 및 구성definitions/queryBuilder- 쿼리 빌더 구성defaults/aggregate- 기본 집계
사용자 보고서에 있는 일반 열의 새 인스턴스의 경우 대화 상자에 정의된 속성은 다음 아래에 유지됩니다.
/etc/reports/userreport/jcr:content/report/columns/genericcol/settings/generic
보고서 디자인
디자인은 보고서를 만들 수 있는 열 유형을 정의합니다. 열이 추가되는 단락 시스템도 정의합니다.
각 보고서마다 개별 디자인을 만드는 것이 좋습니다. 완벽한 유연성을 보장합니다. 새 보고서 정의도 참조하십시오.
기본 보고 구성 요소는 /etc/designs/reports 아래에 있습니다.
보고서 위치는 구성 요소를 찾은 위치에 따라 달라질 수 있습니다.
-
/etc/designs/reports/<yourReport>보고서가/apps/cq/reporting -
/etc/designs/<yourProject>/reports/<*yourReport*>을 사용하여/apps/<yourProject>/reports패턴
필요한 디자인 속성은 jcr:content/reportpage/report/columns에 등록됩니다(예: /etc/designs/reports/<reportName>/jcr:content/reportpage/report/columns).
-
components보고서에서 허용되는 모든 구성 요소 및/또는 구성 요소 그룹.
-
sling:resourceType값이
cq/reporting/components/repparsys인 속성입니다.
디자인 조각(구성 요소 보고서의 디자인에서 가져옴)은 다음과 같습니다.
<!-- ... -->
<jcr:content
jcr:primaryType="nt:unstructured"
jcr:title="Component Report"
sling:resourceType="wcm/core/components/designer">
<reportpage jcr:primaryType="nt:unstructured">
<report jcr:primaryType="nt:unstructured">
<columns
jcr:primaryType="nt:unstructured"
sling:resourceType="cq/reporting/components/repparsys"
components="group:Component Report"/>
</report>
</reportpage>
</jcr:content>
<!-- ... -->
개별 열에 대한 디자인을 지정할 필요는 없습니다. 사용 가능한 열은 디자인 모드에서 정의할 수 있습니다.
표준 보고서 디자인을 변경하지 않는 것이 좋습니다. 이는 핫픽스를 업그레이드하거나 설치할 때 변경 사항이 손실되지 않도록 하기 위한 것입니다.
표준 보고서를 사용자 지정하려면 보고서와 해당 디자인을 복사하십시오.
보고서를 만들 때 기본 열을 자동으로 만들 수 있습니다. 템플릿에 지정되어 있습니다.
보고서 템플릿
각 보고서 유형은 템플릿을 제공해야 합니다. 표준 CQ 템플릿이며 이와 같이 구성할 수 있습니다.
템플릿은 다음을 수행해야 합니다.
-
sling:resourceType을(를)cq/reporting/components/reportpage(으)로 설정 -
사용할 디자인을 나타냅니다.
-
sling:resourceType속성을 사용하여 컨테이너(reportbase) 구성 요소를 참조하는report하위 노드를 만듭니다.
예제 템플릿 조각(구성 요소 보고서 템플릿에서 가져옴)은 다음과 같습니다.
<!-- ... -->
<jcr:content
cq:designPath="/etc/designs/reports/compreport"
jcr:primaryType="cq:PageContent"
sling:resourceType="cq/reporting/components/reportpage">
<report
jcr:primaryType="nt:unstructured"
sling:resourceType="cq/reporting/components/compreport/compreport"/>
</jcr:content>
<!-- .. -->
루트 경로(사용자 보고서 템플릿에서 가져옴)의 정의를 보여주는 예제 템플릿 조각은 다음과 같습니다.
<!-- ... -->
<jcr:content
cq:designPath="/etc/designs/reports/userreport"
jcr:primaryType="cq:PageContent"
sling:resourceType="cq/reporting/components/reportpage">
<report
jcr:primaryType="nt:unstructured"
rootPath="/home/users"
sling:resourceType="cq/reporting/components/compreport/compreport"/>
</jcr:content>
<!-- .. -->
기본 보고 템플릿은 /libs/cq/reporting/templates 아래에 있습니다.
그러나 이러한 노드를 업데이트하지 말고 /apps/cq/reporting/templates 아래에 사용자 고유의 구성 요소 노드를 만들거나 보다 적절한 /apps/<yourProject>/reports/templates 아래에 설정하는 것이 좋습니다.
예(예: 보고서 구성 요소 위치 참조):
N:apps
N:cq [nt:folder]
N:reporting|reports [sling:Folder]
N:templates [sling:Folder]
이 아래에서 템플릿의 루트를 만듭니다.
N:apps
N:cq [nt:folder]
N:reporting|reports [sling:Folder]
N:templates [sling:Folder]
N:<reportname> [sling:Folder]
자체 보고서 만들기 - 예
새 보고서 정의
새 보고서를 정의하려면 만들고 구성해야 합니다.
- 보고서 구성 요소의 루트입니다.
- 보고서 기본 구성 요소입니다.
- 하나 이상의 열 기본 구성 요소입니다.
- 보고서 디자인.
- 보고서 템플릿의 루트입니다.
- 보고서 템플릿입니다.
이러한 단계를 설명하기 위해 다음 예제에서는 저장소 내의 모든 OSGi 구성을 나열하는 보고서를 정의합니다.예: sling:OsgiConfig 노드의 모든 인스턴스.
기존 보고서를 복사한 다음 새 버전을 사용자 지정하는 것이 대체 방법입니다.
-
새 보고서의 루트 노드를 만듭니다.
예를 들어
/apps/cq/reporting/components/osgireport아래에 있습니다.N:cq [nt:folder] N:reporting [sling:Folder] N:components [sling:Folder] N:osgireport [sling:Folder] -
보고서 기준을 정의합니다. 예:
/apps/cq/reporting/components/osgireport아래의osgireport[cq:Component].N:osgireport [sling:Folder] N:osgireport [cq:Component] P:sling:resourceSuperType [String] = "cq/reporting/components/reportbase" N:charting [nt:unstructured] N:settings [nt:unstructured] N:active [cq:WidgetCollection] N:0 [nt:unstructured] P:id [String] = "pie" N:1 [nt:unstructured] P:id [String] = "lineseries" N:definitions [cq:WidgetCollections] N:0 [nt:unstructured] P:id [String] = "pie" P:maxRadius [Long] = 180 P:type [String] = "pie" N:1 [nt:unstructured] P:id [String] = "lineseries" P:type [String] = "lineseries" N:dialog [cq:Dialog] P:height [Long] = 424 N:items [cq:WidgetCollection] N:props [cq:Panel] N:items [cq:WidgetCollection] N:title [cq:Widget] P:path [String] = "/libs/cq/reporting/components/commons/title.infinity.json" P:xtype [String] = "cqinclude" N:description [cq:Widget] P:path [String] = "/libs/cq/reporting/components/commons/description.infinity.json" P:xtype [String] = "cqinclude" N:rootPath [cq:Widget] P:fieldLabel [String] = "Root path" P:name [String] = "./report/rootPath" P:xtype [String] = "pathfield" N:processing [cq:Widget] P:path [String] = "/libs/cq/reporting/components/commons/processing.infinity.json" P:xtype [String] = "cqinclude" N:scheduling [cq:Widget] P:path [String] = "/libs/cq/reporting/components/commons/scheduling.infinity.json" P:xtype [String] = "cqinclude" N:queryBuilder [nt:unstructured] P:nodeTypes [String[]] = "sling:OsgiConfig"다음과 같은 보고서 기본 구성 요소를 정의합니다.
sling:OsgiConfig유형의 모든 노드를 검색합니다.pie및lineseries차트 모두 표시- 사용자가 보고서를 구성할 수 있는 대화 상자를 제공합니다.
-
첫 번째 열(열 기준) 구성 요소를 정의합니다. 예:
/apps/cq/reporting/components/osgireport아래의bundlecol[cq:Component].N:osgireport [sling:Folder] N:bundlecol [cq:Component] P:componentGroup [String] = "OSGi Report" P:jcr:title = "Bundle" P:sling:resourceSuperType [String] = "cq/reporting/components/columnbase" N:cq:editConfig [cq:EditConfig] P:cq:actions [String[]] = "insert", "delete" P:cq:dialogMode [String] = "floating" P:cq:layout [String] = "auto" N:cq:listeners [cq:EditListenersConfig] P:aftercreate [String] "REFRESH_INSERTED" P:afterdelete [String] "REFRESH_SELF" P:afteredit [String] "REFRESH_SELF" P:afterinsert [String] "REFRESH_INSERTED" P:aftermove [String] "REFRESH_SELF" P:afterremove [String] "REFRESH_SELF" N:defaults [nt:unstructured] P:aggregate [String] = "count" N:definitions [nt:unstructured] P:groupable [Boolean] = false P:type [String] = "string" N:queryBuilder [nt:unstructured] P:property [String] = "jcr:path"다음과 같은 열 기본 구성 요소를 정의합니다.
- 서버에서 받는 값을 검색하고 반환합니다.이 경우 모든
sling:OsgiConfig노드에 대한jcr:path속성 count집계- 그룹화할 수 없음
- 제목
Bundle(테이블 내의 열 제목) - 은(는) 사이드킥그룹
OSGi Report에 있습니다. - 지정된 이벤트 시 새로 고침
노트이 예에서는
N:data및P:clientFilter에 대한 정의가 없습니다. 이것은 서버에서 받은 값이 1:1 기반으로 반환되기 때문에 기본 동작입니다.이것은 정의와 동일합니다.
N:data [nt:unstructured] P:clientFilter [String] = "function(v) { return v; }"이 함수는 단순히 받은 값을 반환합니다.
- 서버에서 받는 값을 검색하고 반환합니다.이 경우 모든
-
보고서 디자인을 정의합니다. 예:
/etc/designs/reports아래의osgireport[cq:Page].N:osgireport [cq:Page] N:jcr:content [nt:unstructured] P:jcr:title [String] = "OSGi report" P:sling:resourceType [String] = "wcm/core/components/designer" N:reportpage [nt:unstructured] N:report [nt:unstructured] N:columns [nt:unstructured] P:components [String] = "group:OSGi Report" P:sling:resourceType [String] = "cq/reporting/components/repparsys" -
새 보고서 템플릿의 루트 노드를 만듭니다.
예를 들어
/apps/cq/reporting/templates/osgireport아래에 있습니다.N:cq [nt:folder] N:reporting [sling:Folder] N:templates [sling:Folder] N:osgireport [cq:Template] -
보고서 템플릿을 정의합니다. 예:
/apps/cq/reporting/templates아래의osgireport[cq:Template].N:osgireport [cq:Template] P:allowedPaths [String[]] = "/etc/reports(/.*)?" P:jcr:description [String] = "Use this report generator to create a new OSGi report." P:jcr:title [String] = "OSGi Report Template" P:ranking [Long] = 100 P:shortTitle [String] = "OSGi Report" N:jcr:content [cq:PageContent] P:cq:designPath [String] = "/etc/designs/reports/osgireport" P:sling:resourceType [String] = "cq/reporting/components/reportpage" N:report [nt:unstructured] P:rootPath [String] = "/" P:sling:resourceType [String] = "cq/reporting/components/osgireport/osgireport" N:thumbnail.png [nt:file]다음과 같은 템플릿을 정의합니다.
- 결과 보고서에 대해
allowedPaths을 정의합니다(위의 경우/etc/reports아래의 위치). - 템플릿에 대한 제목 및 설명을 제공합니다.
- 템플릿 목록에서 사용할 축소판 이미지를 제공합니다. 이 노드의 전체 정의는 위에 나열되지 않습니다. 기존 보고서에서 thumbnail.png 인스턴스를 복사하는 것이 가장 쉽습니다.
- 결과 보고서에 대해
새 보고서 인스턴스 만들기
이제 새 보고서의 인스턴스를 만들 수 있습니다.
-
도구 콘솔을 엽니다.
-
왼쪽 창에서 보고서를 선택합니다.
-
그런 다음 새로 만들기…도구 모음에서. 제목 및 이름을 정의하고 템플릿 목록에서 새 보고서 유형(OSGi 보고서 템플릿)을 선택한 다음 만들기를 클릭합니다.
-
새 보고서 인스턴스가 목록에 나타납니다. 열려면 이 아이콘을 두 번 클릭합니다.
-
사이드킥에서 구성 요소(예: OSGi 보고서 그룹의 번들)를 드래그하여 첫 번째 열을 만들고 보고서 정의을 시작합니다.
노트이 예제에 그룹 가능한 열이 없으므로 차트를 사용할 수 없습니다. 차트를 보려면
groupable을true으로 설정합니다.N:osgireport [sling:Folder] N:bundlecol [cq:Component] N:definitions [nt:unstructured] P:groupable [Boolean] = true
보고서 프레임워크 서비스 구성
이 섹션에서는 보고서 프레임워크를 구현하는 OSGi 서비스에 대한 고급 구성 옵션에 대해 설명합니다.
웹 콘솔의 구성 메뉴를 사용하여 볼 수 있습니다(예: http://localhost:4502/system/console/configMgr). AEM으로 작업할 때 이러한 서비스에 대한 구성 설정을 관리하는 방법에는 여러 가지가 있습니다.자세한 내용 및 권장 방법은 OSGi 구성을 참조하십시오.
기본 서비스(일 CQ 보고 구성)
-
Timezoneyes 는 데이터를 만드는 표준 시간대를 정의합니다. 이것은 내역 차트가 전세계 각 사용자에 대해 동일한 데이터를 표시하는지 확인하기 위한 것입니다.
-
현지어 는 내역 데이터를 위해 Timezoneas와 함께 사용할 로케일을 정의합니다. 로캘은 일부 로케일별 달력 설정(예: 주의 첫날이 일요일인지 월요일인지)을 결정하는 데 사용됩니다.
-
스냅샷 경로는 기록 차트에 대한 스냅샷이 저장되는 루트 경로를 정의합니다.
-
보고서 경로는 보고서가 있는 경로를 정의합니다. 스냅샷 서비스에서 스냅샷을 실제로 캡처할 보고서를 결정하는 데 사용됩니다.
-
일별 스냅샷은 일별 스냅샷을 촬영하는 시간을 정의합니다. 지정된 시간은 서버의 로컬 시간대에 있습니다.
-
시간별 스냅샷은 시간별 스냅샷을 촬영하는 각 시간의 분을 정의합니다.
-
행(최대) 은 각 스냅숏에 대해 저장되는 최대 행 수를 정의합니다. 이 값은 적절히 선택해야 합니다.너무 높으면 저장소 크기에 영향을 주고, 너무 낮으면 내역 데이터를 처리하는 방식으로 인해 데이터가 정확하지 않을 수 있습니다.
-
허위 데이터(활성화된 경우)는 선택기를 사용하여 허위 내역 데이터를 만들 수
fakedata있습니다.비활성화된 경우 선택기를fakedata사용하면 예외가 발생합니다.데이터가 가짜이므로 테스트 및 디버깅 목적으로만 만 사용해야 합니다.
fakedata선택기를 사용하면 암시적으로 보고서가 완료되므로 기존의 모든 데이터가 손실됩니다.데이터를 수동으로 복원할 수 있지만 시간이 많이 걸릴 수 있습니다. -
스냅샷 사용자는 스냅샷을 촬영하는 데 사용할 수 있는 선택적 사용자를 정의합니다.
기본적으로, 보고서를 완료한 사용자에 대해 스냅샷이 생성됩니다. 대신 사용할 대체 사용자를 지정하려는 게시 시스템(예: 계정이 복제되지 않아 이 사용자가 존재하지 않는 게시 시스템)에서 있을 수 있습니다.
또한 사용자를 지정하면 보안 위험이 발생할 수 있습니다.
-
스냅샷 사용자를 적용합니다. 활성화되면 스냅샷 사용자 아래에 지정된 사용자가 모든 스냅샷을 촬영 합니다. 제대로 처리되지 않으면 심각한 보안 영향을 줄 수 있습니다.
캐시 설정(일 CQ 보고 캐시)
- 보고서 데이터의 캐시를 활성화하거나 비활성화할 수 있습니다. 보고서 캐시를 활성화하면 여러 요청 동안 보고서 데이터가 메모리에 유지됩니다. 이는 성능을 높일 수 있지만 메모리 사용량이 더 높을 뿐만 아니라 메모리 부족 상황이 발생할 수 있습니다.
- TTL 보고서 데이터가 캐시되는 시간(초)을 정의합니다. 숫자가 높을수록 성능이 향상되지만 기간 내에 데이터가 변경될 경우 부정확한 데이터를 반환할 수도 있습니다.
- 최대 입력은 언제든지 캐시할 최대 보고서 수를 정의합니다.
보고서 데이터는 각 사용자 및 언어에 대해 다를 수 있습니다. 따라서 보고서 데이터는 보고서, 사용자 및 언어별로 캐시됩니다. 즉, Max entries 값이 실제로 다음 중 하나에 대한 데이터를 캐시합니다.2
- 언어 설정이 다른 두 사용자에 대한 보고서 1개
- 사용자 1명과 보고서 2개
이 페이지에서는
