Show Menu
화제×

보고서 개발

AEM에서는 대부분의 표준 보고서를 보고 프레임워크를 기반으로 합니다.
프레임워크를 사용하여 이러한 표준 보고서를 확장하거나 완전히 새로운 보고서를 개발할 수 있습니다. 보고 프레임워크는 기존 CQ5 개념 및 원칙과 긴밀하게 통합되어 있으므로 개발자는 기존의 CQ5 지식을 보고서 개발을 위한 발판으로 사용할 수 있습니다.
AEM과 함께 제공된 표준 보고서의 경우:
자습서 Creating Your Own Report - An Example 또한 아래 원칙 중 몇 개를 사용할 수 있는지 보여줍니다.
표준 보고서를 참조하여 다른 구현 예를 볼 수도 있습니다.
다음 표기법 아래의 예와 정의에서 사용됩니다.
  • 각 줄은 다음과 같은 노드 또는 속성을 정의합니다.
  • N:<name> [<nodeType>]
    의 이름과 노드 <*name*> 유형이 있는 노드에 대해 <*nodeType*> 설명합니다.
  • P:<name> [<propertyType]
    의 이름과 속성 유형을 <*name*> 사용하여 속성을 <*propertyType*> 설명합니다.
  • P:<name> = <value>
    의 값으로 설정해야 <name> 하는 속성을 <value> 설명합니다.
  • 들여쓰기는 노드 간의 계층 종속성을 보여줍니다.
  • 항목 구분| 가능한 항목 목록을 나타냅니다.예를 들어 유형 또는 이름은 다음과 같습니다.
예를 들어 String|String[] 속성은 String 또는 String일 수 있음을 의미합니다 #.
  • [] 배열을 나타냅니다.쿼리 정의에서와 마찬가지로 # 문자열 또는 노드 배열과 같이 .
별도로 명시되어 있지 않는 한 기본 유형은 다음과 같습니다.
  • 노드 - nt:unstructured
  • 속성 - String

Reporting Framework

보고 프레임워크는 다음 원칙을 기반으로 합니다.
  • CQ5 QueryBuilder에서 실행하는 쿼리에서 반환되는 결과 집합을 기반으로 합니다.
  • 결과 세트는 보고서에 표시되는 데이터를 정의합니다. 결과 세트의 각 행은 보고서의 표 형식 보기에 있는 행에 해당합니다.
  • 결과 세트에서 실행할 수 있는 작업은 RDBMS 개념과 유사합니다.주로 그룹화 집계를 ​수행합니다.
  • 대부분의 데이터 검색 및 처리는 서버측에서 수행됩니다.
  • 클라이언트는 사전 처리된 데이터를 표시하는 전적인 책임을 집니다. 작은 처리 작업(예: 셀 컨텐츠에 링크 만들기)만 클라이언트측에서 실행됩니다.
보고 프레임워크(표준 보고서의 구조로 표시됨)에서는 처리 큐에서 제공하는 다음 기본 구성 요소를 사용합니다.

보고서 페이지

보고서 페이지:
  • 표준 CQ5 페이지입니다.
  • 보고서에 대해 구성된 표준 CQ5 템플릿을 기반으로 합니다.

보고서 기준

구성 요소는 reportbase 다음과 같이 모든 보고서의 기초를 형성합니다.
  • 데이터의 기본 결과 집합을 전달하는 쿼리의 정의를 보유합니다.
  • 보고서에 추가된 모든 열( columnbase )을 포함하는 수정된 단락 시스템입니다.
  • 사용 가능한 차트 유형과 현재 활성 차트 유형을 정의합니다.
  • 사용자가 보고서의 특정 측면을 구성할 수 있는 편집 대화 상자를 정의합니다.

열 기준

각 열은 다음과 같은 구성 요소의 columnbase 인스턴스입니다.
  • 각 보고서의 parsys ( reportbase )에서 사용되는 단락입니다.
  • 기본 결과 집합에 대한 링크를 정의합니다.즉, 이 결과 집합 내에서 참조된 특정 데이터와 처리 방법을 정의합니다.
  • 추가 정의 보유;사용할 수 있는 집계 및 필터와 같은 모든 기본값을 사용합니다.

쿼리 및 데이터 검색

쿼리:
  • 구성 요소의 일부로 정의됩니다 reportbase .
  • CQ QueryBuilder 를 기반으로 합니다 .
  • 보고서의 기초로 사용되는 데이터를 검색합니다. 결과 집합(테이블)의 각 행은 쿼리에서 반환되는 대로 노드에 연결됩니다. 그런 다음 개별 열에 대한 특정 정보가 이 데이터 세트에서 추출됩니다.
  • 일반적으로 다음 항목으로 구성됩니다.
    • 루트 경로입니다.
      검색할 저장소의 하위 트리를 지정합니다.
      성능 영향을 최소화하려면 쿼리를 저장소의 특정 하위 트리로 제한하는 것이 좋습니다(시도). 루트 경로는 보고서 템플릿에 사전 정의되거나 구성(편집) 대화 상자에서 구성 대화 상자 사용자가 설정할 수 있습니다.
    • 하나 이상의 기준을 참조하십시오.
      이러한 항목은 (초기) 결과 집합을 만들기 위해 적용됩니다.여기에는 노드 유형에 대한 제한이나 속성 제약 조건이 포함됩니다.
여기에서 중요한 점은 쿼리의 결과 세트에서 반환되는 각 단일 노드가 보고서에서 단일 행을 생성하는 데 사용된다는 것입니다(따라서 1:1 관계).
개발자는 보고서에 대해 정의된 쿼리가 해당 보고서에 적합한 노드 집합을 반환하도록 해야 합니다. 그러나 노드 자체에서 필요한 정보를 모두 보유할 필요는 없습니다. 부모 및/또는 하위 노드에서도 파생될 수 있습니다. 예를 들어 사용자 보고서에 사용된 쿼리는 노드 유형(이 경우 rep:user )을 기준으로 노드를 선택합니다. 그러나 이 보고서의 대부분의 열은 이러한 노드에서 직접 데이터를 가져오지 않고 하위 노드에서 데이터를 가져옵니다 profile .

처리 큐

쿼리는 보고서에서 행으로 표시될 데이터 집합을 반환합니다. 결과 집합의 각 행은 몇 가지 단계로 처리되고, 보고서에 표시하기 위해 클라이언트로 전송됩니다(서버측).
이를 통해 다음을 수행할 수 있습니다.
  • 기본 결과 집합에서 값을 추출하고 추출합니다.
    예를 들어 두 속성 값 간의 차이를 계산하여 두 속성 값을 단일 값으로 처리할 수 있습니다.
  • 추출된 값 해결;다양한 방법으로 수행할 수 있습니다.
    예를 들어, 경로를 제목에 매핑할 수 있습니다(각 jcr:title 속성의 보다 사람이 읽을 수 있는 내용).
  • 다양한 지점에서 필터 적용
  • 필요한 경우 복합 값 만들기
    예를 들어, 사용자에게 표시되는 텍스트로 구성된 경우 정렬에 사용할 값과 링크를 만드는 데 사용되는 추가 URL(클라이언트측)이 있습니다.

처리 큐 워크플로우

다음 워크플로우는 처리 큐를 나타냅니다.

처리 큐의 단계

자세한 단계 및 요소는 다음과 같습니다.
  1. 값 추출기를 사용하여 초기 쿼리(reportbase) 에서 반환된 결과를 기본 결과 세트로 변환합니다.
    값 추출기는 열 유형에 따라 자동으로 선택됩니다. 기본 JCR 쿼리에서 값을 읽고 이 JCR에서 결과 집합을 만드는 데 사용됩니다.이후 추가 처리가 적용될 수 있습니다. 예를 들어, diff 유형의 경우 값 extractor는 두 개의 속성을 읽고 결과 세트에 추가되는 단일 값을 계산합니다. 값 추출기를 구성할 수 없습니다.
  2. 원시 데이터를 포함하는 초기 결과 세트에 대해 초기 필터링 ( 원시 단계)이 적용됩니다.
  3. 값은 미리 처리됩니다 .를 적용 단계에 대해 정의된 대로
  4. 필터링 ( 사전 처리 단계에 지정)은 사전 처리된 값에 대해 실행됩니다.
  5. 값이 해결되었습니다.에 정의된 해결 프로그램에 따라
  6. 해결된 값에 대해 필터링( 해결된 단계에 지정됨)이 실행됩니다.
  7. 배열 데이터는 (문자열 기반) 목록으로 변환하여 결정됩니다.
    다중 값 결과를 표시할 수 있는 목록으로 변환하는 암시적 단계입니다.다중 값 JCR 속성을 기반으로 하는 (집계되지 않은) 셀 값에 필요합니다.
  8. 값이 다시 미리 처리되었습니다 .as defined for the afterApply phase.
  9. 데이터가 정렬됩니다.
  10. 처리된 데이터가 클라이언트로 전송됩니다.
기본 데이터 결과 집합을 반환하는 초기 쿼리는 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

페이지 구성 요소

보고서 페이지는 sling:resourceType 의 속성을 사용해야 합니다 /libs/cq/reporting/components/reportpage .
사용자 지정된 페이지 구성 요소는 필요하지 않습니다(대부분의 경우).

보고서 기본 구성 요소

각 보고서 유형에는 파생된 컨테이너 구성 요소가 있어야 /libs/cq/reporting/components/reportbase 합니다.
이 구성 요소는 보고서의 컨테이너 역할을 하며 다음에 대한 정보를 제공합니다.
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
     ]
    
    
    사용자가 마지막으로 수정한 모든 textimage 구성 요소를 admin 반환합니다.
  • 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 ), each has the following property:
      • id
        활성 차트에 대한 ID. 차트 중 하나의 ID와 일치해야 합니다 definitions .
  • definitions
    보고서에 사용할 수 있는 차트 유형을 정의합니다. 사용할 definitions 항목은 active 설정으로 지정됩니다.
    이 정의는 노드 배열을 사용하여 지정됩니다(종종 이름이 0 , 1 .. x ), 각 속성
    • id
      차트 ID.
    • type
      사용할 수 있는 차트 유형입니다. 다음 중에서 선택:
      • pie 파이 차트. 현재 데이터에서만 생성됩니다.
      • lineseries 일련의 선(실제 스냅샷을 나타내는 연결 점). 내역 데이터에서만 생성됩니다.
    • 차트 유형에 따라 추가 속성을 사용할 수 있습니다.
      • 차트 유형의 경우 pie :
        • maxRadius ( Double/Long )
          파이 차트에 허용되는 최대 반경;따라서 범례 없이 차트에 허용되는 최대 크기입니다. 정의된 경우 fixedRadius 무시됩니다.
        • minRadius ( Double/Long )
          파이 차트에 허용되는 최소 반경입니다. 정의된 경우 fixedRadius 무시됩니다.
        • fixedRadius ( Double/Long )파이 차트의 고정 반경을 정의합니다.
      • 차트 유형의 경우 lineseries :
        • totals ( Boolean )
          합계가 표시된 추가 라인이 표시되어야 하는 경우 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>

미리 구성된 여러 구성 요소가 제공됩니다.이러한 속성은 다음 값을 갖는 xtype 속성을 사용하여 대화 상자에서 참조할 수 있습니다. cqinclude
  • 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
    이렇게 하면 보고서가 저장소의 특정 섹션(트리 또는 하위 트리)으로 제한되며, 이는 성능 최적화를 위해 권장됩니다. 루트 경로는 각 보고서 페이지의 rootPath 노드 report 속성에 의해 지정됩니다(페이지 작성 시 템플릿에서 가져옴).
    다음 방법으로 지정할 수 있습니다.
    • 고정 값 또는 구성 대화 상자의 기본값으로 보고서 템플릿 .
    • 사용자(이 매개 변수 사용)

열 기본 구성 요소

각 열 유형에는 파생된 구성 요소가 필요합니다. /libs/cq/reporting/components/columnbase
열 구성 요소는 다음 조합을 정의합니다.
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
    실제 셀 값을 계산하는 데 사용해야 하는 두 번째 속성을 정의합니다.이것은 특정 열 유형(비교 및 정렬 가능)에만 사용됩니다.
    예를 들어 워크플로우 인스턴스 보고서의 경우 지정된 속성을 사용하여 시작 시간과 종료 시간 사이의 시간 차이(밀리초)의 실제 값을 저장합니다.
  • secondarySubPath
    가 사용될 때 subPath와 secondaryProperty 유사합니다.
대부분의 경우, 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 is resolved to /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
      속성을 사용하여 확인할 상수를 지정합니다. 속성 이름은 확인할 상수를 정의합니다.속성의 값은 해결된 값을 정의합니다.
      예를 들어 Name= 및 Value ​의 1 속성은 1에서 =One One으로확인됩니다.
    • default
      사용할 수 있는 구성이 없습니다.
    • page
      • propertyName (옵션)
        값을 확인하는 데 사용할 속성의 이름을 정의합니다. 지정하지 않으면 jcr:title (페이지 제목)의 기본값이 사용됩니다.해결 프로그램의 경우, 이 page 방법은 먼저 경로가 페이지 경로로 확인된 다음 페이지 제목으로 해결됨을 의미합니다.
    • path
      • propertyName (옵션)
        값을 확인하는 데 사용할 속성의 이름을 지정합니다. 지정하지 않으면 의 기본값이 jcr:title 사용됩니다.
      • subPath (옵션)
        이 속성을 사용하여 값을 확인하기 전에 경로에 추가할 접미사를 지정할 수 있습니다.
    • pathextension
      • path (mandatory)
        프리펜드할 경로를 정의합니다.
      • propertyName (mandatory)
        실제 값이 있는 해결된 경로에서 속성을 정의합니다.
      • i18n (선택 사항;type Boolean)
        해결된 값이 국제화되어야 하는지(예: CQ5 의 국제화 서비스 사용)를 결정합니다.
  • preprocessing
    사전 처리는 선택 사항이며 처리 단계에 바인딩(별도)하여 적용 또는 적용할 ​수 있습니다.
    • apply
      초기 사전 처리 단계(처리 큐 처리 큐 표현에 있는 3단계).
    • applyAfter
      사전 처리 후 적용(처리 큐 처리 큐 표시에서 9단계).

해상도

해상도는 필요한 정보를 추출하는 데 사용됩니다. 다양한 해상도의 예는 다음과 같습니다.
Const
다음은 문자열의 관련 값을 VersionCreated 해결합니다 New version created .
See /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 속성에 대한 경로 값을 확인합니다.
See /libs/cq/reporting/components/compreport/pagecol/definitions/data .
N:data
    P:resolver=page
    N:resolverConfig
        P:propertyName="jcr:description"

경로
다음은 /content/.../page 속성 jcr:title 컨텐츠의 경로를 해결합니다. 이는 페이지 경로가 페이지 제목으로 확인됨을 의미합니다.
See /libs/cq/reporting/components/auditreport/pagecol/definitions/data .
N:data
    P:resolver=path
    N:resolverConfig
        P:propertyName="jcr:title"
        P:subPath="/jcr:content"

경로 확장
다음 예제에서는 경로 확장자를 de 가진 값을 /libs/wcm/core/resources/languages 앞에 추가한 다음 속성 값을 language 가져와 국가 코드를 언어 de 설명에 German 연결합니다.
See /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)(/|$)(.*)
    • replace : $1
  • 다음으로 도착하는 문자열:
    • /content/geometrixx/en/services/jcr:content/par/text
  • 4개의 섹션으로 분할됩니다.
    • $1 - (.*) - /content/geometrixx/en/services
    • $2 - (/jcr:content) - /jcr:content
    • $3 - (/|$) - /
    • $4 - (.*) - par/text
  • 다음으로 표시되는 문자열로 $1 대체되었습니다.
    • /content/geometrixx/en/services

사전 처리 - 데이터 유형 포맷

이러한 형식은 숫자 값을 상대 문자열로 변환합니다.
예를 들어, 이 값은 min avg 집계를 허용하는 시간 열에 사용할 수 max 있습니다. 따라서 min / avg / max 집계는 시간 차이 (예:) 10 days ago 데이터 형식이 필요합니다. 이 경우 datedelta 형식이 min / avg / max 집계된 값에 적용됩니다. 집계를 사용할 수도 count 있는 경우, 형식자가 필요하지 않으며 원래 값도 필요하지 않습니다.
현재 사용 가능한 데이터 유형 형식은 다음과 같습니다.
  • format
    데이터 유형 포맷터:
    • duration
      지속 시간은 정의된 두 날짜 사이의 시간 범위입니다. 예를 들어, 1시간이 걸린 워크플로우 작업의 시작 및 종료(2/13/11 1:23h부터 시작, 1시간 후 2/13/11 1 12:23h로 종료).
      숫자 값(밀리초로 해석됨)을 기간 문자열로 변환합니다.예를 들어 30000 형식은 * 30s .*
    • datedelta
      Datadelta는 과거 날짜에서 "지금"까지의 시간 범위이므로, 나중에 보고서를 보는 경우 다른 결과가 나타납니다.
      숫자 값(일 단위 시간 차이로 해석됨)을 상대 날짜 문자열로 변환합니다. 예를 들어 1의 형식은 1일 전입니다.
다음 예제에서는 datedelta min max 집계의 서식을 정의합니다.
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.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번째 백분위수를 가져옵니다.

열 기본값

열의 기본값을 정의하는 데 사용됩니다.
N:defaults
    P:aggregate

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

이벤트 및 작업

구성 편집은 리스너가 감지하는 데 필요한 이벤트와 이러한 이벤트가 발생한 후 적용할 작업을 정의합니다. 배경 정보는 구성 요소 개발 소개를 참조하십시오.
다음 값을 정의하여 필요한 모든 작업이 준비되도록 해야 합니다.
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 .
열을 일반으로 만들려면
  • type 노드의 definition 속성을 로 설정합니다 generic .
    See /libs/cq/reporting/components/userreport/genericcol/definitions
  • 열의 definition 노드 아래에 (표준) 대화 상자 정의를 지정합니다.
    See /libs/cq/reporting/components/userreport/genericcol/definitions/dialog
    • 대화 상자의 필드는 해당 구성 요소 속성(경로 포함)과 동일한 이름을 참조해야 합니다.
      예를 들어, 대화 상자를 통해 일반 열의 유형을 구성할 수 있도록 하려면 이름이 ./definitions/type 있는 필드를 사용합니다.
    • UI/대화 상자를 사용하여 정의된 속성이 columnbase 구성 요소에 정의된 속성보다 우선합니다.
  • 구성 편집을 정의합니다.
    See /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 있습니다.
보고서 위치는 구성 요소를 찾은 위치에 따라 달라질 수 있습니다.
  • /etc/designs/reports/<yourReport> 보고서가 /apps/cq/reporting
  • /etc/designs/<yourProject>/reports/<*yourReport*> for reports using /apps/<yourProject>/reports pattern
필수 디자인 속성은 다음 항목에 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
  • 사용할 디자인을 가리킵니다.
  • 속성을 통해 컨테이너( report ) 구성 요소를 참조하는 reportbase``sling:resourceType 자식 노드를 만듭니다.
구성 요소 보고서 템플릿에서 가져온 예제 템플릿 조각:
<!-- ... -->
    <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]

자체 보고서 만들기 - 예

새 보고서 정의

새 보고서를 정의하려면 만들고 구성해야 합니다.
  1. 보고서 구성 요소의 루트입니다.
  2. 보고서 기본 구성 요소입니다.
  3. 하나 이상의 열 기본 구성 요소입니다.
  4. 보고서 디자인
  5. 보고서 템플릿의 루트입니다.
  6. 보고서 템플릿입니다.
다음 예에서는 저장소 내의 모든 OSGi 구성을 나열하는 보고서를 정의합니다.예: sling:OsgiConfig 노드의 모든 인스턴스.
기존 보고서를 복사한 다음 새 버전을 사용자 지정하는 것이 대체 방법입니다.
  1. 새 보고서의 루트 노드를 만듭니다.
    예를 들어, under /apps/cq/reporting/components/osgireport .
    N:cq [nt:folder]
        N:reporting [sling:Folder]
            N:components [sling:Folder]
                N:osgireport [sling:Folder]
    
    
  2. 보고서 베이스를 정의합니다. 예를 들어 osgireport[cq:Component] 아래에서 /apps/cq/reporting/components/osgireport 볼 수 있습니다.
    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 차트 표시
    • 사용자가 보고서를 구성할 수 있는 대화 상자를 제공합니다.
  3. 첫 번째 열(열 기준) 구성 요소를 정의합니다. 예를 들어 bundlecol[cq:Component] 아래에서 /apps/cq/reporting/components/osgireport 볼 수 있습니다.
    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"
    
    
    이렇게 하면 다음과 같은 열 기본 구성 요소가 정의됩니다.
    • 서버에서 받은 값을 검색하고 반환합니다.이 경우 jcr:path 모든 sling:OsgiConfig 노드에 대한 속성
    • 를 사용하여 count 집계
    • 그룹화할 수 없음
    • 에는 제목 Bundle (표 내의 열 제목)이 있습니다.
    • 가 사이드 킥에 있음 OSGi Report
    • 지정된 이벤트 새로 고침
    이 예에서는 N:data P:clientFilter 에 대한 정의가 없습니다. 이것은 서버에서 받은 값이 1:1로 반환되기 때문입니다. 이는 기본 동작입니다.
    이는 정의와 동일합니다.
    N:data [nt:unstructured]
      P:clientFilter [String] = "function(v) { return v; }"
    
    
    이 함수는 단순히 받은 값을 반환합니다.
  4. 보고서 디자인을 정의합니다. 예를 들어 osgireport[cq:Page] 아래에서 /etc/designs/reports 볼 수 있습니다.
    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"
    
    
  5. 새 보고서 템플릿의 루트 노드를 만듭니다.
    예를 들어, under /apps/cq/reporting/templates/osgireport .
    N:cq [nt:folder]
        N:reporting [sling:Folder]
            N:templates [sling:Folder]
                N:osgireport [cq:Template]
    
    
  6. 보고서 템플릿을 정의합니다. 예를 들어 osgireport[cq:Template] 아래에서 /apps/cq/reporting/templates 볼 수 있습니다.
    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 인스턴스를 복사하는 것이 가장 쉽습니다.

새 보고서 인스턴스 만들기

이제 새 보고서의 인스턴스를 만들 수 있습니다.
  1. Open the Tools console.
  2. 왼쪽 창에서 보고서를 선택합니다.
  3. 그런 다음 새로 만들기... 를 클릭합니다. 제목 이름을 정의하고 ​템플릿 목록에서 새 보고서 유형( OSGi 보고서 템플릿 )을 선택한 다음 생성 ​클릭합니다.
  4. 새 보고서 인스턴스가 목록에 나타납니다. 이 아이콘을 두 번 클릭하여 엽니다.
  5. 사이드킥에서 구성 요소(예: 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 ). When working with AEM there are several methods of managing the configuration settings for such services; see Configuring OSGi for more details and the recommended practices.

기본 서비스(일 CQ 보고 구성)

  • 표준 시간대는 생성되는 시간대 내역 데이터를 정의합니다. 이것은 내역 차트가 전세계 각 사용자에 대해 동일한 데이터를 표시하는지 확인하기 위한 것입니다.
  • 로케일은 내역 데이터에 대한 시간대와 함께 사용할 로케일을 정의합니다. 로케일은 일부 로케일별 달력 설정(예: 주의 첫날이 일요일인지 월요일인지)을 결정하는 데 사용됩니다.
  • 스냅샷 경로는 내역 차트에 대한 스냅샷이 저장되는 루트 경로를 정의합니다.
  • 보고서 경로는 보고서가 있는 경로를 정의합니다. 이 기능은 스냅샷 서비스에서 실제로 스냅샷을 찍을 보고서를 결정하는 데 사용됩니다.
  • 일별 스냅샷은 일별 스냅샷을 촬영하는 시간을 정의합니다. 지정된 시간은 서버의 로컬 시간대입니다.
  • 시간별 스냅숏은 시간별 스냅숏을 만들 때 각 시간의 분을 정의합니다.
  • 행(최대) 은 각 스냅샷에 대해 저장되는 최대 행 수를 정의합니다. 이 값은 합리적으로 선택해야 합니다.너무 높으면 저장소 크기에 영향을 주고, 너무 낮으면 내역 데이터를 처리하는 방식 때문에 데이터가 정확하지 않을 수 있습니다.
  • 허위 데이터 (활성화된 경우)는 fakedata 선택기를 사용하여 허위 내역 데이터를 만들 수 있습니다.비활성화된 경우 fakedata 선택기를 사용하면 예외가 발생합니다.
    데이터가 가짜이므로 테스트 및 디버깅 용도로만 ** 사용해야 합니다.
    선택기를 fakedata 사용하면 보고서가 암시적으로 완료되므로 모든 기존 데이터가 손실됩니다.데이터를 수동으로 복원할 수 있지만 시간이 많이 소요될 수 있습니다.
  • 스냅샷 사용자는 스냅샷 찍기에 사용할 수 있는 선택적 사용자를 정의합니다.
    기본적으로 보고서를 완료한 사용자에 대해 스냅숏이 만들어집니다. 계정이 복제되지 않아 이 사용자가 존재하지 않는 게시 시스템과 같은 경우에 대신 사용되는 대체 사용자를 지정하려고 할 수 있습니다.
    또한 사용자를 지정하면 보안 위험이 발생할 수 있습니다.
  • 스냅샷 사용자를 ​적용합니다. 활성화된 경우 스냅샷 사용자 아래에 지정된 사용자와 함께 모든 스냅샷을 만듭니다 . 제대로 처리되지 않으면 심각한 보안 문제가 발생할 수 있습니다.

캐시 설정(일 CQ 보고 캐시)

  • 활성화를 사용하면 보고서 데이터 캐시를 활성화하거나 비활성화할 수 있습니다. 보고서 캐시를 활성화하면 여러 요청 동안 보고서 데이터가 메모리에 유지됩니다. 이로 인해 성능이 향상될 수 있지만 메모리 사용량이 더 늘어날 수 있으며, 극심한 경우 메모리 부족 현상이 발생할 수 있습니다.
  • TTL은 보고서 데이터가 캐시되는 시간(초)을 정의합니다. 숫자가 높을수록 성능이 향상되지만 기간 내에 데이터가 변경될 경우 부정확한 데이터를 반환할 수도 있습니다.
  • 최대 항목은 언제든지 캐싱할 최대 보고서 수를 정의합니다.
보고서 데이터는 사용자 및 언어별로 다를 수 있습니다. 따라서 보고서 데이터는 보고서, 사용자 및 언어별로 캐시됩니다. 즉, 최대 항목 값이 2 실제로 다음 중 하나에 대한 데이터를 캐시합니다.
  • 언어 설정이 다른 두 사용자에 대한 보고서 1개
  • 사용자 1명과 보고서 2개