DokumentationAEM 6.5Användarhandbok

Utveckla rapporter developing-reports

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Utvecklare

Adobe Experience Manager (AEM) tillhandahåller ett urval av standardrapporter som i de flesta fall baseras på ett rapportramverk.

Med hjälp av ramverket kan du antingen utöka dessa standardrapporter eller utveckla egna, nya rapporter. Rapporteringsramverket är nära integrerat med befintliga CQ5-koncept och CQ5-principer så att utvecklarna kan använda sina befintliga kunskaper om CQ5 som en språngbräda för att utveckla rapporter.

För standardrapporter som levereras med AEM:

NOTE
I självstudien Creating Your Own Report - An Example visas även hur många av principerna nedan som kan användas.
Du kan även läsa standardrapporterna för att se andra exempel på implementering.
NOTE
I exemplen och definitionerna nedan används följande notering:

  • Varje rad definierar en nod eller en egenskap där:
    N:<name> [<nodeType>] : Beskriver en nod med namnet <*name*> och nodtypen <*nodeType*>.
    P:<name> [<propertyType] : Beskriver en egenskap med namnet <*name*> och egenskapstypen <*propertyType*>.
    P:<name> = <value> : Beskriver egenskapen <name> som måste anges till värdet <value>.

  • Indrag visar hierarkiska beroenden mellan noderna.

  • Objekt avgränsade med | betecknar en lista med möjliga objekt, till exempel typer eller namn. String|String[] betyder till exempel att egenskapen kan vara antingen String eller String [].

  • [] avbildar en array, till exempel String[] eller en array med noder som i Frågedefinitionen.

Om inget annat anges är standardtyperna:
  • Noder - nt:unstructured
  • Egenskaper - String

Reporting Framework reporting-framework

Rapporteringsramen fungerar enligt följande principer:

  • Den är helt baserad på resultatuppsättningar som returneras av en fråga som körs av CQ5 QueryBuilder.

  • Resultatuppsättningen definierar de data som visas i rapporten. Varje rad i resultatmängden motsvarar en rad i rapportens tabellvy.

  • De åtgärder som är tillgängliga för körning i resultatuppsättningen liknar RDBMS-koncept, främst gruppering och aggregering.

  • De flesta datahämtningar och databearbetningar görs på serversidan.

  • Klienten ansvarar själv för att visa förbehandlade data. Endast mindre bearbetningsuppgifter (till exempel att skapa länkar i cellinnehåll) utförs på klientsidan.

Rapporteringsramverket (illustrerat av strukturen i en standardrapport) använder följande byggstenar som matas av bearbetningskön:

chlimage_1-248

Rapportsida report-page

Rapportsidan är:

Rapportbas report-base

reportbase-komponentenutgör grunden för alla rapporter eftersom den:

  • Bevarar definitionen av frågan som levererar den underliggande resultatuppsättningen med data.

  • Det är ett anpassat styckesystem som innehåller alla kolumner ( columnbase) som lagts till i rapporten.

  • Definierar vilka diagramtyper som är tillgängliga och vilka som är aktiva.

  • Definierar dialogrutan Redigera, där användaren kan konfigurera vissa aspekter av rapporten.

Kolumnbas column-base

Varje kolumn är en instans av columnbase-komponenten som:

  • Är ett stycke som används av parsys ( reportbase) i respektive rapport.
  • Definierar länken till den underliggande resultatmängden. Det innebär att den definierar de specifika data som refereras i den här resultatuppsättningen och hur den bearbetas.
  • Bevarar ytterligare definitioner, t.ex. de aggregat och filter som är tillgängliga, tillsammans med eventuella standardvärden.

Fråga och datahämtning the-query-and-data-retrieval

Frågan:

  • Definieras som en del av komponenten reportbase.

  • Baseras på CQ QueryBuilder.

  • Hämtar data som används som grund för rapporten. Varje rad i resultatmängden (tabellen) är kopplad till en nod som returneras av frågan. Specifik information för enskilda kolumner extraheras sedan från den här datauppsättningen.

  • Oftast består de av

    • En rotsökväg.

      Detta anger det underträd i databasen som ska genomsökas.

      För att minimera prestandapåverkan är det tillrådligt att (försöka) begränsa frågan till ett specifikt underträd i databasen. Rotsökvägen kan antingen vara fördefinierad i rapportmallen eller inställd av användaren i dialogrutan Konfiguration (Redigera).

    • Ett eller flera villkor.

      Dessa används för att skapa den (inledande) resultatuppsättningen. De innehåller till exempel begränsningar för nodtypen eller egenskapsbegränsningar.

Nyckelpunkten här är att varje enskild nod som returneras i frågans resultatuppsättning används för att generera en enda rad i rapporten (så en 1:1-relation).

Utvecklaren måste se till att den fråga som definierats för en rapport returnerar en noduppsättning som är lämplig för den rapporten. Noden behöver dock inte innehålla all nödvändig information, den kan också härledas från överordnade och/eller underordnade noder. I frågan som används för användarrapporten väljs till exempel noder baserat på nodtypen (i det här fallet rep:user). De flesta kolumner i den här rapporten tar emellertid inte sina data direkt från de här noderna, utan från de underordnade noderna profile.

Bearbetar kö processing-queue

frågan returnerar en resultatuppsättning med data som ska visas som rader i rapporten. Varje rad i resultatuppsättningen bearbetas (på serversidan) i flera faser innan den överförs till klienten för visning i rapporten.

Detta gör att:

  • Extrahera och härleda värden från den underliggande resultatmängden.

    Du kan till exempel bearbeta två egenskapsvärden som ett enda värde genom att beräkna skillnaden mellan dem.

  • Lösa extraherade värden. Detta kan göras på olika sätt.

    Sökvägar kan till exempel mappas till en titel (som i det mer läsbara innehållet i respektive jcr:title -egenskap).

  • Använda filter vid olika punkter.

  • Skapa sammansatta värden, om det behövs.

    Exempel: en text som visas för användaren, ett värde som ska användas för sortering och en extra URL som används (på klientsidan) för att skapa en länk.

Bearbetningsköns arbetsflöde workflow-of-the-processing-queue

Följande arbetsflöde representerar arbetskön:

chlimage_1-249

Bearbetningsköns faser phases-of-the-processing-queue

Där detaljerade steg och element är:

  1. Omvandlar de resultat som returneras av den ursprungliga frågan (rapportbase) till den grundläggande resultatmängden med värdeextraherare.

    Värdeextraherare väljs automatiskt beroende på kolumntyp. De används för att läsa värden från den underliggande JCR-frågan och skapa en resultatuppsättning från dem. Därefter kan ytterligare bearbetning användas. För typen diff läser värdeextraheraren till exempel två egenskaper och beräknar det enskilda värdet som sedan läggs till i resultatuppsättningen. Det går inte att konfigurera värdeextraherarna.

  2. Till den ursprungliga resultatmängden, som innehåller rådata, används inledande filtrering (raw fas).

  3. Värdena är förbearbetade, enligt definitionen för fasen apply.

  4. Filtrering (tilldelad fasen förbearbetad) körs på de förbearbetade värdena.

  5. Värdena löses, enligt den definierade matcharen.

  6. Filtrering (tilldelad fasen resolved) körs på de lösta värdena.

  7. Data är grupperade och aggregerade.

  8. Matrisdata löses genom att de konverteras till en (strängbaserad) lista.

    Detta är ett implicit steg som konverterar ett flervärdesresultat till en lista som kan visas. Det krävs för (oaggregerade) cellvärden som baseras på JCR-egenskaper med flera värden.

  9. Värdena är förbearbetade igen, enligt definitionen för fasen afterApply .

  10. Data sorteras.

  11. De bearbetade data överförs till klienten.

NOTE
Den inledande frågan som returnerar basdataresultatuppsättningen definieras för komponenten reportbase.
Andra element i bearbetningskön definieras för columnbase-komponenterna.

Rapportkonstruktion och konfiguration report-construction-and-configuration

Följande krävs för att skapa och konfigurera en rapport:

Plats för rapportkomponenter location-of-report-components

Standardrapportkomponenterna finns under /libs/cq/reporting/components.

Vi rekommenderar dock att du inte uppdaterar de här noderna utan skapar egna komponentnoder under /apps/cq/reporting/components eller, om det är mer lämpligt, /apps/<yourProject>/reports/components.

Var (som ett exempel):

N:apps
    N:cq [nt:folder]
        N:reporting|reports [sling:Folder]
            N:components [sling:Folder]

I det här exemplet skapar du roten för rapporten och under det här komponenterna för rapportbasen och kolumnbaskomponenterna:

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

Sidkomponent page-component

En rapportsida måste använda sling:resourceType av /libs/cq/reporting/components/reportpage.

En anpassad sidkomponent ska inte vara nödvändig (vanligtvis).

Rapportbaskomponent report-base-component

Varje rapporttyp kräver en behållarkomponent som härletts från /libs/cq/reporting/components/reportbase.

Den här komponenten fungerar som en behållare för rapporten som helhet och ger information om:

N:<reportname> [cq:Component]
    P:sling:resourceSuperType = "cq/reporting/components/reportbase"
    N:charting
    N:dialog [cq:Dialog]
    N:queryBuilder

Frågedefinition query-definition

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

    Begränsar resultatet som angetts till noder som har specifika egenskaper med specifika värden. Om flera begränsningar anges måste noden uppfylla alla (AND-åtgärd).

    Till exempel:

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

    Returnerar alla textimage-komponenter som senast ändrades av användaren admin.

  • nodeTypes

    Används för att begränsa resultatet som angetts till de angivna nodtyperna. Du kan ange flera nodtyper.

  • mandatoryProperties

    Begränsar resultatmängden till noder som har all angivna egenskaper. Egenskapernas värde räknas inte.

Alla är valfria och kan kombineras om det behövs, men du måste definiera minst en av dem.

Diagramdefinitioner chart-definitions

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

    Innehåller definitioner för aktiva diagram.

    • active

      Eftersom det går att definiera flera inställningar kan du använda den här för att definiera vilka som är aktiva. Dessa definieras av en matris med noder (det finns ingen obligatorisk namnkonvention för dessa noder, men standardrapporterna använder ofta 0, 1. x), som alla har följande egenskap:

      • id

        Identifiering för aktiva diagram. Detta måste matcha ID för ett av diagrammet definitions.

  • definitions

    Definierar de diagramtyper som är tillgängliga för rapporten. definitions som ska användas anges av inställningarna för active.

    Definitionerna anges med hjälp av en matris med noder (som också ofta heter 0, 1. x) med följande egenskaper:

    • id

      Diagrammets identifiering.

    • type

      Diagramtyp som är tillgänglig. Välj bland:

      • pie
        Cirkeldiagram. Genereras endast från aktuella data.

      • lineseries
        En serie linjer (anslutningspunkter som representerar de faktiska fixeringarna). Genereras endast från historikdata.

    • Ytterligare egenskaper är tillgängliga, beroende på diagramtyp:

      • för diagramtypen pie:

        • maxRadius ( Double/Long)

          Den maximala radie som tillåts för cirkeldiagrammet. Därför är den maximala storlek som tillåts för diagrammet (utan teckenförklaring). Ignoreras om fixedRadius har definierats.

        • minRadius ( Double/Long)

          Den minsta radie som tillåts för cirkeldiagrammet. Ignoreras om fixedRadius har definierats.

        • fixedRadius ( Double/Long)
          Definierar en fast radie för cirkeldiagrammet.

      • för diagramtypen lineseries:

        • totals ( Boolean)

          True if an additional line displays the Total should be shown.
          standard: false

        • series ( Long)

          Antal rader/serier som ska visas.
          standard: 9 (detta är också det högsta tillåtna värdet)

        • hoverLimit ( Long)

          Maximalt antal aggregerade ögonblicksbilder (punkter som visas på varje vågrät linje, som representerar distinkta värden) som popup-fönster ska visas för. Det vill säga när användaren för musen över ett distinkt värde eller motsvarande etikett i diagramförklaringen.

          standard: 35 (d.v.s. inga popup-fönster visas alls om fler än 35 distinkta värden kan användas för de aktuella diagraminställningarna).

          Det finns ytterligare en begränsning på tio popup-fönster som kan visas parallellt (flera popup-fönster kan visas när muspekaren förs över förklaringstexterna).

Konfigurationsdialogruta configuration-dialog

Varje rapport kan ha en konfigurationsdialogruta där användaren kan ange olika parametrar för rapporten. Den här dialogrutan är tillgänglig via knappen Redigera när rapportsidan är öppen.

Den här dialogrutan är en standard-CQ dialogruta och kan konfigureras som sådan (mer information finns i CQ.Dialog).

En exempeldialogruta kan se ut så här:

<?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>

Flera förkonfigurerade komponenter har angetts. De kan refereras i dialogrutan med hjälp av egenskapen xtype med värdet cqinclude:

  • title

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

    Textfält som definierar rapportrubriken.

  • description

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

    Textområde som definierar rapportbeskrivningen.

  • processing

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

    Väljare för rapportens behandlingsläge (läsa in data manuellt/automatiskt).

  • scheduling

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

    Väljare för schemaläggning av ögonblicksbilder för det historiska diagrammet.

NOTE
De refererade komponenterna måste inkluderas med suffixet .infinity.json (se exemplet ovan).

Rotsökväg root-path

En rotsökväg kan också definieras för rapporten:

  • rootPath

    Detta begränsar rapporten till ett visst avsnitt (träd eller underträd) i databasen, vilket rekommenderas för prestandaoptimering. Rotsökvägen anges av egenskapen rootPath för noden report för varje rapportsida (hämtas från mallen när sidan skapas).

    Den kan anges av:

    • rapportmallen (antingen som ett fast värde eller som standardvärde för konfigurationsdialogrutan).
    • användaren (med den här parametern)

Kolumnbaskomponent column-base-component

Varje kolumntyp kräver en komponent som härletts från /libs/cq/reporting/components/columnbase.

En kolumnkomponent definierar en kombination av följande:

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

Se även Definiera din nya rapport.

Kolumnspecifik fråga column-specific-query

Detta definierar den specifika dataextraheringen (från rapportdataresultatuppsättningen) som ska användas i den enskilda kolumnen.

N:definitions
    N:queryBuilder
        P:property [String|String[]]
        P:subPath
        P:secondaryProperty [String|String[]]
        P:secondarySubPath

  • property

    Definierar den egenskap som ska användas för att beräkna det faktiska cellvärdet.

    Om en egenskap definieras som String[] skannas flera egenskaper (i sekvens) för att hitta det faktiska värdet.

    Om det till exempel finns:

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

    Motsvarande värdeextraherare (som kontrolleras här):

    • Kontrollerar om det finns en jcr:lastModified-egenskap och använd den i så fall.
    • Om ingen jcr:lastModified-egenskap är tillgänglig används innehållet i jcr:created i stället.

  • subPath

    Om resultatet inte finns på noden som returneras av frågan, definierar subPath var egenskapen finns.

  • secondaryProperty

    En andra egenskap som måste användas för att beräkna det faktiska cellvärdet. Den här definitionen används bara för vissa kolumntyper (diff och sortable).

    Om det till exempel finns en rapport över arbetsflödesinstanser används den angivna egenskapen för att lagra det faktiska värdet för tidsskillnaden (i millisekunder) mellan start- och sluttider.

  • secondarySubPath

    Liknar subPath när secondaryProperty används.

Vanligtvis används bara property.

Klientfilter client-filter

Klientfiltret extraherar informationen som ska visas från data som returneras av servern.

NOTE
Filtret körs på klientsidan när hela serverbearbetningen har tillämpats.
N:definitions
    N:data
        P:clientFilter [String]

clientFilter är en JavaScript-funktion som:

  • som indata, tar emot en parameter; data som returneras från servern (så fullständigt förbearbetad)
  • som utdata, returnerar det filtrerade (bearbetade) värdet, de data som extraherats eller härletts från indatainformationen

I följande exempel extraheras motsvarande sidsökväg från en komponentsökväg:

function(v) {
    var sepPos = v.lastIndexOf('/jcr:content');
    if (sepPos < 0) {
        return v;
    }
    return v.substring(sepPos + '/jcr:content'.length, v.length);
}

Lösning och förbearbetning resolvers-and-preprocessing

Bearbetningskön definierar de olika lösarna och konfigurerar förbearbetningen:

N:definitions
    N:data
        P:resolver
        N:resolverConfig
        N:preprocessing
            N:apply
            N:applyAfter

  • resolver

    Definierar den lösare som ska användas. Följande lösare är tillgängliga:

    • const

      Kopplar värden till andra värden. Detta används till exempel för att matcha konstanter som en med motsvarande värde English.

    • default

      Standardlösaren. Det här är en dummy-lösare som faktiskt inte löser någonting.

    • page

      Matchar ett sökvägsvärde till sökvägen för rätt sida, närmare bestämt till motsvarande jcr:content-nod. Till exempel är /content/.../page/jcr:content/par/xyz löst till /content/.../page/jcr:content.

    • path

      Löser ett sökvägsvärde genom att lägga till en delbana och ta det faktiska värdet från en egenskap i noden (som definieras av resolverConfig) vid den lösta sökvägen. En path av /content/.../page/jcr:content kan till exempel matchas mot innehållet i egenskapen jcr:title, vilket innebär att en sidsökväg matchas mot sidtiteln.

    • pathextension

      Löser ett värde genom att föregå en sökväg och ta det faktiska värdet från en egenskap för noden vid den lösta sökvägen. Ett värde de kan till exempel föregås av en sökväg som /libs/wcm/core/resources/languages, som tar värdet från egenskapen language, för att matcha landskoden de med språkbeskrivningen German.

  • resolverConfig

    Innehåller definitioner för lösaren. Vilka alternativ som är tillgängliga beror på vilken resolver som är vald:

    • const

      Använd egenskaper för att ange konstanter för matchning. Egenskapens namn definierar konstanten som ska lösas. Egenskapens värde definierar det lösta värdet.

      En egenskap med till exempel Namn= 1 och Värde =One matchar 1 till 1.

    • default

      Det finns ingen tillgänglig konfiguration.

    • page

      • propertyName (valfritt)

        Definierar namnet på egenskapen som ska användas för att matcha värdet. Om det inte anges används standardvärdet jcr:title (sidrubriken). För page-tolken innebär det att först matchas sökvägen till sidsökvägen och sedan matchas ytterligare till sidrubriken.

    • path

      • propertyName (valfritt)

        Anger namnet på egenskapen som ska användas för att matcha värdet. Om inget anges används standardvärdet jcr:title.

      • subPath (valfritt)

        Den här egenskapen kan användas för att ange ett suffix som ska läggas till i sökvägen innan värdet löses.

    • pathextension

      • path (obligatoriskt)

        Definierar den sökväg som ska användas som prepended.

      • propertyName (obligatoriskt)

        Definierar egenskapen på den lösta sökvägen där det faktiska värdet finns.

      • i18n (valfritt; typ Boolean)

        Avgör om det matchade värdet ska vara internationaliserat (d.v.s. med CQ5:s internationaliseringstjänster).

  • preprocessing

    Förbearbetningen är valfri och kan bindas (separat) till bearbetningsfaserna apply eller applyAfter:

Resolvers resolvers

Upplösarna används för att extrahera den information som krävs. Exempel på olika lösare är:

Konst

Följande löser ett konstantvärde på VersionCreated till strängen New version created.

Se /libs/cq/reporting/components/auditreport/typecol/definitions/data.

N:data
    P:resolver=const
    N:resolverConfig
        P:VersionCreated="New version created"

Sida

Matchar ett sökvägsvärde till egenskapen jcr:description på noden jcr:content (child) på motsvarande sida.

Se /libs/cq/reporting/components/compreport/pagecol/definitions/data.

N:data
    P:resolver=page
    N:resolverConfig
        P:propertyName="jcr:description"

Sökväg

Följande åtgärdar en sökväg på /content/.../page till innehållet i egenskapen jcr:title, vilket innebär att en sidsökväg matchas mot sidtiteln.

Se /libs/cq/reporting/components/auditreport/pagecol/definitions/data.

N:data
    P:resolver=path
    N:resolverConfig
        P:propertyName="jcr:title"
        P:subPath="/jcr:content"

Sökvägstillägg

I följande exempel läggs värdet de in med sökvägstillägget /libs/wcm/core/resources/languages, och sedan hämtas värdet från egenskapen language för att matcha landskoden de med språkbeskrivningen German.

Se /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"

Förbehandling preprocessing

Definitionen preprocessing kan användas på antingen:

  • ursprungligt värde:

    Förbearbetningsdefinitionen för det ursprungliga värdet anges direkt på apply och/eller applyAfter.

  • värdet i dess aggregerade tillstånd:

    Vid behov kan en separat definition ges för varje aggregering.

    Om du vill ange explicit förbearbetning för aggregerade värden måste förbearbetningsdefinitionerna finnas på en respektive aggregated-undernod ( apply/aggregated, applyAfter/aggregated). Om explicit förbearbetning för distinkta aggregat krävs, finns förbearbetningsdefinitionen på en underordnad nod med namnet på respektive aggregat (till exempel apply/aggregated/min/max eller andra aggregat).

Du kan ange något av följande för förbearbetning:

  • sök och ersätt mönster
    När det angivna mönstret (som definieras som ett reguljärt uttryck) hittas ersätts det med ett annat mönster. Det kan till exempel användas för att extrahera en delsträng av originalet.

  • datatypsformaterare

    Konverterar ett numeriskt värde till en relativ sträng. Värdet"som representerar en tidsskillnad på en timme skulle till exempel matchas till en sträng som 1:24PM (1 hour ago).

Till exempel:

N:definitions
    N:data
        N:preprocessing
            N:apply|applyAfter
                P:pattern         // regex
                P:replace         // replacement for regex
                // and/or
                P:format          // data type formatter

Förbehandling - Sök och ersätt mönster preprocessing-find-and-replace-patterns

För förbearbetning kan du ange en pattern (definierad som ett reguljärt uttryckeller regex) som finns och sedan ersätts med mönstret replace:

  • pattern

    Det reguljära uttryck som används för att hitta en delsträng.

  • replace

    Strängen, eller representationen av strängen, som används som ersättning för den ursprungliga strängen. Detta representerar ofta en delsträng av strängen som finns i det reguljära uttrycket pattern.

En exempelersättning kan delas upp som:

  • För noden definitions/data/preprocessing/apply med följande två egenskaper:

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

  • En sträng kommer fram som:

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

  • Indelad i fyra avsnitt:

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

  • Och ersatt med strängen som representeras av $1:

    • /content/geometrixx/en/services

Förbehandling - Datatyper för datafrågor preprocessing-data-type-formatters

Dessa formaterare konverterar ett numeriskt värde till en relativ sträng.

Detta kan till exempel användas för en tidskolumn som tillåter min-, avg- och max-aggregat. Eftersom min/ avg/ max-aggregat visas som en tidsskillnad (till exempel 10 days ago) krävs en dataformaterare. För detta tillämpas en datedelta-formaterare på aggregerade värden för min/ avg/ max. Om en count-mängd också är tillgänglig behöver den inte någon formaterare, inte heller det ursprungliga värdet.

Följande datatypsformaterare är tillgängliga:

  • format

    Datatypsformaterare:

    • duration

      Varaktighet är tidsintervallet mellan två definierade datum. Exempel: början och slutet av en arbetsflödesåtgärd som tog en timme, med början 11:23 den 13 december och avslutning en timme senare kl. 2.13.11 12:23.

      Det konverterar ett numeriskt värde (tolkas som millisekunder) till en varaktighetssträng. Till exempel formateras 30000 som * 30s.*

    • datedelta

      DataDelta är tidsintervallet mellan ett tidigare datum och"nu" (vilket ger ett annat resultat om rapporten visas vid en senare tidpunkt).

      Det konverterar det numeriska värdet (tolkas som en tidsskillnad i dagar) till en relativ datumsträng. 1 formateras till exempel som en dag sedan.

I följande exempel definieras datedelta-formatering för min- och max-aggregat:

N:definitions
    N:data
        N:preprocessing
            N:apply
                N:aggregated
                    N:min
                        P:format = "datedelta"
                    N:max
                        P:format = "datedelta"

Kolumnspecifika definitioner column-specific-definitions

Kolumnspecifika definitioner definierar de filter och aggregat som är tillgängliga för den kolumnen.

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

    Följande är tillgängliga som standardalternativ:

    • string

    • number

    • int

    • date

    • diff

    • timeslot

      Används för att extrahera delar av ett datum som behövs för aggregering (t.ex. gruppera efter år för att samla in data för varje år).

    • sortable

      Används för värden som använder olika värden (som tagits från olika egenskaper) för sortering och visning.

    Dessutom kan alla ovanstående definieras som flera värden. string[] definierar till exempel en matris med strängar.

    Värdeextraheraren väljs av kolumntypen. Om en värdeextraherare är tillgänglig för en kolumntyp används den här extraheraren. I annat fall används standardvärdeextraheraren.

    En typ kan (valfritt) ta en parameter. timeslot:year extraherar till exempel året från ett datumfält. Typer med sina parametrar:

    • timeslot - Värdena är jämförbara med motsvarande konstanter för 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

    Definierar om rapporten kan grupperas efter den här kolumnen.

  • filters

    Filterdefinitioner.

    • filterType

      Tillgängliga filter:

      • string

        Ett strängbaserat filter.

    • id

      Filteridentifierare.

    • phase

      Tillgängliga faser:

      • raw

        Filtret används på rådata.

      • preprocessed

        Filtret tillämpas på förbearbetade data.

      • resolved

        Filtret används på matchade data.

  • aggregates

    Sammanställningsdefinitioner.

    • text

      Sammanslagningens textnamn. Om text inte anges används standardbeskrivningen för sammanställningen. minimum används till exempel för sammanställningen min.

    • type

      Sammanslagningstyp. Tillgängliga aggregat är:

      • count

        Räknar antalet rader.

      • count-nonempty

        Räknar antalet rader som inte är tomma.

      • min

        Det innehåller det minsta värdet.

      • max

        Det ger det högsta värdet.

      • average

        Det ger det genomsnittliga värdet.

      • sum

        Här anges summan av alla värden.

      • median

        Det tillhandahåller medianvärdet.

      • percentile95

        Använder den 95:e percentilen av alla värden.

Standardvärden för kolumn column-default-values

Definierar standardvärden för kolumnen:

N:defaults
    P:aggregate

Händelser och åtgärder events-and-actions

Redigera konfiguration definierar de händelser som krävs för att avlyssnarna ska kunna identifiera och de åtgärder som ska utföras efter att dessa händelser inträffar. Se introduktionen till komponentutveckling för bakgrundsinformation.

Följande värden måste definieras för att säkerställa att alla nödvändiga åtgärder hanteras:

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"

Allmänna kolumner generic-columns

Allmänna kolumner är ett tillägg där (de flesta av) kolumndefinitionerna lagras på instansen av kolumnnoden (i stället för komponentnoden).

De använder en (standard) dialogruta som du kan anpassa för den enskilda generiska komponenten. I den här dialogrutan kan rapportanvändaren definiera kolumnegenskaperna för en allmän kolumn på rapportsidan (med menyalternativet Kolumnegenskaper…).

Ett exempel är kolumnen Allmänt i användarrapporten. Se /libs/cq/reporting/components/userreport/genericcol.

Så här gör du en kolumn generisk:

  • Ange egenskapen type för kolumnens definition-nod som generic.

    Se /libs/cq/reporting/components/userreport/genericcol/definitions

  • Ange en (standard) dialogrutedefinition under kolumnens definition-nod.

    Se /libs/cq/reporting/components/userreport/genericcol/definitions/dialog

    • Fälten i dialogrutan måste referera till samma namn som motsvarande komponentegenskap, inklusive dess sökväg.

      Om du till exempel vill göra den generiska kolumntypen konfigurerbar via dialogrutan använder du ett fält med namnet ./definitions/type.

    • Egenskaper som definierats med användargränssnittet/dialogrutan har företräde framför de som definierats för komponenten columnbase.

  • Definiera redigeringskonfiguration.

    Se /libs/cq/reporting/components/userreport/genericcol/cq:editConfig

  • Använd AEM standardmetoder för att definiera (ytterligare) kolumnegenskaper.

    För egenskaper som definieras för både komponent- och kolumninstanser har värdet för kolumninstansen företräde.

    De tillgängliga egenskaperna för en allmän kolumn är:

    • jcr:title - kolumnnamn
    • definitions/aggregates - aggregat
    • definitions/filters - filter
    • definitions/type- kolumntypen (detta måste definieras i dialogrutan, antingen med en väljare/kombinationsruta eller ett dolt fält)
    • definitions/data/resolver och definitions/data/resolverConfig (men inte definitions/data/preprocessing eller .../clientFilter) - lösaren och konfigurationen
    • definitions/queryBuilder - konfiguration för frågebyggaren
    • defaults/aggregate - standardsammanställningen

    Om det finns en ny instans av den generiska kolumnen i användarrapporten, kommer egenskaperna som definierats med dialogrutan att behållas under:

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

Rapportdesign report-design

Designen definierar vilka kolumntyper som är tillgängliga för att skapa en rapport. Den definierar också det styckesystem som kolumnerna läggs till i.

Adobe rekommenderar att du skapar en individuell design för varje rapport. På så sätt får du full flexibilitet. Se Definiera din nya rapport.

Standardrapportkomponenterna finns under /etc/designs/reports.

Platsen för dina rapporter beror på var komponenterna finns:

  • /etc/designs/reports/<yourReport> är lämpligt om rapporten är under /apps/cq/reporting

  • /etc/designs/<yourProject>/reports/<*yourReport*> för rapporter med mönstret /apps/<yourProject>/reports

Nödvändiga designegenskaper registreras på jcr:content/reportpage/report/columns (till exempel /etc/designs/reports/<reportName>/jcr:content/reportpage/report/columns):

  • components

    Alla komponenter och/eller komponentgrupper som tillåts i rapporten.

  • sling:resourceType

    Egenskap med värdet cq/reporting/components/repparsys.

Ett exempel på designutdrag (som tagits från komponentrapportens design) är:

<!-- ... -->
    <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>
<!-- ... -->

Du behöver inte ange designer för enskilda kolumner. Tillgängliga kolumner kan definieras i designläge.

NOTE
Adobe rekommenderar att du inte ändrar standardrapportdesignen. Detta för att säkerställa att du inte förlorar några ändringar när du uppgraderar eller installerar snabbkorrigeringar.
Kopiera rapporten och dess design om du vill anpassa en standardrapport.
NOTE
Standardkolumner kan skapas automatiskt när en rapport skapas. Dessa anges i mallen.

Rapportmall report-template

Varje rapporttyp måste innehålla en mall. Dessa är CQ-standardmallar och kan konfigureras som sådana.

Mallen måste:

  • ställ in sling:resourceType på cq/reporting/components/reportpage

  • ange vilken symbol som ska användas

  • skapa en underordnad report-nod som refererar till behållarkomponenten ( reportbase) med egenskapen sling:resourceType

Ett exempelmallutdrag (taget från komponentrapportmallen) är:

<!-- ... -->
    <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>
<!-- .. -->

Ett exempelmallutdrag som visar definitionen av rotsökvägen (som hämtats från användarrapportmallen) är:

<!-- ... -->
    <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>
<!-- .. -->

Standardrapportmallarna finns under /libs/cq/reporting/templates.

Adobe rekommenderar dock att du inte uppdaterar dessa noder. Skapa i stället egna komponentnoder under /apps/cq/reporting/templates eller, om det är mer lämpligt, /apps/<yourProject>/reports/templates.

Där, som ett exempel (se även Plats för rapportkomponenter):

N:apps
    N:cq [nt:folder]
        N:reporting|reports [sling:Folder]
            N:templates [sling:Folder]

Skapa roten för mallen under detta:

N:apps
    N:cq [nt:folder]
        N:reporting|reports [sling:Folder]
            N:templates [sling:Folder]
                N:<reportname> [sling:Folder]

Skapa en egen rapport - ett exempel creating-your-own-report-an-example

Definiera din nya rapport defining-your-new-report

Om du vill definiera en rapport skapar och konfigurerar du:

  1. Roten för rapportkomponenterna.
  2. Rapportbaskomponenten.
  3. En eller flera kolumnbaskomponenter.
  4. Rapportdesignen.
  5. Roten för rapportmallen.
  6. Rapportmallen.

För att illustrera dessa steg definierar följande exempel en rapport som visar alla OSGi-konfigurationer i databasen. Det vill säga alla instanser av noden sling:OsgiConfig.

NOTE
Att kopiera en befintlig rapport och sedan anpassa den nya versionen är en alternativ metod.

  1. Skapa rotnoden för den nya rapporten.

    Till exempel under /apps/cq/reporting/components/osgireport.

    code language-xml 
    N:cq [nt:folder]
    N:reporting [sling:Folder]
        N:components [sling:Folder]
            N:osgireport [sling:Folder]

  2. Definiera din rapportbas. Till exempel osgireport[cq:Component] under /apps/cq/reporting/components/osgireport.

    code language-xml 
    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"

    Detta definierar en rapportbaskomponent som:

    • söker efter alla noder av typen sling:OsgiConfig
    • visar både pie och lineseries diagram
    • innehåller en dialogruta där användaren kan konfigurera rapporten

  3. Definiera den första kolumnkomponenten (columnbase). Till exempel bundlecol[cq:Component] under /apps/cq/reporting/components/osgireport.

    code language-xml 
    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"

    Detta definierar en kolumnbaskomponent som:

    • söker efter och returnerar värdet som tas emot från servern, i det här fallet egenskapen jcr:path för varje sling:OsgiConfig-nod
    • tillhandahåller sammanställningen count
    • är inte grupperingsbar
    • har rubriken Bundle (kolumnrubrik i tabellen)
    • finns i sidospargruppen OSGi Report
    • uppdaterar vid angivna händelser
    note note
    NOTE
    I det här exemplet finns det inga definitioner för N:data och P:clientFilter. Detta beror på att värdet som tas emot från servern returneras på 1:1-basis, vilket är standardbeteendet.
    Detta är samma som definitionerna:
    code language-none 
    N:data [nt:unstructured]
   P:clientFilter [String] = "function(v) { return v; }"
    Där funktionen returnerar värdet som den får.

  4. Definiera rapportdesignen. Till exempel osgireport[cq:Page] under /etc/designs/reports.

    code language-xml 
    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. Skapa rotnoden för den nya rapportmallen.

    Till exempel under /apps/cq/reporting/templates/osgireport.

    code language-xml 
    N:cq [nt:folder]
    N:reporting [sling:Folder]
        N:templates [sling:Folder]
            N:osgireport [cq:Template]

  6. Definiera rapportmallen. Till exempel osgireport[cq:Template] under /apps/cq/reporting/templates.

    code language-xml 
    N:osgireport [cq:Template]
    P:allowedPaths [String[]] = "/etc/reports(/.*)?"
    P:jcr:description [String] = "Use this report generator to create an 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]

    Detta definierar en mall som:

    • definierar allowedPaths för de resulterande rapporterna - i ovanstående fall var som helst under /etc/reports
    • innehåller rubriker och beskrivningar för mallen
    • innehåller en miniatyrbild som kan användas i malllistan (den fullständiga definitionen för den här noden visas inte ovan - det är enklast att kopiera en instans av miniatyrbild.png från en befintlig rapport).

Skapa en instans av din nya rapport creating-an-instance-of-your-new-report

En instans av din nya rapport kan nu skapas:

  1. Öppna konsolen Verktyg.

  2. Välj Rapporter i den vänstra rutan.

  3. Nytt… från verktygsfältet. Definiera en titel och namn, välj den nya rapporttypen (OSGi-rapportmallen) i listan med mallar och klicka sedan på Skapa.

  4. Den nya rapportinstansen visas i listan. Dubbelklicka här för att öppna.

  5. Dra en komponent (till exempel Bundle i gruppen OSGi Report) från sidosparken för att skapa den första kolumnen och starta rapportdefinitionen.

    note note
    NOTE
    Eftersom det här exemplet inte har några grupperbara kolumner är diagrammen inte tillgängliga. Om du vill visa diagram anger du groupable till true:
    code language-none 
    N:osgireport [sling:Folder]
 N:bundlecol [cq:Component]
 N:definitions [nt:unstructured]
 P:groupable [Boolean] = true

Konfigurera Report Framework Services configuring-the-report-framework-services

I det här avsnittet beskrivs avancerade konfigurationsalternativ för OSGi-tjänster som implementerar rapportramverket.

Dessa kan visas med hjälp av webbkonsolens konfigurationsmeny (finns på till exempel http://localhost:4502/system/console/configMgr). När du arbetar med AEM finns det flera metoder för att hantera konfigurationsinställningarna för sådana tjänster. Mer information och rekommenderade tillvägagångssätt finns i Konfigurera OSGi.

Grundläggande tjänst (dagskonfiguration för CQ-rapportering) basic-service-day-cq-reporting-configuration

  • Tidszonen definierar tidszonens historiska data som skapas för. Detta är för att säkerställa att det historiska diagrammet visar samma data för varje användare runt om i världen.

  • Språk definierar språkområdet som ska användas med Tidszon för historiska data. Språkinställningen används för att bestämma vissa språkspecifika kalenderinställningar (t.ex. om den första dagen i en vecka är söndag eller måndag).

  • Sökväg till ögonblicksbild definierar rotsökvägen där ögonblicksbilder för historiska diagram lagras.

  • Sökvägen till rapporter definierar sökvägen där rapporter finns. Detta används av ögonblicksbildstjänsten för att fastställa vilka rapporter som ska ta ögonblicksbilder.

  • Dagliga ögonblicksbilder definierar timmen på varje dag när dagliga ögonblicksbilder tas. Den angivna timmen finns i serverns lokala tidszon.

  • Ögonblicksbilder per timme definierar minuten i varje timme när ögonblicksbilder tas varje timme.

  • Rader (max) definierar det maximala antalet rader som lagras för varje ögonblicksbild. Detta värde bör väljas på ett rimligt sätt. Om den är för hög påverkar detta databasens storlek, om den är för låg, kanske data inte är korrekta på grund av sättet historikdata hanteras på.

  • Om Fake-data är aktiverat kan falska historikdata skapas med fakedata-väljaren. Om den är inaktiverad genereras ett undantag om du använder fakedata-väljaren.

    Eftersom data är falska får endast användas för testning och felsökning.

    Om du använder fakedata-väljaren avslutas rapporten implicit, så alla befintliga data går förlorade. Data kan återställas manuellt, men det kan ta lång tid.

  • Snapshot-användare definierar en valfri användare som kan användas för att ta ögonblicksbilder.

    I princip tas ögonblicksbilder för användaren som är klar med rapporten. Det kan finnas situationer (till exempel i ett publiceringssystem där användaren inte finns eftersom kontot inte har replikerats) där du vill ange en reservanvändare som används i stället.

    Att ange en användare kan dessutom innebära en säkerhetsrisk.

  • Framtvinga användare av ögonblicksbilder, om det här alternativet är aktiverat, tas alla ögonblicksbilder med användaren som anges under Snapshot-användare. Detta kan få allvarliga konsekvenser för säkerheten om det inte hanteras på rätt sätt.

Cacheinställningar (dagars CQ-rapportcache) cache-settings-day-cq-reporting-cache

  • Med Aktivera kan du aktivera eller inaktivera cachelagring av rapportdata. Om du aktiverar rapportcachen sparas rapportdata i minnet under flera begäranden. Detta kan öka prestandan, men leder till högre minnesförbrukning och kan i extrema situationer leda till minnesbrist.
  • TTL definierar den tid (i sekunder) för vilken rapportdata cachelagras. Ett högre tal ökar prestandan, men kan också returnera felaktiga data om data ändras under tidsperioden.
  • Max antal poster definierar det maximala antalet rapporter som kan cachas åt gången.
NOTE
Rapportdata kan vara olika för olika användare och språk. Därför cachelagras rapportdata per rapport, användare och språk. Det innebär att Max-poster-värdet 2 faktiskt cachelagrar data för antingen:
  • en rapport för två användare med olika språkinställningar
  • en användare och två rapporter
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2