Třída Constraint

Tato třída je obálkou popisující jednu podmínku v DynSQL. Po získání podmínky je možné nastavit její hodnoty, ke kterým pak přihlédne objekt DynamicQuery při sestavování dotazů (data budou omezena).

Metody a vlastnosti:

property ID: WideString readonly;
Popis:
Identifikátor podmínky, její unikátní název v rámci jedné definice DynSQL.
property Used: WordBool readonly;
Popis:
Příznak, zda je podmínka určena k použití nebo ne. Pro omezení budou použity podmínky, které mají nastaveno Used na True.
property Caption: WideString readonly;
Popis:
Jazykově závislý popisek podmínky vhodný především pro uživatele.
property ValueCount: Integer readonly;
Popis:
Počet hodnot v podmínce.
property Value: WideString;
Popis:
Hodnota podmínky.
property ValueHigh: WideString;
Popis:
Horní hodnota podmínky.
property Values[Index: Integer]: WideString;
Popis:
Indexový přístup k hodnotám zadaným do podmínky.
property ValueByName[const Name: WideString]: WideString;
Popis:
Přístup k hodnotám podle jména hodnoty.
property ValueList: _Strings;
Popis:
Získání seznamu hodnot.
property UsedKind: NxConstraintKind;
Popis:
Hodnota UsedKind říká, o jaký typ podmínky se jedná. Tato vlastnost je důležitá, neboť určuje, jakými daty je možné podmínky naplnit.
property ValueBag: WideString read Get_ValueBag write Set_ValueBag;
Popis:
Vlastnost umožňuje zadat doplňkové informace k podmínce. Používá se např. u hierarchických číselníkových položek, kde je možné omezovat "včetně podřízených".
Je třeba používat s citem (v podstatě by se do řetězce mělo pouze přidávat nebo v něm nahrazovat). ValueBag obsahuje formátované řetězce oddělené CRLF. Formátovaný řetězec musí mít tvar "ParamName=Value".

Pro omezování včetně/bez podřízených je ParamName = "{WithChildren}", kde {WithChildren} je jméno příslušného parametru. Pak:

  • ValueBag = "{WithChildren}=1": Bude zadáno pro omezení včetně podřízených
  • ValueBag = "{WithChildren}=0": Bude zadáno pro omezení bez podřízených

Pro omezování za mzdové období je ParamName = "ActualWPeriod". Pak:

  • ValueBag = "ActualWPeriod=0": Bude zadáno pro omezení za období vybraná z číselníku
  • ValueBag = "ActualWPeriod=1": Bude zadáno pro omezení za aktivního období
  • ValueBag = "ActualWPeriod=3": Bude zadáno pro omezení za aktivní čtvrtletí
  • ValueBag = "ActualWPeriod=4": Bude zadáno pro omezení za minulé čtvrtletí
  • apod.
Další příklad použití viz kap. Tvorba podmínky pro DynamicQuery - omezení včetně podřízených.