DocumentatieAEM 6.4Handleiding voor ontwikkeling

Voorlopige naslaggids voor Query Builder query-builder-predicate-reference

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Developer
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Algemeen general

Voorspellen predicates

boolproperty boolproperty

Komt overeen met de JCR BOOLEAN-eigenschappen. Accepteert alleen de waarden " true" en " false". In het geval van " false", komt deze overeen als de eigenschap de waarde " false" of als het überhaupt niet bestaat. Dit kan handig zijn om te controleren op Booleaanse markeringen die alleen zijn ingesteld wanneer deze zijn ingeschakeld.

De overgeërfde " operation" parameter heeft geen betekenis.

Ondersteunt facetextractie. Zal emmers leveren voor elk true of false waarde, maar alleen voor bestaande eigenschappen.

Eigenschappen properties

  • boolproperty
    relatief pad naar eigenschap, bijvoorbeeld
    myFeatureEnabled of jcr:content/myFeatureEnabled

  • value
    waarde waarop de eigenschap moet worden gecontroleerd, "
    true" of " false"

contentfragment contentfragment

Hiermee beperkt u het resultaat tot inhoudsfragmenten.

Filteren wordt niet ondersteund.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen properties-1

  • contentfragment
    Deze kan met elke waarde worden gebruikt om te controleren op inhoudsfragmenten.

dateComparison datecomparison

Vergelijkt twee JCR DATE-eigenschappen met elkaar. Kan testen of ze gelijk, ongelijk, groter dan of groter dan of gelijk zijn.

Dit is een voorspelling die alleen kan worden gefilterd en kan geen zoekindex gebruiken.

Eigenschappen properties-2

  • property1

    path to first date, eigenschap

  • property2

    path to second date, eigenschap

  • bewerking

    " =" voor exacte overeenkomst, " !=" voor de vergelijking van ongelijkheid " >" voor eigenschap1 groter dan eigenschap2, " >=" voor property1 groter dan of gelijk aan property2. De standaardwaarde is " =".

daterange daterange

Hiermee worden de JCR-DATE-eigenschappen vergeleken met een datum-/tijdinterval. Dit gebruikt ISO8601
notatie voor datums en tijden ( YYYY-MM-DDTHH:mm:ss.SSSZ) en staat ook gedeeltelijke vertegenwoordiging toe, zoals YYYY-MM-DD. U kunt de tijdstempel ook opgeven als het aantal milliseconden dat is verstreken sinds 1970 in de UTC-tijdzone, de unieke tijdnotatie.

U kunt zoeken naar iets tussen twee tijdstempels, alles wat nieuwer of ouder is dan een bepaalde datum, en u kunt ook kiezen tussen inclusieve en open intervallen.

Ondersteunt facetextractie. Zal emmers "vandaag", "deze week", "deze maand", "laatste 3 maanden", "dit jaar", "vorig jaar" en "eerder dan vorig jaar" leveren.

Filteren wordt niet ondersteund.

Eigenschappen properties-3

  • eigenschap

    relatief pad naar een DATE eigenschap, bijvoorbeeld jcr:lastModified

  • lowerBound

    lagere datum gebonden aan check eigenschap for, bijvoorbeeld 2014-10-01

  • lowerOperation

    " >" (nieuwer) of " >=" (bij of hoger), van toepassing op lowerBound. De standaardwaarde is " >".

  • upperBound

    bovenaan gebonden om eigenschap te controleren voor, bijvoorbeeld 2014-10-01T12:15:00

  • upperOperation

    " <" (ouder) of " <=" (bij of ouder) upperBound. De standaardwaarde is " <".

  • timeZone

    Id van tijdzone die moet worden gebruikt wanneer deze niet wordt gegeven als een ISO-8601-datumtekenreeks. De standaardwaarde is de standaardtijdzone van het systeem.

exclusief paden excludepaths

Hiermee sluit u knooppunten uit van het resultaat wanneer het pad ervan overeenkomt met een reguliere expressie.

Dit is een voorspelling die alleen kan worden gefilterd en kan geen zoekindex gebruiken.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen properties-4

  • exclusief paden

    reguliere expressie komt overeen met resultaatpaden, met uitzondering van overeenkomende paden uit het resultaat.

fulltext fulltext

Zoekt naar termen in de fullText-index.

Filteren wordt niet ondersteund.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen properties-5

  • fulltext

    de zoekterm(en) voor fulltext

  • relPath

    het relatieve pad naar de eigenschap of het subknooppunt. Deze eigenschap is optioneel.

groep group

Hiermee kunt u geneste voorwaarden maken. Groepen kunnen geneste groepen bevatten. Alles in een querybuilderquery bevindt zich impliciet in een hoofdgroep, die kan hebben p.or en p.not ook parameters.

Voorbeeld voor het afstemmen van een van beide eigenschappen op een waarde:

group.p.or=true
group.1_property=jcr:title
group.1_property.value=My Page
group.2_property=navTitle
group.2_property.value=My Page

Dit is conceptueel (1_property OF 2_property).

Voorbeeld voor geneste groepen:

fulltext=Management
group.p.or=true
group.1_group.path=/content/geometrixx/en
group.1_group.type=cq:Page
group.2_group.path=/content/dam/geometrixx
group.2_group.type=dam:Asset

Hiermee wordt gezocht naar de term "Beheer" binnen pagina's in /content/geometrixx/en of in activa /content/dam/geometrixx.

Dit is conceptueel fulltext AND ( (path AND type) OR (path AND type) ). Houd er rekening mee dat dergelijke OR-verbindingen goede indexen nodig hebben voor de prestaties.

Eigenschappen properties-6

  • p.or

    indien ingesteld op " true", slechts één predikaat in de groep moet aanpassen. Dit is standaard " false", wat betekent dat alles moet overeenkomen

  • p.not

    indien ingesteld op " true", wordt de groep genegeerd (standaard ingesteld op " false")

  • <predicate>

    voegt geneste voorspellingen toe

  • N_<predicate>

    voegt meerdere geneste voorspellingen van hetzelfde moment toe, zoals 1_property, 2_property, ...

hasPermission haspermission

Beperkt het resultaat tot punten waar de huidige zitting gespecificeerde heeft JCR-bevoegdheden.

Dit is een voorspelling die alleen kan worden gefilterd en kan geen zoekindex gebruiken. Het ondersteunt geen facetextractie.

Eigenschappen properties-7

  • hasPermission

    de door komma's gescheiden voorrechten van het JCR die de huidige gebruikerszitting ALLE voor de knoop in kwestie moet hebben; bijvoorbeeld jcr:write, jcr:modifyAccessControl

taal language

Hiermee zoekt u CQ-pagina's in een specifieke taal. Hierbij wordt zowel naar de eigenschap language van de pagina als naar het paginapad gekeken, dat vaak de taal of landinstelling in een sitestructuur op hoofdniveau bevat.

Dit is een voorspelling die alleen kan worden gefilterd en kan geen zoekindex gebruiken.

Ondersteunt facetextractie. Zal emmers voor elke unieke taalcode verstrekken.

Eigenschappen properties-8

  • taal

    ISO-taalcode, bijvoorbeeld " de"

hoofdmiddel mainasset

Controleert of een knooppunt een DAM-hoofdmiddel is en geen subelement. Dit is eigenlijk elk knooppunt dat zich niet binnen een 'subassets'-knooppunt bevindt. Dit controleert niet op de dam:Asset knooppunttype. Om dit te gebruiken predikaat, eenvoudig plaats " mainasset=true" of " mainasset=false" , zijn er geen eigenschappen meer.

Dit is een voorspelling die alleen kan worden gefilterd en kan geen zoekindex gebruiken.

Ondersteunt facetextractie. Twee emmers voor hoofd- en subactiva.

Eigenschappen properties-9

  • hoofdmiddel

    boolean, " true" voor de belangrijkste activa, " false" voor subactiva

lidOf memberof

Hiermee worden items gevonden die lid zijn van een specifieke slingerbronverzameling.

Dit is een voorspelling die alleen kan worden gefilterd en kan geen zoekindex gebruiken. Biedt geen ondersteuning voor facetextractie.

Eigenschappen properties-10

  • lidOf

    pad van Sling-bronverzameling

nodenaam nodename

Komt overeen met namen van JCR-knooppunten.

Ondersteunt facetextractie. Wordt gebruikt voor emmers voor elke unieke knooppuntnaam (bestandsnaam).

Eigenschappen properties-11

  • nodenaam

    nodennaampatroon dat jokertekens toestaat: * = een of geen teken, ? = een teken, [abc] = alleen tekens tussen haakjes

notexpired notexpired

Komt overeen met items door te controleren of een JCR DATE-eigenschap groter of gelijk is aan de huidige servertijd. Hiermee kunt u een " expiresAt" Vergelijkbare datum, eigenschap en beperking tot alleen de eigenschappen die nog niet zijn verlopen ( notexpired=true) of die reeds zijn verlopen ( notexpired=false).

Filteren wordt niet ondersteund.

Ondersteunt facetextractie op dezelfde manier als de daterange predikaat.

Eigenschappen properties-12

  • notexpired

    boolean, " true" nog niet verstreken (datum in de toekomst of gelijk aan), " false" voor verlopen (datum in het verleden) (vereist)

  • eigenschap

    relatief pad naar DATE te controleren eigenschap (vereist)

ordonneren orderby

Hiermee kunt u het resultaat sorteren. Als het opdracht geven door veelvoudige eigenschappen wordt vereist, moet dit voorspellen veelvoudige tijden toevoegen gebruikend het aantalprefix, zoals 1_orderby=first, 2_oderby=second.

Eigenschappen properties-13

  • ordonneren

    De JCR-eigenschapsnaam die wordt aangeduid door een regelafstand @, bijvoorbeeld @jcr:lastModified of @jcr:content/jcr:titleof een andere voorspelling in de query, bijvoorbeeld 2_property, waarop wordt gesorteerd

  • sorteren

    sorteerrichting: " desc" voor aflopend of " asc" voor oplopend (standaard)

  • case

    indien ingesteld op " ignore" het sorteren ongevoelig zal maken, wat betekent dat "a" vóór "B" komt; indien leeg of weggelaten, wordt onderscheid gemaakt tussen hoofdletters en kleine letters, wat betekent dat "B" voor "a" komt

pad path

Hiermee zoekt u in een bepaald pad.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen properties-14

  • pad

    padpatroon; afhankelijk van de exacte waarde, komt de volledige substructuur overeen (zoals bij toevoegen) //* in xpath, maar merk op dat dit niet het basispad bevat) (exact=false, standaard) of alleen een exact pad dat overeenkomt met, wat jokertekens kan bevatten ( *); als self is ingesteld, wordt de gehele substructuur, inclusief het basisknooppunt, doorzocht

  • exact

    indien exact is waar/aan, moet de nauwkeurige weg aanpassen maar het kan eenvoudige vervangingen bevatten ( *), die gelijk zijn aan namen, maar niet " /"; als deze onwaar is (standaard), worden alle afstammingen opgenomen (optioneel)

  • plat

    zoekt alleen de directe onderliggende objecten (zoals toevoegen " /*" in xpath) (alleen gebruikt als " exact' is niet waar, optioneel)

  • zelfzucht

    zoekt de subtree maar omvat de basisknoop die als weg (geen vervangingen) wordt gegeven

eigenschap property

Komt overeen met de JCR-eigenschappen en hun waarden.

Ondersteunt facetextractie. Zal emmers verstrekken voor elke unieke eigenschapwaarde in de resultaten.

Eigenschappen properties-15

  • eigenschap

    relatief pad naar eigenschap, bijvoorbeeld jcr:title

  • value

    waarde om eigenschap te controleren voor; volgt het JCR-eigenschapstype op tekenreeksconversies

  • N_value

    gebruiken 1_value, 2_value, … controleren op meerdere waarden (gecombineerd met OR standaard, met AND if en=true) (sinds 5.3)

  • en

    ingesteld op true voor het combineren van meerdere waarden ( N_value) met EN (sinds 5.3)

  • bewerking

    " equals" voor exacte overeenkomst (standaardwaarde), " unequals" voor de vergelijking van ongelijkheid " like" voor het gebruik van de jcr:like xpath, functie (optioneel), " not" voor geen overeenkomst (bijv. " not(@prop)" in xpath, value param will be ignored) of " exists" voor existentiecontrole (waarde kan waar zijn - eigenschap moet bestaan, standaardwaarde - of vals - zelfde als " not")

  • diepte

    aantal jokertekenniveaus waaronder de eigenschap/het relatieve pad kan bestaan (bijvoorbeeld property=size depth=2 controleert node/size, node/*/size en node/*/*/size)

rangeproperty rangeproperty

Hiermee wordt een JCR-eigenschap vergeleken met een interval. Dit geldt voor eigenschappen met lineaire typen, zoals LONG, DOUBLE en DECIMAL. Voor DATE raadpleeg de daterange predikaat die de invoer van de datumnotatie heeft geoptimaliseerd.

U kunt een ondergrens en een bovengrens of slechts één van hen bepalen. De bewerking (bijv. "kleiner dan" of "kleiner of gelijk aan") kan ook worden opgegeven voor de individuele ondergrens en bovengrens.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen properties-16

  • eigenschap

    relatief pad naar eigenschap

  • lowerBound

    ondergrens om eigenschap te controleren voor

  • lowerOperation

    " >" (standaardwaarde) of " >=", is van toepassing op lowerValue

  • upperBound

    bovenaan gebonden om eigenschap te controleren voor

  • upperOperation

    " <" (standaardwaarde) of " <=", is van toepassing op lowerValue

  • decimaal

    " true" als de gecontroleerde eigenschap van het type Decimaal is

relativedaterange relativedaterange

Overeenkomsten JCR DATE eigenschappen op basis van een datum-/tijdinterval waarbij tijdverschuivingen ten opzichte van de huidige servertijd worden gebruikt. U kunt lowerBound en upperBound met een millisecondenwaarde of de bugzilla-syntaxis 1s 2m 3h 4d 5w 6M 7y (één seconde, twee minuten, drie uren, vier dagen, vijf weken, zes maanden, zeven jaar). Voorvoegsel met " -" om een negatieve verschuiving vóór de huidige tijd aan te geven. Als u alleen lowerBound of upperBound, zal andere aan 0, die de huidige tijd betekent in gebreke blijven.

Bijvoorbeeld:

  • upperBound=1h (en lowerBound) in de komende uren alles selecteren
  • lowerBound=-1d (en upperBound) in de afgelopen 24 uur alles selecteren
  • lowerBound=-6M en upperBound=-3M zou om het even wat 6 maanden tot 3 maanden oud selecteren
  • lowerBound=-1500 en upperBound=5500 zou om het even wat tussen 1500 milliseconden in het verleden en 5500 milliseconden in de toekomst selecteren
  • lowerBound=1d en upperBound=2d zou overmorgen alles selecteren

Er wordt geen rekening gehouden met schrikkeljaren en alle maanden zijn 30 dagen.

Filteren wordt niet ondersteund.

Ondersteunt facetextractie op dezelfde manier als de daterange predikaat.

Eigenschappen properties-17

  • upperBound

    hogere datum gebonden in milliseconden of 1s 2m 3h 4d 5w 6M 7y (één seconde, twee minuten, drie uren, vier dagen, vijf weken, zes maanden, zeven jaar) met betrekking tot huidige servertijd, gebruik "-"voor negatieve compensatie

  • lowerBound

    lagere datum gebonden in milliseconden of 1s 2m 3h 4d 5w 6M 7y (één seconde, twee minuten, drie uren, vier dagen, vijf weken, zes maanden, zeven jaar) met betrekking tot huidige servertijd, gebruik "-"voor negatieve compensatie

basis root

Hoofdvoorspelbare groep. Steunt alle eigenschappen van een groep en staat toe om globale vraagparameters te plaatsen.

De naam "wortel"wordt nooit gebruikt in een vraag, het is impliciet.

Eigenschappen properties-18

  • p.offset

    getal dat het begin van de resultatenpagina aangeeft, d.w.z. het aantal items dat moet worden overgeslagen

  • p.limit

    getal dat het paginaformaat aangeeft

  • p.radenTotaal

    aanbevolen: niet het volledige resultaattotaal berekenen dat kostbaar kan zijn; hetzij een getal dat het maximale totaal aangeeft tot (bijvoorbeeld 1000, een getal dat gebruikers voldoende feedback geeft over de ruwe grootte en exacte getallen voor kleinere resultaten), of " true" om slechts tot het noodzakelijke minimum te tellen p.offset + p.limit

  • p.excerpt

    indien ingesteld op " true", moet u het volledige tekstfragment in het resultaat opnemen

  • p.hits

    (alleen voor de JSON-servlet) selecteer de manier waarop de treffers als JSON worden geschreven, met de volgende standaardresultaten (uitbreidbaar via de service ResultHitWriter):

    • eenvoudig:

      minimale objecten zoals path, title, lastmodified, excerpt (indien ingesteld)

    • volledig:

      sling JSON rendering van het knooppunt, met jcr:path het pad van de treffer aangeven: door gebrek maakt enkel een lijst van de directe eigenschappen van de knoop, omvat een diepere boom met p.nodedepth=N, waarbij 0 de gehele oneindige subboom betekent; toevoegen p.acls=true om de JCR-machtigingen van de huidige sessie op te nemen voor het opgegeven resultaatitem (toewijzingen: create = add_node, modify = set_property, delete = remove)

    • selectief:

      alleen eigenschappen opgegeven in p.properties, dat een spatie gescheiden is (gebruik "+" in URL's) lijst met relatieve paden; als het relatieve pad een diepte > 1 heeft, worden deze weergegeven als onderliggende objecten; de speciale eigenschap jcr:path bevat het pad van de hit

opgeslagen query savedquery

Omvat alle predikaten van een persisted querybuilder vraag in de huidige vraag als subgroup predikaat.

Hiermee wordt geen extra query uitgevoerd, maar wordt de huidige query uitgebreid.

De vragen kunnen programmatically worden voortgeduurd gebruikend QueryBuilder#storeQuery(). De indeling kan een tekenreekseigenschap met meerdere regels of een nt:file knooppunt dat de query als een tekstbestand in Java-eigenschappen-indeling bevat.

Biedt geen ondersteuning voor facetextractie voor de voorspelling van de opgeslagen query.

Eigenschappen properties-19

  • opgeslagen query

    pad naar de opgeslagen query (eigenschap String of nt:file node)

gelijkaardig similar

Gelijksoortige zoekopdracht met JCR XPath rep:similar().

Filteren wordt niet ondersteund. Biedt geen ondersteuning voor facetextractie.

Eigenschappen properties-20

  • gelijkaardig
    absolute weg aan de knoop waarvoor om gelijkaardige knopen te vinden

  • lokaal
    een relatief pad naar een afstammend knooppunt of
    . voor het huidige knooppunt (optioneel, standaard is " .")

tag tag

Hiermee zoekt u naar inhoud die is gelabeld met een of meer tags door titelpaden voor tags op te geven.

Ondersteunt facetextractie. Hiermee geeft u emmers voor elke unieke tag op met behulp van het huidige pad voor de tagtitel.

Eigenschappen properties-21

  • tag

    titelpad van tag naar, bijvoorbeeld "Eigenschappen van element: Oriëntatie / Liggend"

  • N_value

    gebruiken 1_value, 2_value, … controleren op meerdere tags (gecombineerd met OR standaard, met AND if en=true) (sinds 5.6)

  • eigenschap

    eigenschap (of relatief pad naar eigenschap) om naar te kijken (standaard " cq:tags")

tagid tagid

Hiermee zoekt u naar inhoud die is gelabeld met een of meer tags, door tag-id's op te geven.

Ondersteunt facetextractie. Hiermee geeft u emmers voor elke unieke tag op met de huidige tag-id.

Eigenschappen properties-22

  • tagid

    tag-id die moet worden gezocht, bijvoorbeeld " properties:orientation/landscape"

  • N_value

    gebruiken 1_value, 2_value, … controleren op meerdere tags (gecombineerd met OR standaard, met AND if en=true) (sinds 5.6)

  • eigenschap

    eigenschap (of relatief pad naar eigenschap) om naar te kijken (standaard " cq:tags")

tagzoeken tagsearch

Zoekt naar inhoud gelabeld met een of meer tags door trefwoorden op te geven. Hiermee zoekt u eerst naar tags die deze trefwoorden bevatten in de titels en beperkt u het resultaat vervolgens tot alleen items die met deze trefwoorden zijn getagd.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen Properties-1

  • tagzoeken

    trefwoord waarnaar moet worden gezocht in titels van tags

  • eigenschap

    eigenschap (of relatief pad naar eigenschap) om naar te kijken (standaard " cq:tags")

  • lang

    om alleen in een bepaalde gelokaliseerde tagtitel te zoeken (bijvoorbeeld " de")

  • alles

    (bool) doorzoek volledige labeltekst, dus alle titels, beschrijving enz. (heeft voorrang op "l ang")

type type

Hiermee beperkt u de resultaten tot een specifiek JCR-knooppunttype, zowel het primaire knooppunttype als het mixintype. Dit zal ook subtypes van dat knooptype vinden. Merk op dat de gegevensopslagplaats onderzoeksindexen de knooppunttypes voor efficiënte uitvoering moeten behandelen.

Ondersteunt facetextractie. Zal emmers voor elk uniek type in de resultaten verstrekken.

Eigenschappen Properties-2

  • type

    knooppunttype of mixin naam aan onderzoek naar, bijvoorbeeld cq:Page

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e