レポートの開発

AEMは、標準のレポートを選択できます。そのほとんどはレポートフレームワークに基づいています。

このフレームワークを使用して、これらの標準レポートを拡張することも、まったく新規のレポートを独自に開発することもできます。レポートフレームワークは、既存のCQ5の概念や原則と緊密に統合され、開発者は、CQ5に関する既存の知識をレポート開発の出発点として使用できます。

AEMで提供される標準レポートの場合:

メモ

独自のレポートの作成 - 例のチュートリアルでも、以下で説明する原理のうち使用できるものを示しています。

標準レポートを参照し、他の実装例を確認することもできます。

メモ

以下の例と定義では、次の表記が使用されています。

  • 各行は、次の場合にノードまたはプロパティを定義します。

    • 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の概念と似ています。主に​グループ化​と​集計​です。

  • データの取得と処理は、ほとんどサーバー側でおこなわれます。

  • クライアントは、事前処理されたデータの表示のみを担当します。 処理タスク(セルコンテンツ内のリンクの作成など)が軽微な場合にのみ実行されます。

レポートフレームワーク(標準レポートの構造で示される)は、処理キューによって供給される次の構成要素を使用します。

chlimage_1-248

レポートページ

レポートページ:

レポートベース

reportbase コンポーネントは、次のようにすべてのレポートの基礎となるものです。

  • 基になる結果セットのデータを提供するクエリの定義を保持します。

  • レポートに追加されたすべての列(columnbase)を含む、適応した段落システムです。

  • 使用可能なチャートタイプおよび現在アクティブなチャートタイプを定義します。

  • 編集ダイアログを定義します。このダイアログでは、ユーザーがレポートの特定の側面を設定できます。

列ベース

各列は、 columnbaseコンポーネントのインスタンスで、次のようなものがあります。

  • それぞれのレポートのparsys( reportbase )で使用される段落です。
  • 基になる結果セットへのリンクを定義します。つまり、この結果セット内で参照される特定のデータと、その処理方法を定義します。
  • 追加の定義が含まれる。例えば、使用可能な集計やフィルター、およびデフォルト値です。

クエリとデータの取得

クエリの概要は次のとおりです。

  • reportbase コンポーネントの一部として定義されます。

  • CQ QueryBuilder に基づいています。

  • レポートの基礎として使用されるデータを取得します。 結果セット(テーブル)の各行が、ノードに 1 つずつ関連付けられ、クエリから返されます。次に、個々の列に関する特定の情報を、このデータセットから抽出します。

  • 通常、次のデータから構成されます。

    • ルートパス。

      これにより、検索対象とするリポジトリのサブツリーが指定されます。

      パフォーマンスの低下を最小限にするため、クエリの対象をリポジトリの特定のサブツリーになるべく制限することをお勧めします。このルートパスは、レポートテンプレートで事前定義するか、または設定(編集)ダイアログでユーザーが設定することができます。

    • 1 つ以上の条件

      これらは、(最初の)結果セットの生成時に適用されます。ノードタイプの制限や、プロパティの制限などがあります。

重要な点は、クエリの結果セットに返されるノードを 1 つ使用して、レポートの行が 1 つ生成される(ノードと行は 1 対 1 の関係にある)ことです。

開発者は、レポートに対して定義したクエリによって、そのレポートに適切なノードセットが返されることを確認する必要があります。ただし、ノード自体に必要な情報をすべて保持する必要はありません。親ノードや子ノードから派生させることもできます。 例えば、ユーザーレポートで使用されるクエリでは、ノードタイプ(この場合は rep:user)に基づいてノードが選択されます。ただし、このレポートの列のほとんどは、これらのノードから直接データを取り出すのではなく、子ノードprofileからデータを取り出します。

Processing Queue

クエリによって返される結果セットのデータが、レポート上で行として表示されます。結果セットの各行は、(サーバー側の)いくつかのフェーズで処理をおこなってから、クライアントに転送され、レポートに表示されます。

次のような操作が可能です。

  • 基になる結果セットからの複数の値の抽出や取得。

    例えば、2 つのプロパティ値の差を計算することで、その 2 つの値を 1 つの値として処理できます。

  • 抽出した値の解決。様々な方法でおこなうことができます。

    例えば、パスをタイトル(対応する jcr:title プロパティの、わかりやすいコンテンツ)にマップできます。

  • 様々なポイントでのフィルターの適用

  • 必要に応じて、複合値を作成します。

    例えば、ユーザーに表示されるテキストから、値を作成してソートに使用したり、追加の URL を作成して(クライアント側で)リンクの作成に使用したりできます。

処理キューのワークフロー

処理キューのワークフローを以下に示します。

chlimage_1-249

処理キューのフェーズ

具体的な手順と要素は次のとおりです。

  1. 初期クエリ(reportbase)から返された結果を、値抽出を使用して基本的な結果セットに変換します。

    値抽出は、列のタイプによって自動的に選択されます。値抽出を使用して、基になる JCR クエリから値を読み取り、その値から結果セットを作成し、その後の処理で適用できるようにします。例えば、diff型の場合、値抽出器は2つのプロパティを読み取り、1つの値を計算して結果セットに追加します。 値抽出を構成できません。

  2. 生データを含むこの初期結果セットに、初期フィルターraw フェーズ)が適用されます。

  3. apply フェーズの定義に従い、値が前処理されます。

  4. 前処理された値に対して、フィルタリングpreprocessed フェーズに割り当てられています)が実行されます。

  5. 指定されたリゾルバーによって、値が解決されます。

  6. 解決された値に対して、フィルタリングresolved フェーズに割り当てられています)が実行されます。

  7. データはグループ化され、集計されます。

  8. 配列データは、 (文字列ベースの)リストに変換することで解決されます。

    この手順は、複数の値を持つ結果をリストに変換して表示できるようにする暗黙の手順です。複数の値を持つ JCR プロパティに基づいた(集計されていない)セル値が必要です。

  9. 値は再び前処理されたです。afterApply​フェーズで定義されたとおりです。

  10. データが並べ替えられます。

  11. 処理されたデータはクライアントに転送される。

メモ

基になるデータの結果セットを返す初期クエリは、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/reportpagesling:resourceTypeを使用する必要があります。

ページコンポーネントのカスタマイズは、(ほとんどの場合)必要ありません。

レポートベースコンポーネント

各レポートタイプには、/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
     ]
    

    adminユーザーが最後に変更したtextimageコンポーネントをすべて返します。

  • nodeTypes

    指定したノードタイプのみを結果セットに含める場合に使用します。複数のノードタイプを指定できます。

  • mandatoryProperties

    指定したプロパティをすべて持つノードのみを結果セットに含める場合に使用できます。**​プロパティの値は考慮されません。

すべてはオプションで、必要に応じて組み合わせることができますが、少なくとも1つを定義する必要があります。

チャート定義

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

      複数の設定を定義できるので、これを使用して現在アクティブなノードを定義できます。これらはノードの配列によって定義されます(これらのノードには必須の命名規則はありませんが、標準レポートでは通常、01xを使用します)。各ノードには次のプロパティがあります。

      • id

        アクティブなグラフのID。 チャート定義(definitions)のいずれかのチャートの ID に一致する必要があります。

  • definitions

    レポートでの使用が可能なチャートタイプを定義します。definitions のうち使用されるタイプが、active で指定されます。

    定義は、ノードの配列を使用して指定します(通常は01xという名前です)。それぞれに次のプロパティがあります。

    • id

      グラフID。

    • type

      使用可能なグラフのタイプ。 次から選択:

      • pie円グラフ。現在のデータのみから生成されます。

      • lineseries線系列(実際のスナップショットを表す点をつないだもの)履歴データからのみ生成されます。

    • グラフのタイプに応じて、追加のプロパティを使用できます。

      • グラフタイプpieの場合:

        • maxRadiusDouble/Long

          この円グラフで許容される半径の最大値、つまりこのチャートで許容される最大サイズ(凡例を使用しない場合)。fixedRadiusが定義されている場合は無視されます。

        • minRadiusDouble/Long

          円グラフで許容される最小半径。 fixedRadiusが定義されている場合は無視されます。

        • fixedRadius ( Double/Long)円グラフの固定半径を定義します。

      • グラフタイプlineseriesの場合:

        • totalsBoolean

          Total​を示す追加の行が表示される場合は、trueを指定します。
          デフォルト値: false

        • seriesLong

          表示する行数/系列数。
          デフォルト:9(この値は許容される最大値です)

        • hoverLimitLong

          ユーザーがグラフの凡例の異なる値または対応するラベルにマウスポインターを置いたときに、ポップアップを表示する集計スナップショット(各水平線に表示される点、異なる値を表す点)の最大数。

          デフォルト:35(現在のチャート設定で適用される個別の値が 35 個を超える場合は、ポップアップが表示されません)。

          このほかに、同時表示できるポップアップ数(凡例のテキストにマウスオーバーしたときに表示できる複数のポップアップ)を 10 個までに制限できます。

設定ダイアログ

各レポートには設定ダイアログを設定でき、ユーザーはレポートの様々なパラメーターを指定できます。 このダイアログは、レポートページが開いているときに「​を編集」ボタンを使用してアクセスできます。

このダイアログは、標準のCQ dialogで、そのように設定できます(詳しくは、 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

    セルの実値の計算に必要な、2 つ目のプロパティを定義します。このプロパティは、特定の列のタイプ(diff および sortable)でのみ使用されます。

    例えばワークフローインスタンスレポートの場合、開始時間と終了時間の時間差(ミリ秒単位)の実値を格納するときに使用するプロパティを指定できます。

  • secondarySubPath

    subPathと同様、 secondaryPropertyが使用される場合。

ほとんどの場合、property のみを使用します。

クライアントフィルター

クライアントフィルタは、サーバから返されたデータから、表示する情報を抽出する。

メモ

このフィルターは、サーバーサイドの処理全体が適用された後で、クライアントサイドで実行されます。

N:definitions
    N:data
        P:clientFilter [String]

clientFilter は、JavaScript 関数として、次のように定義されます。

  • 入力として、は1つのパラメーターを受け取ります。サーバーから返されるデータ(処理が完了している)
  • 出力時、フィルターを適用した後の(処理後の)値を返します。返すデータは、入力時のデータから抽出または取得したものです。

次の例では、コンポーネントのパスから対応するページパスが抽出されます。

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 で指定)から実値を取得することで、パスの値を解決します。例えば、path/content/.../page/jcr:contentjcr:titleプロパティの内容に解決できる場合、ページパスはページタイトルに解決されます。

    • pathextension

      パスを先頭に付加し、解決されたパスのノードのプロパティから実値を取得することで、値を解決します。例えば、国コードdeを言語の説明Germanに解決するために、値deの前に/libs/wcm/core/resources/languagesプロパティlanguageから値を取り出すパスを付けることができます。

  • resolverConfig

    リゾルバーの定義をおこないます。以下のうち使用できるオプションは、resolver の選択によって決まります。

    • const

      プロパティを使用して、解決する定数を指定します。プロパティの名前で、解決する定数を指定します。プロパティの値で、解決後の値を指定します。

      例えば、名前= 1および​ =Oneを持つプロパティは1を1に解決します。

    • default

      使用できる設定がありません。

    • page

      • (オプション)propertyName

        値の解決に使用するプロパティの名前を指定します。指定しなかった場合は、デフォルト値の​jcr:title(ページタイトル)が使用されます。pageリゾルバーの場合、つまり、最初にパスがページパスに解決され、次にページタイトルに解決されます。

    • path

      • (オプション)propertyName

        値の解決に使用するプロパティの名前を指定します。指定しなかった場合は、デフォルト値のjcr:titleが使用されます。

      • (オプション)subPath

        このプロパティは、値を解決する前にパスに付加する接尾辞を指定するときに使用します。

    • pathextension

      • path (mandatory)

        先頭に付加するパスを指定します。

      • propertyName (必須)

        実際の値が存在する解決されたパスのプロパティを定義します。

      • i18n (オプション)type Boolean)

        解決された値を​国際化​する(CQ5の国際化サービスを使用する)かどうかを指定します。

  • preprocessing

    前処理はオプションで、処理フェーズ​apply​または​applyAfter​に(別々に)バインドできます。

リゾルバー

リゾルバーは、必要な情報を抽出するために使用されます。 様々なリゾルバーの例を次に示します。

定数

次の式は、VersionCreatedのcontant値を文字列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(子)ノードの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 の定義は、次のどちらかに適用できます。

  • 元の値:

    元の値の前処理定義は、applyapplyAfterで直接指定します。

  • 値の集計:

    必要に応じて、集計ごとに個別の定義を指定できます。

    集計値の前処理を明示的に指定するには、前処理の定義をそれぞれのaggregated子ノード(apply/aggregatedapplyAfter/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正規表現または正規表現として定義)を指定し、 replaceパターンで置き換えます。

  • pattern

    サブ文字列の検索に使用する正規表現。

  • replace

    元の文字列の置き換えに使用する文字列、または文字列の表現。通常、pattern の正規表現によって検索される文字列のサブ文字列を示します。

置換の例を次のように分類できます。

  • 次の2つのプロパティを持つノード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

前処理 - データタイプフォーマッター

これらのフォーマッタは、数値を相対文字列に変換します。

例えば、minavgおよびmaxの集計を許可する時間列に使用できます。 min/ avg/ max集計は​時間差​として表示されます(例:10 days ago)の場合は、データフォーマッタが必要です。 この場合、datedeltaフォーマッタはmin/avg/max集計値に適用されます。 count集計も使用可能な場合は、元の値もフォーマッターは必要ありません。

現在使用可能なデータ型フォーマッターは次のとおりです。

  • format

    データタイプフォーマッター:

    • duration

      期間は、2つの定義済み日付の間の期間です。 例えば、ワークフローアクションの開始から終了までの時間を 1 時間とした場合、開始を 2011 年 2 月 13 日 11 時 23 分とすると、終了は 1 時間後の 2011 年 2 月 13 日 12 時 23 分となります。

      数値(ミリ秒と解釈)を期間文字列に変換します。例えば、30000は* 30s.*という形式で記述します。

    • datedelta

      過去の日付から「現在」までのタイムスパンです(したがって、レポートを後の時点で表示すると、結果が異なります)。

      数値(日単位の時間差として解釈)が、対応する日付の文字列に変換されます。例えば、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.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

イベントおよびアクション

編集設定を使用して、リスナーが検出する必要のあるイベントおよびそのイベント発生後に適用するアクションを定義できます。背景情報については、コンポーネント開発の概要を参照してください。

必要なアクションがすべて実行されるようにするには、次の値を指定します。

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 - filters
    • definitions/type — 列のタイプ(セレクター/コンボボックスまたは非表示のフィールドを使用して、ダイアログで定義する必要があります)
    • definitions/data/resolver と( definitions/data/resolverConfig ただし、または definitions/data/preprocessing ではな .../clientFilterい) — リゾルバーと設定
    • definitions/queryBuilder - query builderの設定
    • 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:resourceTypecq/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]

独自のレポートの作成 - 例

新しいレポートの定義

新しいレポートを定義するには、以下を作成して設定する必要があります。

  1. レポートコンポーネントのルート
  2. レポートベースコンポーネント
  3. 1 つ以上の列ベースコンポーネント
  4. レポートデザイン
  5. レポートテンプレートのルート
  6. レポートテンプレート

これらの手順を説明するために、次の例では、リポジトリ内のすべてのOSGi設定をリストするレポートを定義しています。つまり、sling:OsgiConfigノードのすべてのインスタンスです。

メモ

既存のレポートをコピーして新しいバージョンにカスタマイズすることもできます。

  1. 新しいレポートのルートノードを作成します。

    例えば、/apps/cq/reporting/components/osgireportの下に。

    N:cq [nt:folder]
        N:reporting [sling:Folder]
            N:components [sling:Folder]
                N:osgireport [sling:Folder]
    
  2. レポートベースを定義します。例えば、/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グラフの両方を表示します。
    • ユーザーがレポート設定できるダイアログを提供する
  3. 最初の列(columnbase)コンポーネントを定義します。例えば、/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"
    

    次のような列ベースコンポーネントを定義します。

    • サーバーから受信する値(この場合、jcr:path の各ノードの sling:OsgiConfig プロパティ)を検索し、その値を返す
    • count集計を提供します。
    • グループ化はできない
    • タイトル(テーブル内の列タイトル)は Bundle
    • サイドキックグループOSGi Reportにあります。
    • 指定のイベントで更新される
    メモ

    この例では、N:dataP:clientFilterの定義はありません。 これは、サーバーから受け取った値が1:1単位で返されるためです。これはデフォルトの動作です。

    これは定義と同じです。

    N:data [nt:unstructured]
       P:clientFilter [String] = "function(v) { return v; }"
    

    関数は、受け取った値を返すだけです。

  4. レポートデザインを定義します。例えば、/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"
    
  5. 新しいレポートテンプレートのルートノードを作成します。

    例えば、/apps/cq/reporting/templates/osgireportの下に。

    N:cq [nt:folder]
        N:reporting [sling:Folder]
            N:templates [sling:Folder]
                N:osgireport [cq:Template]
    
  6. レポートテンプレートを定義します。例えば、/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 のインスタンスをコピーするのが最も簡単な方法です)。

新規レポートのインスタンスの作成

新しいレポートのインスタンスを、次のように作成できます。

  1. ツール​コンソールを開きます。

  2. 左側のウィンドウで、「レポート」を選択します。

  3. 新規…​をツールバーから開きます。 タイトル​と​名前​を定義し、新しいレポートタイプ(OSGiレポートテンプレート)をテンプレートのリストから選択して、「作成」をクリックします。

  4. 新しいレポートインスタンスがリストに表示されます。 ダブルクリックして開きます。

  5. サイドキックからコンポーネント(この例では、「OSGi Report」グループの「バンドル」)をドラッグして最初の列を作成し、レポートの定義を開始します。

    メモ

    この例ではグループ化可能な列がないので、グラフは使用できません。 グラフを表示するには、groupabletrueに設定します。

    N:osgireport [sling:Folder]
     N:bundlecol [cq:Component]
     N:definitions [nt:unstructured]
     P:groupable [Boolean] = true
    

レポートフレームワークサービスの設定

この節では、レポートフレームワークの実装に使用する OSGi サービスの高度な設定オプションについて説明します。

これらは、Webコンソールの設定メニュー(http://localhost:4502/system/console/configMgrなど)を使用して表示できます。 AEM を操作しているときは、このようなサービスの設定を管理する方法がいくつかあります。詳細および推奨事項については、OSGi の設定を参照してください。

基本サービス(Day CQ レポート設定)

  • ​Timezoneは、タイムゾーン履歴データの作成対象となるタイムゾーンを定義します。これは、履歴グラフに世界中の各ユーザーの同じデータが表示されるようにするためです。

  • ​Localeは、履歴データに対してタイムゾーンと組み合わせて使用す ​るロケールを定義します。ロケールは、ロケール固有のカレンダー設定の一部(例えば、週の最初の日が日曜日か月曜日か)を決定するために使用されます。

  • スナップシ ョット・パスは、履歴グラフのスナップショットを保存するルート・パスを定義します。

  • レポートへ のパスは、レポートの場所のパスを定義します。これは、実際にスナップショットを取るレポートを決定するために、スナップショットサービスで使用されます。

  • 日別ス ナップショットは、日別のスナップショットを取る1日の時間を定義します。指定された時間は、サーバーのローカルタイムゾーンになります。

  • 時間別ス ナップショット:時間別スナップショットを取得する時間を1時間ごとに定義します。

  • 行数(最大) :各スナップショットに保存される最大行数を定義します。この値は合理的に選択する必要があります。値が大きすぎる場合は、リポジトリのサイズに影響します。値が小さすぎる場合は、履歴データの処理方法が原因で、データが正確でない可能性があります。

  • 偽のデータ(有効な場合)は、セレクターを使用して、偽の履歴データを作成で fakedata きます。無効にすると、セレクターを使 fakedata 用して例外がスローされます。

    フェイクデータは、必ずテストおよびデバッグの用途でのみ使用してください。**

    fakedata セレクターを使用すると、レポートが暗黙的に終了するので、既存のデータがすべて失われます。データは手動で復元できますが、非常に時間のかかる作業となります。

  • Snapshot user」で、スナップショットの取得に使用できるオプションのユーザーを指定します。

    通常、レポートを終了したユーザーに対してスナップショットが取得されます。例えばパブリッシュシステムで、ユーザーアカウントが複製されていないのでこのユーザーが存在しない場合など、このユーザーの代わりに使用する代替ユーザーの指定が必要な場合があります。

    ただし、ユーザーを指定するとセキュリティリスクが高まる可能性もあります。

  • Enforce snapshot user」を有効にすると、すべてのスナップショットが、「Snapshot user **」で指定したユーザーを使用して取得されます。正しく処理されないと、セキュリティに重大な影響が生じる可能性があります。

キャッシュ設定(Day CQ Reporting Cache)

  • ​「有効」を使用すると、レポートデータのキャッシュを有効または無効にできます。レポートのキャッシュを有効にすると、複数の要求がおこなわれる間、レポートデータがメモリに保持されます。これにより、パフォーマンスが向上しますが、メモリ消費が増加し、極端な状況ではメモリ不足になる場合があります。
  • ​TTLは、レポートデータをキャッシュする時間(秒)を定義します。数値を大きくするとパフォーマンスが向上しますが、期間内にデータが変更された場合は、不正確なデータが返される場合もあります。
  • 「最 大値」では、一度にキャッシュできるレポートの最大数を定義します。
メモ

レポートデータは、ユーザーと言語ごとに異なる場合があります。 したがって、レポートデータは、レポート、ユーザーおよび言語ごとにキャッシュされます。 つまり、Max entries​値2は、次のいずれかのデータを実際にキャッシュします。

  • 言語設定が異なる2人のユーザー向けの1つのレポート
  • 1 人のユーザーに対し、2 つのレポート

このページ