Skip to main content
summaryrefslogtreecommitdiffstats
blob: 5b89db64243a87b39699851dd50cd005b3c3b4ee (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="IBM Software Development Platform">
<link rel="STYLESHEET" href="../../../book.css" charset="ISO-8859-1" type="text/css"/>
<TITLE>&lt;c:include&gt; - Standard JET2 Control Tags</TITLE>
</HEAD>
<BODY>
<TABLE border="0" cellpadding="0" cellspacing="1" width="100%">
	<TBODY>
		<TR>
			<TH align="left">
			<P>&lt;c:include&gt;</P></TH>
			<TH align="right"><A href="overview.html">Standard JET2 Control Tags</A></TH>
		</TR>
	</TBODY>
</TABLE>
<HR>
<P><B>include</B></P>
<P><P>               Process the referenced template, and include its results in the output of the current template.<P><P>The attribute 'passVariables' allows explicit declaration of the variables that are passed to the template. By default, all context variables are available to the template. With this parameter, only those variables specified are available. In addition, any changes to passed variables in the template are not reflected in the invoking context.<P><P>The deprecated &apos;restoreNames&apos; attribute is useful in recursive transforms. It causes the tag to save the listed variable values prior to executing the template, and then restore them after exectuion.<P><P>The 'restoreNames' and 'passVariables' options are mutually exclusive.<P>            </P>
<HR>
<TABLE border="1" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Tag Summary</TH></TR>
		<TR>
			<TD width="10%">required</TD>
			<TD><SPAN style="font-family: monospace">
			&lt;c:include template=&quot;<I>value</I>&quot;/&gt;<br>
			</SPAN></TD>
		</TR>
		<TR>
			<TD width="10%">full tag</TD>
			<TD><SPAN style="font-family: monospace">
			&lt;c:include template=&quot;<I>value</I>&quot; restoreNames=&quot;<I>value</I>&quot; passVariables=&quot;<I>value</I>&quot;/&gt;<br>
			</SPAN></TD>
		</TR>
	</TBODY>
</TABLE>
<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Required Attributes</TH></TR>
		<TR>
			<TD width="10%">template</TD>
			<TD><BR>                  A transform project relative path to the template to execute.<BR>               </TD>
		</TR>
	</TBODY>
</TABLE>
</exists>
<HR>
<TABLE border="1" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Optional Attributes</TH></TR>
		<TR>
		<TR>
			<TD width="10%">restoreNames</TD>
			<TD><BR>                  A comma separated list of variable names (without the $ sign). Mutually exclusive with 'passVariables'.<BR>               </TD>
		</TR>
		<TR>
			<TD width="10%">passVariables</TD>
			<TD><BR>                  A comma separated list of variable names (without the $ sign). Mutually exclusive with 'restoreNames'.<BR>               </TD>
		</TR>
	</TBODY>
</TABLE>
<HR>
<TABLE border="1" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Example</TH></TR>
		<TR>
			<TD width="10%"></TD>
			<TD><SPAN style="font-family: monospace">
<!-- Begin include example -->

			&lt;c:include template=&quot;<I>value</I>&quot;/&gt;<br>
<!-- End include example -->
</SPAN></TD>
		</TR>
	</TBODY>
</TABLE>
<P></P></BODY>
</HTML>

Back to the top