Co to je?
Poznámka administrátora: Tato příručka se zabývá základními “stavebními kameny” vyhledávání dat ve vašem e-shopu. Vysvětluje, jak najít položky na základě jmen, cen nebo jednoduchých příznaků stavu (jako “aktivní” nebo “viditelné”).
Pro koho je to určeno? Administrátoři by si to měli přečíst, aby se naučili nejběžnější způsoby vyhledávání produktů nebo objednávek. Je to nejlepší místo, kde začít, pokud chcete vytvářet vlastní filtry v rozhraní aplikace.
Klíčové výhody pro e-shop:
- Snadné vyhledávání produktů: Rychle vyhledejte produkty podle přesného názvu, cenového rozpětí nebo kategorie.
- Monitorování stavu: Najděte všechny své “skryté” nebo “neaktivní” produkty, abyste zajistili, že vaše výloha bude čistá.
- Chytré vyhledávání textu: Používejte vzory k vyhledání položek, i když neznáte přesný název (např. “všechny položky končící na ‘Pro’”).
- Kombinované pravidla: Použijte logiku “a/nebo” k vytvoření specifických seznamů, jako například “všechny aktivní produkty s cenou pod 50 USD”.
Základní filtrování
Náš systém filtrů poskytuje výkonný, pro člověka čitelný jazyk pro filtrování vašich dat. Stejnou syntaxi můžete použít v uživatelském rozhraní aplikace, systému dotazů a rozhraní REST API.
Přehled
Filtrační podmínka se skládá z názvu pole, operátoru a hodnoty. Můžete kombinovat více podmínek pomocí logických operátorů, jako je and nebo or.
[navigate:where-advanced.md|Pokročilé filtry|database] [navigate:where-functions.md|Funkce a agregace|zap]
Jednoduché příklady filtrování
Rovnost a numerické porovnání
Filtrujte podle přesných hodnot nebo číselných rozsahů. Použijte je k vyhledání produktů se specifickými názvy nebo cenami.
Jednoduchá rovnost
name = "MacBook Pro"
[badge:Basic|secondary|right]
Dvojité rovnítko
Dvojité rovnítko se pro usnadnění automaticky převede na jednoduché rovnítko.
name == "MacBook Pro"
[badge:Basic|secondary|right]
Nerovná se
Více způsobů, jak vyjádřit, že pole by se nemělo shodovat s hodnotou.
name != "iPhone" or code <> "X100" or ean ne "123"
[badge:Basic|secondary|right]
Numerické porovnání
Najděte produkty v cenovém rozpětí.
priceWithVat > 500 and priceWithVat <= 1500
[badge:Numeric|secondary|right]
Kontroly boolean hodnot
Zkontrolujte hodnoty boolean polí, jako je blocked nebo emailVerified.
blocked is false and emailVerified is true
[badge:Boolean|secondary|right]
Kontroly hodnot Null a prázdných hodnot
Ověřte, zda pole mají hodnoty nebo jsou prázdná.
Validace hodnot Null a prázdných hodnot
ean is null and name is not empty
[badge:Null|secondary|right]
Rozlišení mezi prázdnou hodnotou a hodnotou Null
Pochopení rozdílu mezi prázdnou hodnotou (null nebo “”) a hodnotou null.
description is empty or internalNote is not null
[badge:Null|secondary|right]
Porovnávání vzorů
Používejte vzory k vyhledání textu, který začíná, končí nebo obsahuje specifické znaky.
Vzory nerozlišující velikost písmen
name like "iphone" and code ends "-XL"
[badge:Pattern|secondary|right]
Porovnávání nerozlišující velikost písmen (iLike)
name ilike "iPhone" or shortDescription begins "TEST"
[badge:Pattern|secondary|right]
Negované porovnávání vzorů
name not like "temp" and code not ends ".test"
[badge:Pattern|secondary|right]
Členství v množině a rozsahy
Zkontrolujte, zda hodnota patří do seznamu nebo rozsahu.
Členství v množině
code in ("A1", "A2", "A3")
[badge:Set|secondary|right]
Mezi a rozsah
priceWithVat between 100 and 500
[badge:Range|secondary|right]
Logické operátory
Kombinujte více podmínek pro komplexní filtrování.
and
Musí platit obě podmínky.
name = "iPhone" and priceWithVat > 800
[badge:Logic|outline|right]
or
Musí platit alespoň jedna podmínka.
name = "iPhone" or name = "iPad"
[badge:Logic|outline|right]
not
Neguje podmínku.
not (name = "iPhone")
[badge:Logic|outline|right]
Referenční příručka operátorů
| Operátor | Aliases | Popis | Příklad |
|---|---|---|---|
| = | ==, eq, ~eq~ |
Rovná se | name = “iPhone” |
| != | <>, ne, ~ne~ |
Nerovná se | name != “iPhone” |
| > | gt, ~gt~ |
Větší než | weight > 30 |
| >= | gte, ~gte~ |
Větší než nebo rovno | weight >= 18 |
| < | lt, ~lt~ |
Menší než | weight < 65 |
| <= | lte, ~lte~ |
Menší než nebo rovno | weight <= 65 |
| is null | - | Pole má hodnotu null | ean is null |
| is not null | - | Pole nemá hodnotu null | ean is not null |
| is empty | - | Pole má hodnotu null nebo prázdný řetězec | description is empty |
| is not empty | - | Pole nemá hodnotu null a není prázdné | name is not empty |
| is true | - | Pole má hodnotu true | isAccounted is true |
| is false | - | Pole má hodnotu false | isAccounted is false |
| in | - | Hodnota v množině | code in (“A1”, “A2”, “A3”) |
| not in | - | Hodnota není v množině | code not in (“A1”, “A2”) |
| between … and … | - | Hodnota v rozsahu | weight between 18 and 65 |
| not between … and … | - | Hodnota není v rozsahu | weight not between 18 and 65 |
| like | - | Obsahuje (nerozlišuje velikost písmen) | name like “test” |
| begins | - | Začíná na | name begins “iPhone” |
| ends | - | Končí na | name ends “Pro” |
Používání filtrů v aplikaci
Stejná syntaxe filtru funguje v celé platformě.
Uživatelské rozhraní aplikace
- Dvojitým kliknutím na libovolný text filtru upravíte nezpracovanou syntaxi.
- Použijte AI Chat k návrhu složitých filtrů.
- Vizuální nástroj pro vytváření filtrů se převede na tuto syntaxi.
Integrace API
- Systém dotazů: Použijte v parametru
where. - REST API: Použijte jako parametr dotazu
filter. - Changesets: Správně zpracovává historická data a dotazy na konkrétní časový okamžik.