Wstęp do FQL
Naprawdę za darmo chcę wystawić produkty firmy XY a ich cena handlowa jest większa niż 100 Zł. Jak to zrobić?
Filter Query Language (dalej jako FQL) to domyślny język, dzięki któremu można tworzyć bardziej skomplikowane warunki a dzięki temu także lepszą ofertę.
wewnątrz FQL możesz tworzyć logiczne relacje, numeryczne i datowe zakresy, listy lub wyszukiwać tekst
Syntaxe jest prosta i oparta na Apache Lucene.
Sprawdźmy FQL! :)
Podstawowy syntaxe v FQL
Podstwowym elementem pytania FQL jest warunek.
Podmínka se skládá ze dvou částí: pole:hodnota např.: znacka:adidas. Tento jednoduchý dotaz znamená to, že název značky musí být "adidas" (na velikosti písmen nezáleží).
Pokud chceme hledat víceslovný text, tak jej stačí uzavřít do uvozovek znacka:"adidas kids".
Porovnání může být samozřejmě proti číslu cena:99 (cena se rovná 99), datumu zprodejnen:"2020-05-24 14:30:59" (produkt byl zprodejněn 24. května 2020 v 14 hodin 30 minut a 59 vteřin) nebo pravdivostní hodnotě aktivni:false (produkt nesmí být aktivní).
Jednotlivé podmínky můžete slučovat do logických celků "a zároveň" znacka:"adidas" AND cena:99 (značka produktu je "Adidas" a prodejní cena je rovna 99 Kč) či "a nebo" znacka:"adidas" OR cena:99 (značka produktu je "Adidas" nebo prodejní cena je rovna 99 Kč).
Jednotlivé podmínky můžete negovat (obrátit význam) NOT znacka:"adidas" (značka nesmí být "Adidas"). Případně lze negovat celé logické celky NOT (znacka:"adidas" AND cena:99) (značka nesmí být "Adidas" a zároveň cena nesmí být 99 Kč).
Více podmínek nad stejným polem můžete sloučit do kratšího formátu. Např. tento FQL znacka:"*adidas*" OR znacka:"*nike*" je ekvivalentní s tímto FQL znacka:("*adidas*" OR "*nike*") (značka obsahuje "Adidas" nebo "Nike").
Wyszukiwanie tekstowe
Wyszukiwanie, czy zawiera tekst, rozpoczyna się, kończy itp.
Značka se rovná hodnotě "Adidas Kids": znacka:"adidas kids"
Značka začíná na "Adi": znacka:"adi*"
Značka končí na "das": znacka:"*das"
Značka obsahuje "kid": znacka:"*kid*"
Każdy warunek możemy negować dzięki operatorowi NOT.
Značka se nerovná hodnotě "Adidas Kids": NOT znacka:"adidas kids"
Značka nezačíná na "Adi": NOT znacka:"adi*"
Značka nekončí na "das": NOT znacka:"*das"
Značka neobsahuje "kid": NOT znacka:"*kid*"
Wyszukiwanie numeryczne
Szukanie, czy wartość jest mniejsza, większa, równa itp.
Cena se rovná 99: cena:99
Cena je menší než 99: cena:[* TO 99}
Cena je menší nebo rovno 99: cena:[* TO 99]
Cena je větší než 99: cena:{99 TO *]
Cena je větší nebo rovno 99: cena:[99 TO *]
Cena je větší než 29 a menší něž 99: cena:{29 TO 99}
Cena je větší než 29 a menší nebo rovna 99: cena:{29 TO 99]
Cena je větší nebo rovna 29 a menší nebo rovna 99: cena:[29 TO 99]
Każdy warunek możemy negować dzięki operatorowi NOT.
Wyszukiwanie dat
Szukanie, czy data jest starsza, nowsza, taka sama itp.
Zprodejněn dne 24. května 2020 14:30:59: zprodejnen:"2020-05-24 14:30:59"
Zprodejněn do 24. května 2020: zprodejnen:[* TO "2020-05-24 00:00:00"}
Zprodejněn do (včetně) 24. května 2020: zprodejnen:[* TO "2020-05-25 00:00:00"}
Zprodejněn od 24. května 2020: zprodejnen:{"2020-05-24 23:59:59" TO *]
Zprodejněn od (včetně) 24. května 2020: zprodejnen:["2020-05-24 00:00:00" TO *]
Zprodejněn od než 24. května 2020 do (včetně) 24. června 2020: zprodejnen:{"2020-05-24 23:59:59" TO "2020-06-25 00:00:00"}
Każdy warunek możemy negować dzięki operatorowi NOT.
Wyszukiwanie listy
Poszczególne wartości wewnątrz polecenia oddzielamy średnikiem ";".
ID je uvnitř výčtu ABC01, ABC02, ABC03: id:("ABC01;ABC02;ABC03")
Pokud některá z hodnot našeho výčtu obsahuje středník ";", pak je potřeba tento středník escapovat. Pokud náš seznam obsahuje hodnoty např. "01;ABC", "02ABC" a "03;ABC", pak bude náš seznam v FQL vypadat takto: id:("01\;ABC;02ABC;03\;ABC")
Każdy warunek możemy negować dzięki operatorowi NOT.
Wyszukiwanie Regexp
Szukanie w wartości według regulárního výrazu. Vyhledávání je prováděno s příznakem "insensitive" (nezáleží na velikosti písmen).
Značka začíná na "Adidas": znacka:"~^adidas~"
Značka končí na "Kids": znacka:"~kids$~"
Značka obsahuje pouze písmena (ASCII): znacka:"~^[a-z]+$~"
Značka obsahuje pouze písmena (UTF-8): znacka:"~^\p{L}+$~"
Značka obsahuje pouze číslice: znacka:"~^[0-9]+$~"
Każdy warunek możemy negować dzięki operatorowi NOT.
Jeśli w dokumentacji nie odnalazłeś tego czego szukałeś, skontaktuj się z nami (np. przez okienko chat).
Chętnie Państwu doradzimy i dokumentacje uzupełnimy. :)
