Add and clean up rel_2_1 branch.
[working/Evergreen.git] / reports / report-shared-template.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <chapter xml:id="shared-template" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="EN"\r
3    xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink">\r
4    <info>\r
5       <title>Cloning Shared Templates</title>\r
6    </info>\r
7    <para> This chapter describes how\r
8       to make local copies of shared templates for routine reports or as a starting point for\r
9       customization. When creating a new template it is a good idea to review the shared templates\r
10       first: even if the exact template you need does not exist it is often faster to modify an\r
11       existing template than to build a brand new one. A Local System Administrator account is\r
12       required to clone templates from the <guilabel>Shared Folders</guilabel> section and save them\r
13       to <guilabel>My Folders</guilabel>. </para>\r
14    <para>The steps below assume you have already created at least one <guilabel>Templates</guilabel>\r
15       folder.  If you haven’t done this, please see <xref linkend="folder"/>. </para>\r
16 \r
17    <procedure>\r
18       <step>\r
19          <para>Access the reports interface from the <guimenu>Admin (-)</guimenu> menu under <menuchoice>\r
20                <guimenu>Local Administration</guimenu>\r
21                <guimenuitem>Reports</guimenuitem>\r
22             </menuchoice></para>\r
23       </step>\r
24 \r
25       <step>\r
26                     <para>Under <guilabel>Shared Folders</guilabel> expand the\r
27                      <guilabel>Templates</guilabel> folder and the subfolder of the report you wish to clone.  To expand the folders click on\r
28                   the grey arrow or folder icon.  Do not click on the blue underlined hyperlink. </para>\r
29       </step>\r
30  <step>\r
31             <para>Click on the subfolder.</para>\r
32 </step>\r
33       <step>\r
34          <informalfigure>\r
35             <para>Select the template you wish to clone.  From the\r
36                dropdown menu choose <guimenuitem>Clone selected templates</guimenuitem>, then click\r
37                   <guibutton>Submit</guibutton>.  </para>\r
38 \r
39             <para>\r
40                <mediaobject>\r
41                   <imageobject>\r
42                      <imagedata scalefit="0" fileref="../media/shared-template-6.png"/>\r
43                   </imageobject>\r
44                </mediaobject>\r
45             </para>\r
46          </informalfigure>\r
47          <para>By default Evergreen only displays the first 10 items in any folder.  To view all content, change the <guilabel>Limit output</guilabel> setting from <guimenuitem>10</guimenuitem> to <guimenuitem>All</guimenuitem>.</para>   \r
48       </step>\r
49       <step>\r
50          <informalfigure>\r
51             <para>Choose the folder where you want to save the cloned template, then click\r
52                   <guibutton>Select Folder</guibutton>. Only template folders created with your\r
53                account will be visible. If there are no folders to choose from please see <xref\r
54                   linkend="folder"/>.</para>\r
55 \r
56             <para>\r
57                <mediaobject>\r
58                   <imageobject>\r
59                      <imagedata scalefit="0" fileref="../media/shared-template-7.png"/>\r
60                   </imageobject>\r
61                </mediaobject>\r
62             </para>\r
63          </informalfigure>\r
64       </step>\r
65 \r
66 \r
67       <step>\r
68          <informalfigure>\r
69             <para>The cloned template opens in the template editor. From here you may modify the\r
70                template by adding, removing, or editing fields and filters as described in <xref\r
71                   linkend="create-template"/>. Template <guilabel>Name</guilabel> and\r
72                   <guilabel>Description</guilabel> can also be edited. When satisfied with your\r
73                changes click <guibutton>Save</guibutton>.</para>\r
74 \r
75             <para>\r
76                <mediaobject>\r
77                   <imageobject>\r
78                      <imagedata width="100%" scalefit="1" fileref="../media/shared-template-9.png"/>\r
79                   </imageobject>\r
80                </mediaobject>\r
81             </para>\r
82          </informalfigure>\r
83       </step>\r
84         <step>   \r
85             <para>Click OK in the resulting confirmation windows.</para> \r
86       </step>\r
87    </procedure>\r
88  <para>Once saved it is not possible to edit a template.  To make changes, clone a template and change the clone.\r
89      </para>\r
90 \r
91 </chapter>\r