Rapporten ontwikkelen developing-reports

Deze verslagen zijn gebaseerd op het rapportagekader:

• Componentrapport
• Rapport Paginaactiviteit
• Gebruikersrapport
• Rapport voor werkstroominstantie

De volgende verslagen zijn gebaseerd op individuele beginselen en kunnen daarom niet worden uitgebreid:

• Schijfgebruik
• Health Check
• Workflowrapport

Het is volledig gebaseerd op resultaatreeksen die door een vraag zijn teruggekeerd die door CQ5 wordt uitgevoerd QueryBuilder.

De resultaatreeks bepaalt de gegevens die in het rapport worden getoond. Elke rij in de resultaatreeks beantwoordt aan een rij in de tabelmening van het rapport.

De verrichtingen beschikbaar voor uitvoering op de resultaatreeks lijken op concepten RDBMS; hoofdzakelijk groeperend en samenvoeging.

De meeste gegevens worden opgehaald en verwerkt op de server.

De klant is alleen verantwoordelijk voor de weergave van de vooraf verwerkte gegevens. Alleen kleine verwerkingstaken (bijvoorbeeld het maken van koppelingen in celinhoud) worden op de client uitgevoerd.

Behoudt de definitie van de vraagdie de onderliggende resultaatreeks gegevens levert.

Het is een aangepast alineasysteem dat alle kolommen ( columnbase) bevat die aan het rapport zijn toegevoegd.

Bepaalt welke grafiektypes beschikbaar zijn en die momenteel actief zijn.

Bepaalt de Edit dialoogdoos, die de gebruiker toestaat om bepaalde aspecten van het rapport te vormen.

Is gedefinieerd als onderdeel van de component reportbase .

Is gebaseerd op CQ QueryBuilder.

Haalt de gegevens op die als basis voor het rapport worden gebruikt. Elke rij van de resultaatreeks (lijst) is gebonden aan een knoop zoals teruggekeerd door de vraag. De specifieke informatie voor individuele kolommenwordt dan gehaald uit deze gegevensreeks.

Bestaat gewoonlijk uit:

• Een hoofdpad.

  Hiermee wordt de substructuur van de gegevensopslagruimte aangegeven die moet worden doorzocht.

  Om de invloed op de prestaties tot een minimum te beperken, is het raadzaam (probeer) de query te beperken tot een specifieke substructuur van de repository. De wortelweg kan of vooraf bepaald in het rapportmalplaatjezijn of door de gebruiker in de Configuratie (geef uit) dialoogdoosworden geplaatst.

• Één of meerdere criteria.

  Deze worden opgelegd om de (aanvankelijke) resultaatreeks te produceren; zij omvatten, bijvoorbeeld, beperkingen op het knooptype, of bezitsbeperkingen.

Waarden extraheren en afleiden van de onderliggende resultaatset.

U kunt bijvoorbeeld twee eigenschapswaarden als één waarde verwerken door het verschil tussen de twee waarden te berekenen.

Oplossen van geëxtraheerde waarden. Dit kan op verschillende manieren worden gedaan.

Bijvoorbeeld, kunnen de wegen aan een titel (zoals in de meer mens-leesbare inhoud van respectieve jcr worden in kaart gebracht:titel bezit).

Filters toepassen op verschillende punten.

Indien nodig samengestelde waarden maken.

Bijvoorbeeld bestaande uit een tekst die aan de gebruiker wordt getoond, een waarde die voor het sorteren en een extra URL moet worden gebruikt die (op de cliëntkant) voor het creëren van een verbinding wordt gebruikt.

propertyConstraints

Hiermee beperkt u het resultaat dat is ingesteld tot knooppunten met specifieke eigenschappen met specifieke waarden. Als de veelvoudige beperkingen worden gespecificeerd, moet de knoop aan elk van hen (EN verrichting) voldoen.

Bijvoorbeeld:

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

Retourneert alle textimage -componenten die het laatst door de admin -gebruiker zijn gewijzigd.

nodeTypes

Wordt gebruikt om het resultaat te beperken tot de opgegeven knooppunttypen. U kunt meerdere knooppunttypen opgeven.

mandatoryProperties

Beperkt het resultaat dat aan knopen wordt geplaatst die alle de gespecificeerde eigenschappen hebben. De waarde van de eigenschappen wordt niet verwerkt.

settings

Bevat definities voor de actieve grafieken.

• active

  Aangezien er meerdere instellingen kunnen worden gedefinieerd, kunt u dit gebruiken om te definiëren welke momenteel actief zijn. Deze worden gedefinieerd door een array van knooppunten (er is geen verplichte naamgevingsconventie voor deze knooppunten, maar in de standaardrapporten wordt vaak 0, 1 gebruikt… x), met elk de volgende eigenschap:

  • id

    Identificatie voor de actieve diagrammen. Dit moet overeenkomen met de id van een van de diagrammen definitions .

definitions

Bepaalt de grafiektypes die potentieel voor het rapport beschikbaar zijn. De definitions die moet worden gebruikt, wordt opgegeven door de active -instellingen.

De definities worden opgegeven met behulp van een array met knooppunten (ook hier 0 , 1 . x), elk met de volgende eigenschappen:

• id

  De identificatie van het diagram.

• type

  Het type beschikbare grafiek. Selecteren uit:

  • pie
    Cirkeldiagram. Alleen gegenereerd op basis van huidige gegevens.

  • lineseries
    Reeks lijnen (verbindende punten die de daadwerkelijke momentopnamen vertegenwoordigen). Alleen gegenereerd op basis van historische gegevens.

• Er zijn aanvullende eigenschappen beschikbaar, afhankelijk van het diagramtype:

  • voor het diagramtype pie :

    • maxRadius ( Double/Long)

      De maximumstraal die voor het cirkeldiagram wordt toegestaan; daarom de maximumgrootte die voor de grafiek (zonder legenda) wordt toegestaan. Genegeerd als fixedRadius is gedefinieerd.

    • minRadius ( Double/Long)

      De minimale straal die is toegestaan voor het cirkeldiagram. Genegeerd als fixedRadius is gedefinieerd.

    • fixedRadius ( Double/Long)
      Hiermee definieert u een vaste straal voor het cirkeldiagram.

  • voor het diagramtype lineseries :

    • totals ( Boolean)

      Waar als een extra lijn die toont Totaal zou moeten worden getoond.
      default: false

    • series ( Long)

      Aantal weer te geven lijnen/reeksen.
      standaard: 9 (dit is ook het toegestane maximum)

    • hoverLimit ( Long)

      Maximumaantal geaggregeerde momentopnamen (punten die op elke horizontale lijn worden weergegeven en die verschillende waarden vertegenwoordigen) waarvoor pop-ups moeten worden weergegeven. Dat wil zeggen, wanneer de gebruiker de muis boven een bepaalde waarde of een bijbehorend label in de diagramlegenda houdt.

      standaard: 35 (dat wil zeggen dat er helemaal geen pop-ups worden weergegeven als er meer dan 35 verschillende waarden van toepassing zijn voor de huidige diagraminstellingen).

      Er geldt een extra limiet van tien pop-ups die parallel kunnen worden weergegeven (er kunnen meerdere pop-ups worden weergegeven wanneer de muisaanwijzer op de legenda wordt geplaatst).

title

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

Het gebied van de tekst om de rapporttitel te bepalen.

description

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

Het gebied van de tekst om de rapportbeschrijving te bepalen.

processing

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

Selector voor de verwerkingsmodus van het rapport (gegevens handmatig/automatisch laden).

scheduling

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

Kiezer voor het plannen van momentopnamen voor de historische grafiek.

rootPath

Dit beperkt het rapport tot een bepaalde sectie (boom of subboom) van de bewaarplaats, die voor prestatiesoptimalisering wordt geadviseerd. Het hoofdpad wordt opgegeven door de eigenschap rootPath van het knooppunt report van elke rapportpagina (die bij het maken van de pagina uit de sjabloon wordt gehaald).

Deze kan worden gespecificeerd door:

• het rapportmalplaatje(of als vaste waarde of als standaardwaarde voor de configuratiedialoog).
• de gebruiker (met deze parameter)

property

Definieert de eigenschap die moet worden gebruikt voor het berekenen van de werkelijke celwaarde.

Als een bezit als Koord [] wordt bepaald, worden de veelvoudige eigenschappen gescand (in opeenvolging) om de daadwerkelijke waarde te vinden.

Als er bijvoorbeeld:

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

De corresponderende waarde-extractor (die hier wordt beheerd):

• Controleert of er een jcr:lastModified-eigenschap beschikbaar is en zo ja, gebruik deze.
• Als er geen eigenschap jcr:lastModified beschikbaar is, wordt in plaats daarvan de inhoud van jcr:created gebruikt.

subPath

Als het resultaat zich niet op de knoop bevindt die door de vraag is teruggekeerd, bepaalt subPath waar het bezit wordt gevestigd.

secondaryProperty

Een tweede eigenschap die moet worden gebruikt voor het berekenen van de werkelijke celwaarde. Deze definitie wordt alleen gebruikt voor bepaalde kolomtypen (diff en sortable).

Bijvoorbeeld, als er het Rapport van de Instanties van het Werkschema is, wordt het gespecificeerde bezit gebruikt om de daadwerkelijke waarde van het tijdverschil (in milliseconden) tussen begin en eindtijden op te slaan.

secondarySubPath

Gelijkaardig aan subPath, wanneer secondaryProperty wordt gebruikt.

resolver

Definieert de oplosser die moet worden gebruikt. De volgende oplosmiddelen zijn beschikbaar:

• const

  Wijst waarden toe aan andere waarden. Dit wordt bijvoorbeeld gebruikt om constanten zoals en op te lossen naar de equivalente waarde English .

• default

  De standaardoplosser. Dit is een nepoplosser die eigenlijk niets oplost.

• page

  Hiermee wordt een padwaarde omgezet in het pad van de juiste pagina, nauwkeuriger naar het corresponderende knooppunt jcr:content . /content/.../page/jcr:content/par/xyz wordt bijvoorbeeld omgezet in /content/.../page/jcr:content .

• path

  Hiermee lost u een padwaarde op door optioneel een subpad toe te voegen en de werkelijke waarde op te nemen vanuit een eigenschap van het knooppunt (zoals gedefinieerd door resolverConfig ) bij het omgezette pad. Een path van /content/.../page/jcr:content kan bijvoorbeeld worden omgezet in de inhoud van de eigenschap jcr:title , wat betekent dat een paginapad wordt omgezet in de paginatitel.

• pathextension

  Hiermee lost u een waarde op door een pad vooraf in te stellen en de werkelijke waarde van een eigenschap van het knooppunt op het opgeloste pad te nemen. Een waarde de kan bijvoorbeeld worden voorafgegaan door een pad, zoals /libs/wcm/core/resources/languages , dat de waarde van de eigenschap language neemt, om de landcode de op te lossen naar de taalbeschrijving German .

resolverConfig

Verstrekt definities voor resolver. Welke opties beschikbaar zijn, is afhankelijk van de geselecteerde resolver optie:

• const

  Gebruik eigenschappen om de constanten voor het omzetten op te geven. De naam van de eigenschap definieert de constante die moet worden omgezet; de waarde van de eigenschap definieert de herstelde waarde.

  Bijvoorbeeld, lost een bezit met Naam= 1 en Waarde =One 1 aan Één op.

• default

  Geen configuratie beschikbaar.

• page

  • propertyName (optioneel)

    Definieert de naam van de eigenschap die moet worden gebruikt voor het omzetten van de waarde. Als gespecificeerd niet, wordt de standaardwaarde van jcr:title (de paginatitel) gebruikt; voor page resolver, betekent dit dat eerst de weg aan de paginappad wordt opgelost, dan verder opgelost aan de paginatitel.

• path

  • propertyName (optioneel)

    Specifies the name of the property that should be used for resolving the value. Als deze niet wordt opgegeven, wordt de standaardwaarde van jcr:title gebruikt.

  • subPath (optioneel)

    Deze eigenschap kan worden gebruikt om een achtervoegsel op te geven dat aan het pad moet worden toegevoegd voordat de waarde wordt omgezet.

• pathextension

  • path (verplicht)

    Definieert het pad dat moet worden voorafgegaan.

  • propertyName (verplicht)

    Definieert de eigenschap op het omgezette pad waar de werkelijke waarde zich bevindt.

  • i18n (optioneel; type Boolean)

    Bepaalt of de opgeloste waarde ** zou moeten zijn geïnternationaliseerd (namelijk gebruikend de internationaliseringsdiensten van CQ5).

preprocessing

Het preprocessing is facultatief en kan (afzonderlijk) aan de verwerkingsfasen worden gebonden of applyAfter van toepassing zijn:

• apply

  De aanvankelijke preverwerkingsfase ( stap 3 in de vertegenwoordiging van de verwerkingsrij).

• applyAfter

  Pas na preprocessing ( stap 9 in de vertegenwoordiging van de verwerkingsrij) toe.

oorspronkelijke waarde:

De voorbewerkingsdefinitie voor de oorspronkelijke waarde wordt op apply en/of applyAfter direct opgegeven.

waarde in geaggregeerde toestand:

Indien nodig kan voor elke aggregatie een aparte definitie worden gegeven.

Als u expliciete voorbewerking voor geaggregeerde waarden wilt opgeven, moeten de voorbewerkingsdefinities zich op een respectievelijke aggregated onderliggende node ( apply/aggregated , applyAfter/aggregated ) bevinden. Als expliciete voorbewerking voor verschillende aggregaten is vereist, bevindt de voorbewerkingsdefinitie zich op een onderliggende node met de naam van het desbetreffende aggregaat (bijvoorbeeld apply/aggregated/min/max of andere aggregaten).

vind en vervang patronen
Wanneer dit wordt gevonden, wordt het opgegeven patroon (dat wordt gedefinieerd als een reguliere expressie) vervangen door een ander patroon. Dit kan bijvoorbeeld worden gebruikt om een subtekenreeks van het origineel te extraheren.

gegevenstypeopmaakprogramma's

Zet een numerieke waarde om in een relatieve tekenreeks. De waarde "die een tijdsverschil van één uur vertegenwoordigt, wordt bijvoorbeeld omgezet in een tekenreeks zoals 1:24PM (1 hour ago) .

pattern

De reguliere expressie die wordt gebruikt om een subtekenreeks te zoeken.

replace

De tekenreeks, of representatie van de tekenreeks, die wordt gebruikt als vervanging voor de oorspronkelijke tekenreeks. Dit vertegenwoordigt vaak een subtekenreeks van de tekenreeks die zich bevindt door de reguliere expressie pattern .

Voor het knooppunt definitions/data/preprocessing/apply met de volgende twee eigenschappen:

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

Een tekenreeks die aankomt als:

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

Verdeeld in vier secties:

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

En vervangen door de tekenreeks die wordt vertegenwoordigd door $1 :

• /content/geometrixx/en/services

format

Formatter voor gegevenstype:

• duration

  De duur is de tijdspanne tussen twee bepaalde data. Bijvoorbeeld het begin en einde van een werkstroomactie die één uur duurde, te beginnen bij 13/13/11 11:23u en één uur later te eindigen bij 13/11 12:23u.

  Een numerieke waarde (geïnterpreteerd als milliseconden) wordt omgezet in een duurtekenreeks. 30000 wordt bijvoorbeeld opgemaakt als * 30s .*

• datedelta

  Datadelta is de tijdspanwijdte tussen een datum in het verleden tot "nu"(zodat heeft het een verschillend resultaat als het rapport op een later punt in tijd wordt bekeken).

  De numerieke waarde (geïnterpreteerd als een tijdverschil in dagen) wordt omgezet in een relatieve datumtekenreeks. 1 is bijvoorbeeld een dag geleden opgemaakt.

type

De volgende opties zijn beschikbaar als standaardopties:

• string

• number

• int

• date

• diff

• timeslot

  Wordt gebruikt voor het extraheren van delen van een datum die nodig is voor aggregatie (bijvoorbeeld groep per jaar om gegevens voor elk jaar te verzamelen).

• sortable

  Wordt gebruikt voor waarden die verschillende waarden gebruiken (zoals die uit verschillende eigenschappen zijn opgehaald) voor het sorteren en weergeven.

Bovendien kan elk van de bovenstaande opties worden gedefinieerd als een meerwaarde, bijvoorbeeld: string[] definieert een array met tekenreeksen.

De waarde-extractor wordt gekozen door het kolomtype. Als een waarde-extractor beschikbaar is voor een kolomtype, wordt deze extractor gebruikt. Anders wordt de standaardwaarde voor de extractor gebruikt.

Een type kan (optioneel) een parameter nemen. timeslot:year extraheert bijvoorbeeld het jaar uit een datumveld. Typen met de bijbehorende parameters:

• timeslot - De waarden zijn vergelijkbaar met de overeenkomstige constanten van 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

Bepaalt of het rapport door deze kolom kan worden gegroepeerd.

filters

Filterdefinities.

• filterType

  Beschikbare filters zijn:

  • string

    Een op tekenreeks gebaseerd filter.

• id

  Filter-id.

• phase

  Beschikbare fasen:

  • raw

    Het filter wordt toegepast op onbewerkte gegevens.

  • preprocessed

    Het filter wordt toegepast op vooraf verwerkte gegevens.

  • resolved

    Het filter wordt toegepast op omgezette gegevens.

aggregates

Samengevoegde definities.

• text

  De tekstnaam van het aggregaat. Als text niet wordt gespecificeerd, dan neemt het de standaardbeschrijving van het aggregaat. minimum wordt bijvoorbeeld gebruikt voor het min aggregaat.

• type

  Samengevoegde tekst. Beschikbare aggregaten zijn:

  • count

    Telt het aantal rijen.

  • count-nonempty

    Telt het aantal niet-lege rijen.

  • min

    De minimumwaarde wordt opgegeven.

  • max

    Dit levert de maximumwaarde op.

  • average

    Het levert de gemiddelde waarde op.

  • sum

    Het verstrekt de som alle waarden.

  • median

    De mediaanwaarde wordt weergegeven.

  • percentile95

    Gebruikt het 95e percentiel van alle waarden.

aggregate

Geldige aggregate waarden zijn het zelfde als voor type onder aggregates (zie de Specifieke Definities van de Kolom (definities - filters/aggregaten)).

Stel de eigenschap type van het knooppunt definition van de kolom in op generic .

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

Geef een definitie van het dialoogvenster (standaard) op onder het knooppunt definition van de kolom.

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

• De velden van het dialoogvenster moeten naar dezelfde namen verwijzen als de overeenkomende componenteigenschap, inclusief het pad.

  Als u bijvoorbeeld het type algemene kolom configureerbaar wilt maken via het dialoogvenster, gebruikt u een veld met de naam ./definitions/type .

• Eigenschappen die zijn gedefinieerd met de interface/het dialoogvenster hebben voorrang op eigenschappen die zijn gedefinieerd voor de component columnbase .

Bepaal de Edit Configuratie.

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

Gebruik standaard AEM methoden om (aanvullende) kolomeigenschappen te definiëren.

Voor eigenschappen die op zowel de component als de kolominstanties worden bepaald, heeft de waarde op de kolominstantie belangrijkheid.

De eigenschappen die beschikbaar zijn voor een algemene kolom zijn:

• jcr:title - kolomnaam
• definitions/aggregates - aggregaten
• definitions/filters - filters
• definitions/type- het type van de kolom (dit moet in het dialoogvenster worden gedefinieerd met een kiezer/keuzelijst of een verborgen veld)
• definitions/data/resolver en definitions/data/resolverConfig (maar niet definitions/data/preprocessing of .../clientFilter) - de oplosser en configuratie
• definitions/queryBuilder - de configuratie van de querybuilder
• defaults/aggregate - het standaardaggregaat

Als er een nieuw geval van de generische kolom op het Rapport van de Gebruiker is, worden de eigenschappen die met de dialoog worden bepaald voortgeduurd onder:

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

/etc/designs/reports/<yourReport> is geschikt als het rapport zich onder /apps/cq/reporting bevindt

/etc/designs/<yourProject>/reports/<*yourReport*> voor rapporten met het patroon /apps/<yourProject>/reports

components

Om het even welke componenten en/of componentengroepen die op het rapport worden toegestaan.

sling:resourceType

Eigenschap met waarde cq/reporting/components/repparsys .

Stel de sling:resourceType in op cq/reporting/components/reportpage

het te gebruiken ontwerp aangeven

een onderliggende node van report maken die naar de container ( reportbase )-component met de eigenschap sling:resourceType verwijst

Tijdzone bepaalt de historische gegevens van de tijdzone waarvoor wordt gecreeerd. Dit moet ervoor zorgen dat de historische grafiek de zelfde gegevens voor elke gebruiker over de wereld toont.

bepaalt de Plaats van 0} {de scène die met Tijdzone voor historische gegevens moet worden gebruikt. De landinstelling wordt gebruikt om bepaalde landspecifieke kalenderinstellingen te bepalen (bijvoorbeeld of de eerste dag van een week zondag of maandag is).

de weg van de Momentopname bepaalt de wortelweg waar de momentopnamen voor historische grafieken worden opgeslagen.

Weg aan rapporten bepaalt de weg waar de rapporten worden gevestigd. Dit wordt gebruikt door de momentopnameservice om de rapporten te bepalen om momentopnamen voor eigenlijk te nemen.

Dagelijkse momentopnamen bepaalt het uur van elke dag wanneer de dagelijkse momentopnamen worden genomen. Het gespecificeerde uur is in lokale timezone van de server.

Uur momentopnamen bepaalt de minuut van elk uur wanneer de uurmomentopnamen worden genomen.

Rijen (maximum) bepaalt het maximumaantal rijen die voor elke momentopname worden opgeslagen. Deze waarde moet redelijkerwijs worden gekozen. Als het te hoog is, beïnvloedt dit de grootte van de gegevensopslagplaats, als te laag, kunnen de gegevens niet correct zijn wegens de manier waarop historische gegevens worden behandeld.

gegevens van de Vervaging, als toegelaten, kunnen de valse historische gegevens worden gecreeerd door de fakedata selecteur te gebruiken; als gehandicapt, dan het gebruik van de fakedata selecteur een uitzondering werpt.

Omdat het gegeven vals is, moet het slechts voor het testen en het zuiveren doeleinden worden gebruikt.

Als u de kiezer van fakedata gebruikt, wordt het rapport impliciet voltooid, zodat alle bestaande gegevens verloren gaan. Gegevens kunnen handmatig worden hersteld, maar dit kan een tijdrovend proces zijn.

gebruiker van de Momentopname bepaalt een facultatieve gebruiker die voor het nemen van momentopnamen kan worden gebruikt.

In feite worden momentopnamen gemaakt voor de gebruiker die het rapport heeft voltooid. Er kunnen situaties zijn (bijvoorbeeld op een publicatiesysteem, waar deze gebruiker niet bestaat omdat zijn account niet is gerepliceerd) waarin u een fallback-gebruiker wilt opgeven die in plaats daarvan wordt gebruikt.

Ook, zou het specificeren van een gebruiker een veiligheidsrisico kunnen opleggen.

afdwingen momentopname gebruiker, als toegelaten, worden alle momentopnamen genomen met de gebruiker die onder wordt gespecificeerd de gebruiker van de Momentopname. Dit kan ernstige gevolgen voor de beveiliging hebben als het niet correct wordt afgehandeld.