Čo to je?
Poznámka administrátora: Táto príručka pokrýva základné “stavebné bloky” vyhľadávania údajov vo vašom e-shope. Vysvetľuje, ako nájsť položky na základe názvov, cien alebo jednoduchých príznakov stavu (ako “aktívne” alebo “viditeľné”).
Pre koho je to určené? Administrátori by si to mali prečítať, aby sa naučili najbežnejšie spôsoby vyhľadávania produktov alebo objednávok. Je to najlepšie miesto, kde začať, ak si chcete vytvoriť vlastné filtre v aplikačnom rozhraní.
Kľúčové výhody pre e-shop:
- Jednoduché vyhľadávanie produktov: Rýchlo vyhľadajte produkty podľa presného názvu, cenového rozpätia alebo kategórie.
- Monitorovanie stavu: Nájdite všetky svoje “skryté” alebo “neaktívne” produkty, aby ste zaistili, že váš obchod bude čistý.
- Inteligentné vyhľadávanie textu: Používajte vzory na vyhľadanie položiek, aj keď nepoznáte presný názov (napr. “všetky položky končiace na ‘Pro’”).
- Kombinované pravidlá: Používajte logiku “a/alebo” na vytvorenie špecifických zoznamov, ako napríklad “všetky aktívne produkty s cenou do 50 USD”.
Základné filtrovanie
Náš systém filtrov poskytuje výkonný, pre človeka čitateľný jazyk na filtrovanie vašich údajov. Rovnakú syntax môžete použiť v používateľskom rozhraní aplikácie, systéme dotazov a rozhraniach REST API.
Prehľad
Podmienka filtra pozostáva z názvu poľa, operátora a hodnoty. Môžete kombinovať viacero podmienok pomocou logických operátorov, ako napríklad and alebo or.
[navigate:where-advanced.md|Rozšírené filtre|database] [navigate:where-functions.md|Funkcie a agregácia|zap]
Jednoduché príklady filtrov
Rovnosť a číselné porovnania
Filtrujte podľa presných hodnôt alebo číselných rozsahov. Použite ich na vyhľadanie produktov s konkrétnymi názvami alebo cenami.
Jednoduchá rovnosť
name = "MacBook Pro"
[badge:Basic|secondary|right]
Dvojité rovná sa
Dvojité rovná sa automaticky konvertuje na jednoduché rovná sa pre pohodlie.
name == "MacBook Pro"
[badge:Basic|secondary|right]
Nerovná sa
Viacero spôsobov, ako vyjadriť, že pole by sa nemalo zhodovať s hodnotou.
name != "iPhone" or code <> "X100" or ean ne "123"
[badge:Basic|secondary|right]
Číselné porovnania
Nájdite produkty v cenovom rozpätí.
priceWithVat > 500 and priceWithVat <= 1500
[badge:Numeric|secondary|right]
Booleovské kontroly
Skontrolujte hodnoty booleovských polí, ako napríklad blocked alebo emailVerified.
blocked is false and emailVerified is true
[badge:Boolean|secondary|right]
Kontroly Null a Empty
Overte, či polia majú hodnoty alebo sú prázdne.
Validácie Null a Empty
ean is null and name is not empty
[badge:Null|secondary|right]
Rozlíšenie Empty vs Null
Pochopenie rozdielu medzi empty (null alebo “”) a null.
description is empty or internalNote is not null
[badge:Null|secondary|right]
Porovnávanie vzorov
Používajte vzory na vyhľadanie textu, ktorý začína, končí alebo obsahuje špecifické znaky.
Vzory nerozlišujúce veľké a malé písmená
name like "iphone" and code ends "-XL"
[badge:Pattern|secondary|right]
Porovnávanie nerozlišujúce veľké a malé písmená (iLike)
name ilike "iPhone" or shortDescription begins "TEST"
[badge:Pattern|secondary|right]
Negované porovnávanie vzorov
name not like "temp" and code not ends ".test"
[badge:Pattern|secondary|right]
Členstvo v množine a rozsahy
Skontrolujte, či hodnota patrí do zoznamu alebo rozsahu.
Členstvo v množine
code in ("A1", "A2", "A3")
[badge:Set|secondary|right]
Between a rozsah
priceWithVat between 100 and 500
[badge:Range|secondary|right]
Logické operátory
Kombinujte viacero podmienok pre komplexné filtrovanie.
and
Obe podmienky musia byť pravdivé.
name = "iPhone" and priceWithVat > 800
[badge:Logic|outline|right]
or
Aspoň jedna podmienka musí byť pravdivá.
name = "iPhone" or name = "iPad"
[badge:Logic|outline|right]
not
Neguje podmienku.
not (name = "iPhone")
[badge:Logic|outline|right]
Referencia operátorov
| Operátor | Aliasy | Popis | Príklad |
|---|---|---|---|
| = | ==, eq, ~eq~ |
Rovná sa | name = “iPhone” |
| != | <>, ne, ~ne~ |
Nerovná sa | name != “iPhone” |
| > | gt, ~gt~ |
Väčšie ako | weight > 30 |
| >= | gte, ~gte~ |
Väčšie alebo rovné | weight >= 18 |
| < | lt, ~lt~ |
Menšie ako | weight < 65 |
| <= | lte, ~lte~ |
Menšie alebo rovné | weight <= 65 |
| is null | - | Pole je null | ean is null |
| is not null | - | Pole nie je null | ean is not null |
| is empty | - | Pole je null alebo prázdny reťazec | description is empty |
| is not empty | - | Pole nie je null a nie je prázdne | name is not empty |
| is true | - | Pole je true | isAccounted is true |
| is false | - | Pole je false | isAccounted is false |
| in | - | Hodnota v množine | code in (“A1”, “A2”, “A3”) |
| not in | - | Hodnota nie je v množine | code not in (“A1”, “A2”) |
| between … and … | - | Hodnota v rozsahu | weight between 18 and 65 |
| not between … and … | - | Hodnota nie je v rozsahu | weight not between 18 and 65 |
| like | - | Obsahuje (nerozlišuje veľké a malé písmená) | name like “test” |
| begins | - | Začína sa na | name begins “iPhone” |
| ends | - | Končí sa na | name ends “Pro” |
Používanie filtrov v aplikácii
Rovnaká syntax filtra funguje v celej platforme.
Používateľské rozhranie aplikácie
- Dvojitým kliknutím na ľubovoľný text filtra upravíte surovú syntax.
- Použite AI Chat na pomoc s návrhom komplexných filtrov.
- Vizuálny nástroj na vytváranie filtrov konvertuje na túto syntax.
Integrácia API
- Systém dotazov: Použite v parametri
where. - REST API: Použite ako parameter dotazu
filter. - Changesets: Správne spracováva historické údaje a dotazy na konkrétny časový bod.