List Filter Online vaicājumu veidotājs: nosacījumi, grupas un CAML vaicājums aiz tiem

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.

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.

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.

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

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.

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.

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:

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.

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:

<Where>
  <And>
    <!-- iepriekš definētais filtrs no Query Builder -->
    <!-- nosacījumi, ko lietotājs atlasījis filtru rūtī -->
  </And>
</Where>

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) 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 <And> un <Or> 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 <Where> klauzulu. Tās skelets — ar saīsinātiem salīdzinājumiem — izskatās šādi:

<Where>
  <And>
    <Or>  <!-- izveidojis es VAI modificējis es -->
      <Eq><FieldRef Name="Author" /><Value Type="Integer"><UserID /></Value></Eq>
      <Eq><FieldRef Name="Editor" /><Value Type="Integer"><UserID /></Value></Eq>
    </Or>
    <And>
      <Or>  <!-- izveidots pēdējā gada laikā VAI modificēts pēdējā gada laikā -->
        <And> <Geq Created 2025-10-21 /> <Leq Created <Today /> /> </And>
        <And> <Geq Modified 2025-10-21 /> <Leq Modified <Today /> /> </And>
      </Or>
      <And>
        <Or>  <!-- (klients aizpildīts UN summa > 5000) VAI ir pielikumi -->
          <And> <IsNotNull Customer /> <Gt Amount 5000 /> </And>
          <Eq Attachments 1 />
        </Or>
        <And> <IsNotNull Title /> <BeginsWith Title "C" /> </And>
      </And>
    </And>
  </And>
</Where>

Katra rinda Pēdējie X gadi kļuva par divu datumu salīdzinājumu <And>, katra VAI grupa — par elementu <Or>, bet saknes UN grupas četri elementi — par trim ligzdotiem elementiem <And>.

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

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.

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