Fulltextové hledání - záložka Detail

Agenda

Třída Business objektu (BO), pro který je dané pravidlo definováno. Needitovatelná položka zobrazující se pouze z informativních důvodů.

Řetězec, pod kterým se jednotlivé třídy v seznamu nabízejí, odpovídá položce "Popis" daného Business objektu a můžete podle ní i daný Business objekt dohledat v popisu Struktur a definic GenDoc.chm.

K vybrané třídě se zobrazuje i CLSID (identifikační GUID) Business objektu dané třídy.

Parametr, který indikuje, zda-li je tabulka definice fulltextového hledání v kódování Unicode nebo ANSI. Parametr nemá uživatel možnost ovlivnit, neboť definice vznikají v kódování Unicode automaticky a tabulky v kódování ANSI se mohou v systému ABRA Gen vyskytnout pouze přenesením z verzí, kdy podpora Unicode ještě nebyla v systému implementována.

Staré definice v ANSI je možné do Unicode převést pomocí funkce Převést na Unicode.

Stav aktualizace fulltextu.

• OK - fulltext je aktuální.

• Aktualizovat - je zapotřebí provést aktualizaci (ručně funkcí Aktualizovat fulltext nebo naplánovanou úlohou Aktualizace fulltextového hledání). Stav po update databáze, vytvoření nové definice fulltextu, případně úpravě definice stávající.

  Stav Aktualizovat na hlavičce dokladu znamená, že se ve stavu Aktualizovat nachází nejméně jeden index, který je součástí definice daného fulltextu (viz popis položky Stav v tabulce Indexy).

Datum a čas poslední aktualizace fulltextu. Pokud fulltext dosud nebyl aktualizován (typicky po vytvoření nové definice), zobrazuje se místo časového údaje text "Neproběhla".

Výrazem je možné omezit počet zpracovávaných záznamů, které se do aktualizace fulltextu mají zahrnout. Napočtené záznamy nesplňující podmínku se při další aktualizaci odmažou

Budeme-li mít například záznamy napočteny za posledních 5 let, zadáme podmínku na přepočtení záznamů jen za poslední rok. Následně se již přepočtené záznamy nesplňující podmínku vymažou a napočteny a aktualizovány budou jenom ty záznamy, které podmínku splňují.

Výraz můžete zapsat ručně nebo jej můžete sestavit komfortněji pomocí Editoru výrazů, který si můžete vyvolat po stisku funkčního tlačítka (může se lišit dle verze a nastaveného vzhledu). Ve výrazech jsou k dispozici funkce a data z objektů dostupných v daném místě programu, viz funkce a datové položky objektu v editoru výrazů.

Při psaní SQL platí:

• Bude se doplňovat do Where klauzule na vymazávání/přidávání ID, nad kterými se má fulltext zpracovat.
• Na sloupce tabulky se odkazujeme pomoci aliasu RT (Reference Table)

Položka nabývající hodnot OK nebo Aktualizovat se stejným významem jako v hlavičce.

Uživatelský název indexu pro snadnější identifikaci.

Bližší vysvětlující popis dané definice indexu. V panelu pro fulltextové hledání se popis zobrazuje formou tooltipu.

Položka typu skrytý seznam, z něhož vyberete způsob rozdělování znakových řetězců, tj. jaké části řetězce budou považovány za samostatná slova:

• Bílé znaky - slova se budou dělit pomocí bílých znaků (mezery, tabulátory).

  Přechod na nový řádek ve víceřádkovém textu je vždy považován za oddělovač.

• Regulární výraz - slova se budou dělit pomocí libovolného řetězce vyhovujícímu definici regulárního výrazu v poli Regulární výraz.

  Přechod na nový řádek ve víceřádkovém textu je vždy považován za oddělovač.

• Nerozdělovat - slova nebudou nijak rozdělována (tedy ani mezerami - celý zadaný řetězec bude považován za jedno slovo).
• Vlastní - slova se budou dělit vždy pomocí bílých znaků a dále dle seznamu volitelných oddělovačů, které je možné zadat do pole Oddělovače slov. Jednotlivé oddělovače při zadávání nijak neoddělujte, každý znak v zadaném řetězci znamená jeden oddělovač.
• Inteligentní - za slovo budou považovány následující řetězce:
  • e-mailové adresy
  • URL adresy (něco://něco dalšího)

  • skupiny čísel oddělených jedním z těchto oddělovačů _-.,\/ (datumy, čísla verzí apod.)

    Je třeba mít na paměti, že v případě používání s ostatními znaky (nenumerickými) jsou tyto oddělovače chápány jako konce slov a systém bude řetězce na místech jejich výskytu dělit. Pokud je tedy třeba vyhledávat řetězce typu např. aaa-bbb, je třeba zvolit dělení Vlastní, ve kterém nebude znak "-" uveden mezi oddělovači.

  • číslo dokladu (DisplayName)

    Algoritmus vyhledá i další alfanumerické řetězce, které svou strukturou DisplayName připomínají.

  • (A-Za-z0-9_) libovolně se opakující, tedy v podstatě jakékoliv běžné slovo

Umožňuje nadefinovat oddělování slov prostřednictvím regulárního výrazu.

Regulární výraz je zapotřebí zadat tak, aby byl složen ze dvou skupin. Mechanismus indexování následně v definovaném výrazu postupně vyhledává řetězec odpovídající zadanému celému regulárnímu výrazu (dvě skupiny). Obsah první skupiny považuje za slovo k indexaci, obsah druhé skupiny za oddělovač.

Lorem **ipsum** _dolor_ sit **amet**,
consectetuer ~adipiscing~ elit.

(.*?)(?:[\s*_~.,]+)

Položka se zpřístupní pouze v případě, že je v položce Dělení slov vybrána volba Regulární výraz.

Maximální délka slov, která budou zahrnuty do množiny záznamů, jež se budou prohledávat. Hodnota může být v rozmezí 0 - 100. Pokud bude tato hodnota překročena, systém záznam nedovolí uložit.

Typ výrazu určuje, co bude obsahem následující položky Výraz (jakým způsobem se nadefinuje, co bude daný index prohledávat). V aktuální verzi jsou k dispozici dvě možnosti:

• QR výraz - k definici výrazu se použijí vestavěné funkce (jejichž parametry mohou být položky business objektů z datového modelu) a podporované operátory; QR výrazy se zpravidla sestavují interaktivně pomocí Editoru výrazů
• SQL - alternativně je možné výraz zapsat také pomocí dotazovacího jazyka SQL; tato možnost je určena pro pokročilejší uživatele a využívá se ve specifických případech, kdy se možnost definice pomocí QR výrazu ukáže jako příliš omezující; SQL dotazy se zapisují ručně (k čemuž je zapotřebí přiměřená znalost databázových struktur ABRA Gen)

Položka pro zadání vlastního výrazu. Zde se je třeba odkázat na patřičnou položku, která se bude při použití daného indexu prohledávat. Obsah záleží na tom, zda je v položce Typ zvolena možnost QR výraz nebo SQL:

QR výraz

Výraz můžete zapsat ručně nebo jej můžete sestavit komfortněji pomocí Editoru výrazů, který si můžete vyvolat po stisku funkčního tlačítka (může se lišit dle verze a nastaveného vzhledu).

SQL

Výraz se zapisuje ručně.

Klauzule SELECT musí obsahovat dva sloupce:

• ID - odpovídá ID příslušného business objektu - např. pokud definujete index pro prohledávání skladových karet, SQL dotaz musí vracet ID jednotlivých skladových karet, viz příklad níže

• TEXT - výraz (textový řetězec), který se bude vyhodnocovat (hledaný řetězec, který zadá uživatel, se bude porovnávat s hodnotami vrácenými SQL dotazem ve sloupci TEXT)

SELECT SU.Parent_ID as ID, S.EAN as Text
FROM StoreUnits SU
JOIN StoreEANs S ON S.Parent_ID = SU.ID