Trieda Constraint

Táto trieda je obálkou popisujúcou jednu podmienku v DynSQL. Po získaní podmienky je možné nastaviť jej hodnoty, ku ktorým potom prihliadne objekt DynamicQuery pri zostavovaní príkazov (dáta budú obmedzené).

Metódy a vlastnosti:

property ID: WideString readonly;
Popis:
Identifikátor podmienky, jej unikátny názov v rámci jednej definície DynSQL.
property Used: WordBool readonly;
Popis:
Príznak, či je podmienka určená na použitie alebo nie. Na obmedzenie budú použité podmienky, ktoré majú nastavené Used na True.
property Caption: WideString readonly;
Popis:
Jazykovo závislý popisok podmienky vhodný predovšetkým pre užívateľov.
property ValueCount: Integer readonly;
Popis:
Počet hodnôt v podmienke.
property Value: WideString;
Popis:
Hodnota podmienky.
property ValueHigh: WideString;
Popis:
Horná hodnota podmienky.
property Values[Index: Integer]: WideString;
Popis:
Indexový prístup k hodnotám zadaným do podmienky.
property ValueByName[const Name: WideString]: WideString;
Popis:
Prístup k hodnotám podľa mena hodnoty.
property ValueList: _Strings;
Popis:
Získanie zoznamu hodnôt.
property UsedKind: NxConstraintKind;
Popis:
Hodnota UsedKind hovorí, o aký typ podmienky ide. Táto vlastnosť je dôležitá, pretože určuje, akými dátami je možné podmienky naplniť.
property ValueBag: WideString read Get_ValueBag write Set_ValueBag;
Popis:
Vlastnosť umožňuje zadať doplnkové informácie k podmienke. Používa sa napr. pri hierarchických číselníkových položkách, kde je možné obmedzovať "vrátane podriadených".
Je potrebné používať s citom (v podstate by sa do reťazca malo len pridávať alebo v ňom nahrádzať). ValueBag obsahuje formátované reťazce oddelené CRLF. Formátovaný reťazec musí mať 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. Potom:

  • 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

Na obmedzovanie podľa mzdového obdobia je ParamName = "ActualWPeriod". Potom:

  • 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í
  • a pod.
Ďalší príklad použitia viď kap. Tvorba podmienky pre DynamicQuery - obmedzenie vrátane podriadených.