Pokročilé výstupy - Dokumentace Tritius

* SubDataset může mít parametr, field, variable a group stejně jako samotný report. Každý subDataset má vlastní query, report může mít neomezeně subDataset.

46

* jr:listContents je analogický k elementu detail band, lze tedy do něj umístit jiné elementy.

47

* DatasetRun je vlastně podobný subreport elementu. Může mít uvnitř dataSourceExpression nebo connectionExpression, který mění odkud data pochází.

48

* Stejný subDataset může být použit pro více datasetRun, takže lze lehce použít stejnou query s různými parametry.

49

50

Příklad použití na list:

|

{{{ <subDataset name="dataset1" uuid="9fbfd1be-cb5a-476e-940a-afd2e2eb9b1e">

55

56

57

<![CDATA[SELECT work FROM item WHERE id=$P!{parametr1}]]>

</queryString>

</subDataset>}}}

|

{{{ <componentElement>

66

67

<jr:list xmlns:jr="http://jasperreports.sourceforge.net/jasperreports/components" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports/components http://jasperreports.sourceforge.net/xsd/components.xsd" printOrder="Vertical">

</datasetParameter>

</datasetRun>

<jr:listContents height="50" width="553">

</textElement>

</textField>

</jr:listContents>

</jr:list>

</componentElement>}}}

84

85

* Výsledkem je, že textField v listu zobrazí ID work uložený v filed work pro ID item zaslaného subDataset pomocí jeho parametr "parametr1", který hodnotu uložil do field work.

86

87

Předání hodnoty z proměnné subDataset do hlavního reportu lze provést přidáním:

|

{{{<returnValue fromVariable="promenna_subdataset" toVariable="promenna_reportu"/>}}}

92

93

* Nastavení parametru/proměnné subDataset, aby měli stejné hodnoty jako parametr/proměnná hlavního reportu lze provést takto:

94

95

[[image:1722591788345-379.PNG||height="284" width="609"]]

96

97

= Parametry výstupu =

98

99

* Výstupy mohou být parametrizované, tzn. čtenář může omezit data, která se mají načítat.

100

* Např. načtení výpůjček konkrétního čtenáře za časové období.

101

102

* Tyto parametry je nutné v šabloně definovat

103

* Přidání parametru v iReport:

104

** Pravým na Parameters -> Add Parameter

105

** Vhodně parametr pojmenovat a nastavit mu datový typ

106

107

== Definice v šabloně ==

108

109

* Parametr je poté možno používat v šabloně pomocí zápisu $P{název_parametru}

110

* (((

111

Je možno použít parametr přímo v SQL pro načítání

|

{{{<parameter name="l1" class="java.lang.Long"/>

116

117

<![CDATA[

118

SELECT [name] AS work_type_name

FROM [work_type]

WHERE [id] = $P{l1}

]]>

</queryString>

<field name="work_type_name" class="java.lang.String"/>}}}

)))

* Tímto způsobem je ovšem možno vložit parametr pouze bez nějakých dalších úprav

128

** Funguje pro řetězce, čísla

129

** Nefunguje pro datum a pokročilé struktury Tritia

130

* Pokud je parametr potřeba nějakým způsobem zpracovat, tak toto není možné v části s SQL (omezení JasperReports).

131

* Je nutné si vytvořit nový parametr, nastavit mu požadovanou hodnotu a teprve pak ho použít v šabloně.

132

* K takto vytvořenému parametru je nutno přistupovat přes $P!{název_parametru} (vykřičník navíc).

133

* Pro vytvoření hodnoty parametru se dá použít skládání hodnot jako v Javě.

* (((

Příklad:

|

{{{<parameter name="d1" class="java.util.Date"/>

140

141

<defaultValueExpression><![CDATA["[work_type].[date_created] > '" + new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format($P{d1}) + "'"]]></defaultValueExpression>

</parameter>

<![CDATA[

SELECT [name] AS work_type_name

146

FROM [work_type]

147

WHERE $P!{d1_sql_condition}

148

]]>

149

</queryString>

150

<field name="work_type_name" class="java.lang.String"/>}}}

)))

* Pro datum 1.2.2015 10:00:00 bude v parametru d1_sql_condition nastavena hodnota "[work_type].[date_created] > '2015-02-01 10:00:00' ", což odpovídá SQL zápisu

155

156

== Povinné a nepovinné parametry ==

157

158

* Pokud je parametr povinný, není potřeba ho ošetřovat.

159

* Nepovinný parametr může do šablony přijít jako NULL - je potřeba zajistit vytvoření validního SQL.

160

* K tomu se používá předzpracování parametru, viz výše.

161

* Využití ternárního operátoru

162

** Když je parametr různý od null, použij hodnotu A, jinak hodnotu B

163

* Podmínka 1=1 - neomezuje výsledky.

* (((

Příklad:

|

{{{<parameter name="d1" class="java.util.Date"/>

171

172

<defaultValueExpression><![CDATA[$P{d1} == null ? "1=1" : ("[work].[date_created] > '" + new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format($P{d1}) + "'"]]></defaultValueExpression>

</parameter>

<![CDATA[

SELECT [name] AS work_type_name

177

FROM [work_type]

178

WHERE $P!{d1_sql_condition}

179

]]>

180

</queryString>

181

<field name="work_type_name" class="java.lang.String"/>}}}

)))

* Pokud je parametr NULL, použije se podmínka 1=1 (načtou se všechny záznamy). Jinak použije standardní SQL podmínku pro zadanou hodnotu.

== Definice v GUI ==

*

** Výše uvedené řeší, jak se mají parametry, které přijdou z Tritia, zpracovávat v šabloně.

191

** Je ale nutné definovat, že se zadání těchto parametrů má v Tritiu nabízet.

192

** Definováno v report_template ve sloupci param2.

193

** Každý parametr je určen:

194

*** unikátním názvem - pod tímto názvem se pak zpracová v šabloně, musí být stejné,datovým typem - aby se v Tritiu zobrazila odpovídající komponenta pro vstup,klíčem k překladu popisku,určením, zda je parametr nepovinný.

**Datové typy**

*

** řetězec - s

** celočíselná hodnota - n

202

** desetinná hodnota - double

203

** datum včetně času - d

204

** datum začátek dne (bez časové složky) - ds

205

** datum konec dne (bez časové složky) - de

206

** logická hodnota - b

207

** uživatel - u

208

** knihovna - l

209

** webová definice - w

210

** databázové objekty - zadávají se jako název UJO class (např. Work, Item, ...)

211

*** zobrazují se v comboboxu

212

213

* **Unikátní název** - skládá se z datového typu doplněného o číslo

214

** např. d1, u2, Work3

215

216

* **Klíč k překladu** - zobrazuje se jako popisek vstupu

217

** zadává se v hranatých závorkách

218

** např. [User], [Work_id]

219

220

* **Nastavení povinnosti**

221

** Povinné parametry je nutno v Tritiu vyplnit, není bez nich umožněno vytvořit výstup.

222

** Parametry jsou ve výchozím stavu povinné.

223

** Nepovinnost je možno nastavit přidáním znaku ? (otazník) před název parametru.

224

225

* Příklady parametrů:

226

** n1[Work_id] - povinný celočíselný parametr s názvem n1 v šabloně a překladem Work_id v Tritiu.

227

** ?w2[Web_definition] - nepovinný parametr, zobrazuje se combobox s webovými definicemi, název v šabloně je w2, popiskem v Tritiu je překlad Web_definition.

228

** Work3[My_work] - povinný parametr, nabízí se jako combobox s díly, v šabloně pod názvem Work3, popisek je překlad My_work.

229

230

* Každá šablona může obsahovat více parametrů - navzájem oddělené čárkou nebo středníkem.

231

* Příklad:

232

** n1[Work_id],?w2[Web_definition]- šablona s 1 povinným parametrem a jedním nepovinným.

233

234

= Rozlišení pro různé databáze =

235

236

* Různé databáze používají jiné escapování tabulek.

237

** Mysql - `work`

238

** MSSQL - [work]

239

* Pokud se vytváří šablona pro jednu konkrétní databázi, není toto nutné řešit.

240

* V šabloně pro více databází je nutno escapování řešit - nejsou navzájem kompatibilní

241

* K tomuto se používají speciální párové tagy

242

** SQL se umístí dovnitř těchto tagů.

243

** Escapování se upraví pro použitou databázi.

244

** Je nutno escapovat pro MSSQL

== <sql> ==

* Používá se v části s hlavním SQL šablony.

249

* Nelze ho používat v parametrech.

250

* Pro SQL se musí používat MSSQL escapování.

251

* Musí se vkládat do části ![CDATA[....]] - nejedná se o standardní XML tag, JasperReports by ho nedokázal zpracovat.

* (((

Příklad:

|

{{{<queryString language="SQL">

258

<![CDATA[

259

<sql>

260

SELECT [name] AS work_type_name

FROM [work_type]

</sql>

]]>

</queryString>}}}

)))

== <sqlp> ==

* Používá se v části s parametry

272

* Nelze ho použít v hlavním SQL šablony

273

* SQL musí mít MSSQL escapování

274

* Musí se vkládat do ![CDATA[....]]

* (((

Příklad:

|

{{{<parameter name="d1_sql_condition" class="java.lang.String">

281

<defaultValueExpression><![CDATA[<sqlp>$P{d1} == null ? "1=1" : ("[work].[date_created] > '" + new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format($P{d1}) + "'")</sqlp>]]></defaultValueExpression>

</parameter>}}}

)))

== Různá SQL pro databáze ==

288

289

* Pro složitější SQL dotazy jen změna escapování nestačí, protože každá databáze používá jinou syntaxi příkazů