---
title: "List Filter Online vaicājumu veidotājs: nosacījumi, grupas un CAML vaicājums aiz tiem"
description: "Uzziņa par Vitextra List Filter Online tīmekļa daļas vaicājumu veidotāju (Query Builder): kur to atrast, kā darbojas nosacījumi un UN/VAI grupas, kuri operatori pieejami katram kolonnas tipam, kā tiek izvērtēti dinamiskie nosacījumi, piemēram, pašreizējais lietotājs un pēdējie X gadi, kā iepriekš definētais filtrs apvienojas ar lietotāja filtriem un kā apskatīt ģenerēto CAML vaicājumu."
url: https://vitextra.com/lv/support/kb/10320
language: lv
published: 2026-10-21
modified: 2026-10-21
products:
- "List Filter Online"
author: "Lidija Reising"
tags: ["List Filter Online Query Builder", "SharePoint CAML vaicājumu veidotājs", "iepriekš definēts filtrs SharePoint saraksta tīmekļa daļa", "UN VAI filtra grupas SharePoint", "dinamisks filtrs pašreizējais lietotājs", "pēdējo X mēnešu filtrs", "ligzdoti filtra nosacījumi SharePoint Online", "skatīt CAML vaicājumu", "Vitextra List Filter Online"]
---
# List Filter Online vaicājumu veidotājs: nosacījumi, grupas un CAML vaicājums aiz tiem
Uzziņa par Vitextra List Filter Online tīmekļa daļas vaicājumu veidotāju (Query Builder): kur to atrast, kā darbojas nosacījumi un UN/VAI grupas, kuri operatori pieejami katram kolonnas tipam, kā tiek izvērtēti dinamiskie nosacījumi, piemēram, pašreizējais lietotājs un pēdējie X gadi, kā iepriekš definētais filtrs apvienojas ar lietotāja filtriem un kā apskatīt ģenerēto CAML vaicājumu.
## Pārskats
**Query Builder** (vaicājumu veidotājs) ir Vitextra List Filter Online tīmekļa daļas sastāvdaļa, kurā lapas redaktors definē **iepriekš definēto filtru** — nosacījumu kopu, kurai jāatbilst katram vienumam, pirms tas parādās tīmekļa daļā. Lietotāji šo filtru neredz un nevar noņemt; viņi rezultātu var tikai papildus sašaurināt ar filtru rūti un kolonnu galveņu filtriem.
Iepriekš definētais filtrs tiek glabāts kā nosacījumu un grupu koks un tiek pārveidots par **CAML vaicājumu**, ko SharePoint izpilda serverī. Nekas netiek ielādēts pārlūkprogrammā un filtrēts pēc tam: saraksts atgriež tikai atbilstošos vienumus, lapu pa lapai, un tieši tāpēc tīmekļa daļa saglabā ātrdarbību lielos sarakstos.
Tipiski iepriekš definētā filtra lietojumi:
- Rādīt tikai dokumentus, ko **izveidojis vai modificējis pašreizējais lietotājs**.
- Informācijas paneļa lapā rādīt tikai **pēdējo 12 mēnešu** ierakstus.
- Rādīt tikai **apstiprinātus** vienumus, vienumus **ar pielikumiem** vai vienumus, kuru **Status** nav *Closed*.
- No viena saraksta izveidot lapu katrai nodaļai, neveidojot skatu katrai nodaļai.
📝 **Piezīme**
Query Builder definē filtru, kas tiek lietots vienmēr. Vadīklas, ko lietotāji redz filtru rūtī, tiek konfigurētas atsevišķi — skatiet [KB10255. Filtru rūts vadīklas un atbalstītie kolonnu tipi List Filter Online](https://vitextra.com/lv/support/kb/10255).
---
## Kur atrast Query Builder
1. Atveriet lapu rediģēšanas režīmā un List Filter Online tīmekļa daļā atlasiet **Rediģēt tīmekļa daļu**.
2. Rekvizītu rūtī ritiniet līdz grupai **Filtrs**. Aiz uzraksta **Filtrēt skatu pēc:** redzams pašreizējā filtra priekšskatījums — **Filtrs nav lietots**, ja nekas vēl nav definēts.
3. Atlasiet **Rediģēt filtru**. Query Builder atveras lielā sānu panelī.
4. Izveidojiet vaicājumu un pēc tam atlasiet **Saglabāt**, lai to lietotu, vai **Atcelt**, lai atmestu izmaiņas. Tīmekļa daļa nekavējoties tiek pārzīmēta ar jauno filtru.
*Rekvizītu rūts grupa Filtrs ar filtra priekšskatījumu un pogu Rediģēt filtru*
Query Builder ir pieejams tikai pēc tam, kad grupā **Datu avots** ir atlasīta **vietne** un **saraksts vai bibliotēka**, jo lauku saraksts un to tipi tiek iegūti no atlasītā saraksta.
---
## Nosacījumi un grupas
Vaicājums sastāv no divu veidu elementiem.
- **Nosacījums** ir viens salīdzinājums: *lauks* — *operators* — *vērtība*, piemēram, `Amount` — *Lielāks par* — `5000`. Dažiem operatoriem vērtība nav vajadzīga (*Satur datus*, *Ir pašreizējais lietotājs*, *Šodien*).
- **Grupa** satur nosacījumus un citas grupas un savieno tos ar vienu loģisko operatoru — **UN** (patiesiem jābūt visiem elementiem) vai **VAI** (patiesam jābūt vismaz vienam elementam). Pārslēgs grupas kreisajā malā pārslēdz starp abiem.
Panelī vienmēr ir viena **saknes grupa**; to nevar izdzēst. Jebkurā grupā poga **Pievienot** piedāvā divas komandas:
- **Nosacījums** — pievieno pašreizējai grupai tukšu rindu;
- **Grupa** — pievieno ligzdotu grupu (pēc noklusējuma UN), ko aizpildāt tāpat.
Grupas var ligzdot līdz **desmit līmeņu** dziļumā. Katrai rindai un katrai ligzdotajai grupai labajā pusē ir dzēšanas ikona; dzēšot grupu, tiek dzēsts viss tās saturs.
*Vaicājums ar ligzdotām UN/VAI grupām Query Builder*
Attēlā redzamais vaicājums nozīmē: *Title nav tukšs un sākas ar „C"* **un** *(izveidojis es vai modificējis es)* **un** *(izveidots pēdējā gada laikā vai modificēts pēdējā gada laikā)* **un** *(ir pielikumi, vai arī Customer ir aizpildīts un Amount ir lielāks par 5000)*.
💡 **Padoms**
Atstājiet saknes grupu kā **UN** un katru alternatīvo nosacījumu kopu ievietojiet savā **VAI** grupā. Šādi veidotu vaicājumu ir viegli nolasīt priekšskatījumā un vēlāk viegli paplašināt.
---
## Operatori pēc kolonnas tipa
Rindas **operatoru** saraksts ir atkarīgs no atlasītā lauka tipa. Tabulā uzskaitīti operatori, ko Query Builder piedāvā katram atbalstītajam kolonnas tipam.
| Kolonnas tips | Operatori |
|:---|:---|
| **Viena teksta rinda**, **Vairākas teksta rindas**, **Hipersaite vai attēls** | Vienāds ar, Nav vienāds ar, Sākas ar, Satur, Satur datus, Nesatur datus |
| **Izvēle** | Vienāds ar, Nav vienāds ar, Sākas ar, Satur, Satur datus, Nesatur datus |
| **Izvēle (vairākas vērtības)**, **Uzmeklēšana**, **Aprēķināta** (teksta rezultāts) | Vienāds ar, Nav vienāds ar, Satur datus, Nesatur datus (aprēķinātai kolonnai pieejami arī Sākas ar un Satur) |
| **Skaitlis**, **Valūta**, **ID** | Vienāds ar, Nav vienāds ar, Lielāks par, Lielāks vai vienāds ar, Mazāks par, Mazāks vai vienāds ar (skaitlim pieejami arī Satur datus, Nesatur datus) |
| **Datums un laiks** | Uz, Nevis, Uz vai pēc, Pēc, Uz vai pirms, Pirms, Starp, Šodien, Pēdējās X dienas, Pēdējās X nedēļas, Pēdējie X mēneši, Pēdējie X gadi, Nākamās X dienas, Nākamās X nedēļas, Nākamie X mēneši, Nākamie X gadi, Satur datus, Nesatur datus |
| **Jā/Nē** | Vienāds ar, Nav vienāds ar, Satur datus, Nesatur datus |
| **Pielikumi** | Vienāds ar, Nav vienāds ar (vērtība: Jā / Nē) |
| **Persona vai grupa** | Vienāds ar, Nav vienāds ar, Ir pašreizējais lietotājs, Nav pašreizējais lietotājs, Satur datus, Nesatur datus |
| **Pārvaldītie metadati** (viena un vairākas vērtības) | Vienāds ar, Nav vienāds ar, Satur, Nesatur, Satur datus, Nesatur datus |
| **Apstiprinājuma statuss** | Vienāds ar, Nav vienāds ar (vērtība — statusu saraksts) |
| **Vērtējums**, **Patīk** | Vienāds ar, Nav vienāds ar, Satur datus, Nesatur datus (Patīk: tikai Satur datus, Nesatur datus) |
*Satur datus* un *Nesatur datus* pārbauda, vai kolonnai vispār ir vērtība — tāpat kā **IsNotNull** un **IsNull** CAML valodā.
Arī **vērtības** redaktors atbilst kolonnas tipam: datumu atlasītājs datumiem (operatoram *Starp* — divi datumu atlasītāji), skaitlisks lauks skaitļiem un valūtai, personu atlasītājs kolonnai **Persona vai grupa**, terminu atlasītājs **pārvaldītajiem metadatiem**, saraksts *Jā / Nē* kolonnām Jā/Nē un Pielikumi, statusu saraksts kolonnai **Apstiprinājuma statuss**, kā arī tekstlodziņš teksta, izvēles un uzmeklēšanas kolonnām.
❗ **Svarīgi**
Sistēmas un tikai lasāmās kolonnas (piemēram, *Content Type ID*, *Unique ID*, *Version* vai *Checked Out To*) lauku sarakstā netiek piedāvātas. Netiek piedāvātas arī kolonnas, kuru tipus CAML nevar salīdzināt, — piemēram, *Attēls*, *Atrašanās vieta* vai *Atkārtošanās*.
---
## Statiski un dinamiski nosacījumi
**Statisks** nosacījums salīdzina kolonnu ar jūsu ievadītu fiksētu vērtību: datumu, skaitli, tekstu, personu. Vērtība vaicājumā tiek ierakstīta tāda, kāda tā ir. *Starp* ietver abus datumus, ar precizitāti līdz kalendārajai dienai; ja ir iestatīts tikai viens no datumiem, nosacījums kļūst par atvērtu *Uz vai pēc* vai *Uz vai pirms*.
**Dinamisku** nosacījumu SharePoint izvērtē **vaicājuma izpildes brīdī**, tāpēc viena un tā pati lapa dažādiem lietotājiem un dažādās dienās rāda dažādus vienumus:
| Operators | Kā tas tiek izvērtēts |
|:---|:---|
| **Ir pašreizējais lietotājs** / **Nav pašreizējais lietotājs** | Salīdzina personas kolonnu ar pierakstītā lietotāja ID (`` CAML valodā). |
| **Šodien** | Salīdzina datuma kolonnu ar pašreizējo datumu (``). |
| **Pēdējās X dienas / nedēļas / mēneši / gadi** | Diapazons no *šodien mīnus X* (dienas, nedēļas, mēneši vai gadi) līdz *šodien*. |
| **Nākamās X dienas / nedēļas / mēneši / gadi** | Diapazons no *šodien* līdz *šodien plus X*. |
Skaitli *Pēdējās X* un *Nākamās X* operatoriem ievada rindas vērtības laukā. **Pēdējie X mēneši** un **Pēdējie X gadi** vaicājuma ģenerēšanas brīdī tiek pārveidoti par sākuma datumu, tāpēc lapa ar nosacījumu *Modified — Pēdējie X gadi — 1* vienmēr aptver pēdējos divpadsmit mēnešus, nevienam nerediģējot filtru.
📝 **Piezīme**
Dinamiskie nosacījumi tiek izvērtēti serverī, vietnes laika joslā. Tāpēc vēlu vakarā modificēts dokuments var iekrist citā dienā, nekā rāda jūsu vietējais pulkstenis.
---
## Kā iepriekš definētais filtrs apvienojas ar lietotāja filtriem
Kad lietotājs lieto filtru filtru rūtī vai kolonnas galvenē, tīmekļa daļa iepriekš definēto filtru neaizstāj. Tā izveido jaunu vaicājumu, kurā **iepriekš definētais filtrs un lietotāja filtri ir savienoti ar UN**:
```
```
Sekas, ko ir vērts zināt:
- Lietotāji rezultātu var sašaurināt, bet nekad nevar paplašināt ārpus iepriekš definētā filtra. Lapa, kas filtrēta pēc *Created By — Ir pašreizējais lietotājs*, nekad nerāda citas personas vienumus neatkarīgi no tā, ko lietotājs atlasa rūtī.
- Kārtošana, grupēšana, kopsummas un eksports uz Excel darbojas ar apvienoto rezultātu.
- Saglabātie filtri un filtru saites (skatiet [KB10253. Filtru saglabāšana un saites uz filtrētu skatu kopīgošana List Filter Online](https://vitextra.com/lv/support/kb/10253)) glabā tikai vaicājuma lietotāja daļu. Iepriekš definētais filtrs ir lapas konfigurācijas daļa un pārvietojas kopā ar lapu.
---
## No koka līdz CAML
CAML — SharePoint sarakstu vaicājumu valoda — elementos `` un `` pieļauj **tieši divus operandus**. Tāpēc grupu ar trim vai vairāk elementiem nevar ierakstīt kā vienu elementu; tā jāsaloka ligzdotu pāru ķēdē. Query Builder šo salocīšanu veic jūsu vietā, kā arī parūpējas par tipam specifiskajām detaļām: katras vērtības atribūtu `Type`, `LookupId` uzmeklēšanas kolonnām un `IncludeTimeValue` datumu salīdzinājumiem.
Iepriekš redzamā attēla vaicājums rada aptuveni 70 rindu garu `` klauzulu. Tās skelets — ar saīsinātiem salīdzinājumiem — izskatās šādi:
```
/>
/>
```
Katra rinda *Pēdējie X gadi* kļuva par divu datumu salīdzinājumu ``, katra VAI grupa — par elementu ``, bet saknes UN grupas četri elementi — par trim ligzdotiem elementiem ``.
### Ģenerētā vaicājuma apskate
Lai redzētu precīzu CAML, ko tīmekļa daļa nosūta, — ieskaitot iepriekš definēto filtru, pašreizējos lietotāja filtrus, skata laukus, rindu ierobežojumu un grupēšanu:
1. Rekvizītu rūtī izvērsiet **Izstrādātāja rīki** un ieslēdziet **Iespējot izstrādātāja režīmu**.
2. Saglabājiet lapu. Tīmekļa daļas komandjoslas labajā galā parādās izstrādātāja rīku izvēlne.
3. Atlasiet **CAML vaicājums**. Vaicājums atveras dialoglodziņā, un to var nokopēt.
*Dialoglodziņš CAML vaicājums rāda precīzu vaicājumu, kas nosūtīts SharePoint*
💡 **Padoms**
Kad filtrs ir gatavs, izslēdziet izstrādātāja režīmu. Izvēlne ir redzama visiem, kas redz tīmekļa daļu.
---
## Iepriekš definēti filtri lielos sarakstos
Sarakstos ar vairāk nekā 5000 vienumiem SharePoint vaicājumu izpilda tikai tad, ja **pirmais** nosacījums, kas sašaurina rezultātu, izmanto **indeksētu** kolonnu. Iepriekš definētais filtrs tiek izpildīts pirmais, tāpēc tieši tas izšķir, vai lapa vispār atvērsies.
- Sāciet saknes grupu ar nosacījumu indeksētā kolonnā (*Created*, *Modified*, *Author*, *Editor* un *ID* ir indeksētas pēc noklusējuma; citas var indeksēt saraksta iestatījumos).
- Saknē dodiet priekšroku UN: VAI starp divām neindeksētām kolonnām nevar izmantot nevienu indeksu.
- Dinamiskie datuma nosacījumi (*Pēdējie X mēneši*, *Šodien*) ir labi pirmie nosacījumi, ja datuma kolonna ir indeksēta.
Sīkāka informācija, indeksa brīdinājums filtru konfiguratorā un indeksa izveide ar vienu klikšķi aprakstīti rakstā [KB10257. Lielu sarakstu filtrēšana: indeksētas kolonnas un 5000 vienumu slieksnis](https://vitextra.com/lv/support/kb/10257).
---
## Ierobežojumi
- Query Builder strādā ar **viena saraksta vai bibliotēkas** kolonnām — tā, kas atlasīts datu avotā. Nosacījumi citu sarakstu kolonnām nav iespējami.
- Uzmeklēšanas un izvēles vērtības tiek salīdzinātas pēc **jūsu ievadītā teksta**; Query Builder tām atlasītāja nav.
- Ligzdota grupa bez nosacījumiem vaicājuma ģenerēšanā tiek ignorēta.
- Maksimālais ligzdošanas dziļums ir desmit līmeņi. Praksē divi vai trīs līmeņi aptver gandrīz visus scenārijus; dziļāku koku priekšskatījumā ir grūti nolasīt.
- Iepriekš definētais filtrs lietotājiem netiek rādīts. Ja lietotājiem jāzina, kāpēc daži vienumi trūkst, norādiet to tīmekļa daļas virsrakstā vai lapā.
---
## Saistītie raksti
💡 **Padoms**
Pārējie rekvizītu rūts iestatījumi aprakstīti rakstā [KB10201. List Filter Online tīmekļa daļas konfigurēšana](https://vitextra.com/lv/support/kb/10201); filtru rūts vadīklas — rakstā [KB10255. Filtru rūts vadīklas un atbalstītie kolonnu tipi List Filter Online](https://vitextra.com/lv/support/kb/10255); kaskādes nolaižamo sarakstu opcijas — rakstā [KB10256. Kaskādes filtri: nolaižamo sarakstu opciju sašaurināšana pēc citiem atlasītajiem filtriem](https://vitextra.com/lv/support/kb/10256). Salīdzinājumu ar iebūvēto List tīmekļa daļu skatiet rakstā [KB10321. List Filter Online un iebūvētā List tīmekļa daļa: kāda ir atšķirība?](https://vitextra.com/lv/support/kb/10321).