Značky parametrů

Komponenty používají parametry, jako např. ID pohledu, řetězce a čísla, pomocí kterých přidávají do sestav informace. Tyto parametry se zadávají pomocí značek fp:*Param.
Každá komponenta má povinné a volitelné značky. Všechny značky parametrů mají atributy.
Tabulka 1. Značky a atributy parametrů
Název Popis
Značky parametrů
fp:attrParam Určuje atribut. Např. Stav v modulu Požadavky.
fp:checkboxParam Obsahuje logickou hodnotu true nebo false.
fp:critParam Obsahuje celočíselnou hodnotu. Např. (..., -2, -1, 0, 1, 2, ....).
fp:memberParam Určuje člena. Např. Admin.
fp:stringParam Obsahuje hodnotu řetězce.
fp:viewParam Určuje pohled. Např. "Všechny požadavky".
Atributy značek parametru
changeable Povinný atribut, který určuje, kdy se parametr změnil, a který se používá u všech značek *Param. Atribut má čtyři hodnoty:
  • Template: změní se, když se vytvoří nebo upraví typ sestavy
  • Runtime: změní se, když se vytvoří sestava
  • Never: nelze změnit a používá se pouze v případě, že v okamžiku vytváření sestavy je hodnota již známa. Hodnotu lze přečíst z atributu defaultvalue.
  • Fetch: hodnota se automaticky načte. Která hodnota se má načíst určuje hodnota atributu "name".
    • currentdate: aktuální datum
    • currenttime: aktuální čas
    • currentuser: uživatel, který je přihlášen
    • fortune: Soubor "fortune cookie," který je vždy nový. Tato hodnota se používá, přidáváte-li další soubory .jar.
    • numpages: počet stránek v sestavě. Tato hodnota se používá v záhlavích a zápatích.
    • workspacename: název pracovního prostoru
    • pageno: číslo aktuální stránky. Tato hodnota se používá v záhlavích a zápatích.
id Povinný atribut, který určuje ID parametru a který se používá u všech značek *Param. Každý parametr má jedinečné ID. Stejné ID můžete použít u více parametrů.

Na uživatelském rozhraní bude viditelný pouze první parametr. Ostatní parametry okopírují své hodnoty z prvního parametru. Tato konvence je užitečná v případě, že chcete zobrazit stejnou informaci ve více záhlavích, nebo pokud ve více komponentách používáte stejný pohled.

name Povinný atribut, který určuje název parametru a který se používá u všech značek *Param. Ve značce komponenty je název jedinečným identifikátorem, který se používá při hledání parametrů. Obecné názvy jsou viewId, attrId, elementId, pageno.
masterid ID parametru, který řídí parametr. Tento atribut je povinný, ale nemusí se používat. Závisí to na komponentě. Tento atribut se používá u attrParam. Obvykle je hlavní parametr viewParam. Musíte nejprve nastavit hlavní parametr, jinak nebudete vědět, které atributy nebo prvky máte k dispozici.
type Určuje typ atributu, který má tento parametr povolen. Tento atribut je povinný, ale nemusí se používat. Závisí to na komponentě. Tento atribut se používá u attrParam. Používat můžete tyto typy atributů:
  • choice: pro atributy voleb
  • number: pro celočíselné atributy a atributy typu float
  • numbertext: pro celočíselné atributy, atributy typu float a maticové atributy
  • link: pro spojovací atributy a atributy typu seznam odkazů
  • all: pro všechny typy atributů
defaultvalue Parametr se nastaví na defaultvalue, když poprvé vytváříte nebo upravujete typ sestavy, nebo když poprvé vygenerujete sestavu. Tento atribut je volitelný a používá se u všech značek *Param. Výchozí hodnota je prázdný řetězec:defaultvalue="".
descr Popis parametru. Tento atribut je volitelný. Popis se zobrazí, když se vytváří nebo upravuje typ sestavy, nebo když se generuje sestava. Výchozí nastavení je nepoužívat popis: descr="".

Zpětná vazba