doc/src/docbook/user/webclient.xml

Code
Comments
Other
Rev Date Author Line
3153 05 Mar 07 nicklas 1 <?xml version="1.0" encoding="UTF-8"?>
3159 05 Mar 07 martin 2 <!DOCTYPE chapter PUBLIC 
3159 05 Mar 07 martin 3     "-//Dawid Weiss//DTD DocBook V3.1-Based Extension for XML and graphics inclusion//EN" 
3192 13 Mar 07 martin 4     "../../../../lib/docbook/preprocess/dweiss-docbook-extensions.dtd">
3159 05 Mar 07 martin 5 <!--
3192 13 Mar 07 martin 6   $Id$
3153 05 Mar 07 nicklas 7
4889 06 Apr 09 nicklas 8   Copyright (C) 2007 Jari Häkkinen, Peter Johansson, Nicklas Nordborg, Martin Svensson
3159 05 Mar 07 martin 9
3159 05 Mar 07 martin 10   This file is part of BASE - BioArray Software Environment.
3159 05 Mar 07 martin 11   Available at http://base.thep.lu.se/
3159 05 Mar 07 martin 12
3159 05 Mar 07 martin 13   BASE is free software; you can redistribute it and/or
3159 05 Mar 07 martin 14   modify it under the terms of the GNU General Public License
4477 05 Sep 08 jari 15   as published by the Free Software Foundation; either version 3
3159 05 Mar 07 martin 16   of the License, or (at your option) any later version.
3159 05 Mar 07 martin 17
3159 05 Mar 07 martin 18   BASE is distributed in the hope that it will be useful,
3159 05 Mar 07 martin 19   but WITHOUT ANY WARRANTY; without even the implied warranty of
3159 05 Mar 07 martin 20   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
3159 05 Mar 07 martin 21   GNU General Public License for more details.
3159 05 Mar 07 martin 22
3159 05 Mar 07 martin 23   You should have received a copy of the GNU General Public License
4509 11 Sep 08 jari 24   along with BASE. If not, see <http://www.gnu.org/licenses/>.
3159 05 Mar 07 martin 25 -->
3159 05 Mar 07 martin 26
3181 12 Mar 07 nicklas 27 <chapter id="webclient">
5782 04 Oct 11 nicklas 28   <?dbhtml dir="webclient" filename="index.html" ?>
3181 12 Mar 07 nicklas 29   <title>Using the web client</title>
3181 12 Mar 07 nicklas 30     <sect1 id="webclient.introduction">
5782 04 Oct 11 nicklas 31       <?dbhtml filename="introduction.html" ?>
3153 05 Mar 07 nicklas 32       <title>Introduction</title>
3153 05 Mar 07 nicklas 33       
3181 12 Mar 07 nicklas 34       <sect2 id="webclient.intro.login">
3181 12 Mar 07 nicklas 35         <title>Logging in</title>
3197 19 Mar 07 nicklas 36         <para>
3197 19 Mar 07 nicklas 37           There are three things that you need to know
3197 19 Mar 07 nicklas 38           before you can use BASE:
3197 19 Mar 07 nicklas 39         </para>
3197 19 Mar 07 nicklas 40         
3197 19 Mar 07 nicklas 41         <orderedlist>
3320 10 May 07 martin 42         <listitem><simpara>The address (URL) to a BASE server</simpara></listitem>
3320 10 May 07 martin 43         <listitem><simpara>A username to login with</simpara></listitem>
3320 10 May 07 martin 44         <listitem><simpara>A password</simpara></listitem>
3197 19 Mar 07 nicklas 45         </orderedlist>
3197 19 Mar 07 nicklas 46         
3197 19 Mar 07 nicklas 47         <para>
4487 08 Sep 08 jari 48           You may, for example, try the BASE demo server. Go to the
7982 14 Jun 21 nicklas 49           URL <ulink url="https://base.onk.lu.se/demo/">https://base.onk.lu.se/demo/</ulink>
3197 19 Mar 07 nicklas 50           and enter <userinput>base2</userinput> for the login and <userinput>base2</userinput>
6576 22 Oct 14 nicklas 51           for the password. NOTE! The demo server is currently down!
3197 19 Mar 07 nicklas 52         </para>
3197 19 Mar 07 nicklas 53         
3197 19 Mar 07 nicklas 54         <para>
3320 10 May 07 martin 55           You need to get all three things from an administrator
3197 19 Mar 07 nicklas 56           of the BASE server. If you know only the address to the
3197 19 Mar 07 nicklas 57           BASE server, you may check the front page if the administrator
3197 19 Mar 07 nicklas 58           has added any information about how to get a username/password
3276 26 Apr 07 nicklas 59           there. Look for the <guilabel>Get an account!</guilabel> link on
3276 26 Apr 07 nicklas 60           the front page.
3197 19 Mar 07 nicklas 61         </para>
3197 19 Mar 07 nicklas 62         
3197 19 Mar 07 nicklas 63         <para>
3197 19 Mar 07 nicklas 64           Logging in is simple, just enter your <guilabel>login</guilabel> 
3276 26 Apr 07 nicklas 65           and <guilabel>password</guilabel> in the form on the front page
5827 26 Oct 11 nicklas 66           and click the <guibutton>Login</guibutton> button.
3197 19 Mar 07 nicklas 67         </para>
7115 16 Mar 16 nicklas 68         
7115 16 Mar 16 nicklas 69         <note>
7115 16 Mar 16 nicklas 70           <title>Problems with the start page</title>
7115 16 Mar 16 nicklas 71           <para>
7115 16 Mar 16 nicklas 72             If you have selected a non-default start page
7115 16 Mar 16 nicklas 73             and there happens to be a problem with it 
7115 16 Mar 16 nicklas 74             it may prevent you from accessing BASE. In
7115 16 Mar 16 nicklas 75             the worst scenario all that is displayed is a cryptic
7115 16 Mar 16 nicklas 76             error message. In this case, it is good to know that
7115 16 Mar 16 nicklas 77             holding down either one of the <guilabel>ALT</guilabel>
7115 16 Mar 16 nicklas 78             or <guilabel>CTRL</guilabel> or <guilabel>SHIFT</guilabel>
7115 16 Mar 16 nicklas 79             keys while clicking the <guibutton>Login</guibutton>
7115 16 Mar 16 nicklas 80             button will force BASE to use the regular start page.
7115 16 Mar 16 nicklas 81           </para>
7115 16 Mar 16 nicklas 82         </note>
7115 16 Mar 16 nicklas 83         
3153 05 Mar 07 nicklas 84       </sect2>
3276 26 Apr 07 nicklas 85       
3276 26 Apr 07 nicklas 86       <sect2 id="webclient.intro.forgotten_password">
3276 26 Apr 07 nicklas 87         <title>Forgotten password</title>
3276 26 Apr 07 nicklas 88         <para>
3276 26 Apr 07 nicklas 89           If you forget your password you will need to get a new one.
3487 13 Jun 07 peter 90           BASE stores the passwords in an encrypted form that does not allow
3276 26 Apr 07 nicklas 91           anyone, not even the server administrator, to find out the 
3276 26 Apr 07 nicklas 92           un-encrypted password.
3276 26 Apr 07 nicklas 93         </para>
3276 26 Apr 07 nicklas 94         <para>
3276 26 Apr 07 nicklas 95           To get a new password you will have to contact the server
3276 26 Apr 07 nicklas 96           administrator. There may be a <guilabel>Forgot your password?</guilabel>
3276 26 Apr 07 nicklas 97           link on the front page where the server administrator has entered
3276 26 Apr 07 nicklas 98           information about how to get a new password.
3276 26 Apr 07 nicklas 99         </para>
3276 26 Apr 07 nicklas 100       </sect2>
7412 11 Oct 17 nicklas 101       
7412 11 Oct 17 nicklas 102       <sect2 id="webclient.intro.2-factor-login">
7412 11 Oct 17 nicklas 103         <title>2-factor login</title>
7412 11 Oct 17 nicklas 104         <para>
7412 11 Oct 17 nicklas 105           BASE supports a 2-factor login system that sends out one-time
7412 11 Oct 17 nicklas 106           verification codes via email the first time you try to
7412 11 Oct 17 nicklas 107           login from a new browser. The system has been designed to
7412 11 Oct 17 nicklas 108           protect your account in case your login information and password
7412 11 Oct 17 nicklas 109           is compromised. If 2-factor login has been enabled on the 
7412 11 Oct 17 nicklas 110           server and for your user account (see <xref linkend="webclient.configuration.contact" />), 
7412 11 Oct 17 nicklas 111           an additional screen is displayed.
7412 11 Oct 17 nicklas 112         </para>
3276 26 Apr 07 nicklas 113
7412 11 Oct 17 nicklas 114         <figure id="webclient.figures.2-factor-login">
7412 11 Oct 17 nicklas 115           <title>2-factor login: Enter verification code</title>
7412 11 Oct 17 nicklas 116           <screenshot>
7412 11 Oct 17 nicklas 117             <mediaobject>
7412 11 Oct 17 nicklas 118               <imageobject><imagedata fileref="figures/verification_code.png" format="PNG"
7412 11 Oct 17 nicklas 119                 scalefit="1" width="100%"/></imageobject>
7412 11 Oct 17 nicklas 120             </mediaobject>
7412 11 Oct 17 nicklas 121           </screenshot>
7412 11 Oct 17 nicklas 122         </figure>
7412 11 Oct 17 nicklas 123
7412 11 Oct 17 nicklas 124         <para>
7412 11 Oct 17 nicklas 125           To complete the login, you need to enter the verification code (6 digits)
7412 11 Oct 17 nicklas 126           that is sent to your registered email address. If you keep the 
7412 11 Oct 17 nicklas 127           <guilabel>Remember this device</guilabel> checked then BASE will remember
7412 11 Oct 17 nicklas 128           the browser you are using and not ask you about a verification code the next
7412 11 Oct 17 nicklas 129           time.
7412 11 Oct 17 nicklas 130         </para>
7412 11 Oct 17 nicklas 131         
7412 11 Oct 17 nicklas 132         <tip>
7412 11 Oct 17 nicklas 133           <para>
7412 11 Oct 17 nicklas 134             If you are on a public computer you should uncheck the 
7412 11 Oct 17 nicklas 135             <guilabel>Remember this device</guilabel> to prevent someone
7412 11 Oct 17 nicklas 136             else from logging into your account at a later time from that
7412 11 Oct 17 nicklas 137             computer.
7412 11 Oct 17 nicklas 138           </para>
7412 11 Oct 17 nicklas 139           
7412 11 Oct 17 nicklas 140           <para>
7412 11 Oct 17 nicklas 141             If you go to <menuchoice><guimenu>BASE</guimenu><guimenuitem>Devices</guimenuitem></menuchoice>
7412 11 Oct 17 nicklas 142             you can see all registered devices/browsers that you have used to access the BASE server.
7412 11 Oct 17 nicklas 143             We recommend that you check this list once in a while and delete browsers that
7412 11 Oct 17 nicklas 144             you no longer use. 
7412 11 Oct 17 nicklas 145           </para>
7412 11 Oct 17 nicklas 146         </tip>
7412 11 Oct 17 nicklas 147         
7412 11 Oct 17 nicklas 148         <note>
7412 11 Oct 17 nicklas 149           <title>Private browsing mode</title>
7412 11 Oct 17 nicklas 150           
7412 11 Oct 17 nicklas 151           <para>
7412 11 Oct 17 nicklas 152             BASE need to store a token on your computer to make the 2-factor login system
7412 11 Oct 17 nicklas 153             work. If you are using a browser in private or incognito mode the 2-factor login
7412 11 Oct 17 nicklas 154             may not work.
7412 11 Oct 17 nicklas 155           </para>
7412 11 Oct 17 nicklas 156         </note>
7412 11 Oct 17 nicklas 157         
7412 11 Oct 17 nicklas 158       </sect2>
7412 11 Oct 17 nicklas 159
3197 19 Mar 07 nicklas 160       <sect2 id="webclient.intro.homepage">
3197 19 Mar 07 nicklas 161         <title>The home page</title>
3153 05 Mar 07 nicklas 162       
3197 19 Mar 07 nicklas 163       <para>
3197 19 Mar 07 nicklas 164         When you have been logged in the home page will be displayed. It
3276 26 Apr 07 nicklas 165         displays some useful information. You can also go to the home page
3276 26 Apr 07 nicklas 166         using the 
3276 26 Apr 07 nicklas 167         <menuchoice><guimenu>View</guimenu><guimenuitem>Home</guimenuitem></menuchoice>
5789 06 Oct 11 nicklas 168         menu.
3197 19 Mar 07 nicklas 169       </para>
3197 19 Mar 07 nicklas 170         
3197 19 Mar 07 nicklas 171       <figure id="webclient.figures.homepage">
3197 19 Mar 07 nicklas 172         <title>The home page</title>
3197 19 Mar 07 nicklas 173         <screenshot>
3197 19 Mar 07 nicklas 174           <mediaobject>
3346 16 May 07 nicklas 175             <imageobject><imagedata fileref="figures/homepage.png" format="PNG"
3348 16 May 07 nicklas 176               scalefit="1" width="100%"/></imageobject>
3197 19 Mar 07 nicklas 177           </mediaobject>
3197 19 Mar 07 nicklas 178         </screenshot>
3197 19 Mar 07 nicklas 179       </figure>
3197 19 Mar 07 nicklas 180         
3197 19 Mar 07 nicklas 181       <variablelist>
3197 19 Mar 07 nicklas 182         <varlistentry>
3197 19 Mar 07 nicklas 183           <term><interface>New messages</interface></term>
3197 19 Mar 07 nicklas 184           <listitem>
3197 19 Mar 07 nicklas 185             <para>
5789 06 Oct 11 nicklas 186             Messages are, for example, sent by plug-ins to notify you about finished jobs. In the
3214 26 Mar 07 nicklas 187             future, you may get messages from other sources as well. As of today,
3214 26 Mar 07 nicklas 188             messages are not used for communication between users.
3197 19 Mar 07 nicklas 189             </para>
3197 19 Mar 07 nicklas 190           </listitem>
3197 19 Mar 07 nicklas 191         </varlistentry>
3197 19 Mar 07 nicklas 192         
3197 19 Mar 07 nicklas 193         <varlistentry>
3197 19 Mar 07 nicklas 194           <term><interface>Projects</interface></term>
3197 19 Mar 07 nicklas 195           <listitem>
3197 19 Mar 07 nicklas 196             <para>
3276 26 Apr 07 nicklas 197             A list of projects that you are a member of. Projects are an important
3276 26 Apr 07 nicklas 198             part of BASE and are the best way to share data when you are 
3276 26 Apr 07 nicklas 199             cooperating with other users. We recommend
3276 26 Apr 07 nicklas 200             that you always use a project when working with BASE. 
5684 02 Aug 11 nicklas 201             For more information read <xref linkend="project_permission"/>. The list
5684 02 Aug 11 nicklas 202             displays the most recently used projects first and then fills up
5684 02 Aug 11 nicklas 203             with the rest sorted by name.
3197 19 Mar 07 nicklas 204             </para>
3197 19 Mar 07 nicklas 205           </listitem>
3197 19 Mar 07 nicklas 206         </varlistentry>
3197 19 Mar 07 nicklas 207         
3197 19 Mar 07 nicklas 208         <varlistentry>
3197 19 Mar 07 nicklas 209           <term><interface>Disk usage</interface></term>
3197 19 Mar 07 nicklas 210           <listitem>
3197 19 Mar 07 nicklas 211             <para>
3197 19 Mar 07 nicklas 212             An overview of how much disk space you have been assigned and
3197 19 Mar 07 nicklas 213             how much you are using.
3197 19 Mar 07 nicklas 214             </para>
3197 19 Mar 07 nicklas 215           </listitem>
3197 19 Mar 07 nicklas 216         </varlistentry>
3197 19 Mar 07 nicklas 217         
3197 19 Mar 07 nicklas 218         <varlistentry>
3197 19 Mar 07 nicklas 219           <term><interface>Help</interface></term>
3197 19 Mar 07 nicklas 220           <listitem>
3197 19 Mar 07 nicklas 221             <para>
3214 26 Mar 07 nicklas 222             Links for getting help and reporting bugs. The number
3276 26 Apr 07 nicklas 223             of links displayed here may vary depending on the server
3276 26 Apr 07 nicklas 224             configuration.
3197 19 Mar 07 nicklas 225             </para>
3197 19 Mar 07 nicklas 226           </listitem>
3197 19 Mar 07 nicklas 227         </varlistentry>
3197 19 Mar 07 nicklas 228         
3197 19 Mar 07 nicklas 229         <varlistentry>
3197 19 Mar 07 nicklas 230           <term><interface>News and announcements</interface></term>
3197 19 Mar 07 nicklas 231           <listitem>
3197 19 Mar 07 nicklas 232             <para>
3197 19 Mar 07 nicklas 233             A list of important news and announcements from the
3197 19 Mar 07 nicklas 234             server administrator. Here you may, for example, find
3197 19 Mar 07 nicklas 235             information about server upgrades and maintenance.
3197 19 Mar 07 nicklas 236             </para>
5789 06 Oct 11 nicklas 237             
5789 06 Oct 11 nicklas 238             <tip>
5789 06 Oct 11 nicklas 239               <title>Subscribe to the RSS news feed.</title>
5789 06 Oct 11 nicklas 240               <para>
5789 06 Oct 11 nicklas 241                 Click on the RSS icon <guiicon>
5789 06 Oct 11 nicklas 242               <inlinemediaobject>
5789 06 Oct 11 nicklas 243               <imageobject><imagedata fileref="figures/rss.png" format="PNG" /></imageobject>
5789 06 Oct 11 nicklas 244               </inlinemediaobject>
5789 06 Oct 11 nicklas 245             </guiicon> in the <interface>News and announcements</interface>
5789 06 Oct 11 nicklas 246                 title bar. This allows you to subscribe to the news feed 
5789 06 Oct 11 nicklas 247                 from the BASE server so that you don't miss anything interesting.
5789 06 Oct 11 nicklas 248               </para>
5789 06 Oct 11 nicklas 249             </tip>
3197 19 Mar 07 nicklas 250           </listitem>
3197 19 Mar 07 nicklas 251         </varlistentry>
3197 19 Mar 07 nicklas 252       </variablelist>
3197 19 Mar 07 nicklas 253         
3197 19 Mar 07 nicklas 254       </sect2>
3197 19 Mar 07 nicklas 255       
3181 12 Mar 07 nicklas 256       <sect2 id="webclient.intro.menubar">
3181 12 Mar 07 nicklas 257         <title>Using the menu bar</title>
3197 19 Mar 07 nicklas 258         <para>
3197 19 Mar 07 nicklas 259           On the top of the home page is the <interface>Menu bar</interface>.
3197 19 Mar 07 nicklas 260           This is the main navigation tool in BASE. It works the same way 
3197 19 Mar 07 nicklas 261           as the regular menu system found in most other applications. Use
3320 10 May 07 martin 262           the mouse to click and select an item from the menu. 
3197 19 Mar 07 nicklas 263         </para>
3197 19 Mar 07 nicklas 264         
3197 19 Mar 07 nicklas 265         <para>
3197 19 Mar 07 nicklas 266           Most of the menu is in two levels, ie. clicking on a top-level menu
3197 19 Mar 07 nicklas 267           will open a submenu just below it. Clicking on something in the
4487 08 Sep 08 jari 268           submenu will take you to another page or open a pop-up dialog window. 
3276 26 Apr 07 nicklas 269           For example, the
4733 21 Jan 09 martin 270           <menuchoice><guimenu>Biomaterial LIMS</guimenu><guimenuitem>Samples</guimenuitem></menuchoice>
3276 26 Apr 07 nicklas 271           menu will take you to the page listing samples and 
5017 26 Jun 09 nicklas 272           <menuchoice><guimenu>BASE</guimenu><guimenuitem>Contact information</guimenuitem></menuchoice>
3276 26 Apr 07 nicklas 273           opens a dialog where you can modify your contact information details.
3197 19 Mar 07 nicklas 274         </para>
3197 19 Mar 07 nicklas 275         
3214 26 Mar 07 nicklas 276         <para>
3214 26 Mar 07 nicklas 277           The menu bar also contains shortcuts to some often-used
3214 26 Mar 07 nicklas 278           actions:
3214 26 Mar 07 nicklas 279         </para>
3214 26 Mar 07 nicklas 280         
3214 26 Mar 07 nicklas 281         
3214 26 Mar 07 nicklas 282       <variablelist>
3214 26 Mar 07 nicklas 283         <varlistentry>
5684 02 Aug 11 nicklas 284           <term>
5684 02 Aug 11 nicklas 285             <guiicon>
5684 02 Aug 11 nicklas 286               <inlinemediaobject>
5971 17 Feb 12 nicklas 287               <imageobject><imagedata fileref="figures/project.png" format="PNG" /></imageobject>
5684 02 Aug 11 nicklas 288               </inlinemediaobject>
5684 02 Aug 11 nicklas 289             </guiicon>
5684 02 Aug 11 nicklas 290             <interface>
5684 02 Aug 11 nicklas 291             Projects
5684 02 Aug 11 nicklas 292             </interface>
5684 02 Aug 11 nicklas 293           </term>
5684 02 Aug 11 nicklas 294           <listitem>
5684 02 Aug 11 nicklas 295             <para>
5684 02 Aug 11 nicklas 296             A list of all projects you are a member of. The most recently used projects are
5684 02 Aug 11 nicklas 297             listed first, then the list is filled with the rest of your projects up to a
5684 02 Aug 11 nicklas 298             maximum of 15. If you have more projects an option to display the remaining 
5684 02 Aug 11 nicklas 299             projects is activated. Selecting a project in the list will make that project 
5684 02 Aug 11 nicklas 300             the active project. 
5684 02 Aug 11 nicklas 301             </para>
5684 02 Aug 11 nicklas 302             <tip>
5684 02 Aug 11 nicklas 303               <para>
5684 02 Aug 11 nicklas 304               The sort order in the menu of non-recent projects is the same as the sort order on the
5684 02 Aug 11 nicklas 305               projects list page. If you, for example, want to sort the newest
5684 02 Aug 11 nicklas 306               project first (after the most recently used ones), select to sort by the 
5684 02 Aug 11 nicklas 307               <guilabel>Registered</guilabel> column in descending order on the list page. 
5684 02 Aug 11 nicklas 308               The menu will automatically use the same order.
5684 02 Aug 11 nicklas 309               </para>
5684 02 Aug 11 nicklas 310             </tip>
5684 02 Aug 11 nicklas 311           </listitem>
5684 02 Aug 11 nicklas 312         </varlistentry>
5684 02 Aug 11 nicklas 313         <varlistentry>
3950 12 Nov 07 martin 314           <term>            
3950 12 Nov 07 martin 315             <guiicon>
3950 12 Nov 07 martin 316               <inlinemediaobject>
5971 17 Feb 12 nicklas 317               <imageobject><imagedata fileref="figures/refresh.png" format="PNG" 
3950 12 Nov 07 martin 318                 /></imageobject>
3950 12 Nov 07 martin 319               </inlinemediaobject>
5792 07 Oct 11 nicklas 320             </guiicon> 
3214 26 Mar 07 nicklas 321             <interface>
3221 02 Apr 07 nicklas 322             Refresh page
3214 26 Mar 07 nicklas 323             </interface>
3214 26 Mar 07 nicklas 324           </term>
3214 26 Mar 07 nicklas 325           <listitem>
3214 26 Mar 07 nicklas 326             <para>
3214 26 Mar 07 nicklas 327             Refresh/reload the current page. This is useful when you add
3214 26 Mar 07 nicklas 328             or modify items in BASE. Most of the time the page is refreshed
3214 26 Mar 07 nicklas 329             automatically, but in some cases you will have to use
3214 26 Mar 07 nicklas 330             this button to refresh the page.
3214 26 Mar 07 nicklas 331             </para>
3214 26 Mar 07 nicklas 332             
3214 26 Mar 07 nicklas 333             <warning>
3214 26 Mar 07 nicklas 334               <para>
3276 26 Apr 07 nicklas 335               Do not use your browser's <guibutton>Refresh</guibutton> button.
3276 26 Apr 07 nicklas 336               Most browsers will take you to the login page again.
3214 26 Mar 07 nicklas 337               </para>
3214 26 Mar 07 nicklas 338             </warning>
3214 26 Mar 07 nicklas 339           </listitem>
3214 26 Mar 07 nicklas 340         </varlistentry>
3214 26 Mar 07 nicklas 341         
3214 26 Mar 07 nicklas 342         <varlistentry>
3950 12 Nov 07 martin 343           <term>      
3950 12 Nov 07 martin 344             <guiicon>      
3950 12 Nov 07 martin 345               <inlinemediaobject>
5792 07 Oct 11 nicklas 346               <imageobject><imagedata fileref="figures/recent.png" format="PNG"/></imageobject>
3950 12 Nov 07 martin 347               </inlinemediaobject>
3950 12 Nov 07 martin 348             </guiicon>
3214 26 Mar 07 nicklas 349             <interface>
3214 26 Mar 07 nicklas 350             Recent items
3214 26 Mar 07 nicklas 351             </interface>
3214 26 Mar 07 nicklas 352           </term>
3214 26 Mar 07 nicklas 353           <listitem>
3214 26 Mar 07 nicklas 354             <para>
3492 14 Jun 07 nicklas 355             Shortcut to the most recently viewed items. The number of items are
3492 14 Jun 07 nicklas 356             configurable and you can also make some item types 
3492 14 Jun 07 nicklas 357             <emphasis>sticky</emphasis>. This will for example keep the shortcut
3492 14 Jun 07 nicklas 358             to the last experiment even if you have viewed lots of other items
3492 14 Jun 07 nicklas 359             more recently.
3221 02 Apr 07 nicklas 360             See <xref linkend="webclient.configuration.preferences.mostrecent"/>
3492 14 Jun 07 nicklas 361             for configuration information.
3214 26 Mar 07 nicklas 362             </para>
3214 26 Mar 07 nicklas 363           </listitem>
3214 26 Mar 07 nicklas 364         </varlistentry>
3214 26 Mar 07 nicklas 365         
3214 26 Mar 07 nicklas 366         <varlistentry>
3214 26 Mar 07 nicklas 367           <term>
3950 12 Nov 07 martin 368             <guiicon>
3950 12 Nov 07 martin 369               <inlinemediaobject>
5792 07 Oct 11 nicklas 370               <imageobject><imagedata fileref="figures/user.png" format="PNG" /></imageobject>
3950 12 Nov 07 martin 371               </inlinemediaobject>
3950 12 Nov 07 martin 372             </guiicon>
3214 26 Mar 07 nicklas 373             <interface>
3214 26 Mar 07 nicklas 374             Logged in user
3214 26 Mar 07 nicklas 375             </interface>
3214 26 Mar 07 nicklas 376           </term>
3214 26 Mar 07 nicklas 377           <listitem>
3214 26 Mar 07 nicklas 378             <para>
3214 26 Mar 07 nicklas 379             Displays the name of the currently logged in user and allows
4487 08 Sep 08 jari 380             you to quickly log out and switch to another user.
3214 26 Mar 07 nicklas 381             </para>
3214 26 Mar 07 nicklas 382           </listitem>
3214 26 Mar 07 nicklas 383         </varlistentry>
3214 26 Mar 07 nicklas 384         
3214 26 Mar 07 nicklas 385       </variablelist>
3214 26 Mar 07 nicklas 386         
3153 05 Mar 07 nicklas 387       </sect2>
3153 05 Mar 07 nicklas 388       
3181 12 Mar 07 nicklas 389       <sect2 id="webclient.intro.help">
3181 12 Mar 07 nicklas 390         <title>Getting help</title>
3276 26 Apr 07 nicklas 391         <para>
3276 26 Apr 07 nicklas 392           Besides reading this document there are more ways to get help:
3276 26 Apr 07 nicklas 393         </para>
3276 26 Apr 07 nicklas 394         <variablelist>
3276 26 Apr 07 nicklas 395           <varlistentry>
3276 26 Apr 07 nicklas 396             <term>
4487 08 Sep 08 jari 397               On-line context-sensitive help
3276 26 Apr 07 nicklas 398             </term>
3276 26 Apr 07 nicklas 399             <listitem>
3276 26 Apr 07 nicklas 400               <para>
3950 12 Nov 07 martin 401               Whenever you find a small help icon 
5789 06 Oct 11 nicklas 402               <guiicon>
3950 12 Nov 07 martin 403                 <inlinemediaobject>
5971 17 Feb 12 nicklas 404                 <imageobject><imagedata fileref="figures/help.png" format="PNG" /></imageobject>
3950 12 Nov 07 martin 405                 </inlinemediaobject>
5789 06 Oct 11 nicklas 406               </guiicon>
3950 12 Nov 07 martin 407               or button you may
3276 26 Apr 07 nicklas 408               click it to get help about the part of the page
3276 26 Apr 07 nicklas 409               you are currently viewing. The icon is located in the title
4487 08 Sep 08 jari 410               bar in most pop-up dialog windows and in the toolbar in most
3276 26 Apr 07 nicklas 411               other pages.
3276 26 Apr 07 nicklas 412               </para>
3276 26 Apr 07 nicklas 413             </listitem>
3276 26 Apr 07 nicklas 414           </varlistentry>
3276 26 Apr 07 nicklas 415
3276 26 Apr 07 nicklas 416           <varlistentry>
3276 26 Apr 07 nicklas 417             <term>
3276 26 Apr 07 nicklas 418               Using the <menuchoice><guimenu>Help</guimenu></menuchoice> menu
3276 26 Apr 07 nicklas 419             </term>
3276 26 Apr 07 nicklas 420             <listitem>
3276 26 Apr 07 nicklas 421               <para>
3276 26 Apr 07 nicklas 422               The <menuchoice><guimenu>Help</guimenu></menuchoice> menu
4487 08 Sep 08 jari 423               contains links for getting on-line help. These links
3276 26 Apr 07 nicklas 424               may be configured by a server administrator, so they may be 
3276 26 Apr 07 nicklas 425               different from server to server. By default links for reporting
3276 26 Apr 07 nicklas 426               a bug and accessing this document are installed.
3276 26 Apr 07 nicklas 427               </para>
3276 26 Apr 07 nicklas 428             </listitem>
3276 26 Apr 07 nicklas 429           </varlistentry>
3276 26 Apr 07 nicklas 430
3276 26 Apr 07 nicklas 431           <varlistentry>
3276 26 Apr 07 nicklas 432             <term>
3276 26 Apr 07 nicklas 433               Mailing lists and other resources
3276 26 Apr 07 nicklas 434             </term>
3276 26 Apr 07 nicklas 435             <listitem>
3276 26 Apr 07 nicklas 436               <para>
3276 26 Apr 07 nicklas 437               See <xref linkend="resources" />.
3276 26 Apr 07 nicklas 438               </para>
3276 26 Apr 07 nicklas 439             </listitem>
3276 26 Apr 07 nicklas 440           </varlistentry>
3276 26 Apr 07 nicklas 441
3276 26 Apr 07 nicklas 442         </variablelist>
3276 26 Apr 07 nicklas 443         
3153 05 Mar 07 nicklas 444       </sect2>
3181 12 Mar 07 nicklas 445     
3181 12 Mar 07 nicklas 446     </sect1>
3181 12 Mar 07 nicklas 447     
3181 12 Mar 07 nicklas 448     <sect1 id="webclient.configuration">
5782 04 Oct 11 nicklas 449       <?dbhtml filename="configuration.html" ?>
3181 12 Mar 07 nicklas 450       <title>Configuring your account</title>
3153 05 Mar 07 nicklas 451       
3181 12 Mar 07 nicklas 452       <sect2 id="webclient.configuration.contact">
3181 12 Mar 07 nicklas 453         <title>Contact information</title>
3221 02 Apr 07 nicklas 454         
3221 02 Apr 07 nicklas 455         <para>
5017 26 Jun 09 nicklas 456           Use the <menuchoice><guimenu>BASE</guimenu>
3221 02 Apr 07 nicklas 457           <guimenuitem>Contact information</guimenuitem></menuchoice>
3276 26 Apr 07 nicklas 458           menu to bring up the user information dialog. 
3221 02 Apr 07 nicklas 459         </para>
5971 17 Feb 12 nicklas 460           
5971 17 Feb 12 nicklas 461           <figure id="webclient.figures.contactinformation">
5971 17 Feb 12 nicklas 462             <title>Contact information</title>
5971 17 Feb 12 nicklas 463             <screenshot>
5971 17 Feb 12 nicklas 464               <mediaobject>
5971 17 Feb 12 nicklas 465                 <imageobject><imagedata fileref="figures/contact_information.png" format="PNG" /></imageobject>
5971 17 Feb 12 nicklas 466               </mediaobject>
5971 17 Feb 12 nicklas 467             </screenshot>
5971 17 Feb 12 nicklas 468           </figure>
3221 02 Apr 07 nicklas 469         
3221 02 Apr 07 nicklas 470         <helptext external_id="userpreferences.contact" title="Contact information">
3276 26 Apr 07 nicklas 471         
3276 26 Apr 07 nicklas 472           <para>
3276 26 Apr 07 nicklas 473           This dialog has three tabs, <guilabel>Contact information</guilabel>
3276 26 Apr 07 nicklas 474           (selected), <guilabel>Password</guilabel> and <guilabel>Other information</guilabel>.
3276 26 Apr 07 nicklas 475           The logged in user can update the following contact information 
3276 26 Apr 07 nicklas 476           details.
3276 26 Apr 07 nicklas 477           </para>
3276 26 Apr 07 nicklas 478         
3276 26 Apr 07 nicklas 479           <note>
3276 26 Apr 07 nicklas 480             <title>Multi-user accounts</title>
3320 10 May 07 martin 481             <para>
3320 10 May 07 martin 482               If you are using a multi-user account, for example a demo-account, you 
3487 13 Jun 07 peter 483               do not have permission to change the contact information.
3320 10 May 07 martin 484             </para>
3276 26 Apr 07 nicklas 485           </note>
3276 26 Apr 07 nicklas 486         
3221 02 Apr 07 nicklas 487           <variablelist>
3221 02 Apr 07 nicklas 488             <varlistentry>
3221 02 Apr 07 nicklas 489               <term>
3295 07 May 07 nicklas 490                 <guilabel>Full name</guilabel>
3221 02 Apr 07 nicklas 491               </term>
3221 02 Apr 07 nicklas 492               <listitem>
3276 26 Apr 07 nicklas 493                 <para>
3276 26 Apr 07 nicklas 494                 Your full name. You are not allowed to change this. If
3276 26 Apr 07 nicklas 495                 it is not correct, contact an administrator to do it for 
3276 26 Apr 07 nicklas 496                 you.
3276 26 Apr 07 nicklas 497                 </para>
3276 26 Apr 07 nicklas 498               </listitem>
3276 26 Apr 07 nicklas 499             </varlistentry>
3276 26 Apr 07 nicklas 500             <varlistentry>
3276 26 Apr 07 nicklas 501               <term>
3295 07 May 07 nicklas 502                 <guilabel>Email</guilabel>
3276 26 Apr 07 nicklas 503               </term>
3276 26 Apr 07 nicklas 504               <listitem>
3276 26 Apr 07 nicklas 505                 <para>
5442 07 Oct 10 nicklas 506                 Your email address (optional). If an email has been specified and if the
5442 07 Oct 10 nicklas 507                 server administrator has enabled email notifications, you also have the
5442 07 Oct 10 nicklas 508                 option to select if messages should be sent as emails. This can be useful
5442 07 Oct 10 nicklas 509                 to keep track of jobs that take a long time to complete.
3276 26 Apr 07 nicklas 510                 </para>
3221 02 Apr 07 nicklas 511               </listitem>
3221 02 Apr 07 nicklas 512             </varlistentry>
3221 02 Apr 07 nicklas 513             <varlistentry>
3221 02 Apr 07 nicklas 514               <term>
7412 11 Oct 17 nicklas 515                 <guilabel>Enable 2-factor login</guilabel>
7412 11 Oct 17 nicklas 516               </term>
7412 11 Oct 17 nicklas 517               <listitem>
7412 11 Oct 17 nicklas 518                 <para>
7412 11 Oct 17 nicklas 519                 Enables 2-factor login for your account. This causes BASE to send out
7412 11 Oct 17 nicklas 520                 an email message with a one-time verification code the first time you
7412 11 Oct 17 nicklas 521                 login with an unknown device/browser. When you enable this option BASE
7412 11 Oct 17 nicklas 522                 will also send an email to verify your email address.
7412 11 Oct 17 nicklas 523                 Note that this option is only available if the server administrator has 
7412 11 Oct 17 nicklas 524                 configure BASE to use it.
7412 11 Oct 17 nicklas 525                 </para>
7412 11 Oct 17 nicklas 526               </listitem>
7412 11 Oct 17 nicklas 527             </varlistentry>
7412 11 Oct 17 nicklas 528             <varlistentry>
7412 11 Oct 17 nicklas 529               <term>
3295 07 May 07 nicklas 530                 <guilabel>Organisation</guilabel>
3221 02 Apr 07 nicklas 531               </term>
3221 02 Apr 07 nicklas 532               <listitem>
3276 26 Apr 07 nicklas 533                 <para>
3221 02 Apr 07 nicklas 534                 The name of the organisation you work for or represent (optional).
3276 26 Apr 07 nicklas 535                 </para>
3221 02 Apr 07 nicklas 536               </listitem>
3221 02 Apr 07 nicklas 537             </varlistentry>
3221 02 Apr 07 nicklas 538             <varlistentry>
3221 02 Apr 07 nicklas 539               <term>
3295 07 May 07 nicklas 540                 <guilabel>Address</guilabel>
3221 02 Apr 07 nicklas 541               </term>
3221 02 Apr 07 nicklas 542               <listitem>
3276 26 Apr 07 nicklas 543                 <para>
3221 02 Apr 07 nicklas 544                 Your postal address as it should be printed on letters to you 
3221 02 Apr 07 nicklas 545                 (optional).
3276 26 Apr 07 nicklas 546                 </para>
3221 02 Apr 07 nicklas 547               </listitem>
3221 02 Apr 07 nicklas 548             </varlistentry>
3221 02 Apr 07 nicklas 549             <varlistentry>
3221 02 Apr 07 nicklas 550               <term>
3295 07 May 07 nicklas 551                 <guilabel>Phone</guilabel>
3221 02 Apr 07 nicklas 552               </term>
3221 02 Apr 07 nicklas 553               <listitem>
3276 26 Apr 07 nicklas 554                 <para>
3221 02 Apr 07 nicklas 555                 Your phone number (optional). You may enter multiple phone numbers, 
3221 02 Apr 07 nicklas 556                 for example your work phone number and a mobile number.
3276 26 Apr 07 nicklas 557                 </para>
3221 02 Apr 07 nicklas 558               </listitem>
3221 02 Apr 07 nicklas 559             </varlistentry>
3221 02 Apr 07 nicklas 560             <varlistentry>
3221 02 Apr 07 nicklas 561               <term>
3295 07 May 07 nicklas 562                 <guilabel>Fax</guilabel>
3221 02 Apr 07 nicklas 563               </term>
3221 02 Apr 07 nicklas 564               <listitem>
3276 26 Apr 07 nicklas 565                 <para>
3221 02 Apr 07 nicklas 566                 Your fax number (optional).
3276 26 Apr 07 nicklas 567                 </para>
3221 02 Apr 07 nicklas 568               </listitem>
3221 02 Apr 07 nicklas 569             </varlistentry>
3221 02 Apr 07 nicklas 570             <varlistentry>
3221 02 Apr 07 nicklas 571               <term>
3295 07 May 07 nicklas 572                 <guilabel>Url</guilabel>
3221 02 Apr 07 nicklas 573               </term>
3221 02 Apr 07 nicklas 574               <listitem>
3276 26 Apr 07 nicklas 575                 <para>
3320 10 May 07 martin 576                 An URL to your home page or your organisation's home page (optional).
3276 26 Apr 07 nicklas 577                 </para>
3221 02 Apr 07 nicklas 578               </listitem>
3221 02 Apr 07 nicklas 579             </varlistentry>
3221 02 Apr 07 nicklas 580           </variablelist>
3221 02 Apr 07 nicklas 581           
3276 26 Apr 07 nicklas 582           <para>
3394 28 May 07 martin 583             Press &gbSave; to save the changes or 
3394 28 May 07 martin 584             &gbCancel; to abort.
3276 26 Apr 07 nicklas 585           </para>
3221 02 Apr 07 nicklas 586           
3276 26 Apr 07 nicklas 587           <seeother>
3276 26 Apr 07 nicklas 588             <other external_id="userpreferences.password">Change password</other>
3276 26 Apr 07 nicklas 589             <other external_id="userpreferences.other">Other information</other>
7412 11 Oct 17 nicklas 590             <other external_id="userpreferences.verifyemail">Verify email</other>
3276 26 Apr 07 nicklas 591           </seeother>
3221 02 Apr 07 nicklas 592         </helptext>
3276 26 Apr 07 nicklas 593         
7412 11 Oct 17 nicklas 594         <sect3 id="webclient.configuration.verifyemail">
7412 11 Oct 17 nicklas 595           <title>Verify email</title>
7412 11 Oct 17 nicklas 596
7412 11 Oct 17 nicklas 597           <figure id="webclient.figures.verifyemail">
7412 11 Oct 17 nicklas 598             <title>Verify email</title>
7412 11 Oct 17 nicklas 599             <screenshot>
7412 11 Oct 17 nicklas 600               <mediaobject>
7412 11 Oct 17 nicklas 601                 <imageobject><imagedata fileref="figures/verify_email.png" format="PNG" /></imageobject>
7412 11 Oct 17 nicklas 602               </mediaobject>
7412 11 Oct 17 nicklas 603             </screenshot>
7412 11 Oct 17 nicklas 604           </figure>
7412 11 Oct 17 nicklas 605           
7412 11 Oct 17 nicklas 606           <helptext external_id="userpreferences.verifyemail" title="Verify email">
7412 11 Oct 17 nicklas 607           <para>
7412 11 Oct 17 nicklas 608             If you enable <guilabel>2-factor login</guilabel> or change your email
7412 11 Oct 17 nicklas 609             address while it is enabled, BASE will send out an email with a verification
7412 11 Oct 17 nicklas 610             code and display this dialog. You need to enter the verification code to
7412 11 Oct 17 nicklas 611             enable 2-factor login. If the code is incorrect or if you cancel this dialog
7412 11 Oct 17 nicklas 612             2-factor login will be disabled.
7412 11 Oct 17 nicklas 613           </para>
7412 11 Oct 17 nicklas 614           </helptext>
7412 11 Oct 17 nicklas 615           
7412 11 Oct 17 nicklas 616         </sect3>
7412 11 Oct 17 nicklas 617         
3153 05 Mar 07 nicklas 618       </sect2>
3539 29 Jun 07 martin 619       
3539 29 Jun 07 martin 620       <sect2 id="webclient.configuration.other">
3539 29 Jun 07 martin 621         <title>Other information</title>
3539 29 Jun 07 martin 622         <para>
3539 29 Jun 07 martin 623           Use the
3539 29 Jun 07 martin 624           <menuchoice>
5017 26 Jun 09 nicklas 625             <guimenu>BASE</guimenu>
3539 29 Jun 07 martin 626             <guimenuitem>Other information&hellip;</guimenuitem>
3539 29 Jun 07 martin 627           </menuchoice>
3539 29 Jun 07 martin 628           menu to bring up the other information dialog.
3539 29 Jun 07 martin 629         </para>
5971 17 Feb 12 nicklas 630
5971 17 Feb 12 nicklas 631           <figure id="webclient.figures.otherinformation">
5971 17 Feb 12 nicklas 632             <title>Other information</title>
5971 17 Feb 12 nicklas 633             <screenshot>
5971 17 Feb 12 nicklas 634               <mediaobject>
5971 17 Feb 12 nicklas 635                 <imageobject><imagedata fileref="figures/other_information.png" format="PNG" /></imageobject>
5971 17 Feb 12 nicklas 636               </mediaobject>
5971 17 Feb 12 nicklas 637             </screenshot>
5971 17 Feb 12 nicklas 638           </figure>
5971 17 Feb 12 nicklas 639
5971 17 Feb 12 nicklas 640
3539 29 Jun 07 martin 641         <helptext external_id="userpreferences.other" title="Other information">
3539 29 Jun 07 martin 642           <para>
3539 29 Jun 07 martin 643             This dialog has three tabs,
5971 17 Feb 12 nicklas 644             <guilabel>Contact information</guilabel>,
5971 17 Feb 12 nicklas 645             <guilabel>Password</guilabel> and
3539 29 Jun 07 martin 646             <guilabel>Other information</guilabel>
5971 17 Feb 12 nicklas 647             (selected).
3539 29 Jun 07 martin 648           </para>
3539 29 Jun 07 martin 649           <para>
3539 29 Jun 07 martin 650             The look of the
3539 29 Jun 07 martin 651             <guilabel>Other information</guilabel>
4487 08 Sep 08 jari 652             tab can differ a bit between different servers, depending on what settings
4487 08 Sep 08 jari 653             the server is installed with. There are three inputs in a fresh BASE
3539 29 Jun 07 martin 654             installation but it is only the
3539 29 Jun 07 martin 655             <guilabel>Description</guilabel>
4487 08 Sep 08 jari 656             text area that is static, the others can be removed or more fields can be
3539 29 Jun 07 martin 657             added (managed by the server administrator). The three fields, included in a
4487 08 Sep 08 jari 658             the BASE installation, are
3539 29 Jun 07 martin 659             <variablelist>
3539 29 Jun 07 martin 660               <varlistentry>
3539 29 Jun 07 martin 661                 <term>
3539 29 Jun 07 martin 662                   <guilabel>Mobile</guilabel>
3539 29 Jun 07 martin 663                 </term>
3539 29 Jun 07 martin 664                 <listitem>
3539 29 Jun 07 martin 665                   <para>Your mobile number(Optional).</para>
3539 29 Jun 07 martin 666                 </listitem>
3539 29 Jun 07 martin 667               </varlistentry>
3539 29 Jun 07 martin 668               <varlistentry>
3539 29 Jun 07 martin 669                 <term>
3539 29 Jun 07 martin 670                   <guilabel>Skype</guilabel>
3539 29 Jun 07 martin 671                 </term>
3539 29 Jun 07 martin 672                 <listitem>
4487 08 Sep 08 jari 673                   <para>Your Skype contact information(Optional).</para>
3539 29 Jun 07 martin 674                 </listitem>
3539 29 Jun 07 martin 675               </varlistentry>
3539 29 Jun 07 martin 676               <varlistentry>
3539 29 Jun 07 martin 677                 <term>
3539 29 Jun 07 martin 678                   <guilabel>Description</guilabel>
3539 29 Jun 07 martin 679                 </term>
3539 29 Jun 07 martin 680                 <listitem>
3539 29 Jun 07 martin 681                   <para>
3539 29 Jun 07 martin 682                     Text area where you can put useful information that couldn't
3539 29 Jun 07 martin 683                     be stored anywhere else(Optional).
3539 29 Jun 07 martin 684                   </para>
3539 29 Jun 07 martin 685                 </listitem>
3539 29 Jun 07 martin 686               </varlistentry>
3539 29 Jun 07 martin 687             </variablelist>
3539 29 Jun 07 martin 688           </para>
3539 29 Jun 07 martin 689           <para>Press &gbSave; to save the changes or &gbCancel; to abort.</para>
3539 29 Jun 07 martin 690           <seeother>
3539 29 Jun 07 martin 691             <other external_id="userpreferences.contact">Contact information</other>
3539 29 Jun 07 martin 692             <other external_id="userpreferences.password">Change password</other>
3539 29 Jun 07 martin 693           </seeother>
3539 29 Jun 07 martin 694         </helptext>
3539 29 Jun 07 martin 695       </sect2>
3181 12 Mar 07 nicklas 696
3181 12 Mar 07 nicklas 697       <sect2 id="webclient.configuration.password">
3181 12 Mar 07 nicklas 698         <title>Changing password</title>
3221 02 Apr 07 nicklas 699         
3221 02 Apr 07 nicklas 700         <para>
5017 26 Jun 09 nicklas 701           Use the <menuchoice><guimenu>BASE</guimenu>
3221 02 Apr 07 nicklas 702           <guimenuitem>Change password</guimenuitem></menuchoice>
3221 02 Apr 07 nicklas 703           menu to bring up the change password dialog.
3221 02 Apr 07 nicklas 704         </para>
3221 02 Apr 07 nicklas 705         
5971 17 Feb 12 nicklas 706           <figure id="webclient.figures.changepassword">
5971 17 Feb 12 nicklas 707             <title>Change password</title>
5971 17 Feb 12 nicklas 708             <screenshot>
5971 17 Feb 12 nicklas 709               <mediaobject>
5971 17 Feb 12 nicklas 710                 <imageobject><imagedata fileref="figures/change_password.png" format="PNG" /></imageobject>
5971 17 Feb 12 nicklas 711               </mediaobject>
5971 17 Feb 12 nicklas 712             </screenshot>
5971 17 Feb 12 nicklas 713           </figure>
5971 17 Feb 12 nicklas 714         
3221 02 Apr 07 nicklas 715         <helptext external_id="userpreferences.password" title="Change password">
3276 26 Apr 07 nicklas 716
3276 26 Apr 07 nicklas 717           <para>
3276 26 Apr 07 nicklas 718           This dialog has three tabs, <guilabel>Contact information</guilabel>,
3276 26 Apr 07 nicklas 719           <guilabel>Password</guilabel> (selected) and <guilabel>Other information</guilabel>.
3276 26 Apr 07 nicklas 720           </para>
3276 26 Apr 07 nicklas 721
3221 02 Apr 07 nicklas 722           <variablelist>
3221 02 Apr 07 nicklas 723             <varlistentry>
3221 02 Apr 07 nicklas 724               <term>
3295 07 May 07 nicklas 725                 <guilabel>New password</guilabel>
3221 02 Apr 07 nicklas 726               </term>
3221 02 Apr 07 nicklas 727               <listitem>
3276 26 Apr 07 nicklas 728                 <para>
3221 02 Apr 07 nicklas 729                 Enter the new password.
3276 26 Apr 07 nicklas 730                 </para>
3221 02 Apr 07 nicklas 731               </listitem>
3221 02 Apr 07 nicklas 732             </varlistentry>
3221 02 Apr 07 nicklas 733             <varlistentry>
3221 02 Apr 07 nicklas 734               <term>
3295 07 May 07 nicklas 735                 <guilabel>Retype password</guilabel>
3221 02 Apr 07 nicklas 736               </term>
3221 02 Apr 07 nicklas 737               <listitem>
3276 26 Apr 07 nicklas 738                 <para>
3221 02 Apr 07 nicklas 739                 Retype the same password. You must do this to 
3221 02 Apr 07 nicklas 740                 avoid spelling mistakes.
3276 26 Apr 07 nicklas 741                 </para>
3221 02 Apr 07 nicklas 742               </listitem>
3221 02 Apr 07 nicklas 743             </varlistentry>
3221 02 Apr 07 nicklas 744           </variablelist>
3276 26 Apr 07 nicklas 745
3221 02 Apr 07 nicklas 746           <note>
3276 26 Apr 07 nicklas 747             <title>Multi-user accounts</title>
3320 10 May 07 martin 748             <para>
3320 10 May 07 martin 749               If you are using a multi-user account, for example a demo-account, you 
3487 13 Jun 07 peter 750               do not have permission to change the password.
3320 10 May 07 martin 751             </para>
3276 26 Apr 07 nicklas 752           </note>
3276 26 Apr 07 nicklas 753         
3276 26 Apr 07 nicklas 754           <note>
3276 26 Apr 07 nicklas 755             <title>Empty passwords</title>
3320 10 May 07 martin 756             <para>
3320 10 May 07 martin 757               If you leave both fields empty the password will not be changed. It
3320 10 May 07 martin 758               is not possible to have an empty password.
3320 10 May 07 martin 759             </para>
3221 02 Apr 07 nicklas 760           </note>
3221 02 Apr 07 nicklas 761           
3276 26 Apr 07 nicklas 762           <seeother>
3276 26 Apr 07 nicklas 763             <other external_id="userpreferences.contact">Contact information</other>
3276 26 Apr 07 nicklas 764             <other external_id="userpreferences.other">Other information</other>
3276 26 Apr 07 nicklas 765           </seeother>
3221 02 Apr 07 nicklas 766           
3221 02 Apr 07 nicklas 767         </helptext>
3181 12 Mar 07 nicklas 768       </sect2>
3181 12 Mar 07 nicklas 769
3221 02 Apr 07 nicklas 770       <sect2 id="webclient.configuration.preferences">
3221 02 Apr 07 nicklas 771         <title>Preferences</title>
3221 02 Apr 07 nicklas 772         
3221 02 Apr 07 nicklas 773         <para>
5017 26 Jun 09 nicklas 774           Use the <menuchoice><guimenu>BASE</guimenu>
3221 02 Apr 07 nicklas 775           <guimenuitem>Preferences</guimenuitem></menuchoice>
3276 26 Apr 07 nicklas 776           menu to bring up the preferences dialog.
3276 26 Apr 07 nicklas 777           This dialog has three tabs, <guilabel>Appearance</guilabel>,
5684 02 Aug 11 nicklas 778           <guilabel>Plugins</guilabel> and <guilabel>Recent items</guilabel>.
3221 02 Apr 07 nicklas 779         </para>
3221 02 Apr 07 nicklas 780         
3221 02 Apr 07 nicklas 781         <sect3 id="webclient.configuration.preferences.appearance">
3276 26 Apr 07 nicklas 782           <title>The Appearance tab</title>
5971 17 Feb 12 nicklas 783
5971 17 Feb 12 nicklas 784           <figure id="webclient.figures.appearance">
5971 17 Feb 12 nicklas 785             <title>The Appearance tab</title>
5971 17 Feb 12 nicklas 786             <screenshot>
5971 17 Feb 12 nicklas 787               <mediaobject>
5971 17 Feb 12 nicklas 788                 <imageobject><imagedata fileref="figures/preferences_appearance.png" format="PNG" /></imageobject>
5971 17 Feb 12 nicklas 789               </mediaobject>
5971 17 Feb 12 nicklas 790             </screenshot>
5971 17 Feb 12 nicklas 791           </figure>
3221 02 Apr 07 nicklas 792           
3221 02 Apr 07 nicklas 793           <helptext external_id="userpreferences.appearance" title="Preferences - Appearance">
3221 02 Apr 07 nicklas 794           
3221 02 Apr 07 nicklas 795           <para>
3221 02 Apr 07 nicklas 796           This tab contains settings that affect the appearance of the
3221 02 Apr 07 nicklas 797           web client.
3221 02 Apr 07 nicklas 798           </para>
3221 02 Apr 07 nicklas 799           
3221 02 Apr 07 nicklas 800           <variablelist>
3221 02 Apr 07 nicklas 801             <varlistentry>
3221 02 Apr 07 nicklas 802               <term>
3295 07 May 07 nicklas 803                 <guilabel>Font size</guilabel>
3221 02 Apr 07 nicklas 804               </term>
3221 02 Apr 07 nicklas 805               <listitem>
3276 26 Apr 07 nicklas 806                 <para>
3221 02 Apr 07 nicklas 807                 Select a basic font size. You can choose between
3221 02 Apr 07 nicklas 808                 five sizes: extra small (XS), small (S), medium (M),
3221 02 Apr 07 nicklas 809                 large (L) and extra large (XL). The default font size is
3221 02 Apr 07 nicklas 810                 medium.
3276 26 Apr 07 nicklas 811                 </para>
3221 02 Apr 07 nicklas 812               </listitem>
3221 02 Apr 07 nicklas 813             </varlistentry>
3221 02 Apr 07 nicklas 814             <varlistentry>
3221 02 Apr 07 nicklas 815               <term>
3295 07 May 07 nicklas 816                 <guilabel>Scale factor</guilabel>
3221 02 Apr 07 nicklas 817               </term>
3221 02 Apr 07 nicklas 818               <listitem>
3276 26 Apr 07 nicklas 819                 <para>
4487 08 Sep 08 jari 820                 The scale factor affects the size of pop-up windows.
3221 02 Apr 07 nicklas 821                 This setting exists because different browsers render 
4487 08 Sep 08 jari 822                 pages differently. If you often find that pop-up windows
3221 02 Apr 07 nicklas 823                 are too small you can change this setting to make them
3221 02 Apr 07 nicklas 824                 bigger.
3276 26 Apr 07 nicklas 825                 </para>
3221 02 Apr 07 nicklas 826                 <note>
3320 10 May 07 martin 827                   <para>
3320 10 May 07 martin 828                     The scale factor is automatically changed if the 
3320 10 May 07 martin 829                     font size is changed.
3320 10 May 07 martin 830                   </para>
3221 02 Apr 07 nicklas 831                 </note>
3221 02 Apr 07 nicklas 832               </listitem>
3221 02 Apr 07 nicklas 833             </varlistentry>
3221 02 Apr 07 nicklas 834             <varlistentry>
3221 02 Apr 07 nicklas 835               <term>
4673 28 Nov 08 nicklas 836                 <guilabel>Display long texts</guilabel>
4673 28 Nov 08 nicklas 837               </term>
4673 28 Nov 08 nicklas 838               <listitem>
4673 28 Nov 08 nicklas 839                 <para>
4673 28 Nov 08 nicklas 840                 This setting is used to control how long description texts
4673 28 Nov 08 nicklas 841                 are displayed in tables and other places with limited space.
4673 28 Nov 08 nicklas 842                 There are three settings:
4673 28 Nov 08 nicklas 843                 </para>
4673 28 Nov 08 nicklas 844                 <itemizedlist>
4673 28 Nov 08 nicklas 845                   <listitem>
4673 28 Nov 08 nicklas 846                     <simpara>
5684 02 Aug 11 nicklas 847                     <guilabel>Always</guilabel>: The full text is always displayed. This may
5684 02 Aug 11 nicklas 848                     cause tables, etc. to become hard to read since cells will automatically 
5684 02 Aug 11 nicklas 849                     grow to be able to display the full text.
4673 28 Nov 08 nicklas 850                     </simpara>
4673 28 Nov 08 nicklas 851                   </listitem>
4673 28 Nov 08 nicklas 852                   <listitem>
4673 28 Nov 08 nicklas 853                     <simpara>
4673 28 Nov 08 nicklas 854                     <guilabel>On hover</guilabel>: A short version of the text is
4673 28 Nov 08 nicklas 855                     displayed and the full text is automatically displayed when
4673 28 Nov 08 nicklas 856                     the mouse is moved over the text. Texts that are not fully
4673 28 Nov 08 nicklas 857                     visible are indicated with a dotted line to the right.
4673 28 Nov 08 nicklas 858                     </simpara>
4673 28 Nov 08 nicklas 859                   </listitem>
4673 28 Nov 08 nicklas 860                   <listitem>
4673 28 Nov 08 nicklas 861                     <simpara>
4673 28 Nov 08 nicklas 862                     <guilabel>On click</guilabel>: A short version of the text is
4673 28 Nov 08 nicklas 863                     displayed and the full text is displayed when the mouse is clicked
4673 28 Nov 08 nicklas 864                     somewhere on the short text. Texts that are not fully visible
4673 28 Nov 08 nicklas 865                     are indicated with a grey line to the right.
4673 28 Nov 08 nicklas 866                     </simpara>
4673 28 Nov 08 nicklas 867                   </listitem>
4673 28 Nov 08 nicklas 868                 </itemizedlist>
4673 28 Nov 08 nicklas 869                 
4673 28 Nov 08 nicklas 870                 <warning>
4673 28 Nov 08 nicklas 871                   The 'On click' mode may not perform so well if lots of items are
4673 28 Nov 08 nicklas 872                   displayed in a single list. This is particularly so with Internet
4673 28 Nov 08 nicklas 873                   Explorer (version 7) which is 5-10 times slower than Firefox to
4673 28 Nov 08 nicklas 874                   render the page. If you experience problems with this mode you should
4673 28 Nov 08 nicklas 875                   either use a different mode or display less items on a single page.
4673 28 Nov 08 nicklas 876                 </warning>
4673 28 Nov 08 nicklas 877                 
4673 28 Nov 08 nicklas 878               </listitem>
4673 28 Nov 08 nicklas 879             </varlistentry>
4673 28 Nov 08 nicklas 880             <varlistentry>
4673 28 Nov 08 nicklas 881               <term>
3295 07 May 07 nicklas 882                 <guilabel>Toolbar</guilabel>
3221 02 Apr 07 nicklas 883               </term>
3221 02 Apr 07 nicklas 884               <listitem>
3276 26 Apr 07 nicklas 885                 <para>
3221 02 Apr 07 nicklas 886                 You may choose if the toolbar buttons should
3221 02 Apr 07 nicklas 887                 have only images, only text or both images and text.
3221 02 Apr 07 nicklas 888                 The default is that they have both images and text.
3276 26 Apr 07 nicklas 889                 </para>
3221 02 Apr 07 nicklas 890               </listitem>
3221 02 Apr 07 nicklas 891             </varlistentry>
3221 02 Apr 07 nicklas 892             <varlistentry>
3221 02 Apr 07 nicklas 893               <term>
3295 07 May 07 nicklas 894                 <guilabel>Ratio color range</guilabel>
3221 02 Apr 07 nicklas 895               </term>
3221 02 Apr 07 nicklas 896               <listitem>
3276 26 Apr 07 nicklas 897                 <para>
3221 02 Apr 07 nicklas 898                 Select three colors to use when displaying 
3221 02 Apr 07 nicklas 899                 data that is suitable for color coding, for
3221 02 Apr 07 nicklas 900                 example the intensity ratio in two-color 
5684 02 Aug 11 nicklas 901                 experiments. The default setting is blue-white-yellow.
3221 02 Apr 07 nicklas 902                 The list of presets contains other useful color combinations
4487 08 Sep 08 jari 903                 (for example, the BASE version 1 red-yellow-green) and the most
3221 02 Apr 07 nicklas 904                 recently used color combinations.
3276 26 Apr 07 nicklas 905                 </para>
3221 02 Apr 07 nicklas 906               </listitem>
3221 02 Apr 07 nicklas 907             </varlistentry>
3221 02 Apr 07 nicklas 908             <varlistentry>
3221 02 Apr 07 nicklas 909               <term>
3295 07 May 07 nicklas 910                 <guilabel>Date format</guilabel>
3221 02 Apr 07 nicklas 911               </term>
3221 02 Apr 07 nicklas 912               <listitem>
3221 02 Apr 07 nicklas 913                 <para>
3221 02 Apr 07 nicklas 914                 A format string describing how dates should be displayed.
3221 02 Apr 07 nicklas 915                 We support all formatting options supported by the Java
3221 02 Apr 07 nicklas 916                 language. For more information see:
5684 02 Aug 11 nicklas 917                 <ulink url="http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html">SimpleDateFormat documentation</ulink>
3221 02 Apr 07 nicklas 918                 The most useful format patterns are:
3221 02 Apr 07 nicklas 919                 </para>
3221 02 Apr 07 nicklas 920                 
3221 02 Apr 07 nicklas 921                 <itemizedlist>
3320 10 May 07 martin 922                   <listitem><simpara>yy: two-digit year</simpara></listitem>
3320 10 May 07 martin 923                   <listitem><simpara>yyyy: four-digit year</simpara></listitem>
3320 10 May 07 martin 924                   <listitem><simpara>MM: two-digit month</simpara></listitem>
3320 10 May 07 martin 925                   <listitem><simpara>MMM: month name (short)</simpara></listitem>
3320 10 May 07 martin 926                   <listitem><simpara>MMMM: month name (full)</simpara></listitem>
3320 10 May 07 martin 927                   <listitem><simpara>dd: two-digit day in month</simpara></listitem>
3221 02 Apr 07 nicklas 928                 </itemizedlist>
3221 02 Apr 07 nicklas 929                 
3221 02 Apr 07 nicklas 930                 <para>
3221 02 Apr 07 nicklas 931                 The list of presets contains the most commonly/recently
3221 02 Apr 07 nicklas 932                 used date formats.
3221 02 Apr 07 nicklas 933                 </para>
3221 02 Apr 07 nicklas 934                 
3221 02 Apr 07 nicklas 935               </listitem>
3221 02 Apr 07 nicklas 936             </varlistentry>
3221 02 Apr 07 nicklas 937             
3221 02 Apr 07 nicklas 938             <varlistentry>
3221 02 Apr 07 nicklas 939               <term>
3295 07 May 07 nicklas 940                 <guilabel>Date-time format</guilabel>
3221 02 Apr 07 nicklas 941               </term>
3221 02 Apr 07 nicklas 942               <listitem>
3221 02 Apr 07 nicklas 943                 <para>
3221 02 Apr 07 nicklas 944                 A format string describing how dates with times should be displayed.
3221 02 Apr 07 nicklas 945                 We support all formatting options supported by the Java
3221 02 Apr 07 nicklas 946                 language. For more information see:
5684 02 Aug 11 nicklas 947                 <ulink url="http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html">SimpleDateFormat documentations</ulink>
3221 02 Apr 07 nicklas 948                 The most useful time-format patterns are:
3221 02 Apr 07 nicklas 949                 </para>
3221 02 Apr 07 nicklas 950                 
3221 02 Apr 07 nicklas 951                 <itemizedlist>
3320 10 May 07 martin 952                   <listitem><simpara>HH: two-digit hour (0-23)</simpara></listitem>
3320 10 May 07 martin 953                   <listitem><simpara>hh: two-digit hour (1-12)</simpara></listitem>
3320 10 May 07 martin 954                   <listitem><simpara>a: AM/PM marker</simpara></listitem>
3320 10 May 07 martin 955                   <listitem><simpara>mm: two-digit minute</simpara></listitem>
3320 10 May 07 martin 956                   <listitem><simpara>ss: two-digit second</simpara></listitem>
3221 02 Apr 07 nicklas 957                 </itemizedlist>
3221 02 Apr 07 nicklas 958                 
3221 02 Apr 07 nicklas 959               </listitem>
3221 02 Apr 07 nicklas 960             </varlistentry>
3221 02 Apr 07 nicklas 961             
3221 02 Apr 07 nicklas 962             <varlistentry>
3221 02 Apr 07 nicklas 963               <term>
3295 07 May 07 nicklas 964                 <guilabel>Decimals</guilabel>
3221 02 Apr 07 nicklas 965               </term>
3221 02 Apr 07 nicklas 966               <listitem>
3276 26 Apr 07 nicklas 967                 <para>
6268 11 Apr 13 nicklas 968                 The base number of decimals to display for numerical floating point values.
6268 11 Apr 13 nicklas 969                 The default is 2. This setting is used for values between 1 and 10. For higher
6268 11 Apr 13 nicklas 970                 or lower values, the number of decimals is adapted in order to not loose 
6268 11 Apr 13 nicklas 971                 information (eg. 0.0059 instead of 0.01) or give the impression of very 
6268 11 Apr 13 nicklas 972                 high precision (eg. 135000 instead of 135000.00).
3276 26 Apr 07 nicklas 973                 </para>
3221 02 Apr 07 nicklas 974               </listitem>
3221 02 Apr 07 nicklas 975             </varlistentry>
7115 16 Mar 16 nicklas 976
7115 16 Mar 16 nicklas 977             <varlistentry>
7115 16 Mar 16 nicklas 978               <term>
8144 21 Apr 23 nicklas 979                 <guilabel>Thousands separator</guilabel>
8144 21 Apr 23 nicklas 980               </term>
8144 21 Apr 23 nicklas 981               <listitem>
8144 21 Apr 23 nicklas 982                 <para>
8144 21 Apr 23 nicklas 983                 Specifies a separator character for grouping large numeric values into
8144 21 Apr 23 nicklas 984                 groups of 3 digits. It is possible to choose between no separator, space
8144 21 Apr 23 nicklas 985                 and comma. For example: 101,456,998.
8144 21 Apr 23 nicklas 986                 </para>
8144 21 Apr 23 nicklas 987               </listitem>
8144 21 Apr 23 nicklas 988             </varlistentry>
8144 21 Apr 23 nicklas 989
8144 21 Apr 23 nicklas 990             <varlistentry>
8144 21 Apr 23 nicklas 991               <term>
7115 16 Mar 16 nicklas 992                 <guilabel>Dialogs</guilabel>
7115 16 Mar 16 nicklas 993               </term>
7115 16 Mar 16 nicklas 994               <listitem>
7115 16 Mar 16 nicklas 995                 <para>
7115 16 Mar 16 nicklas 996                   Check the <guilabel>Remember positions</guilabel> option
7115 16 Mar 16 nicklas 997                   to let BASE remember the position and size of dialogs
7115 16 Mar 16 nicklas 998                   so that they always open in the same place as the last
7115 16 Mar 16 nicklas 999                   time. The positions are remembered during the current 
7115 16 Mar 16 nicklas 1000                   session only and are forgotten if the browser is closed.
7115 16 Mar 16 nicklas 1001                 </para>
7115 16 Mar 16 nicklas 1002               </listitem>
7115 16 Mar 16 nicklas 1003             </varlistentry>
3221 02 Apr 07 nicklas 1004             
7115 16 Mar 16 nicklas 1005             <varlistentry>
7115 16 Mar 16 nicklas 1006               <term>
7115 16 Mar 16 nicklas 1007                 <guilabel>Start page</guilabel>
7115 16 Mar 16 nicklas 1008               </term>
7115 16 Mar 16 nicklas 1009               <listitem>
7115 16 Mar 16 nicklas 1010                 <para>
7115 16 Mar 16 nicklas 1011                   Select the start page that should be displayed after logging 
7115 16 Mar 16 nicklas 1012                   in to BASE. The default and only built-in start page is the 
7115 16 Mar 16 nicklas 1013                   <menuchoice>
7115 16 Mar 16 nicklas 1014                     <guimenu>BASE</guimenu>
7115 16 Mar 16 nicklas 1015                     <guimenuitem>Home</guimenuitem>
7115 16 Mar 16 nicklas 1016                   </menuchoice>. Other start pages may be enabled by
7115 16 Mar 16 nicklas 1017                   extensions.
7115 16 Mar 16 nicklas 1018                 </para>
7115 16 Mar 16 nicklas 1019                 
7115 16 Mar 16 nicklas 1020                 <note>
7115 16 Mar 16 nicklas 1021                   <title>Problems with the start page</title>
7115 16 Mar 16 nicklas 1022                   <para>
7115 16 Mar 16 nicklas 1023                     If there are problems with the selected start page
7115 16 Mar 16 nicklas 1024                     it may prevent the user from accessing BASE. In
7115 16 Mar 16 nicklas 1025                     the worst scenario all that is displayed is a cryptic
7115 16 Mar 16 nicklas 1026                     error message. In this case, it is good to know that
7115 16 Mar 16 nicklas 1027                     holding down either one of the <guilabel>ALT</guilabel>
7115 16 Mar 16 nicklas 1028                     or <guilabel>CTRL</guilabel> or <guilabel>SHIFT</guilabel>
7115 16 Mar 16 nicklas 1029                     keys while clicking the <guibutton>Login</guibutton>
7115 16 Mar 16 nicklas 1030                     button will force BASE to use the regular start page.
7115 16 Mar 16 nicklas 1031                   </para>
7115 16 Mar 16 nicklas 1032                 </note>
7115 16 Mar 16 nicklas 1033                 
7115 16 Mar 16 nicklas 1034               </listitem>
7115 16 Mar 16 nicklas 1035             </varlistentry>
7115 16 Mar 16 nicklas 1036             
3221 02 Apr 07 nicklas 1037           </variablelist>
3221 02 Apr 07 nicklas 1038         
3221 02 Apr 07 nicklas 1039           </helptext>
3221 02 Apr 07 nicklas 1040         
3221 02 Apr 07 nicklas 1041         </sect3>
3221 02 Apr 07 nicklas 1042         
3221 02 Apr 07 nicklas 1043         <sect3 id="webclient.configuration.preferences.plugins">
3276 26 Apr 07 nicklas 1044           <title>The Plugins tab</title>
3221 02 Apr 07 nicklas 1045           
5971 17 Feb 12 nicklas 1046           <figure id="webclient.figures.preferences.plugins">
5971 17 Feb 12 nicklas 1047             <title>The Plugins tab</title>
5971 17 Feb 12 nicklas 1048             <screenshot>
5971 17 Feb 12 nicklas 1049               <mediaobject>
5971 17 Feb 12 nicklas 1050                 <imageobject><imagedata fileref="figures/preferences_plugins.png" format="PNG" /></imageobject>
5971 17 Feb 12 nicklas 1051               </mediaobject>
5971 17 Feb 12 nicklas 1052             </screenshot>
5971 17 Feb 12 nicklas 1053           </figure>
5971 17 Feb 12 nicklas 1054           
3221 02 Apr 07 nicklas 1055           <helptext external_id="userpreferences.plugins" title="Preferences - Plugins">
3221 02 Apr 07 nicklas 1056           
3221 02 Apr 07 nicklas 1057           <para>
3495 14 Jun 07 nicklas 1058             This tab contains settings that affect plug-in execution.
3221 02 Apr 07 nicklas 1059           </para>
3221 02 Apr 07 nicklas 1060           
3221 02 Apr 07 nicklas 1061           <variablelist>
3221 02 Apr 07 nicklas 1062             <varlistentry>
3221 02 Apr 07 nicklas 1063               <term>
3295 07 May 07 nicklas 1064                 <guilabel>Messages</guilabel>
3221 02 Apr 07 nicklas 1065               </term>
3221 02 Apr 07 nicklas 1066               <listitem>
3276 26 Apr 07 nicklas 1067                 <para>
3221 02 Apr 07 nicklas 1068                 Mark the checkbox if you want to have a message sent
3495 14 Jun 07 nicklas 1069                 to you when a plug-in completes execution. This setting
5684 02 Aug 11 nicklas 1070                 can be overridden each time you start a plug-in. You'll
5684 02 Aug 11 nicklas 1071                 receive the message as a notification in BASE, but it may 
5684 02 Aug 11 nicklas 1072                 also be possible to get the message as an email.
3276 26 Apr 07 nicklas 1073                 </para>
3221 02 Apr 07 nicklas 1074               </listitem>
3221 02 Apr 07 nicklas 1075             </varlistentry>
3490 14 Jun 07 martin 1076             <varlistentry>
3490 14 Jun 07 martin 1077               <term>
3490 14 Jun 07 martin 1078                 <guilabel>Remove jobs</guilabel>
3490 14 Jun 07 martin 1079               </term>
3490 14 Jun 07 martin 1080               <listitem>
3490 14 Jun 07 martin 1081                 <para>
3490 14 Jun 07 martin 1082                   This checkbox should be marked if you want the jobs, done by
3495 14 Jun 07 nicklas 1083                   import or export plug-ins, to be marked as removed if they
3490 14 Jun 07 martin 1084                   finished successfully. This setting can be overridden each time
3495 14 Jun 07 nicklas 1085                   you start a plug-in.
3490 14 Jun 07 martin 1086                 </para>
3490 14 Jun 07 martin 1087               </listitem>
3490 14 Jun 07 martin 1088             </varlistentry>
3495 14 Jun 07 nicklas 1089             <varlistentry>
3495 14 Jun 07 nicklas 1090               <term>
3495 14 Jun 07 nicklas 1091                 <guilabel>Show warnings</guilabel>
3495 14 Jun 07 nicklas 1092               </term>
3495 14 Jun 07 nicklas 1093               <listitem>
3495 14 Jun 07 nicklas 1094                 <para>
3495 14 Jun 07 nicklas 1095                   This checkbox should be marked if you want to show warning
3495 14 Jun 07 nicklas 1096                   messages from plug-ins in the <guilabel>Select plug-in</guilabel>
3495 14 Jun 07 nicklas 1097                   dialog. Warning-level messages usually originates from plug-ins
3495 14 Jun 07 nicklas 1098                   that are unrelated to the current task and are only of interest to
3495 14 Jun 07 nicklas 1099                   plug-in developers. Error messages that are related to the
3495 14 Jun 07 nicklas 1100                   current task are always shown.
3495 14 Jun 07 nicklas 1101                 </para>
3495 14 Jun 07 nicklas 1102               </listitem>
3495 14 Jun 07 nicklas 1103             </varlistentry>
3221 02 Apr 07 nicklas 1104           </variablelist>
3221 02 Apr 07 nicklas 1105           </helptext>
3221 02 Apr 07 nicklas 1106           
3221 02 Apr 07 nicklas 1107         </sect3>
3221 02 Apr 07 nicklas 1108         
3221 02 Apr 07 nicklas 1109         <sect3 id="webclient.configuration.preferences.mostrecent">
3492 14 Jun 07 nicklas 1110           <title>The Recent items tab</title>
3221 02 Apr 07 nicklas 1111           
5971 17 Feb 12 nicklas 1112           <figure id="webclient.figures.preferences.recentitems">
5971 17 Feb 12 nicklas 1113             <title>The Recent items tab</title>
5971 17 Feb 12 nicklas 1114             <screenshot>
5971 17 Feb 12 nicklas 1115               <mediaobject>
5971 17 Feb 12 nicklas 1116                 <imageobject><imagedata fileref="figures/preferences_recentitems.png" format="PNG" /></imageobject>
5971 17 Feb 12 nicklas 1117               </mediaobject>
5971 17 Feb 12 nicklas 1118             </screenshot>
5971 17 Feb 12 nicklas 1119           </figure>
5971 17 Feb 12 nicklas 1120           
3492 14 Jun 07 nicklas 1121           <helptext external_id="userpreferences.mostrecent" 
3492 14 Jun 07 nicklas 1122             title="Preferences - Recent items">
3221 02 Apr 07 nicklas 1123           
3221 02 Apr 07 nicklas 1124           <para>
3492 14 Jun 07 nicklas 1125             This tab contains settings that affect the <guilabel>Recent
5684 02 Aug 11 nicklas 1126             items</guilabel> menu and selection lists in many edit dialogs. 
3221 02 Apr 07 nicklas 1127           </para>
3221 02 Apr 07 nicklas 1128           
3492 14 Jun 07 nicklas 1129           <variablelist>
3492 14 Jun 07 nicklas 1130           <varlistentry>
3492 14 Jun 07 nicklas 1131             <term>
3492 14 Jun 07 nicklas 1132               <guilabel>Recently viewed items</guilabel>
3492 14 Jun 07 nicklas 1133             </term>
3492 14 Jun 07 nicklas 1134             <listitem>
3492 14 Jun 07 nicklas 1135               <para>
3492 14 Jun 07 nicklas 1136               The number of recently <emphasis>viewed</emphasis> items to remember. 
3492 14 Jun 07 nicklas 1137               The default is to remember 6 items. The remembered items
3492 14 Jun 07 nicklas 1138               will be displayed in the <guilabel>Recent items</guilabel>
3492 14 Jun 07 nicklas 1139               menu in the menu bar.
3492 14 Jun 07 nicklas 1140               </para>
3492 14 Jun 07 nicklas 1141             </listitem>
3492 14 Jun 07 nicklas 1142           </varlistentry>
3492 14 Jun 07 nicklas 1143           <varlistentry>
3492 14 Jun 07 nicklas 1144             <term>
3492 14 Jun 07 nicklas 1145               <guilabel>Recently used items</guilabel>
3492 14 Jun 07 nicklas 1146             </term>
3492 14 Jun 07 nicklas 1147             <listitem>
3492 14 Jun 07 nicklas 1148               <para>
3492 14 Jun 07 nicklas 1149               The number of recently <emphasis>used</emphasis> items to remember.
3492 14 Jun 07 nicklas 1150               The default is to remember 4 items. The remembered items will
3492 14 Jun 07 nicklas 1151               be displayed in edit dialogs where they have been used before.
3492 14 Jun 07 nicklas 1152               Each type of edit operation has it's own list of remembered items.
3492 14 Jun 07 nicklas 1153               For example, there is one list that remembers the most recently used
3492 14 Jun 07 nicklas 1154               protocols when creating a sample, and there is another list that
3492 14 Jun 07 nicklas 1155               remembers the most recently used scanners when creating a scan.
3492 14 Jun 07 nicklas 1156               </para>
3492 14 Jun 07 nicklas 1157             </listitem>
3492 14 Jun 07 nicklas 1158           </varlistentry>
3492 14 Jun 07 nicklas 1159           
3492 14 Jun 07 nicklas 1160           <varlistentry>
3492 14 Jun 07 nicklas 1161             <term>
3492 14 Jun 07 nicklas 1162               <guilabel>Load the names of all items</guilabel>
3492 14 Jun 07 nicklas 1163             </term>
3492 14 Jun 07 nicklas 1164             <listitem>
3492 14 Jun 07 nicklas 1165               <para>
3492 14 Jun 07 nicklas 1166               If checked, the names of the items will be loaded and
3492 14 Jun 07 nicklas 1167               displayed in the menu, otherwise only the ID and type of item
3492 14 Jun 07 nicklas 1168               is displayed.
3492 14 Jun 07 nicklas 1169               </para>
3492 14 Jun 07 nicklas 1170             </listitem>
3492 14 Jun 07 nicklas 1171           </varlistentry>
3492 14 Jun 07 nicklas 1172           
3492 14 Jun 07 nicklas 1173           <varlistentry>
3492 14 Jun 07 nicklas 1174             <term>
3492 14 Jun 07 nicklas 1175               <guilabel>Sticky items</guilabel>
3492 14 Jun 07 nicklas 1176             </term>
3492 14 Jun 07 nicklas 1177             <listitem>
3492 14 Jun 07 nicklas 1178               <para>
3492 14 Jun 07 nicklas 1179               Always remember the last viewed item of the selected types.
3492 14 Jun 07 nicklas 1180               For example, if you have selected <emphasis>Experiment</emphasis>
3492 14 Jun 07 nicklas 1181               as a sticky item, the last viewed experiment will be remembered
3492 14 Jun 07 nicklas 1182               even if you view hundreds of other items. Use the arrow buttons
3492 14 Jun 07 nicklas 1183               to move item types between the lists and sort the sticky items list.
3492 14 Jun 07 nicklas 1184               Sticky items will be displayed in the <guilabel>Recent items</guilabel>
3492 14 Jun 07 nicklas 1185               menu in the menu bar.              
3492 14 Jun 07 nicklas 1186               </para>
3492 14 Jun 07 nicklas 1187             </listitem>
3492 14 Jun 07 nicklas 1188           </varlistentry>
3492 14 Jun 07 nicklas 1189           </variablelist>
3221 02 Apr 07 nicklas 1190           </helptext>
3221 02 Apr 07 nicklas 1191           
3221 02 Apr 07 nicklas 1192         </sect3>
7300 24 Feb 17 nicklas 1193
7300 24 Feb 17 nicklas 1194         <sect3 id="webclient.configuration.preferences.roles">
7300 24 Feb 17 nicklas 1195           <title>The Inactive roles tab</title>
7300 24 Feb 17 nicklas 1196           
7300 24 Feb 17 nicklas 1197           <figure id="webclient.figures.preferences.roles">
7300 24 Feb 17 nicklas 1198             <title>The Inactive roles tab</title>
7300 24 Feb 17 nicklas 1199             <screenshot>
7300 24 Feb 17 nicklas 1200               <mediaobject>
7300 24 Feb 17 nicklas 1201                 <imageobject><imagedata fileref="figures/preferences_roles.png" format="PNG" /></imageobject>
7300 24 Feb 17 nicklas 1202               </mediaobject>
7300 24 Feb 17 nicklas 1203             </screenshot>
7300 24 Feb 17 nicklas 1204           </figure>
7300 24 Feb 17 nicklas 1205           
7300 24 Feb 17 nicklas 1206           <helptext external_id="userpreferences.inactiveroles" 
7300 24 Feb 17 nicklas 1207             title="Preferences - Inactive roles">
7300 24 Feb 17 nicklas 1208           
7300 24 Feb 17 nicklas 1209           <para>
7300 24 Feb 17 nicklas 1210             <nohelp>
7300 24 Feb 17 nicklas 1211               <inlinemediaobject>
7300 24 Feb 17 nicklas 1212                 <imageobject>
7300 24 Feb 17 nicklas 1213                   <imagedata fileref="figures/preferences_roles_menu.png" format="PNG" align="right"/>
7300 24 Feb 17 nicklas 1214                 </imageobject>
7300 24 Feb 17 nicklas 1215               </inlinemediaobject>
7300 24 Feb 17 nicklas 1216             </nohelp>
7300 24 Feb 17 nicklas 1217             With this tab you can control which roles that
7300 24 Feb 17 nicklas 1218             are active or inactive after logging in.
7300 24 Feb 17 nicklas 1219             This is, for example, useful if you have a power user 
7300 24 Feb 17 nicklas 1220             role that is rarely needed. Setting that role as 
7300 24 Feb 17 nicklas 1221             <guilabel>Inactive at login</guilabel> prevents
7300 24 Feb 17 nicklas 1222             you from accidentally do things by mistake. When you need
7300 24 Feb 17 nicklas 1223             the full power user role, it can easily be
7300 24 Feb 17 nicklas 1224             activated from the popupmenu you get when clicking on your own
7300 24 Feb 17 nicklas 1225             name in the upper right corner.
7300 24 Feb 17 nicklas 1226           </para>
7300 24 Feb 17 nicklas 1227           
7300 24 Feb 17 nicklas 1228           <variablelist>
7300 24 Feb 17 nicklas 1229           <varlistentry>
7300 24 Feb 17 nicklas 1230             <term>
7300 24 Feb 17 nicklas 1231               <guilabel>Default roles - Inactive at login</guilabel>
7300 24 Feb 17 nicklas 1232             </term>
7300 24 Feb 17 nicklas 1233             <listitem>
7300 24 Feb 17 nicklas 1234               <para>
7300 24 Feb 17 nicklas 1235               All roles that you have been assigned are listed here.
7300 24 Feb 17 nicklas 1236               Put a checkbox before those roles that should not be
7300 24 Feb 17 nicklas 1237               active after logging in. Note that the settings only
7300 24 Feb 17 nicklas 1238               apply when using the web client. Logging in via
7300 24 Feb 17 nicklas 1239               other means (for example the FTP server) always
7300 24 Feb 17 nicklas 1240               enables all assigned roles.
7300 24 Feb 17 nicklas 1241               </para>
7300 24 Feb 17 nicklas 1242             </listitem>
7300 24 Feb 17 nicklas 1243           </varlistentry>
7300 24 Feb 17 nicklas 1244           </variablelist>
7300 24 Feb 17 nicklas 1245           </helptext>
7300 24 Feb 17 nicklas 1246           
7300 24 Feb 17 nicklas 1247         </sect3>
3181 12 Mar 07 nicklas 1248       </sect2>
3181 12 Mar 07 nicklas 1249   
3153 05 Mar 07 nicklas 1250     </sect1>
3153 05 Mar 07 nicklas 1251     
3295 07 May 07 nicklas 1252     <sect1 id="webclient.items">
5782 04 Oct 11 nicklas 1253       <?dbhtml filename="items.html" ?>
3295 07 May 07 nicklas 1254       <title>Working with items</title>
3295 07 May 07 nicklas 1255       
3295 07 May 07 nicklas 1256       <para>
3295 07 May 07 nicklas 1257         No matter what you are doing in BASE some things works more
3320 10 May 07 martin 1258         or less in the same way. This section covers things that are
3295 07 May 07 nicklas 1259         common for most parts of BASE.
3295 07 May 07 nicklas 1260       </para>
3295 07 May 07 nicklas 1261       
3295 07 May 07 nicklas 1262       <para>
3295 07 May 07 nicklas 1263         You mostly work with a single type of item at a time. This is
3359 22 May 07 nicklas 1264         reflected in the menu system. For example, use 
3359 22 May 07 nicklas 1265         <menuchoice>
4733 21 Jan 09 martin 1266           <guimenu>Biomaterial LIMS</guimenu>
3359 22 May 07 nicklas 1267           <guimenuitem>Samples</guimenuitem>
3359 22 May 07 nicklas 1268         </menuchoice>
3359 22 May 07 nicklas 1269         to work with samples, and 
3359 22 May 07 nicklas 1270         <menuchoice>
3359 22 May 07 nicklas 1271           <guimenu>View</guimenu>
3359 22 May 07 nicklas 1272           <guimenuitem>Experiments</guimenuitem>
3359 22 May 07 nicklas 1273         </menuchoice>
3359 22 May 07 nicklas 1274         to work with experiments. In most cases the list view for that type
3295 07 May 07 nicklas 1275         of item is displayed. The list view, as the name says, 
3295 07 May 07 nicklas 1276         is used to list all items. There are two more standard views, the 
3295 07 May 07 nicklas 1277         single-item view and the edit view.
3295 07 May 07 nicklas 1278       </para>
3295 07 May 07 nicklas 1279       
3295 07 May 07 nicklas 1280       <variablelist>
3295 07 May 07 nicklas 1281         <varlistentry>
3295 07 May 07 nicklas 1282           <term>List view</term>
3295 07 May 07 nicklas 1283           <listitem>
3295 07 May 07 nicklas 1284             <para>
3359 22 May 07 nicklas 1285             This view lists all items of a certain type. The view allows you to search
3295 07 May 07 nicklas 1286             and it is possible to configure which information to show
3295 07 May 07 nicklas 1287             for each item. It also contains functions that
3295 07 May 07 nicklas 1288             can be used on multiple items at the same time, for example,
3359 22 May 07 nicklas 1289             delete, share and export. See <xref linkend="webclient.itemlist"/> for more information.
3295 07 May 07 nicklas 1290             </para>
3295 07 May 07 nicklas 1291           </listitem>
3295 07 May 07 nicklas 1292         </varlistentry>
3295 07 May 07 nicklas 1293       
3295 07 May 07 nicklas 1294         <varlistentry>
3295 07 May 07 nicklas 1295           <term>Single-item view</term>
3295 07 May 07 nicklas 1296           <listitem>
3295 07 May 07 nicklas 1297             <para>
5789 06 Oct 11 nicklas 1298             Displays information about a single item. For some items it is very little,
5789 06 Oct 11 nicklas 1299             but for some it is very much and the information may be divided
3295 07 May 07 nicklas 1300             into multiple tabs.
3295 07 May 07 nicklas 1301             </para>
3295 07 May 07 nicklas 1302           </listitem>
3295 07 May 07 nicklas 1303         </varlistentry>
3295 07 May 07 nicklas 1304       
3295 07 May 07 nicklas 1305         <varlistentry>
3295 07 May 07 nicklas 1306           <term>Edit view</term>
3295 07 May 07 nicklas 1307           <listitem>
3295 07 May 07 nicklas 1308             <para>
5789 06 Oct 11 nicklas 1309             This view is used for editing the information about a single item. 
5789 06 Oct 11 nicklas 1310             It is always displayed as a pop-up window. Quite often the popup has
5789 06 Oct 11 nicklas 1311             multiple tabs, but the most important information is found on the
5789 06 Oct 11 nicklas 1312             first tab. Information that is required is always found on the
5789 06 Oct 11 nicklas 1313             first tab.
3295 07 May 07 nicklas 1314             </para>
3295 07 May 07 nicklas 1315           </listitem>
3295 07 May 07 nicklas 1316         </varlistentry>
3295 07 May 07 nicklas 1317       </variablelist>  
3295 07 May 07 nicklas 1318               
3295 07 May 07 nicklas 1319       <sect2 id="webclient.items.new">
3295 07 May 07 nicklas 1320         <title>Create a new item</title>
3295 07 May 07 nicklas 1321         
3295 07 May 07 nicklas 1322         <para>
3295 07 May 07 nicklas 1323           New items are mostly created from the list view. For example,
3295 07 May 07 nicklas 1324           to create a new experiment go to the 
3295 07 May 07 nicklas 1325           <menuchoice><guimenu>View</guimenu> <guimenuitem>Experiments</guimenuitem></menuchoice>
3394 28 May 07 martin 1326           page. Here you will find a &gbNew; button in the
3487 13 Jun 07 peter 1327           toolbar. The button is disabled if you do not have permission to create new experiments. 
4487 08 Sep 08 jari 1328           Otherwise, click on it and enter any required information in the pop-up dialog.
3295 07 May 07 nicklas 1329           Sometimes there are multiple tabs in this dialog. In the case of experiments
3295 07 May 07 nicklas 1330           there are three tabs: <guilabel>Experiment</guilabel>, <guilabel>Publication</guilabel>
3295 07 May 07 nicklas 1331           and <guilabel>Experimental factors</guilabel>.
3295 07 May 07 nicklas 1332           
3295 07 May 07 nicklas 1333           As a general rule, only the first tab has information that is required. 
3295 07 May 07 nicklas 1334           The information in all other tabs are optional.
3295 07 May 07 nicklas 1335         </para>
3295 07 May 07 nicklas 1336         
3295 07 May 07 nicklas 1337         <para>
3295 07 May 07 nicklas 1338           In some places you will also find actions that create items
3295 07 May 07 nicklas 1339           directly in the list. For example in the list of samples or on
3295 07 May 07 nicklas 1340           the single-item view for a sample you can create an extract using that
3295 07 May 07 nicklas 1341           sample as the parent. If you use such links the parent
3295 07 May 07 nicklas 1342           item will in most cases be selected automatically, which saves
3295 07 May 07 nicklas 1343           you a few clicks when creating new items.
3295 07 May 07 nicklas 1344         </para>
3295 07 May 07 nicklas 1345         
3295 07 May 07 nicklas 1346         <para>
3394 28 May 07 martin 1347           Click on the &gbSave; button to save the new
3394 28 May 07 martin 1348           item to the database or on the &gbCancel; button
3295 07 May 07 nicklas 1349           to abort.
3295 07 May 07 nicklas 1350         </para>
3295 07 May 07 nicklas 1351
3295 07 May 07 nicklas 1352         <note>
3295 07 May 07 nicklas 1353           <para>
3295 07 May 07 nicklas 1354           To speed up data entry when adding multiple new items there
3295 07 May 07 nicklas 1355           are a few tricks you can use to make the web client supply
3295 07 May 07 nicklas 1356           default values for most properties. To find a default value
3295 07 May 07 nicklas 1357           the following checklist is used in this order:
3295 07 May 07 nicklas 1358           </para>
3295 07 May 07 nicklas 1359         
3295 07 May 07 nicklas 1360         <orderedlist>          
3295 07 May 07 nicklas 1361           <listitem>
3295 07 May 07 nicklas 1362             <para>
3295 07 May 07 nicklas 1363             If the list have an active filter the filter values are
3295 07 May 07 nicklas 1364             used as default property values for the new item. For example,
3295 07 May 07 nicklas 1365             if you are listing experiments with <guilabel>Genepix</guilabel>
3295 07 May 07 nicklas 1366             raw data type the new experiment will automatically have
3295 07 May 07 nicklas 1367             <guilabel>Genepix</guilabel> selected. This trick should work
3487 13 Jun 07 peter 1368             for all properties except annotations, if it does not
3295 07 May 07 nicklas 1369             report it as a bug to the development team.
3295 07 May 07 nicklas 1370             </para>
3295 07 May 07 nicklas 1371           </listitem>
3295 07 May 07 nicklas 1372           
3295 07 May 07 nicklas 1373           <listitem>
3295 07 May 07 nicklas 1374             <para>
3295 07 May 07 nicklas 1375             When you link to other items the same item will be used the next time.
3295 07 May 07 nicklas 1376             For example, if you create an extract and selects an extraction protocol
3295 07 May 07 nicklas 1377             the same protocol is used the next time you create another extract.
3295 07 May 07 nicklas 1378             In fact, BASE will remember as many items as specified by
3791 26 Sep 07 martin 1379             the 
3791 26 Sep 07 martin 1380             <guilabel>Recently used items</guilabel> setting (default is 4),
3791 26 Sep 07 martin 1381             allowing you to quickly select one of those protocols. 
5684 02 Aug 11 nicklas 1382             <xref linkend="webclient.configuration.preferences.mostrecent" /> 
3791 26 Sep 07 martin 1383             contains more information about the setting.
3295 07 May 07 nicklas 1384             </para>
3295 07 May 07 nicklas 1385           </listitem>
3295 07 May 07 nicklas 1386           
3295 07 May 07 nicklas 1387           <listitem>
3295 07 May 07 nicklas 1388             <para>
3295 07 May 07 nicklas 1389             If you have a project active and that project has specified default 
3295 07 May 07 nicklas 1390             values those values will be used for new items. A project can specify
3295 07 May 07 nicklas 1391             defaults for protocols, hardware and software and a few other settings.
3295 07 May 07 nicklas 1392             </para>
3295 07 May 07 nicklas 1393           </listitem>
3295 07 May 07 nicklas 1394           
3295 07 May 07 nicklas 1395         </orderedlist>
3295 07 May 07 nicklas 1396         
3295 07 May 07 nicklas 1397         </note>
3295 07 May 07 nicklas 1398         
3295 07 May 07 nicklas 1399       </sect2>
3295 07 May 07 nicklas 1400       
3295 07 May 07 nicklas 1401       <sect2 id="webclient.items.edit">
3295 07 May 07 nicklas 1402         <title>Edit an existing item</title>
3295 07 May 07 nicklas 1403         
3295 07 May 07 nicklas 1404         <para>
3394 28 May 07 martin 1405           On all single-item views there is an &gbEdit;
4487 08 Sep 08 jari 1406           button in the toolbar that opens a pop-up dialog for editing the properties
3487 13 Jun 07 peter 1407           of the item. This button is disabled if the logged in user does not have
3295 07 May 07 nicklas 1408           write permission for the item.
3295 07 May 07 nicklas 1409         </para>
3295 07 May 07 nicklas 1410         
3295 07 May 07 nicklas 1411         <para>
4487 08 Sep 08 jari 1412           You can also open the edit pop-up in most other places where
3295 07 May 07 nicklas 1413           the item appears, for example, in lists or the single-item view
3295 07 May 07 nicklas 1414           of a related item. Press and hold one of the <keycap>CTRL</keycap>, 
3295 07 May 07 nicklas 1415           <keycap>ALT</keycap> or <keycap>SHIFT</keycap> keys while clicking
4487 08 Sep 08 jari 1416           on the link and the edit window will open in a pop-up. 
3487 13 Jun 07 peter 1417           If you do not have write permission
4487 08 Sep 08 jari 1418           on the item there is no meaning to open the edit pop-up and you will 
3295 07 May 07 nicklas 1419           be taken to the single-item view page instead.
3295 07 May 07 nicklas 1420         </para>
3295 07 May 07 nicklas 1421
3295 07 May 07 nicklas 1422         <para>
3394 28 May 07 martin 1423           Click on the &gbSave; button to save the changes
3394 28 May 07 martin 1424           to the database or on the &gbCancel; button
3295 07 May 07 nicklas 1425           to abort.
3295 07 May 07 nicklas 1426         </para>
3295 07 May 07 nicklas 1427       
3295 07 May 07 nicklas 1428       </sect2>
3295 07 May 07 nicklas 1429
3295 07 May 07 nicklas 1430       <sect2 id="webclient.items.delete">
3295 07 May 07 nicklas 1431         <title>Delete items</title>
3295 07 May 07 nicklas 1432
3295 07 May 07 nicklas 1433         <para>
3295 07 May 07 nicklas 1434           You can delete items either from the list view or from 
3840 16 Oct 07 jari 1435           a single-item view. In both cases, deleted items are only moved to
3840 16 Oct 07 jari 1436           the trashcan. No information is removed from the database. This allows
3840 16 Oct 07 jari 1437           you to restore items if you later find out that you need them again.
3295 07 May 07 nicklas 1438           In fact, there is nothing special about a removed item. It can still be
3295 07 May 07 nicklas 1439           used for the same things as any non-removed item can.
3295 07 May 07 nicklas 1440         </para>
3295 07 May 07 nicklas 1441
3295 07 May 07 nicklas 1442         <important>
3320 10 May 07 martin 1443           <para>
4004 26 Nov 07 nicklas 1444           To really delete items from the database you have two options:
4004 26 Nov 07 nicklas 1445           <orderedlist>
4004 26 Nov 07 nicklas 1446           <listitem>
4004 26 Nov 07 nicklas 1447             <para>
4004 26 Nov 07 nicklas 1448             Go to the trashcan 
4004 26 Nov 07 nicklas 1449             <menuchoice><guimenu>View</guimenu><guimenuitem>Trashcan</guimenuitem></menuchoice>
4004 26 Nov 07 nicklas 1450             and delete it from there. From the trashcan you can delete several items
4004 26 Nov 07 nicklas 1451             in one go. See <xref linkend="webclient.trashcan"/>.
4004 26 Nov 07 nicklas 1452             </para>
4004 26 Nov 07 nicklas 1453           </listitem>
4004 26 Nov 07 nicklas 1454           <listitem>
4004 26 Nov 07 nicklas 1455             <para>
4004 26 Nov 07 nicklas 1456             Click on the small trashcan icon in the list or single-item view. 
4004 26 Nov 07 nicklas 1457             You can only delete one item at a time.
4004 26 Nov 07 nicklas 1458             </para>
4004 26 Nov 07 nicklas 1459           </listitem>
4004 26 Nov 07 nicklas 1460           </orderedlist>
3320 10 May 07 martin 1461           </para>
3295 07 May 07 nicklas 1462         </important>
3295 07 May 07 nicklas 1463         
3295 07 May 07 nicklas 1464         <para>
3295 07 May 07 nicklas 1465           To delete items from the list view you must first mark
3295 07 May 07 nicklas 1466           the checkbox for each item you want to delete. Then, click on 
3394 28 May 07 martin 1467           the &gbDelete; button. The list should refresh itself
3295 07 May 07 nicklas 1468           automatically. If you want to confirm that the items have been removed
3295 07 May 07 nicklas 1469           use the <guilabel>view / presets</guilabel> dropdown and select
3295 07 May 07 nicklas 1470           the <guilabel>Removed</guilabel> option. The removed items should now
3295 07 May 07 nicklas 1471           be displayed in the list with a small trashcan icon to indicate that
3295 07 May 07 nicklas 1472           they are located in the trashcan.
3295 07 May 07 nicklas 1473         </para>
3295 07 May 07 nicklas 1474
3295 07 May 07 nicklas 1475         <para>
3295 07 May 07 nicklas 1476           To delete items from the single-item view, click on the 
3394 28 May 07 martin 1477           &gbDelete; button in the toolbar. The page will refresh
3295 07 May 07 nicklas 1478           itself automatically and a small trashcan icon should be displayed.
3487 13 Jun 07 peter 1479           If you do not have permission to delete the item the delete button
3295 07 May 07 nicklas 1480           is disabled.
3295 07 May 07 nicklas 1481         </para>
3295 07 May 07 nicklas 1482
3295 07 May 07 nicklas 1483       </sect2>
3295 07 May 07 nicklas 1484       
3295 07 May 07 nicklas 1485       <sect2 id="webclient.items.restore">
3295 07 May 07 nicklas 1486         <title>Restore deleted items</title>
3295 07 May 07 nicklas 1487         
3295 07 May 07 nicklas 1488         <para>
3840 16 Oct 07 jari 1489           You can restore deleted items either from the trashcan, from
3840 16 Oct 07 jari 1490           the list view, or from the single-item view. This section
3840 16 Oct 07 jari 1491           only covers the last two cases. The trashcan is described in
5684 02 Aug 11 nicklas 1492           <xref linkend="webclient.trashcan"/>.
3295 07 May 07 nicklas 1493         </para>
3295 07 May 07 nicklas 1494
3295 07 May 07 nicklas 1495         <para>
3295 07 May 07 nicklas 1496           To delete items from the list view you must first make the deleted
3295 07 May 07 nicklas 1497           items appear in the list. This is easy, just use the <guilabel>view / presets</guilabel> 
3295 07 May 07 nicklas 1498           dropdown and select the <guilabel>Removed</guilabel> option. The list should
3295 07 May 07 nicklas 1499           refresh itself automatically. The removed items are 
3295 07 May 07 nicklas 1500           displayed in the list with a small trashcan icon to indicate that
3295 07 May 07 nicklas 1501           they are located in the trashcan. Then, mark the checkbox for each item that you want
3394 28 May 07 martin 1502           to restore and click the &gbRestore; button. The list should 
3295 07 May 07 nicklas 1503           refresh itself automatically and the trashcan icon should be gone from the
3295 07 May 07 nicklas 1504           restored items.
3295 07 May 07 nicklas 1505         </para>
3295 07 May 07 nicklas 1506         
3295 07 May 07 nicklas 1507         <para>
3295 07 May 07 nicklas 1508           To restore items from the single-item view, click on the 
3394 28 May 07 martin 1509           &gbRestore; button in the toolbar. The page will refresh
3295 07 May 07 nicklas 1510           itself automatically and the small trashcan icon should be gone.
3487 13 Jun 07 peter 1511           If you do not have permission to restore the item the restore button
3295 07 May 07 nicklas 1512           is disabled.
3295 07 May 07 nicklas 1513         </para>
3295 07 May 07 nicklas 1514
3295 07 May 07 nicklas 1515       </sect2>
3295 07 May 07 nicklas 1516
3295 07 May 07 nicklas 1517       <sect2 id="webclient.items.share">
3295 07 May 07 nicklas 1518         <title>Share items to other users</title>
3295 07 May 07 nicklas 1519         <para>
3295 07 May 07 nicklas 1520           Sharing data with other users is an important feature
4268 06 May 08 jari 1521           of BASE, which allows you cooperate in teams. If you
4268 06 May 08 jari 1522           follow the instructions in <xref linkend="project_permission" />
3295 07 May 07 nicklas 1523           you will find that you almost never have to share items manually
3295 07 May 07 nicklas 1524           to other users. This is because whenever you work with an active 
3295 07 May 07 nicklas 1525           project each new item you create will automatically be shared
5370 23 Jun 10 nicklas 1526           according to the settings of that project. In most cases, this
5370 23 Jun 10 nicklas 1527           is all you need.
3295 07 May 07 nicklas 1528         </para>
3295 07 May 07 nicklas 1529         
3295 07 May 07 nicklas 1530         <para>
3295 07 May 07 nicklas 1531           If you still need to manually share your data with other users, 
3295 07 May 07 nicklas 1532           here is how to do it.
3295 07 May 07 nicklas 1533         </para>
3295 07 May 07 nicklas 1534         
3295 07 May 07 nicklas 1535         <para>
3295 07 May 07 nicklas 1536           From a list view, mark the checkbox for each item you want to share.
3394 28 May 07 martin 1537           Then, click on the &gbShare; button.
3394 28 May 07 martin 1538           If you are on a single-item page, click on the &gbShare; 
3295 07 May 07 nicklas 1539           button on that page. In both cases, this will open the 
3295 07 May 07 nicklas 1540           <guilabel>Set access permissions</guilabel>
3295 07 May 07 nicklas 1541           dialog window.
3295 07 May 07 nicklas 1542         </para>
3295 07 May 07 nicklas 1543         
3295 07 May 07 nicklas 1544         <figure id="webclient.items.share.set_permissions">
3295 07 May 07 nicklas 1545           <title>Sharing items to other users</title>
3295 07 May 07 nicklas 1546           <screenshot>
3295 07 May 07 nicklas 1547           <mediaobject>
3295 07 May 07 nicklas 1548             <imageobject>
3353 21 May 07 nicklas 1549               <imagedata fileref="figures/set_permissions.png" format="PNG" />
3295 07 May 07 nicklas 1550             </imageobject>
3295 07 May 07 nicklas 1551           </mediaobject>
3295 07 May 07 nicklas 1552           </screenshot>
3295 07 May 07 nicklas 1553         </figure>
3295 07 May 07 nicklas 1554         
3295 07 May 07 nicklas 1555         <helptext external_id="share.setpermissions" title="Set access permissions">
3295 07 May 07 nicklas 1556           <variablelist>
3295 07 May 07 nicklas 1557             <varlistentry>
3295 07 May 07 nicklas 1558               <term><guilabel>Members</guilabel></term>
3295 07 May 07 nicklas 1559               <listitem>
3295 07 May 07 nicklas 1560                 <para>
3295 07 May 07 nicklas 1561                 The list displays the users, groups and projects
3320 10 May 07 martin 1562                 that already has access to the items you selected.
3295 07 May 07 nicklas 1563                 The list shows the name and the permission level. 
3295 07 May 07 nicklas 1564                 The permission level uses a one-letter code as follows:
3295 07 May 07 nicklas 1565                 </para>
3295 07 May 07 nicklas 1566                 
3295 07 May 07 nicklas 1567                 <itemizedlist>
3320 10 May 07 martin 1568                 <listitem><simpara><guilabel>R</guilabel> = Read</simpara></listitem>
3320 10 May 07 martin 1569                 <listitem><simpara><guilabel>U</guilabel> = Use</simpara></listitem>
7222 04 Nov 16 nicklas 1570                 <listitem><simpara><guilabel>A</guilabel> = Annotate</simpara> (only visble if sharing items that are annotatable)</listitem>
3320 10 May 07 martin 1571                 <listitem><simpara><guilabel>W</guilabel> = Write</simpara></listitem>
3320 10 May 07 martin 1572                 <listitem><simpara><guilabel>D</guilabel> = Delete</simpara></listitem>
4588 16 Oct 08 martin 1573                 <listitem><simpara><guilabel>O</guilabel> = Set owner</simpara></listitem>
3320 10 May 07 martin 1574                 <listitem><simpara><guilabel>P</guilabel> = Set permission</simpara></listitem>
3295 07 May 07 nicklas 1575                 </itemizedlist>
3295 07 May 07 nicklas 1576                 
3295 07 May 07 nicklas 1577                 <para>
3295 07 May 07 nicklas 1578                   Instead of a permission code, the word <guilabel>varying</guilabel>
3295 07 May 07 nicklas 1579                   may be displayed. This happens if the items you selected have been
3295 07 May 07 nicklas 1580                   shared with different permission.
3295 07 May 07 nicklas 1581                 </para>
3295 07 May 07 nicklas 1582                 
5370 23 Jun 10 nicklas 1583                 <para>
5370 23 Jun 10 nicklas 1584                   The <guilabel>Permission templates</guilabel> part of the list
5370 23 Jun 10 nicklas 1585                   is always empty to begin with.
5370 23 Jun 10 nicklas 1586                 </para>
5370 23 Jun 10 nicklas 1587                 
3295 07 May 07 nicklas 1588               </listitem>
3295 07 May 07 nicklas 1589             </varlistentry>
3295 07 May 07 nicklas 1590             
3295 07 May 07 nicklas 1591             <varlistentry>
3295 07 May 07 nicklas 1592               <term><guilabel>Permissions</guilabel></term>
3295 07 May 07 nicklas 1593               <listitem>
3295 07 May 07 nicklas 1594                 <para>
3295 07 May 07 nicklas 1595                 When you select a user, group or project in the
5789 06 Oct 11 nicklas 1596                 list, the checkboxes will change to indicate the current permissions. 
3295 07 May 07 nicklas 1597                 The exception is if the permissions are varying, in which
3295 07 May 07 nicklas 1598                 case no checkboxes are checked.
3295 07 May 07 nicklas 1599                 To change the permissions just check the permissions you want to 
3295 07 May 07 nicklas 1600                 grant or uncheck the permissions you want to revoke.
3295 07 May 07 nicklas 1601                 You can select more than one user, group or project
3295 07 May 07 nicklas 1602                 and change the permissions for all of them at once.
3295 07 May 07 nicklas 1603                 </para>
5370 23 Jun 10 nicklas 1604                 <para>
5370 23 Jun 10 nicklas 1605                 The permission boxes are disabled if a permission template
5370 23 Jun 10 nicklas 1606                 is selected. The permissions are already part of the template
5370 23 Jun 10 nicklas 1607                 and can't be changed here.
5370 23 Jun 10 nicklas 1608                 </para>
3295 07 May 07 nicklas 1609               </listitem>
3295 07 May 07 nicklas 1610             </varlistentry>            
3295 07 May 07 nicklas 1611
3295 07 May 07 nicklas 1612             <varlistentry>
3295 07 May 07 nicklas 1613               <term><guibutton>Add users</guibutton></term>
3295 07 May 07 nicklas 1614               <listitem>
3295 07 May 07 nicklas 1615                 <para>
4487 08 Sep 08 jari 1616                 Opens a pop-up window that allows you to select
4487 08 Sep 08 jari 1617                 users to share the items to. In the pop-up window, mark
3394 28 May 07 martin 1618                 one or more users and click on the &gbOk;
4487 08 Sep 08 jari 1619                 button. The pop-up window will only list users that you have
4437 02 Sep 08 nicklas 1620                 permission to read. Unless you are an administrator, this
4437 02 Sep 08 nicklas 1621                 usually means that you can only see users that: 
3295 07 May 07 nicklas 1622                 </para>
4437 02 Sep 08 nicklas 1623                 <itemizedlist>
4437 02 Sep 08 nicklas 1624                   <listitem>
4437 02 Sep 08 nicklas 1625                     <para>
5789 06 Oct 11 nicklas 1626                     you share group memberships with  (the <emphasis>Everyone</emphasis> 
5789 06 Oct 11 nicklas 1627                     group or groups with hidden members doesn't count)
4437 02 Sep 08 nicklas 1628                     </para>
4437 02 Sep 08 nicklas 1629                   </listitem>
4437 02 Sep 08 nicklas 1630                   <listitem>
4437 02 Sep 08 nicklas 1631                     <para>
4437 02 Sep 08 nicklas 1632                     are members of the currently active project, if any.
4437 02 Sep 08 nicklas 1633                     </para>
4437 02 Sep 08 nicklas 1634                   </listitem>
4437 02 Sep 08 nicklas 1635                 </itemizedlist>
4437 02 Sep 08 nicklas 1636                 <para>
4437 02 Sep 08 nicklas 1637                 Users that already have access to the item are not included in the
4437 02 Sep 08 nicklas 1638                 list. If you don't see a user that you want to share an item to,
4437 02 Sep 08 nicklas 1639                 you'll need to talk to an administrator for setting up the proper
4437 02 Sep 08 nicklas 1640                 group membership.
4437 02 Sep 08 nicklas 1641                 </para>
3295 07 May 07 nicklas 1642               </listitem>
3295 07 May 07 nicklas 1643             </varlistentry>
3295 07 May 07 nicklas 1644
3295 07 May 07 nicklas 1645             <varlistentry>
3295 07 May 07 nicklas 1646               <term><guibutton>Add groups</guibutton></term>
3295 07 May 07 nicklas 1647               <listitem>
3295 07 May 07 nicklas 1648                 <para>
4487 08 Sep 08 jari 1649                 Opens a pop-up window that allows you to select
4487 08 Sep 08 jari 1650                 groups to share the items to. In the pop-up window, mark
3394 28 May 07 martin 1651                 one or more groups and click on the &gbOk;
4487 08 Sep 08 jari 1652                 button. Unless you are an administrator, the pop-up window 
3295 07 May 07 nicklas 1653                 will only list groups where you are a member. It will not list
5789 06 Oct 11 nicklas 1654                 groups that already have access to the items. The
5789 06 Oct 11 nicklas 1655                 <emphasis>Everyone</emphasis> groups is normally not visible unless
5789 06 Oct 11 nicklas 1656                 have a specific permission to share items with this group.
3295 07 May 07 nicklas 1657                 </para>
3295 07 May 07 nicklas 1658               </listitem>
3295 07 May 07 nicklas 1659             </varlistentry>
3295 07 May 07 nicklas 1660             
3295 07 May 07 nicklas 1661             <varlistentry>
3295 07 May 07 nicklas 1662               <term><guibutton>Add projects</guibutton></term>
3295 07 May 07 nicklas 1663               <listitem>
3295 07 May 07 nicklas 1664                 <para>
4487 08 Sep 08 jari 1665                 Opens a pop-up window that allows you to select
4487 08 Sep 08 jari 1666                 projects to share the items to. In the pop-up window, mark
3394 28 May 07 martin 1667                 one or more projects and click on the &gbOk;
4487 08 Sep 08 jari 1668                 button. Unless you are an administrator, the pop-up window 
3295 07 May 07 nicklas 1669                 will only list projects where you are a member. It will not list
3295 07 May 07 nicklas 1670                 projects that already have access to the items.
3295 07 May 07 nicklas 1671                 </para>
3295 07 May 07 nicklas 1672               </listitem>
3295 07 May 07 nicklas 1673             </varlistentry>
5370 23 Jun 10 nicklas 1674             
5370 23 Jun 10 nicklas 1675             <varlistentry>
5370 23 Jun 10 nicklas 1676               <term><guibutton>Templates</guibutton></term>
5370 23 Jun 10 nicklas 1677               <listitem>
5370 23 Jun 10 nicklas 1678                 <para>
5370 23 Jun 10 nicklas 1679                 Opens a pop-up window that allows you to select 
5370 23 Jun 10 nicklas 1680                 permission templates. In the pop-up window, mark
5370 23 Jun 10 nicklas 1681                 one or more templates and click on the &gbOk;
5370 23 Jun 10 nicklas 1682                 button. Unless you are an administrator, the pop-up window 
5370 23 Jun 10 nicklas 1683                 will only list templates that you are allowed to use. It will 
5370 23 Jun 10 nicklas 1684                 not list templates that have already been added.
5370 23 Jun 10 nicklas 1685                 </para>
5370 23 Jun 10 nicklas 1686                 
5370 23 Jun 10 nicklas 1687                 <note>
5370 23 Jun 10 nicklas 1688                   <para>
5370 23 Jun 10 nicklas 1689                   The permissions from the selected templates are <emphasis>copied</emphasis>
5370 23 Jun 10 nicklas 1690                   to the items when the access permissions are saved. If you re-open the share dialog,
5370 23 Jun 10 nicklas 1691                   the actual permissions are shown and the permission templates 
5370 23 Jun 10 nicklas 1692                   section is empty. Modifying the permission template later doesn't 
5370 23 Jun 10 nicklas 1693                   affect the permissions on existing items. See <xref linkend="project_permission.templates" /> 
5370 23 Jun 10 nicklas 1694                   for more information about permission templates.
5370 23 Jun 10 nicklas 1695                   </para>
5370 23 Jun 10 nicklas 1696                 </note>
5370 23 Jun 10 nicklas 1697                 
5370 23 Jun 10 nicklas 1698               </listitem>
5370 23 Jun 10 nicklas 1699             </varlistentry>
3295 07 May 07 nicklas 1700
3295 07 May 07 nicklas 1701             <varlistentry>
3394 28 May 07 martin 1702               <term>&gbRemove;</term>
3295 07 May 07 nicklas 1703               <listitem>
3295 07 May 07 nicklas 1704                 <para>
3295 07 May 07 nicklas 1705                 Click on this button to revoke access permissions from
3295 07 May 07 nicklas 1706                 the selected users, groups and projects.
3295 07 May 07 nicklas 1707                 </para>
3295 07 May 07 nicklas 1708               </listitem>    
3295 07 May 07 nicklas 1709             </varlistentry>
4313 26 May 08 nicklas 1710             
4313 26 May 08 nicklas 1711             <varlistentry>
4487 08 Sep 08 jari 1712               <term><guilabel>Apply permissions to all sub-directories and their files</guilabel></term>
4313 26 May 08 nicklas 1713               <listitem>
4313 26 May 08 nicklas 1714                 <para>
4313 26 May 08 nicklas 1715                 This option shows up if at least one of the selected items
4313 26 May 08 nicklas 1716                 is a directory. If this option is selected the permissions given
4313 26 May 08 nicklas 1717                 to the directory will recursively be copied to all files and 
4487 08 Sep 08 jari 1718                 sub-directories. Existing permissions on those items will be
4313 26 May 08 nicklas 1719                 overwritten with the new permissions.
4313 26 May 08 nicklas 1720                 </para>
4313 26 May 08 nicklas 1721               </listitem>    
4313 26 May 08 nicklas 1722             </varlistentry>
3295 07 May 07 nicklas 1723           </variablelist>
3295 07 May 07 nicklas 1724         
3295 07 May 07 nicklas 1725           <para>
3394 28 May 07 martin 1726             Use the &gbSave; button to save your
3394 28 May 07 martin 1727             changes or the &gbCancel; button to
4487 08 Sep 08 jari 1728             close the pop-up without saving.
3295 07 May 07 nicklas 1729           </para>
3295 07 May 07 nicklas 1730         </helptext>
3295 07 May 07 nicklas 1731
3295 07 May 07 nicklas 1732       </sect2>
3295 07 May 07 nicklas 1733
4587 15 Oct 08 martin 1734       <sect2 id="webclient.items.changeowner">
4587 15 Oct 08 martin 1735         <title>Change owner of items</title>
3295 07 May 07 nicklas 1736         <para>
4588 16 Oct 08 martin 1737           Sometimes it may be necessary to change the owner of an item.
4588 16 Oct 08 martin 1738           This can be done by everyone with <emphasis>Set owner</emphasis>
4587 15 Oct 08 martin 1739           permission on the item.
4587 15 Oct 08 martin 1740           For a user to have the rights to change owner of an item, the item must 
4588 16 Oct 08 martin 1741           either be owned by or shared with <emphasis>Set owner</emphasis> 
4587 15 Oct 08 martin 1742           permission to the user . 
3295 07 May 07 nicklas 1743           See <xref linkend="webclient.items.share" />.
3295 07 May 07 nicklas 1744         </para>
3295 07 May 07 nicklas 1745         
3295 07 May 07 nicklas 1746         <para>
4588 16 Oct 08 martin 1747           An user with <emphasis>Set owner</emphasis> permission can go to a list view 
4587 15 Oct 08 martin 1748           (or the single-item view), mark the checkboxes for the items to change owner of, 
4588 16 Oct 08 martin 1749           and click on the <guibutton>Set owner</guibutton> button.   
4588 16 Oct 08 martin 1750           A dialog window, like the screen-shot below, will appear.
3295 07 May 07 nicklas 1751         </para>
4588 16 Oct 08 martin 1752         <helptext external_id="ownership.configure" title="Change owner">
4588 16 Oct 08 martin 1753         <variablelist>
4588 16 Oct 08 martin 1754         <varlistentry>
4588 16 Oct 08 martin 1755           <term><guilabel>New owner</guilabel></term>
4588 16 Oct 08 martin 1756           <listitem>
4588 16 Oct 08 martin 1757           <para>
4588 16 Oct 08 martin 1758             The user to be the new owner of selected item(s).
4588 16 Oct 08 martin 1759             By default the current user will be selected but other
4588 16 Oct 08 martin 1760             users can be picked from the <emphasis>currently used</emphasis> part of the drop-down 
4588 16 Oct 08 martin 1761             list or by clicking on <guibutton>Select</guibutton>.
4588 16 Oct 08 martin 1762           </para>
4588 16 Oct 08 martin 1763           </listitem>
4588 16 Oct 08 martin 1764         </varlistentry>
4588 16 Oct 08 martin 1765         </variablelist>
4588 16 Oct 08 martin 1766         <para>
4588 16 Oct 08 martin 1767           Use the &gbSave; button to set the new owner
4588 16 Oct 08 martin 1768           or the &gbCancel; button to
4588 16 Oct 08 martin 1769           close the pop-up without saving.
4588 16 Oct 08 martin 1770         </para>
4588 16 Oct 08 martin 1771         </helptext> 
4587 15 Oct 08 martin 1772         <figure id="webclient.figures.selectowner">
4587 15 Oct 08 martin 1773           <title>Select a new owner</title>
4587 15 Oct 08 martin 1774           <screenshot>
4587 15 Oct 08 martin 1775             <mediaobject>
4587 15 Oct 08 martin 1776               <imageobject><imagedata fileref="figures/select_owner.png" format="PNG"
4587 15 Oct 08 martin 1777                 scalefit="1" width="100%" /></imageobject>
4587 15 Oct 08 martin 1778             </mediaobject>
4587 15 Oct 08 martin 1779           </screenshot>
4587 15 Oct 08 martin 1780         </figure>
3295 07 May 07 nicklas 1781         
5789 06 Oct 11 nicklas 1782         <warning>
3320 10 May 07 martin 1783           <para>
5789 06 Oct 11 nicklas 1784           If you are the original owner of the items, you should be aware of that
5789 06 Oct 11 nicklas 1785           after the change you may no longer have access to the items. If you
5789 06 Oct 11 nicklas 1786           make a mistake you may have to talk to an administrator to correct it.
3320 10 May 07 martin 1787           </para>
5789 06 Oct 11 nicklas 1788         </warning>
3295 07 May 07 nicklas 1789         
3295 07 May 07 nicklas 1790       </sect2>
3295 07 May 07 nicklas 1791       
3295 07 May 07 nicklas 1792     </sect1>
3295 07 May 07 nicklas 1793     
3181 12 Mar 07 nicklas 1794     <sect1 id="webclient.itemlist">
5782 04 Oct 11 nicklas 1795       <?dbhtml filename="lists.html" ?>
3181 12 Mar 07 nicklas 1796       <title>Listing items</title>
3181 12 Mar 07 nicklas 1797       
3181 12 Mar 07 nicklas 1798       <para>
3181 12 Mar 07 nicklas 1799         All pages that lists items are very similar in their appearance and
3181 12 Mar 07 nicklas 1800         functionality. In this section we will describe the things that are
3181 12 Mar 07 nicklas 1801         common for most (if not all) list pages.
3181 12 Mar 07 nicklas 1802       </para>
3181 12 Mar 07 nicklas 1803       
3181 12 Mar 07 nicklas 1804       <para>
3791 26 Sep 07 martin 1805         Use the menu to open a page listing items. Most list pages can only list one type of
3791 26 Sep 07 martin 1806         items. For example: use the
3791 26 Sep 07 martin 1807         <menuchoice>
3791 26 Sep 07 martin 1808           <guimenu>View</guimenu>
3791 26 Sep 07 martin 1809           <guimenuitem>Samples</guimenuitem>
3791 26 Sep 07 martin 1810         </menuchoice>
3791 26 Sep 07 martin 1811         menu to list samples and the
3791 26 Sep 07 martin 1812         <menuchoice>
3791 26 Sep 07 martin 1813           <guimenu>View</guimenu>
3791 26 Sep 07 martin 1814           <guimenuitem>Experiments</guimenuitem>
3791 26 Sep 07 martin 1815         </menuchoice>
3791 26 Sep 07 martin 1816         menu to list experiments.
3181 12 Mar 07 nicklas 1817       </para>
3791 26 Sep 07 martin 1818
3359 22 May 07 nicklas 1819       <tip>
3359 22 May 07 nicklas 1820         An example of a list page that can list
3359 22 May 07 nicklas 1821         items of several types is found by going to 
3359 22 May 07 nicklas 1822         <menuchoice>
3359 22 May 07 nicklas 1823           <guimenu>View</guimenu>
3359 22 May 07 nicklas 1824           <guimenuitem>All items</guimenuitem>
3359 22 May 07 nicklas 1825         </menuchoice>.
3359 22 May 07 nicklas 1826         This page lists all items that you are the owner of. It has a few limitations:
3359 22 May 07 nicklas 1827         
3359 22 May 07 nicklas 1828         <itemizedlist>
3359 22 May 07 nicklas 1829           <listitem>
3359 22 May 07 nicklas 1830             <para>
5684 02 Aug 11 nicklas 1831               It support only a limited set of columns (id, item type, name and description) 
5684 02 Aug 11 nicklas 1832               since these are the only properties that are common among all items. It is also
5684 02 Aug 11 nicklas 1833               possible to display sharing information.
3359 22 May 07 nicklas 1834             </para>
3359 22 May 07 nicklas 1835           </listitem>
3359 22 May 07 nicklas 1836           
3359 22 May 07 nicklas 1837           <listitem>
3359 22 May 07 nicklas 1838             <para>
5202 16 Dec 09 nicklas 1839               The list may have not have full support for filtering and
5202 16 Dec 09 nicklas 1840               sorting. This is due to a limitation in the 
5202 16 Dec 09 nicklas 1841               query system used to generate the list.
3359 22 May 07 nicklas 1842             </para>
3359 22 May 07 nicklas 1843           </listitem>
3359 22 May 07 nicklas 1844         </itemizedlist>
3359 22 May 07 nicklas 1845         
3359 22 May 07 nicklas 1846         <para>
3359 22 May 07 nicklas 1847           There are also several similarities:
3359 22 May 07 nicklas 1848         </para>
3359 22 May 07 nicklas 1849         
3359 22 May 07 nicklas 1850         <itemizedlist>
3359 22 May 07 nicklas 1851           <listitem>
3359 22 May 07 nicklas 1852             <para>
3359 22 May 07 nicklas 1853               It supports all of the regular multi-item 
3359 22 May 07 nicklas 1854               operations such as delete, restore, share
4587 15 Oct 08 martin 1855               and change owner.
3359 22 May 07 nicklas 1856             </para>
3359 22 May 07 nicklas 1857           </listitem>
3359 22 May 07 nicklas 1858           
3359 22 May 07 nicklas 1859           <listitem>
3359 22 May 07 nicklas 1860             <para>
3359 22 May 07 nicklas 1861               Clicking on the name of the item will take you to the
3359 22 May 07 nicklas 1862               single-item view of that item. Holding down <keycap>CTRL</keycap>, 
3359 22 May 07 nicklas 1863               <keycap>ALT</keycap> or <keycap>SHIFT</keycap> while clicking,
4487 08 Sep 08 jari 1864               will open the edit pop-up.
3359 22 May 07 nicklas 1865             </para>
3359 22 May 07 nicklas 1866           </listitem>
3359 22 May 07 nicklas 1867         </itemizedlist>        
3359 22 May 07 nicklas 1868         
3359 22 May 07 nicklas 1869       </tip>
3359 22 May 07 nicklas 1870       
3181 12 Mar 07 nicklas 1871       <figure id="webclient.figures.listpage">
3359 22 May 07 nicklas 1872         <title>A typical list page</title>
3181 12 Mar 07 nicklas 1873         <screenshot>
3181 12 Mar 07 nicklas 1874           <mediaobject>
3346 16 May 07 nicklas 1875             <imageobject><imagedata fileref="figures/listpage.png" format="PNG"
3348 16 May 07 nicklas 1876               scalefit="1" width="100%" /></imageobject>
3181 12 Mar 07 nicklas 1877           </mediaobject>
3181 12 Mar 07 nicklas 1878         </screenshot>
3181 12 Mar 07 nicklas 1879       </figure>
3181 12 Mar 07 nicklas 1880       
3181 12 Mar 07 nicklas 1881       <para>
3181 12 Mar 07 nicklas 1882         The typical list page contains the following important
3181 12 Mar 07 nicklas 1883         elements:
3181 12 Mar 07 nicklas 1884       </para>
3197 19 Mar 07 nicklas 1885
3181 12 Mar 07 nicklas 1886       <variablelist>
3181 12 Mar 07 nicklas 1887         <varlistentry>
3197 19 Mar 07 nicklas 1888           <term><interface>1. Toolbar</interface></term>
3181 12 Mar 07 nicklas 1889           <listitem>
3181 12 Mar 07 nicklas 1890             <para>
3181 12 Mar 07 nicklas 1891             A toolbar with buttons for various actions such as
3394 28 May 07 martin 1892             &gbNew; for creating a new item, 
3394 28 May 07 martin 1893             &gbDelete; for deleting items and 
3181 12 Mar 07 nicklas 1894             <guibutton>Columns&hellip;</guibutton> for configuring columns.
3181 12 Mar 07 nicklas 1895             Depending on the permissions of the logged in user
3181 12 Mar 07 nicklas 1896             some buttons may be disabled (greyed out) or not shown at all.
3181 12 Mar 07 nicklas 1897             </para>
3181 12 Mar 07 nicklas 1898           </listitem>
3181 12 Mar 07 nicklas 1899         </varlistentry>
3181 12 Mar 07 nicklas 1900         
3181 12 Mar 07 nicklas 1901         <varlistentry>
3197 19 Mar 07 nicklas 1902           <term><interface>2. Navigation bar</interface></term>
3181 12 Mar 07 nicklas 1903           <listitem>
3181 12 Mar 07 nicklas 1904             <para>
3181 12 Mar 07 nicklas 1905             If there are many items the list will be divided into
3295 07 May 07 nicklas 1906             pages, each one showing a limited number of items.
3181 12 Mar 07 nicklas 1907             The navigation bar allows you to
3181 12 Mar 07 nicklas 1908             move to other pages and specify how many items each page
3181 12 Mar 07 nicklas 1909             should display. The navigation bar is repeated at the
3487 13 Jun 07 peter 1910             bottom of the list so you do not have to scroll back to the
3181 12 Mar 07 nicklas 1911             top of a long list just to get to another page.
3181 12 Mar 07 nicklas 1912             </para>
3181 12 Mar 07 nicklas 1913           </listitem>
3181 12 Mar 07 nicklas 1914         </varlistentry>
3181 12 Mar 07 nicklas 1915         
3181 12 Mar 07 nicklas 1916         <varlistentry>
3197 19 Mar 07 nicklas 1917           <term><interface>3. List of presets</interface></term>
3181 12 Mar 07 nicklas 1918           <listitem>
3181 12 Mar 07 nicklas 1919             <para>
3295 07 May 07 nicklas 1920             A list with preconfigured settings which allows you to 
3181 12 Mar 07 nicklas 1921             quickly switch between different layouts (sort order, visible
3181 12 Mar 07 nicklas 1922             columns, filter settings, etc).
3181 12 Mar 07 nicklas 1923             </para>
3181 12 Mar 07 nicklas 1924           </listitem>
3181 12 Mar 07 nicklas 1925         </varlistentry>
3181 12 Mar 07 nicklas 1926         
3181 12 Mar 07 nicklas 1927         <varlistentry>
3197 19 Mar 07 nicklas 1928           <term><interface>4. Column headers</interface></term>
3181 12 Mar 07 nicklas 1929           <listitem>
3181 12 Mar 07 nicklas 1930             <para>
3181 12 Mar 07 nicklas 1931             The columns headers can be used for selecting sort order.
3181 12 Mar 07 nicklas 1932             </para>
3181 12 Mar 07 nicklas 1933           </listitem>
3181 12 Mar 07 nicklas 1934         </varlistentry>
3181 12 Mar 07 nicklas 1935         
3181 12 Mar 07 nicklas 1936         <varlistentry>
3197 19 Mar 07 nicklas 1937           <term><interface>5. Filter bar</interface></term>
3181 12 Mar 07 nicklas 1938           <listitem>
3181 12 Mar 07 nicklas 1939             <para>
6708 02 Feb 15 nicklas 1940             The filter bar allows you to search for items. Use the <guiicon>
6708 02 Feb 15 nicklas 1941                   <inlinemediaobject>
6708 02 Feb 15 nicklas 1942                     <imageobject>
6708 02 Feb 15 nicklas 1943                       <imagedata fileref="figures/add.png" format="PNG" />
6708 02 Feb 15 nicklas 1944                     </imageobject>
6708 02 Feb 15 nicklas 1945                   </inlinemediaobject>
6708 02 Feb 15 nicklas 1946                 </guiicon> icon to add more filter rows.
3181 12 Mar 07 nicklas 1947             </para>
3181 12 Mar 07 nicklas 1948           </listitem>
3181 12 Mar 07 nicklas 1949         </varlistentry>
3181 12 Mar 07 nicklas 1950         
3181 12 Mar 07 nicklas 1951       </variablelist>
3181 12 Mar 07 nicklas 1952       
3181 12 Mar 07 nicklas 1953       
3181 12 Mar 07 nicklas 1954       <sect2 id="webclient.itemlist.order">
3181 12 Mar 07 nicklas 1955         <title>Ordering the list</title>
3181 12 Mar 07 nicklas 1956         
3181 12 Mar 07 nicklas 1957         <para>
3181 12 Mar 07 nicklas 1958           Most lists are by default sorted by the name of the item. This can
3181 12 Mar 07 nicklas 1959           be changed by clicking on the column header of another column.
3181 12 Mar 07 nicklas 1960           If you click on the same column twice the sort order is reversed.
3181 12 Mar 07 nicklas 1961           A downwards or upwards pointing arrow is displayed next to the 
3181 12 Mar 07 nicklas 1962           column header in the column that is currently used for sorting.
3487 13 Jun 07 peter 1963           Column headers that are black cannot be used for sorting.
3181 12 Mar 07 nicklas 1964         </para>
3181 12 Mar 07 nicklas 1965         
3181 12 Mar 07 nicklas 1966         <para>
3181 12 Mar 07 nicklas 1967           It is possible to use more than one column for sorting. Press
3181 12 Mar 07 nicklas 1968           and hold one of the <keycap>CTRL</keycap>, 
3181 12 Mar 07 nicklas 1969           <keycap>ALT</keycap> or <keycap>SHIFT</keycap> keys while clicking 
3181 12 Mar 07 nicklas 1970           on another column header. The original sorting is kept and the new
3181 12 Mar 07 nicklas 1971           column is used for sub-sorting the list. The procedure can be 
3181 12 Mar 07 nicklas 1972           repeated with more columns if you need to sort on three or more
3295 07 May 07 nicklas 1973           columns. To revert to sort by only one column again click a 
3181 12 Mar 07 nicklas 1974           column header without holding down any key.
3181 12 Mar 07 nicklas 1975         </para> 
3181 12 Mar 07 nicklas 1976       </sect2>
3181 12 Mar 07 nicklas 1977     
3181 12 Mar 07 nicklas 1978       <sect2 id="webclient.itemlist.filter">
3181 12 Mar 07 nicklas 1979         <title>Filtering the list</title>
3181 12 Mar 07 nicklas 1980         
3181 12 Mar 07 nicklas 1981         <para>
3181 12 Mar 07 nicklas 1982           If the list contains many items you may need to use a filter to be
3181 12 Mar 07 nicklas 1983           able to find the item you are looking for. The input boxes on the
3181 12 Mar 07 nicklas 1984           line below the column headers are used for filtering. Most columns
3181 12 Mar 07 nicklas 1985           are filtered using a free-text input box, but some columns that can
3181 12 Mar 07 nicklas 1986           only take a few distinct values use a selection list or radio buttons
3181 12 Mar 07 nicklas 1987           instead. The selection list and radio buttons are very simple to use.
3181 12 Mar 07 nicklas 1988           Just select the alternative that you want to filter on. The list
3181 12 Mar 07 nicklas 1989           will be automatically updated when the selection has been made.
3181 12 Mar 07 nicklas 1990         </para>
3181 12 Mar 07 nicklas 1991         
3181 12 Mar 07 nicklas 1992         <para>
3181 12 Mar 07 nicklas 1993           The free-text filter is a bit more complex. By default, an exact match is
4487 08 Sep 08 jari 1994           required, use % as a wildcard character that matches any character. 
3181 12 Mar 07 nicklas 1995           For example, the filter <informalexample>Experiment A</informalexample> 
3181 12 Mar 07 nicklas 1996           only matches the same exact string, but the filter 
3181 12 Mar 07 nicklas 1997           <informalexample>Exp%</informalexample> matches 
3181 12 Mar 07 nicklas 1998           <informalexample>Experiment A, Experiment B, etc.</informalexample>
3181 12 Mar 07 nicklas 1999         </para>
3181 12 Mar 07 nicklas 2000         <para>
4093 18 Jan 08 enell 2001           If you want to filter on several values at the same time, separate the 
4093 18 Jan 08 enell 2002           values in the filter input box with the <quote>|</quote> character.
4093 18 Jan 08 enell 2003           For example, a filter text like <informalexample>Experiment A|C%</informalexample>
4093 18 Jan 08 enell 2004           matches both <quote>Experiment A</quote> and values  
4093 18 Jan 08 enell 2005           that begin with <quote>C</quote>.
4093 18 Jan 08 enell 2006         </para>        
4093 18 Jan 08 enell 2007         <para>
3181 12 Mar 07 nicklas 2008           You can also use operators to find items which has a value that
3181 12 Mar 07 nicklas 2009           is greater than, less than or not equal to a specific value. This is
3181 12 Mar 07 nicklas 2010           mostly useful on numeric or date columns but also works on text
3181 12 Mar 07 nicklas 2011           columns. The operator must be entered first in the
3181 12 Mar 07 nicklas 2012           free-text box, for example
3181 12 Mar 07 nicklas 2013           <informalexample>&lt;=10</informalexample>
3181 12 Mar 07 nicklas 2014           to find items which has a value less than or equal to 10.    
3181 12 Mar 07 nicklas 2015           Here is a list of the supported operators:
3181 12 Mar 07 nicklas 2016         </para>
3181 12 Mar 07 nicklas 2017         
3181 12 Mar 07 nicklas 2018         <variablelist id="webclient.itemlist.filter.operators">
3181 12 Mar 07 nicklas 2019           <title>List of operators supported by the free-text filter</title>
3181 12 Mar 07 nicklas 2020           <varlistentry>
3181 12 Mar 07 nicklas 2021             <term><keycap>&lt;</keycap></term>
3320 10 May 07 martin 2022             <listitem><simpara>Less than</simpara></listitem>
3181 12 Mar 07 nicklas 2023           </varlistentry>
3181 12 Mar 07 nicklas 2024           <varlistentry>
3181 12 Mar 07 nicklas 2025             <term><keycap>&lt;=</keycap></term>
3320 10 May 07 martin 2026             <listitem><simpara>Less than or equal to</simpara></listitem>
3181 12 Mar 07 nicklas 2027           </varlistentry>
3181 12 Mar 07 nicklas 2028           <varlistentry>
3181 12 Mar 07 nicklas 2029             <term><keycap>&gt;</keycap></term>
3320 10 May 07 martin 2030             <listitem><simpara>Greater than</simpara></listitem>
3181 12 Mar 07 nicklas 2031           </varlistentry>
3181 12 Mar 07 nicklas 2032           <varlistentry>
3181 12 Mar 07 nicklas 2033             <term><keycap>&gt;=</keycap></term>
3320 10 May 07 martin 2034             <listitem><simpara>Greater than or equal to</simpara></listitem>
3181 12 Mar 07 nicklas 2035           </varlistentry>
3181 12 Mar 07 nicklas 2036           <varlistentry>
3181 12 Mar 07 nicklas 2037             <term><keycap>=</keycap></term>
4093 18 Jan 08 enell 2038             <listitem>
4093 18 Jan 08 enell 2039               <simpara>
4093 18 Jan 08 enell 2040                 Equal to (useful to find items with a null value). Supports
4093 18 Jan 08 enell 2041                 filtering on more then one value.
4093 18 Jan 08 enell 2042               </simpara>
4093 18 Jan 08 enell 2043             </listitem>
3181 12 Mar 07 nicklas 2044           </varlistentry>
3181 12 Mar 07 nicklas 2045           <varlistentry>
3181 12 Mar 07 nicklas 2046             <term><keycap>&lt;&gt;</keycap></term>
3181 12 Mar 07 nicklas 2047             <term><keycap>!=</keycap></term>
4093 18 Jan 08 enell 2048             <listitem>
4093 18 Jan 08 enell 2049               <simpara>
4093 18 Jan 08 enell 2050                 Not equal to (useful to find items with a non-null value). Supports
4093 18 Jan 08 enell 2051                 filtering on more then one value.
4093 18 Jan 08 enell 2052               </simpara>
4093 18 Jan 08 enell 2053             </listitem>
3181 12 Mar 07 nicklas 2054           </varlistentry>
4093 18 Jan 08 enell 2055           <varlistentry>
4093 18 Jan 08 enell 2056             <term><keycap>==</keycap></term>
4093 18 Jan 08 enell 2057             <listitem>
4093 18 Jan 08 enell 2058               <simpara>
4711 18 Dec 08 nicklas 2059                 Same as <keycap>=</keycap> but interprets <quote>|</quote>, <quote>%</quote> 
4711 18 Dec 08 nicklas 2060                 and other special characters literally. Use this when you need an exact 
4711 18 Dec 08 nicklas 2061                 string match.
4093 18 Jan 08 enell 2062               </simpara>
4093 18 Jan 08 enell 2063             </listitem>
4093 18 Jan 08 enell 2064           </varlistentry>
5817 21 Oct 11 nicklas 2065           <varlistentry>
5817 21 Oct 11 nicklas 2066             <term><keycap>&gt;&lt;</keycap></term>
5817 21 Oct 11 nicklas 2067             <listitem>
5817 21 Oct 11 nicklas 2068               <simpara>
5817 21 Oct 11 nicklas 2069                 Within a range. Two values separated by <quote>|</quote> are required.
5817 21 Oct 11 nicklas 2070                 For example, <code>&gt;&lt;10|20</code> to find values between 10 
5817 21 Oct 11 nicklas 2071                 and 20 (inclusive).
5817 21 Oct 11 nicklas 2072               </simpara>
5817 21 Oct 11 nicklas 2073             </listitem>
5817 21 Oct 11 nicklas 2074           </varlistentry>
3181 12 Mar 07 nicklas 2075         </variablelist>
4561 06 Oct 08 nicklas 2076         
7341 18 Apr 17 nicklas 2077         <variablelist id="webclient.itemlist.filter.special">
7341 18 Apr 17 nicklas 2078           <title>Other special characers used by the free-text filter</title>
7341 18 Apr 17 nicklas 2079           <varlistentry>
7341 18 Apr 17 nicklas 2080             <term><keycap>¤</keycap></term>
7341 18 Apr 17 nicklas 2081             <listitem>
7341 18 Apr 17 nicklas 2082               <simpara>Can be used as a suffix in annotation columns where
7341 18 Apr 17 nicklas 2083               the annotation type supports project-specific annotations. 
7341 18 Apr 17 nicklas 2084               When present, the filter will only match items that:
7341 18 Apr 17 nicklas 2085               
7341 18 Apr 17 nicklas 2086               <orderedlist>
7341 18 Apr 17 nicklas 2087                 <listitem>
7341 18 Apr 17 nicklas 2088                 Has a default value (can be any value).
7341 18 Apr 17 nicklas 2089                 </listitem>
7341 18 Apr 17 nicklas 2090                 <listitem>
7341 18 Apr 17 nicklas 2091                 Has a project-specific annotation that matches the filter.
7341 18 Apr 17 nicklas 2092                 </listitem>
7341 18 Apr 17 nicklas 2093               </orderedlist>
7341 18 Apr 17 nicklas 2094               <informalexample>=10¤</informalexample> matches items that
7341 18 Apr 17 nicklas 2095               have a default value (any) and a project-specific annotation
7341 18 Apr 17 nicklas 2096               with the value 10.
7341 18 Apr 17 nicklas 2097               <informalexample>&lt;&gt;¤</informalexample> matches 
7341 18 Apr 17 nicklas 2098               all items that has a project-specific value overriding the 
7341 18 Apr 17 nicklas 2099               default.
7341 18 Apr 17 nicklas 2100               </simpara>
7341 18 Apr 17 nicklas 2101               
7341 18 Apr 17 nicklas 2102               <note>
7341 18 Apr 17 nicklas 2103                 Just because an item has a project-specific annotation
7341 18 Apr 17 nicklas 2104                 there is no guarantee that the value is actually different
7341 18 Apr 17 nicklas 2105                 from the default value.
7341 18 Apr 17 nicklas 2106               </note>
7341 18 Apr 17 nicklas 2107               
7341 18 Apr 17 nicklas 2108             </listitem>
7341 18 Apr 17 nicklas 2109           </varlistentry>
7341 18 Apr 17 nicklas 2110         </variablelist>
7341 18 Apr 17 nicklas 2111         
6708 02 Feb 15 nicklas 2112         <sect3 id="webclient.itemlist.filter.extending">
6708 02 Feb 15 nicklas 2113           <title>Extending the search with multiple filter rows</title>
6708 02 Feb 15 nicklas 2114           <para>
6708 02 Feb 15 nicklas 2115           Most list pages allows you to add more than one filter row by clicking on the 
6708 02 Feb 15 nicklas 2116             <guiicon>
6708 02 Feb 15 nicklas 2117               <inlinemediaobject>
6708 02 Feb 15 nicklas 2118                 <imageobject>
6708 02 Feb 15 nicklas 2119                   <imagedata fileref="figures/add.png" format="PNG" />
6708 02 Feb 15 nicklas 2120                 </imageobject>
6708 02 Feb 15 nicklas 2121               </inlinemediaobject>
6708 02 Feb 15 nicklas 2122             </guiicon> icon at the start of the row. Each filter row is an independent filter set
6708 02 Feb 15 nicklas 2123             that extends the search result with more items (eg. it is logically equivalent to an OR 
6708 02 Feb 15 nicklas 2124             condition). 
6708 02 Feb 15 nicklas 2125           </para>
6708 02 Feb 15 nicklas 2126           
6708 02 Feb 15 nicklas 2127           <para>
6708 02 Feb 15 nicklas 2128             Use the
6708 02 Feb 15 nicklas 2129             <guiicon>
6708 02 Feb 15 nicklas 2130               <inlinemediaobject>
6708 02 Feb 15 nicklas 2131                 <imageobject>
6708 02 Feb 15 nicklas 2132                   <imagedata fileref="figures/remove.png" format="PNG" />
6708 02 Feb 15 nicklas 2133                 </imageobject>
6708 02 Feb 15 nicklas 2134               </inlinemediaobject>
6708 02 Feb 15 nicklas 2135             </guiicon> icon to remove an existing filter row.
6708 02 Feb 15 nicklas 2136           </para>
6708 02 Feb 15 nicklas 2137         </sect3>
6708 02 Feb 15 nicklas 2138         
4561 06 Oct 08 nicklas 2139         <sect3 id="webclient.itemlist.filter.units">
4561 06 Oct 08 nicklas 2140           <title>Units</title>
4561 06 Oct 08 nicklas 2141           <para>
4561 06 Oct 08 nicklas 2142             Some (numeric) columns have values with units. There are, for example,
4561 06 Oct 08 nicklas 2143             the <emphasis>Original quantity</emphasis> and <emphasis>Remaining quantity</emphasis>
4561 06 Oct 08 nicklas 2144             columns for biomaterials, which have values in micrograms (µg), and 
4561 06 Oct 08 nicklas 2145             annotations which may have any unit.
4561 06 Oct 08 nicklas 2146           </para>
4561 06 Oct 08 nicklas 2147           <para>
4561 06 Oct 08 nicklas 2148             When filtering on a column that has a unit, numeric values without units are
4561 06 Oct 08 nicklas 2149             interpreted as the default unit for that column. But it is also possible to
4561 06 Oct 08 nicklas 2150             add a unit to the filter value. The examples below are filtering on the
4561 06 Oct 08 nicklas 2151             original quantity column of a biomaterial:
4561 06 Oct 08 nicklas 2152           </para>
4561 06 Oct 08 nicklas 2153           <para>
4561 06 Oct 08 nicklas 2154             <informalexample>&gt;=0.5mg</informalexample> matches biomaterials with
4561 06 Oct 08 nicklas 2155             an original quantity &gt;=500µg.
4561 06 Oct 08 nicklas 2156           </para>
4561 06 Oct 08 nicklas 2157           <para>
4561 06 Oct 08 nicklas 2158             <informalexample>=100|200|300µg</informalexample> matches biomaterials with
4561 06 Oct 08 nicklas 2159             exactly 100, 200 or 300 micrograms.
4561 06 Oct 08 nicklas 2160           </para>
4561 06 Oct 08 nicklas 2161           <para>
4561 06 Oct 08 nicklas 2162             It is also possible to mix units in a single filter:
4561 06 Oct 08 nicklas 2163             <informalexample>=100|200|300µg|0.5|1mg</informalexample> which matches
4561 06 Oct 08 nicklas 2164             100, 200, 300, 500 and 1000 micrograms.
4561 06 Oct 08 nicklas 2165           </para>
4561 06 Oct 08 nicklas 2166           
4561 06 Oct 08 nicklas 2167           <warning>
4561 06 Oct 08 nicklas 2168             <title>Be aware of rounding errors</title>
4561 06 Oct 08 nicklas 2169             <para>
4561 06 Oct 08 nicklas 2170               All filter values with a unit that is different from the default
4561 06 Oct 08 nicklas 2171               unit are converted to the default unit before being applied. Since
4561 06 Oct 08 nicklas 2172               numeric conversions are never exact down to the last decimal, this may 
4561 06 Oct 08 nicklas 2173               result in problems to filter with an exact match. The last example above
4561 06 Oct 08 nicklas 2174               could, for example, be converted to: 100, 200, 300, 500.000001 and
4561 06 Oct 08 nicklas 2175               999.99999998.
4561 06 Oct 08 nicklas 2176             </para>
4561 06 Oct 08 nicklas 2177           </warning>
4565 07 Oct 08 nicklas 2178           
4565 07 Oct 08 nicklas 2179           <tip>
4565 07 Oct 08 nicklas 2180             <title>Hard-to-type characters</title>
4565 07 Oct 08 nicklas 2181             <para>
4565 07 Oct 08 nicklas 2182               Some units contains hard-to-type characters. For example,
4565 07 Oct 08 nicklas 2183               the greek letter µ in µg, and m² and m³ for areas and volumes.
4565 07 Oct 08 nicklas 2184               In all those cases it is also possible to use ug, m2 and m3, 
4565 07 Oct 08 nicklas 2185               respectively.
4565 07 Oct 08 nicklas 2186             </para>
4565 07 Oct 08 nicklas 2187           </tip>
4565 07 Oct 08 nicklas 2188           
4565 07 Oct 08 nicklas 2189           <note>
4565 07 Oct 08 nicklas 2190             <title>Units are case-sensitive</title>
4565 07 Oct 08 nicklas 2191             <para>
4565 07 Oct 08 nicklas 2192               All units are case sensitive. The main reason for this is that
4565 07 Oct 08 nicklas 2193               it must be possible to tell the difference between 
4565 07 Oct 08 nicklas 2194               <emphasis>milli (m)</emphasis> and <emphasis>mega (M)</emphasis> 
4565 07 Oct 08 nicklas 2195               prefixes, for example, <emphasis>mJ</emphasis> and <emphasis>MJ</emphasis>.
4565 07 Oct 08 nicklas 2196             </para>
4565 07 Oct 08 nicklas 2197           </note>
4565 07 Oct 08 nicklas 2198           
4561 06 Oct 08 nicklas 2199         </sect3>
3181 12 Mar 07 nicklas 2200       </sect2>
3181 12 Mar 07 nicklas 2201       
3181 12 Mar 07 nicklas 2202       <sect2 id="webclient.itemlist.columns">
3181 12 Mar 07 nicklas 2203         <title>Configuring which columns to show</title>
3181 12 Mar 07 nicklas 2204         
3181 12 Mar 07 nicklas 2205         <para>
3181 12 Mar 07 nicklas 2206           Most lists show only a small subset of the columns it
7086 02 Mar 16 nicklas 2207           is capable of showing. There are several ways to change
7086 02 Mar 16 nicklas 2208           which columns that are visible and in which order.
3181 12 Mar 07 nicklas 2209         </para>
3181 12 Mar 07 nicklas 2210         
7086 02 Mar 16 nicklas 2211         <itemizedlist>
7086 02 Mar 16 nicklas 2212           <listitem>
7086 02 Mar 16 nicklas 2213             <para>
7086 02 Mar 16 nicklas 2214               Right-click on any column header. This will bring up a
7086 02 Mar 16 nicklas 2215               context-sensitive menu containing all possible columns.
7086 02 Mar 16 nicklas 2216               Select a column in the menu to show it. It will be inserted 
7086 02 Mar 16 nicklas 2217               right after the column that was right-clicked.
7086 02 Mar 16 nicklas 2218               If the selected column is already visible it is hidden instead.
7086 02 Mar 16 nicklas 2219             </para>
7086 02 Mar 16 nicklas 2220           </listitem>
7086 02 Mar 16 nicklas 2221           
7086 02 Mar 16 nicklas 2222           <listitem>
7086 02 Mar 16 nicklas 2223             <para>
7086 02 Mar 16 nicklas 2224               When hovering with the mouse inside a column header, an
7086 02 Mar 16 nicklas 2225               <guilabel>×</guilabel> is displayed in the top right
7086 02 Mar 16 nicklas 2226               corner. Click the <guilabel>×</guilabel> to hide the column.
7086 02 Mar 16 nicklas 2227             </para>
7086 02 Mar 16 nicklas 2228           </listitem>
7086 02 Mar 16 nicklas 2229           
7086 02 Mar 16 nicklas 2230           <listitem>
7086 02 Mar 16 nicklas 2231             <para>
7086 02 Mar 16 nicklas 2232               It is possible to drag columns to change their order.
7086 02 Mar 16 nicklas 2233               When hovering with the mouse inside a column header,
7086 02 Mar 16 nicklas 2234               left-click the mouse and hold it. Move the mouse 
7086 02 Mar 16 nicklas 2235               to another column either to the left or right and release
7086 02 Mar 16 nicklas 2236               the mouse button. The dragged column is moved to the location
7086 02 Mar 16 nicklas 2237               indicated by the black vertical bar.
7086 02 Mar 16 nicklas 2238             </para>
7086 02 Mar 16 nicklas 2239           </listitem>
7086 02 Mar 16 nicklas 2240
7086 02 Mar 16 nicklas 2241           <listitem>
7086 02 Mar 16 nicklas 2242             <para>
7086 02 Mar 16 nicklas 2243               Use the <guibutton>Columns&hellip;</guibutton> button to open 
7086 02 Mar 16 nicklas 2244               a dialog (see below) that allows you to select which columns to show
7086 02 Mar 16 nicklas 2245               and the order in which they are shown. This is the most
7086 02 Mar 16 nicklas 2246               powerful way to configure the columns and includes the possibility
7086 02 Mar 16 nicklas 2247               to save a certain configuration as a preset.
7086 02 Mar 16 nicklas 2248             </para>
7086 02 Mar 16 nicklas 2249           </listitem>
7086 02 Mar 16 nicklas 2250         </itemizedlist>
7086 02 Mar 16 nicklas 2251           
3181 12 Mar 07 nicklas 2252         <figure id="webclient.figures.configure_columns">
3181 12 Mar 07 nicklas 2253           <title>Configuring which columns to show</title>
3181 12 Mar 07 nicklas 2254           <screenshot>
3181 12 Mar 07 nicklas 2255           <mediaobject>
3181 12 Mar 07 nicklas 2256             <imageobject>
3348 16 May 07 nicklas 2257               <imagedata fileref="figures/configure_columns.png" format="PNG"/>
3181 12 Mar 07 nicklas 2258             </imageobject>
3181 12 Mar 07 nicklas 2259           </mediaobject>
3181 12 Mar 07 nicklas 2260           </screenshot>
3181 12 Mar 07 nicklas 2261         </figure>
3181 12 Mar 07 nicklas 2262         
3295 07 May 07 nicklas 2263         <helptext external_id="columns.configure" 
3295 07 May 07 nicklas 2264           title="Set column order and visiblity">
3181 12 Mar 07 nicklas 2265         
3295 07 May 07 nicklas 2266         <variablelist>
3295 07 May 07 nicklas 2267         <varlistentry>
3295 07 May 07 nicklas 2268           <term><guilabel>Visible columns</guilabel></term>
3295 07 May 07 nicklas 2269           <listitem>
3295 07 May 07 nicklas 2270             <para>
3295 07 May 07 nicklas 2271               Shows the columns that are currently visible.
3295 07 May 07 nicklas 2272               Use the up/down arrow buttons to arrange the order of the 
3295 07 May 07 nicklas 2273               visible columns. The topmost column is shown to the left. 
3295 07 May 07 nicklas 2274               Use the right arrow button to move columns from this list
3295 07 May 07 nicklas 2275               to the hidden columns list. Columns marked with an <guilabel>×</guilabel> 
3295 07 May 07 nicklas 2276               are required
3487 13 Jun 07 peter 2277               and cannot be hidden. In most lists the <guilabel>Name</guilabel> column
3295 07 May 07 nicklas 2278               is the only column that is required.
3295 07 May 07 nicklas 2279             </para>
3295 07 May 07 nicklas 2280           </listitem>
3295 07 May 07 nicklas 2281         </varlistentry>
3295 07 May 07 nicklas 2282           
3295 07 May 07 nicklas 2283         <varlistentry>
3295 07 May 07 nicklas 2284           <term><guilabel>Hidden columns</guilabel></term>
3295 07 May 07 nicklas 2285           <listitem>
3295 07 May 07 nicklas 2286             <para>
3295 07 May 07 nicklas 2287               Shows columns that are not currently visible in the
3295 07 May 07 nicklas 2288               list. Use the left arrow button to move columns from
3295 07 May 07 nicklas 2289               this list to the visible columns list.
3295 07 May 07 nicklas 2290             </para>
3295 07 May 07 nicklas 2291           </listitem>
3295 07 May 07 nicklas 2292         </varlistentry>
3181 12 Mar 07 nicklas 2293         
3295 07 May 07 nicklas 2294         <varlistentry>
7982 14 Jun 21 nicklas 2295           <term><guilabel>Sticky column</guilabel></term>
7982 14 Jun 21 nicklas 2296           <listitem>
7982 14 Jun 21 nicklas 2297             <para>
7982 14 Jun 21 nicklas 2298               In most lists one column can be selected to be <emphasis>sticky</emphasis>,
7982 14 Jun 21 nicklas 2299               which means that it will always be visible and stick to either the left or right
7982 14 Jun 21 nicklas 2300               side of the browser window when scrolling would take outside the visible area.
7982 14 Jun 21 nicklas 2301               In most lists the <guilabel>Name</guilabel> column is the default sticky
7982 14 Jun 21 nicklas 2302               column.
7982 14 Jun 21 nicklas 2303             </para>
7982 14 Jun 21 nicklas 2304           </listitem>
7982 14 Jun 21 nicklas 2305         </varlistentry>
7982 14 Jun 21 nicklas 2306                 
7982 14 Jun 21 nicklas 2307         <varlistentry>
3295 07 May 07 nicklas 2308           <term><guilabel>Presets</guilabel></term>
3295 07 May 07 nicklas 2309           <listitem>
3295 07 May 07 nicklas 2310             <para>
3295 07 May 07 nicklas 2311               A dropdown list that allows you to
3295 07 May 07 nicklas 2312               select a set of preconfigured columns. You may also create 
3295 07 May 07 nicklas 2313               your own preset if you often need to switch between different
3295 07 May 07 nicklas 2314               configurations. The list of presets is the same as the one
3295 07 May 07 nicklas 2315               described <link linkend="webclient.itemlist.presets">below</link>, 
5684 02 Aug 11 nicklas 2316               but if used from this dialog the presets only affects the visible columns
5684 02 Aug 11 nicklas 2317               and not filters or sort order.
3295 07 May 07 nicklas 2318             </para>
3295 07 May 07 nicklas 2319           </listitem>
3295 07 May 07 nicklas 2320         </varlistentry>
6709 02 Feb 15 nicklas 2321
6709 02 Feb 15 nicklas 2322         <varlistentry>
6709 02 Feb 15 nicklas 2323           <term><guilabel>Add inherited annotations...</guilabel></term>
6709 02 Feb 15 nicklas 2324           <listitem>
6709 02 Feb 15 nicklas 2325             <para>
6709 02 Feb 15 nicklas 2326               Used for adding columns representing annotations that are inherited from parent items.
6709 02 Feb 15 nicklas 2327               Since a system may define a lot of different annotation types, there are no pre-defined
6709 02 Feb 15 nicklas 2328               columns that represent inherited annotations. Clicking on the buttons opens a
6709 02 Feb 15 nicklas 2329               dialog that allows you to select any annotation type that you have access to. Selected
6709 02 Feb 15 nicklas 2330               columns will be marked with <guilabel>[I]</guilabel> after their names.
6709 02 Feb 15 nicklas 2331             </para>
6709 02 Feb 15 nicklas 2332             
6709 02 Feb 15 nicklas 2333             <note>
6709 02 Feb 15 nicklas 2334               <title>Not all items can inherit annotations</title>
6709 02 Feb 15 nicklas 2335               <para>
6709 02 Feb 15 nicklas 2336                 This functionality is of course only available in lists that display
6709 02 Feb 15 nicklas 2337                 item that can inherit annotations. For more information about
6709 02 Feb 15 nicklas 2338                 inheriting annotations see <xref linkend="annotations.inheriting" />.
6709 02 Feb 15 nicklas 2339               </para>
6709 02 Feb 15 nicklas 2340             </note>
6709 02 Feb 15 nicklas 2341             
6709 02 Feb 15 nicklas 2342           </listitem>
6709 02 Feb 15 nicklas 2343         </varlistentry>
6709 02 Feb 15 nicklas 2344
7847 08 Sep 20 nicklas 2345         <varlistentry>
7847 08 Sep 20 nicklas 2346           <term><guilabel>Add parent or child item columns...</guilabel></term>
7847 08 Sep 20 nicklas 2347           <listitem>
7847 08 Sep 20 nicklas 2348             <para>
7847 08 Sep 20 nicklas 2349               This function can be used to add columns that display data from
7847 08 Sep 20 nicklas 2350               a parent or child items. The function is enabled for biosources,
7847 08 Sep 20 nicklas 2351               samples, extracts, and the physical, derived and raw bioassays,
7847 08 Sep 20 nicklas 2352               and requires that items are classified with a subtype. 
7847 08 Sep 20 nicklas 2353             </para>
6709 02 Feb 15 nicklas 2354
7847 08 Sep 20 nicklas 2355           </listitem>
7847 08 Sep 20 nicklas 2356         </varlistentry>
7847 08 Sep 20 nicklas 2357
3295 07 May 07 nicklas 2358         </variablelist>
3181 12 Mar 07 nicklas 2359         
3295 07 May 07 nicklas 2360           <para>
3394 28 May 07 martin 2361             Use the &gbSave; button to apply your
3394 28 May 07 martin 2362             changes or the &gbCancel; button to
4487 08 Sep 08 jari 2363             close the pop-up without saving.
3295 07 May 07 nicklas 2364           </para>
7847 08 Sep 20 nicklas 2365           
7847 08 Sep 20 nicklas 2366           <seeother>
7847 08 Sep 20 nicklas 2367             <other external_id="columns.configure.add_relateditem_column"
7847 08 Sep 20 nicklas 2368               >Add parent or child item columns</other>
7847 08 Sep 20 nicklas 2369           </seeother>
3295 07 May 07 nicklas 2370
3295 07 May 07 nicklas 2371         </helptext>
3295 07 May 07 nicklas 2372
3181 12 Mar 07 nicklas 2373       </sect2>
3181 12 Mar 07 nicklas 2374       
7847 08 Sep 20 nicklas 2375       <sect2 id="webclient.itemlist.relateditem-columns">
7847 08 Sep 20 nicklas 2376         <title>Parent and child item columns</title>
7847 08 Sep 20 nicklas 2377         
7847 08 Sep 20 nicklas 2378         <figure id="webclient.figures.configure_relateditem_columns">
7847 08 Sep 20 nicklas 2379           <title>Add parent and child item columns</title>
7847 08 Sep 20 nicklas 2380           <screenshot>
7847 08 Sep 20 nicklas 2381           <mediaobject>
7847 08 Sep 20 nicklas 2382             <imageobject>
7847 08 Sep 20 nicklas 2383               <imagedata fileref="figures/configure_relateditems_columns.png" format="PNG"/>
7847 08 Sep 20 nicklas 2384             </imageobject>
7847 08 Sep 20 nicklas 2385           </mediaobject>
7847 08 Sep 20 nicklas 2386           </screenshot>
7847 08 Sep 20 nicklas 2387         </figure>
7847 08 Sep 20 nicklas 2388         
7847 08 Sep 20 nicklas 2389         <helptext external_id="columns.configure.add_relateditem_column" 
7847 08 Sep 20 nicklas 2390           title="Add parent and child item columns">
7847 08 Sep 20 nicklas 2391         
7847 08 Sep 20 nicklas 2392         <variablelist>
7847 08 Sep 20 nicklas 2393         <varlistentry>
8083 20 Oct 22 nicklas 2394           <term><guilabel>Parent/child</guilabel></term>
7847 08 Sep 20 nicklas 2395           <listitem>
7847 08 Sep 20 nicklas 2396             <para>
7847 08 Sep 20 nicklas 2397               Select the main item type of the parent or child items. This list
7847 08 Sep 20 nicklas 2398               will have different options depending on the current context.
7847 08 Sep 20 nicklas 2399             </para>
7847 08 Sep 20 nicklas 2400           </listitem>
7847 08 Sep 20 nicklas 2401         </varlistentry>
7847 08 Sep 20 nicklas 2402         
7847 08 Sep 20 nicklas 2403         <varlistentry>
7847 08 Sep 20 nicklas 2404           <term><guilabel>Subtype</guilabel></term>
7847 08 Sep 20 nicklas 2405           <listitem>
7847 08 Sep 20 nicklas 2406             <para>
7847 08 Sep 20 nicklas 2407               This list will automatically be updated with all available subtypes
8083 20 Oct 22 nicklas 2408               for the selected parent or child item type. It is not possible to select 
8083 20 Oct 22 nicklas 2409               items without a subtype.
7847 08 Sep 20 nicklas 2410             </para>
7847 08 Sep 20 nicklas 2411           </listitem>
7847 08 Sep 20 nicklas 2412         </varlistentry>
8083 20 Oct 22 nicklas 2413         
8083 20 Oct 22 nicklas 2414         <varlistentry>
8083 20 Oct 22 nicklas 2415           <term><guilabel>with link to</guilabel></term>
8083 20 Oct 22 nicklas 2416           <listitem>
8083 20 Oct 22 nicklas 2417             <para>
8083 20 Oct 22 nicklas 2418               This is an optional selection that is only available if a parent item type has
8083 20 Oct 22 nicklas 2419               been selected in the left list. In this list is possible to select
8083 20 Oct 22 nicklas 2420               an item type that should be a child type of the selected parent type.
8083 20 Oct 22 nicklas 2421               A subtype for the child item must also be selected.
8083 20 Oct 22 nicklas 2422             </para>
8083 20 Oct 22 nicklas 2423           </listitem>
8083 20 Oct 22 nicklas 2424         </varlistentry>
8094 04 Nov 22 nicklas 2425         
8094 04 Nov 22 nicklas 2426         <varlistentry>
8094 04 Nov 22 nicklas 2427           <term><guilabel>Allow doubling back</guilabel></term>
8094 04 Nov 22 nicklas 2428           <listitem>
8094 04 Nov 22 nicklas 2429             <para>        
8094 04 Nov 22 nicklas 2430               The normal operation when both a parent and child selection 
8094 04 Nov 22 nicklas 2431               has been made is that the path used when going up to the parent 
8094 04 Nov 22 nicklas 2432               is ignored when going down to the child. If this option is checked
8094 04 Nov 22 nicklas 2433               then it is allowed to "double back" the same path also when going
8094 04 Nov 22 nicklas 2434               down to the child item.
8094 04 Nov 22 nicklas 2435             </para>
8094 04 Nov 22 nicklas 2436           </listitem>
8094 04 Nov 22 nicklas 2437         </varlistentry>
7847 08 Sep 20 nicklas 2438
7847 08 Sep 20 nicklas 2439         <varlistentry>
8083 20 Oct 22 nicklas 2440           <term><guilabel>Columns/Annotations/Extensions</guilabel></term>
7847 08 Sep 20 nicklas 2441           <listitem>
7847 08 Sep 20 nicklas 2442             <para>
8083 20 Oct 22 nicklas 2443               When the parent/child selection contains a valid combination,
8083 20 Oct 22 nicklas 2444               the table will display all possible columns that can be selected
8083 20 Oct 22 nicklas 2445               and added to the table. Most regular properties such as
7847 08 Sep 20 nicklas 2446               <guilabel>Name</guilabel> and <guilabel>Registration date</guilabel>
8083 20 Oct 22 nicklas 2447               can be selected and are displayed in the <guilabel>Columns</guilabel>
8083 20 Oct 22 nicklas 2448               column. All annotation types that has been defined and linked to the 
8083 20 Oct 22 nicklas 2449               selected subtype are displayed in the <guilabel>Annotations</guilabel>
8083 20 Oct 22 nicklas 2450               column. It is also possible for external extensions to add more columns
8083 20 Oct 22 nicklas 2451               that can be selected in the <guilabel>Extensions</guilabel> column.
7847 08 Sep 20 nicklas 2452             </para>
7847 08 Sep 20 nicklas 2453           </listitem>
7847 08 Sep 20 nicklas 2454         </varlistentry>
7847 08 Sep 20 nicklas 2455         
7847 08 Sep 20 nicklas 2456         <varlistentry>
7847 08 Sep 20 nicklas 2457           <term><guilabel>Show annotations for all subtypes</guilabel></term>
7847 08 Sep 20 nicklas 2458           <listitem>
7847 08 Sep 20 nicklas 2459             <para>
7847 08 Sep 20 nicklas 2460               By default, only annotations that are linked to the
7847 08 Sep 20 nicklas 2461               selected subtype are included in the list. Enable this option
7847 08 Sep 20 nicklas 2462               to include all annotations that are enabled for the 
7847 08 Sep 20 nicklas 2463               selected main item type.
7847 08 Sep 20 nicklas 2464             </para>
7847 08 Sep 20 nicklas 2465           </listitem>
7847 08 Sep 20 nicklas 2466         </varlistentry>
7847 08 Sep 20 nicklas 2467
7847 08 Sep 20 nicklas 2468         </variablelist>
7847 08 Sep 20 nicklas 2469         
7847 08 Sep 20 nicklas 2470           <para>
7847 08 Sep 20 nicklas 2471             Use the <guibutton>Add</guibutton> button to add columns to the table. 
8083 20 Oct 22 nicklas 2472             It is possible change the parent/child item type and subtype to add more
8083 20 Oct 22 nicklas 2473             columns. When you are done, use the &gbClose; button to close the dialog.
7847 08 Sep 20 nicklas 2474           </para>
7847 08 Sep 20 nicklas 2475         
7847 08 Sep 20 nicklas 2476           <note>
7847 08 Sep 20 nicklas 2477             <title>Limitations for parent and child item columns</title>
7847 08 Sep 20 nicklas 2478             <para>
7847 08 Sep 20 nicklas 2479               While it is possible to display and filter by the values from the
7847 08 Sep 20 nicklas 2480               parent and child items, it is not possible to use them for sorting.
7847 08 Sep 20 nicklas 2481               This is because the values are not loaded immediately together with
7847 08 Sep 20 nicklas 2482               the rest of the table. Instead, there are placeholders that will be
7847 08 Sep 20 nicklas 2483               filled with values later. This is usually quick, but may take several
7847 08 Sep 20 nicklas 2484               seconds depending on the amount of intermediate steps between the
7847 08 Sep 20 nicklas 2485               parent and child items.
7847 08 Sep 20 nicklas 2486             </para>
7847 08 Sep 20 nicklas 2487           </note>
7847 08 Sep 20 nicklas 2488         
7847 08 Sep 20 nicklas 2489         </helptext>        
7847 08 Sep 20 nicklas 2490       </sect2>
7847 08 Sep 20 nicklas 2491       
3181 12 Mar 07 nicklas 2492       <sect2 id="webclient.itemlist.presets">
3181 12 Mar 07 nicklas 2493         <title>Presets</title>
3181 12 Mar 07 nicklas 2494         
3181 12 Mar 07 nicklas 2495         <para>
3181 12 Mar 07 nicklas 2496           The <guilabel>view / presets</guilabel> dropdown has three
3197 19 Mar 07 nicklas 2497           main functions:
3181 12 Mar 07 nicklas 2498         </para>
3181 12 Mar 07 nicklas 2499         
5791 07 Oct 11 nicklas 2500         <figure id="webclient.figures.viewpresets" float="right">
3197 19 Mar 07 nicklas 2501           <title>The view / presets dropdown</title>
3197 19 Mar 07 nicklas 2502           <screenshot>
3197 19 Mar 07 nicklas 2503             <mediaobject>
3346 16 May 07 nicklas 2504               <imageobject><imagedata fileref="figures/view_presets.png" format="PNG" 
3346 16 May 07 nicklas 2505                 /></imageobject>
3197 19 Mar 07 nicklas 2506             </mediaobject>
3197 19 Mar 07 nicklas 2507           </screenshot>
3197 19 Mar 07 nicklas 2508         </figure>
3181 12 Mar 07 nicklas 2509         <orderedlist>
3181 12 Mar 07 nicklas 2510           <listitem>
3181 12 Mar 07 nicklas 2511             <para>
3181 12 Mar 07 nicklas 2512               Switch between different configuration presets.
3197 19 Mar 07 nicklas 2513               The top of the dropdown contains user-defined presets (<guilabel>Saved preset #1</guilabel> and 
3197 19 Mar 07 nicklas 2514               <guilabel>#2</guilabel>) and a few preconfigured presets. 
3197 19 Mar 07 nicklas 2515               The user-defined presets are used to store a complete table configuration,
3197 19 Mar 07 nicklas 2516               including:
3181 12 Mar 07 nicklas 2517             </para>
3181 12 Mar 07 nicklas 2518             
3197 19 Mar 07 nicklas 2519             <itemizedlist>
3320 10 May 07 martin 2520               <listitem><simpara>Which columns are visible and their order</simpara></listitem>
3320 10 May 07 martin 2521               <listitem><simpara>The column (or columns) used for sorting</simpara></listitem>
3320 10 May 07 martin 2522               <listitem><simpara>Filter settings</simpara></listitem>
3320 10 May 07 martin 2523               <listitem><simpara>The number of items per page and the current page</simpara></listitem>
3197 19 Mar 07 nicklas 2524             </itemizedlist>
3197 19 Mar 07 nicklas 2525             
3197 19 Mar 07 nicklas 2526             <para>              
3197 19 Mar 07 nicklas 2527               The preconfigured presets only affects
3181 12 Mar 07 nicklas 2528               the visible columns as follows:
3181 12 Mar 07 nicklas 2529             </para>
3181 12 Mar 07 nicklas 2530             
3181 12 Mar 07 nicklas 2531             <itemizedlist>
3181 12 Mar 07 nicklas 2532               <listitem>
3197 19 Mar 07 nicklas 2533                 <para><guilabel>All columns</guilabel> - Show all columns.</para>
3181 12 Mar 07 nicklas 2534               </listitem>
3181 12 Mar 07 nicklas 2535               <listitem>
3197 19 Mar 07 nicklas 2536                 <para><guilabel>Required columns</guilabel> - Show only the required columns. 
3197 19 Mar 07 nicklas 2537                   Usually only the <guilabel>Name</guilabel> column is required.</para>
3181 12 Mar 07 nicklas 2538               </listitem>
3181 12 Mar 07 nicklas 2539               <listitem>
3197 19 Mar 07 nicklas 2540                 <para><guilabel>Default columns</guilabel> - Show the default set of columns.</para>
3181 12 Mar 07 nicklas 2541               </listitem>
3181 12 Mar 07 nicklas 2542               <listitem>
3181 12 Mar 07 nicklas 2543                 <para><guilabel>Other&hellip;</guilabel> - 
3791 26 Sep 07 martin 2544                   Open the configure columns dialog box, described in 
3791 26 Sep 07 martin 2545                   <xref linkend="webclient.itemlist.columns"/>.</para>
3181 12 Mar 07 nicklas 2546               </listitem>
3181 12 Mar 07 nicklas 2547             </itemizedlist>
3181 12 Mar 07 nicklas 2548             
3197 19 Mar 07 nicklas 2549           </listitem>
3197 19 Mar 07 nicklas 2550           
3197 19 Mar 07 nicklas 2551           <listitem>
3181 12 Mar 07 nicklas 2552             <para>
3197 19 Mar 07 nicklas 2553               Filter items by the removed status and the access
3197 19 Mar 07 nicklas 2554               permissions to an item.
3181 12 Mar 07 nicklas 2555             </para>
3197 19 Mar 07 nicklas 2556             
3197 19 Mar 07 nicklas 2557             <itemizedlist>
3197 19 Mar 07 nicklas 2558               <listitem>
3197 19 Mar 07 nicklas 2559                 <para><guilabel>Removed</guilabel> - If checked, items that have been
3295 07 May 07 nicklas 2560                 moved to the trashcan are shown, otherwise they are hidden.</para>
3197 19 Mar 07 nicklas 2561               </listitem>
3197 19 Mar 07 nicklas 2562               <listitem>
3197 19 Mar 07 nicklas 2563                 <para><guilabel>Owned by me</guilabel> - If checked, items that the logged in user
3197 19 Mar 07 nicklas 2564                 owns are displayed, otherwise they are hidden.</para>
3197 19 Mar 07 nicklas 2565               </listitem>
3197 19 Mar 07 nicklas 2566               <listitem>
3197 19 Mar 07 nicklas 2567                 <para><guilabel>Shared to me</guilabel> - If checked, items that are owned
3197 19 Mar 07 nicklas 2568                 by other users but shared to the logged in user are displayed, otherwise 
3197 19 Mar 07 nicklas 2569                 they are hidden.</para>
3197 19 Mar 07 nicklas 2570               </listitem>
3197 19 Mar 07 nicklas 2571               <listitem>
3197 19 Mar 07 nicklas 2572                 <para><guilabel>In current project</guilabel> - 
3197 19 Mar 07 nicklas 2573                   If checked, items that are linked with the current project are displayed,
3487 13 Jun 07 peter 2574                   otherwise they are hidden. It does not matter if the logged in user is the
3197 19 Mar 07 nicklas 2575                   owner or not. This option is only available if a project is active.
3197 19 Mar 07 nicklas 2576                 </para>
3197 19 Mar 07 nicklas 2577               </listitem>
3197 19 Mar 07 nicklas 2578               <listitem>
3197 19 Mar 07 nicklas 2579                 <para><guilabel>Owned by others</guilabel> - 
3320 10 May 07 martin 2580                   This option is only available to administrators and will display
3197 19 Mar 07 nicklas 2581                   items that are owned by other users.
3197 19 Mar 07 nicklas 2582                 </para>
3197 19 Mar 07 nicklas 2583               </listitem>
3197 19 Mar 07 nicklas 2584             </itemizedlist>
3197 19 Mar 07 nicklas 2585             
3197 19 Mar 07 nicklas 2586             <para>
3295 07 May 07 nicklas 2587               The default is to display item that the current user
3295 07 May 07 nicklas 2588               owns and, if a project is active, items in that project.
3197 19 Mar 07 nicklas 2589             </para>
3197 19 Mar 07 nicklas 2590             
3181 12 Mar 07 nicklas 2591           </listitem>
3197 19 Mar 07 nicklas 2592
3197 19 Mar 07 nicklas 2593           <listitem>
3197 19 Mar 07 nicklas 2594             <para>
3197 19 Mar 07 nicklas 2595               Administrate the presets
3197 19 Mar 07 nicklas 2596             </para>
3197 19 Mar 07 nicklas 2597             <itemizedlist>
3197 19 Mar 07 nicklas 2598               <listitem>
3197 19 Mar 07 nicklas 2599                 <para><guilabel>Clear filter</guilabel> - Clears
3197 19 Mar 07 nicklas 2600                 all filters.</para>
3197 19 Mar 07 nicklas 2601               </listitem>
3197 19 Mar 07 nicklas 2602               
3197 19 Mar 07 nicklas 2603               <listitem>
3197 19 Mar 07 nicklas 2604                 <para><guilabel>Save as&hellip;</guilabel> - Save the
3197 19 Mar 07 nicklas 2605                 current configuration as a preset.</para>
3197 19 Mar 07 nicklas 2606               </listitem>
3197 19 Mar 07 nicklas 2607
3197 19 Mar 07 nicklas 2608               <listitem>
3197 19 Mar 07 nicklas 2609                 <para><guilabel>Manage&hellip;</guilabel> - Opens a dialog
3197 19 Mar 07 nicklas 2610                 where you can remove saved presets. You can also load
3197 19 Mar 07 nicklas 2611                 saved presets from the dialog, but it is quicker to just
3197 19 Mar 07 nicklas 2612                 use the dropdown list for this.</para>
3197 19 Mar 07 nicklas 2613               </listitem>
3197 19 Mar 07 nicklas 2614             </itemizedlist>
3197 19 Mar 07 nicklas 2615           </listitem>
3181 12 Mar 07 nicklas 2616         </orderedlist>
3221 02 Apr 07 nicklas 2617         
3295 07 May 07 nicklas 2618         <sect3 id="webclient.itemlist.presets.saveas">
3295 07 May 07 nicklas 2619           <title>Save a preset</title>
3221 02 Apr 07 nicklas 2620           
3221 02 Apr 07 nicklas 2621           <para>
3295 07 May 07 nicklas 2622             If you select the <guilabel>Save as&hellip;</guilabel>
3295 07 May 07 nicklas 2623             option from the <guilabel>view / presets</guilabel> dropdown
3295 07 May 07 nicklas 2624             the <guilabel>Save preset as</guilabel> dialog is opened.
3221 02 Apr 07 nicklas 2625           </para>
3221 02 Apr 07 nicklas 2626           
3295 07 May 07 nicklas 2627           <figure id="webclient.figures.savepresetas">
3295 07 May 07 nicklas 2628             <title>Save preset as</title>
3295 07 May 07 nicklas 2629             <screenshot>
3295 07 May 07 nicklas 2630               <mediaobject>
3348 16 May 07 nicklas 2631                 <imageobject><imagedata fileref="figures/save_preset.png" format="PNG" /></imageobject>
3295 07 May 07 nicklas 2632               </mediaobject>
3295 07 May 07 nicklas 2633             </screenshot>
3295 07 May 07 nicklas 2634           </figure>
3221 02 Apr 07 nicklas 2635           
3295 07 May 07 nicklas 2636           <helptext external_id="contexts.saveas" title="Save preset as">
3221 02 Apr 07 nicklas 2637           
3276 26 Apr 07 nicklas 2638           <variablelist>
3295 07 May 07 nicklas 2639           <varlistentry>
3295 07 May 07 nicklas 2640             <term><guilabel>For item</guilabel></term>
3295 07 May 07 nicklas 2641             <listitem>
3295 07 May 07 nicklas 2642               <para>
3295 07 May 07 nicklas 2643               The type of item the preset is saved for.
3295 07 May 07 nicklas 2644               </para>
3295 07 May 07 nicklas 2645             </listitem>
3295 07 May 07 nicklas 2646           </varlistentry>
3295 07 May 07 nicklas 2647           <varlistentry>
3295 07 May 07 nicklas 2648             <term><guilabel >Name</guilabel></term>
3295 07 May 07 nicklas 2649             <listitem>
3295 07 May 07 nicklas 2650               <para>
3295 07 May 07 nicklas 2651               The name of the preset. The name must be unique.
3295 07 May 07 nicklas 2652               </para>
3295 07 May 07 nicklas 2653             </listitem>
3295 07 May 07 nicklas 2654           </varlistentry>
3295 07 May 07 nicklas 2655           <varlistentry>
3295 07 May 07 nicklas 2656             <term><guilabel>Overwrite existing</guilabel></term>
3295 07 May 07 nicklas 2657             <listitem>
3295 07 May 07 nicklas 2658               <para>
3295 07 May 07 nicklas 2659               If a preset with the same name already exists, it is
3295 07 May 07 nicklas 2660               overwritten if this checkbox is checked.
3295 07 May 07 nicklas 2661               </para>
3295 07 May 07 nicklas 2662             </listitem>
3295 07 May 07 nicklas 2663           </varlistentry>
3295 07 May 07 nicklas 2664           <varlistentry>
3295 07 May 07 nicklas 2665             <term><guilabel>Public</guilabel></term>
3295 07 May 07 nicklas 2666             <listitem>
3295 07 May 07 nicklas 2667               <para>
3295 07 May 07 nicklas 2668               This options is only available for users
3295 07 May 07 nicklas 2669               which has the <emphasis>SHARE_TO_EVERYONE</emphasis>
3295 07 May 07 nicklas 2670               permission. If checked the preset is visible to
3295 07 May 07 nicklas 2671               all users.
3295 07 May 07 nicklas 2672               </para>
3295 07 May 07 nicklas 2673             </listitem>
3295 07 May 07 nicklas 2674           </varlistentry>
3276 26 Apr 07 nicklas 2675           </variablelist>
3295 07 May 07 nicklas 2676           
3295 07 May 07 nicklas 2677           <para>
3394 28 May 07 martin 2678             Use the &gbOk; button to save the preset
3394 28 May 07 martin 2679             or the &gbCancel; button to
4487 08 Sep 08 jari 2680             close the pop-up without saving.
3295 07 May 07 nicklas 2681           </para>
3295 07 May 07 nicklas 2682           
3295 07 May 07 nicklas 2683           
3295 07 May 07 nicklas 2684           </helptext>
3295 07 May 07 nicklas 2685           
3295 07 May 07 nicklas 2686         </sect3>
3276 26 Apr 07 nicklas 2687         
3295 07 May 07 nicklas 2688         <sect3 id="webclient.itemlist.presets.manage">
3295 07 May 07 nicklas 2689           <title>Manage presets</title>
3295 07 May 07 nicklas 2690           
3276 26 Apr 07 nicklas 2691           <para>
3295 07 May 07 nicklas 2692             If you select the <guilabel>Manage&hellip;</guilabel>
3295 07 May 07 nicklas 2693             option from the <guilabel>view / presets</guilabel> dropdown
3295 07 May 07 nicklas 2694             the <guilabel>Manage presets</guilabel> dialog is opened.
3276 26 Apr 07 nicklas 2695           </para>
3295 07 May 07 nicklas 2696           
3295 07 May 07 nicklas 2697           <figure id="webclient.figures.managepresets">
3295 07 May 07 nicklas 2698             <title>Manage presets</title>
3295 07 May 07 nicklas 2699             <screenshot>
3295 07 May 07 nicklas 2700               <mediaobject>
3348 16 May 07 nicklas 2701                 <imageobject><imagedata fileref="figures/manage_presets.png" format="PNG" /></imageobject>
3295 07 May 07 nicklas 2702               </mediaobject>
3295 07 May 07 nicklas 2703             </screenshot>
3295 07 May 07 nicklas 2704           </figure>
3295 07 May 07 nicklas 2705           
3295 07 May 07 nicklas 2706           <helptext external_id="contexts.manage" title="Manage presets">
3295 07 May 07 nicklas 2707           
3295 07 May 07 nicklas 2708           <para>
3295 07 May 07 nicklas 2709             From this dialog you can delete or load presets.
3295 07 May 07 nicklas 2710           </para>
3295 07 May 07 nicklas 2711           
3295 07 May 07 nicklas 2712           <para>
3295 07 May 07 nicklas 2713             To delete presets, first mark the checkbox in front of
3295 07 May 07 nicklas 2714             each preset you want to delete. Then, click on the
3295 07 May 07 nicklas 2715             <guibutton>Delete&hellip;</guibutton> button. You will get
3487 13 Jun 07 peter 2716             a warning about that the action cannot be undone. Unlike other
3295 07 May 07 nicklas 2717             items, the presets are not moved to the trashcan. Click on
3394 28 May 07 martin 2718             &gbOk; to delete the preset.
3295 07 May 07 nicklas 2719           </para>
3295 07 May 07 nicklas 2720           
3295 07 May 07 nicklas 2721           <note>
3295 07 May 07 nicklas 2722             <title>Edit a preset</title>
3320 10 May 07 martin 2723             <para>
3295 07 May 07 nicklas 2724             It is not possible to edit a preset directly. To change an
3295 07 May 07 nicklas 2725             existing preset you must:
3295 07 May 07 nicklas 2726             
3295 07 May 07 nicklas 2727             <orderedlist>
3320 10 May 07 martin 2728             <listitem><simpara>Load the preset.</simpara></listitem>
3320 10 May 07 martin 2729             <listitem><simpara>Use the interface to change column settings, filter, 
3320 10 May 07 martin 2730               sort order, etc.</simpara></listitem>
3320 10 May 07 martin 2731             <listitem><simpara>Save the preset with the same name.</simpara></listitem>
3295 07 May 07 nicklas 2732             </orderedlist>
3320 10 May 07 martin 2733             </para>
3295 07 May 07 nicklas 2734           </note>
3295 07 May 07 nicklas 2735           
3295 07 May 07 nicklas 2736           <para>
3394 28 May 07 martin 2737             Use the &gbClose; button to
4487 08 Sep 08 jari 2738             close the pop-up.
3295 07 May 07 nicklas 2739           </para>
3295 07 May 07 nicklas 2740           
3295 07 May 07 nicklas 2741           
3295 07 May 07 nicklas 2742           </helptext>
3295 07 May 07 nicklas 2743           
3295 07 May 07 nicklas 2744         </sect3>
3295 07 May 07 nicklas 2745         
3245 16 Apr 07 nicklas 2746       </sect2>
3181 12 Mar 07 nicklas 2747     </sect1>
3840 16 Oct 07 jari 2748
3840 16 Oct 07 jari 2749
3840 16 Oct 07 jari 2750     <sect1 id="webclient.trashcan">
5782 04 Oct 11 nicklas 2751       <?dbhtml filename="trashcan.html" ?>
3840 16 Oct 07 jari 2752       <title>Trashcan</title>
3840 16 Oct 07 jari 2753       <para>
3840 16 Oct 07 jari 2754         All items that have been deleted, and are owned by you, are
3840 16 Oct 07 jari 2755         listed in your trashcan. This list page is accessed with
3840 16 Oct 07 jari 2756         <menuchoice>
3840 16 Oct 07 jari 2757           <guimenu>View</guimenu>
3840 16 Oct 07 jari 2758           <guimenuitem>Trashcan</guimenuitem>
3840 16 Oct 07 jari 2759         </menuchoice>
3840 16 Oct 07 jari 2760         and it differs a bit from the other common list pages. The
3840 16 Oct 07 jari 2761         most significant difference is that the trashcan page can
3840 16 Oct 07 jari 2762         contain more then one item type, actually all removable item
4487 08 Sep 08 jari 2763         types in BASE can be listed in the trashcan. Items that neither
3840 16 Oct 07 jari 2764         can be removed or deleted, <emphasis>i.e.,</emphasis> items
3840 16 Oct 07 jari 2765         like sessions, nor clients' help texts since these are deleted
3840 16 Oct 07 jari 2766         from the database immediately in list/item view will be shown
3840 16 Oct 07 jari 2767         in the trashcan page.
3840 16 Oct 07 jari 2768       </para>
3840 16 Oct 07 jari 2769       <warning>
3840 16 Oct 07 jari 2770         <para>
3840 16 Oct 07 jari 2771           Some item types do not have any owner and these are listed
3840 16 Oct 07 jari 2772           in the trashcans for everyone with delete permission on that
3840 16 Oct 07 jari 2773           specific item type.
3840 16 Oct 07 jari 2774         </para>
3840 16 Oct 07 jari 2775       </warning>
3840 16 Oct 07 jari 2776
3840 16 Oct 07 jari 2777       <para>
3840 16 Oct 07 jari 2778         Things that the trashcan page have in common with other list
3840 16 Oct 07 jari 2779         pages are the possibility to restore and view/edit items, see
3840 16 Oct 07 jari 2780         <xref linkend="webclient.items.restore" /> and
3840 16 Oct 07 jari 2781         <xref linkend="webclient.items.edit" /> . If an item is
3840 16 Oct 07 jari 2782         restored, it will of course disappear from the trashcan.
3840 16 Oct 07 jari 2783       </para>
3840 16 Oct 07 jari 2784
3840 16 Oct 07 jari 2785       <sect2 id="webclient.trashcan.deleteitem">
3840 16 Oct 07 jari 2786         <title>Delete items permanently</title>
3840 16 Oct 07 jari 2787         <para>
3840 16 Oct 07 jari 2788           Items can be permanently deleted from BASE only if they are
3840 16 Oct 07 jari 2789           not used by other items.  Items that are used have the icon
3840 16 Oct 07 jari 2790           <inlinemediaobject>
3840 16 Oct 07 jari 2791             <imageobject>
5971 17 Feb 12 nicklas 2792               <imagedata fileref="figures/used.png" format="PNG" />
3840 16 Oct 07 jari 2793             </imageobject>
3840 16 Oct 07 jari 2794           </inlinemediaobject>
3840 16 Oct 07 jari 2795           in the first column and by clicking on it you can get more
3840 16 Oct 07 jari 2796           information about the dependencies, see
3840 16 Oct 07 jari 2797           <xref linkend="webclient.trashcan.viewdependencies" /> .
3840 16 Oct 07 jari 2798           <note>
3840 16 Oct 07 jari 2799             <simpara>
3840 16 Oct 07 jari 2800               This view is NOT the same view page as when clicking on
3840 16 Oct 07 jari 2801               the item's name, which brings you to the item's view
3840 16 Oct 07 jari 2802               page.
3840 16 Oct 07 jari 2803             </simpara>
3840 16 Oct 07 jari 2804           </note>
3840 16 Oct 07 jari 2805         </para>
3840 16 Oct 07 jari 2806         <para>
3840 16 Oct 07 jari 2807           To delete one or several items permanently from the trashcan
3840 16 Oct 07 jari 2808           you first have to select them and then to click on the
3840 16 Oct 07 jari 2809           &gbDelete; button. Press then on either &gbOk; (completes
3840 16 Oct 07 jari 2810           the deletion) or &gbCancel; (no items will be deleted) in
3840 16 Oct 07 jari 2811           the dialog window that appears.
3840 16 Oct 07 jari 2812         </para>
3840 16 Oct 07 jari 2813
3840 16 Oct 07 jari 2814         <sect3 id="webclient.trashcan.deleteitem.empty">
3840 16 Oct 07 jari 2815           <title>Empty trashcan</title>
3840 16 Oct 07 jari 2816           <para>
3840 16 Oct 07 jari 2817             If all items in the trashcan should be deleted permanently
3840 16 Oct 07 jari 2818             the <guibutton>Empty trash</guibutton> button can be
3840 16 Oct 07 jari 2819             used. This function will remove all items that are listed
3840 16 Oct 07 jari 2820             in your trashcan, except those items which other items,
3840 16 Oct 07 jari 2821             not marked for deletion or cannot be deleted, are
3840 16 Oct 07 jari 2822             dependent on.
3840 16 Oct 07 jari 2823           </para>
3840 16 Oct 07 jari 2824         </sect3>
3840 16 Oct 07 jari 2825       </sect2>
3840 16 Oct 07 jari 2826
3840 16 Oct 07 jari 2827       <sect2 id="webclient.trashcan.viewdependencies">
3840 16 Oct 07 jari 2828         <title>View dependencies of a trashed item</title>
3840 16 Oct 07 jari 2829         <helptext external_id="trash.view.properties" title="Properties for a trashed item">
3840 16 Oct 07 jari 2830           <para>
3840 16 Oct 07 jari 2831             This view can only be accessed from trashed items that are
3840 16 Oct 07 jari 2832             linked together with other items. Beside the item's
3840 16 Oct 07 jari 2833             <guilabel>item type</guilabel>, <guilabel>name</guilabel>,
3840 16 Oct 07 jari 2834             and <guilabel>description</guilabel> there is a list at
3840 16 Oct 07 jari 2835             the bottom of the view page with those items that are
3840 16 Oct 07 jari 2836             using the current item in some way.
3840 16 Oct 07 jari 2837           </para>
3840 16 Oct 07 jari 2838         </helptext>
3840 16 Oct 07 jari 2839         <para>
3840 16 Oct 07 jari 2840           <nohelp>
3840 16 Oct 07 jari 2841             <figure id="webclient.trashcan.figures.viewtrasheditem">
3840 16 Oct 07 jari 2842               <title>Item view of a trashed item.</title>
3840 16 Oct 07 jari 2843               <screenshot>
3840 16 Oct 07 jari 2844                 <mediaobject>
3840 16 Oct 07 jari 2845                   <imageobject>
3840 16 Oct 07 jari 2846                     <imagedata fileref="figures/trashview.png" format="PNG" 
3840 16 Oct 07 jari 2847                                scalefit="1" width="100%" />
3840 16 Oct 07 jari 2848                   </imageobject>
3840 16 Oct 07 jari 2849                 </mediaobject>
3840 16 Oct 07 jari 2850               </screenshot>
3840 16 Oct 07 jari 2851             </figure>
3840 16 Oct 07 jari 2852           </nohelp>
3840 16 Oct 07 jari 2853           <orderedlist>
3840 16 Oct 07 jari 2854             <listitem>
3840 16 Oct 07 jari 2855               <para>
3840 16 Oct 07 jari 2856                 This icon indicates that the item cannot be deleted
5789 06 Oct 11 nicklas 2857                 permanently cause of some dependencies, listed below.
3840 16 Oct 07 jari 2858               </para>
3840 16 Oct 07 jari 2859             </listitem>
3840 16 Oct 07 jari 2860             <listitem>
3840 16 Oct 07 jari 2861               <para>Common properties for all removable items.</para>
3840 16 Oct 07 jari 2862             </listitem>
3840 16 Oct 07 jari 2863             <listitem id="webclient.trashcan.lists.dependentitem3">
5789 06 Oct 11 nicklas 2864               <para>
5789 06 Oct 11 nicklas 2865                 A list of other items that are using the current item, 
5789 06 Oct 11 nicklas 2866                 blocking permanent removal.
5789 06 Oct 11 nicklas 2867               </para>
3840 16 Oct 07 jari 2868             </listitem>
3840 16 Oct 07 jari 2869           </orderedlist>
3840 16 Oct 07 jari 2870         </para>
3840 16 Oct 07 jari 2871       </sect2>
3840 16 Oct 07 jari 2872     </sect1>
4771 19 Feb 09 nicklas 2873     
4771 19 Feb 09 nicklas 2874   <sect1 id="webclient.itemoverview">
5782 04 Oct 11 nicklas 2875     <?dbhtml filename="itemoverview.html" ?>
4771 19 Feb 09 nicklas 2876     <title>Item overview</title>
3840 16 Oct 07 jari 2877
4771 19 Feb 09 nicklas 2878     <helptext external_id="item.overview" 
4771 19 Feb 09 nicklas 2879       title="Item overview">
4771 19 Feb 09 nicklas 2880     
4771 19 Feb 09 nicklas 2881     <para>
4771 19 Feb 09 nicklas 2882       With the <guilabel>Item overview</guilabel> 
5684 02 Aug 11 nicklas 2883       function you can get an overview of all bioassays,
4771 19 Feb 09 nicklas 2884       extracts, samples, annotations, raw data sets, etc. that are
4842 25 Mar 09 martin 2885       related to a given item. In the overview you can also validate
4840 24 Mar 09 martin 2886       the data to find possibly missing or incorrect information.
4771 19 Feb 09 nicklas 2887     </para>
4771 19 Feb 09 nicklas 2888     
4771 19 Feb 09 nicklas 2889     <nohelp>
4771 19 Feb 09 nicklas 2890     <para>
4771 19 Feb 09 nicklas 2891       You can access the overview for an item by navigating
4771 19 Feb 09 nicklas 2892       to the single-item view of the item you are interested in.
4771 19 Feb 09 nicklas 2893       Then, switch to the <guilabel>Overview</guilabel> tab that
4771 19 Feb 09 nicklas 2894       is present on that page. Here is an example of what is displayed:
4771 19 Feb 09 nicklas 2895     </para>
4771 19 Feb 09 nicklas 2896     
4771 19 Feb 09 nicklas 2897     <figure id="webclient.figures.itemoverview">
4771 19 Feb 09 nicklas 2898       <title>The item overview</title>
4771 19 Feb 09 nicklas 2899       <screenshot>
4771 19 Feb 09 nicklas 2900         <mediaobject>
4771 19 Feb 09 nicklas 2901           <imageobject><imagedata 
4771 19 Feb 09 nicklas 2902             scalefit="1" width="100%"
4771 19 Feb 09 nicklas 2903             fileref="figures/item_overview.png" format="PNG"
4771 19 Feb 09 nicklas 2904             /></imageobject>
4771 19 Feb 09 nicklas 2905         </mediaobject>
4771 19 Feb 09 nicklas 2906       </screenshot>
4771 19 Feb 09 nicklas 2907     </figure>
4771 19 Feb 09 nicklas 2908     </nohelp>
4771 19 Feb 09 nicklas 2909     
4771 19 Feb 09 nicklas 2910     <para>
4771 19 Feb 09 nicklas 2911       The page is divided into three sections:
4771 19 Feb 09 nicklas 2912     </para>
4771 19 Feb 09 nicklas 2913     
4771 19 Feb 09 nicklas 2914     <itemizedlist>
4771 19 Feb 09 nicklas 2915       <listitem>
4771 19 Feb 09 nicklas 2916         <para>
4840 24 Mar 09 martin 2917         To the left is a tree displaying items that are related 
4840 24 Mar 09 martin 2918         to the current item. The tree is loaded gradually when 
4840 24 Mar 09 martin 2919         you click your way through the sublevels. 
4842 25 Mar 09 martin 2920         The only exception is after a validation has been done, 
4840 24 Mar 09 martin 2921         in this case the whole tree is loaded through the validation-process.                 
4771 19 Feb 09 nicklas 2922         </para>
4771 19 Feb 09 nicklas 2923       </listitem>
4771 19 Feb 09 nicklas 2924       
4771 19 Feb 09 nicklas 2925       <listitem>
4771 19 Feb 09 nicklas 2926         <para>
4771 19 Feb 09 nicklas 2927         The lower right shows a list of warnings and error
4771 19 Feb 09 nicklas 2928         messages that was found when validating the data.
4840 24 Mar 09 martin 2929         This section is empty if no validation has been done. 
4842 25 Mar 09 martin 2930         Click on the <guibutton>Validate</guibutton> button 
4842 25 Mar 09 martin 2931         to validate the data and load errors and warnings.         
4771 19 Feb 09 nicklas 2932         <nohelp>
4842 25 Mar 09 martin 2933           In the example you can see that we have failed to 
4842 25 Mar 09 martin 2934           specify a value for the <guilabel>Temperature</guilabel> 
4842 25 Mar 09 martin 2935           protocol parameter for one of the samples. 
4840 24 Mar 09 martin 2936         </nohelp> 
4771 19 Feb 09 nicklas 2937         </para>
4771 19 Feb 09 nicklas 2938       </listitem>
4771 19 Feb 09 nicklas 2939         
4771 19 Feb 09 nicklas 2940       <listitem>
4771 19 Feb 09 nicklas 2941         <para>
4771 19 Feb 09 nicklas 2942           The upper right shows information about the
4840 24 Mar 09 martin 2943           currently selected item in the tree. This part will also
4840 24 Mar 09 martin 2944           contain more information about errors or warnings for this
4840 24 Mar 09 martin 2945           item, but only if a validation has been done. 
4840 24 Mar 09 martin 2946           It may also present you with one or more suggestions
4771 19 Feb 09 nicklas 2947           about how to fix the problem and with a link that
4771 19 Feb 09 nicklas 2948           takes you to the most probable location where you can fix
4771 19 Feb 09 nicklas 2949           the error or warning.
4771 19 Feb 09 nicklas 2950         </para>
4771 19 Feb 09 nicklas 2951         
4771 19 Feb 09 nicklas 2952       </listitem>
4771 19 Feb 09 nicklas 2953         
4771 19 Feb 09 nicklas 2954     </itemizedlist>
4771 19 Feb 09 nicklas 2955     
4771 19 Feb 09 nicklas 2956     <seeother>
4771 19 Feb 09 nicklas 2957       <other external_id="item.overview.validationoptions"
4771 19 Feb 09 nicklas 2958         >Validation options</other>
4771 19 Feb 09 nicklas 2959       <other external_id="item.overview.fixfailures"
4771 19 Feb 09 nicklas 2960         >How to fix validation failures</other>
4771 19 Feb 09 nicklas 2961     </seeother>
4771 19 Feb 09 nicklas 2962     
4771 19 Feb 09 nicklas 2963     </helptext>
4771 19 Feb 09 nicklas 2964     
4771 19 Feb 09 nicklas 2965     <sect2 id="webclient.itemoverview.validationoptions">
4771 19 Feb 09 nicklas 2966       <title>Validation options</title>
4771 19 Feb 09 nicklas 2967       <para>
4771 19 Feb 09 nicklas 2968         Click on the <guibutton>Validation options</guibutton>
4771 19 Feb 09 nicklas 2969         button in the toolbar to open the <guilabel>Validation
4771 19 Feb 09 nicklas 2970         options</guilabel> dialog.
4771 19 Feb 09 nicklas 2971       </para>
4771 19 Feb 09 nicklas 2972       
4771 19 Feb 09 nicklas 2973       <figure id="webclient.figures.validationoptions">
4771 19 Feb 09 nicklas 2974         <title>Validation options</title>
4771 19 Feb 09 nicklas 2975         <screenshot>
4771 19 Feb 09 nicklas 2976           <mediaobject>
4771 19 Feb 09 nicklas 2977             <imageobject><imagedata 
4771 19 Feb 09 nicklas 2978               fileref="figures/validation_options.png" format="PNG"
4771 19 Feb 09 nicklas 2979               /></imageobject>
4771 19 Feb 09 nicklas 2980           </mediaobject>
4771 19 Feb 09 nicklas 2981         </screenshot>
4771 19 Feb 09 nicklas 2982       </figure>          
4771 19 Feb 09 nicklas 2983       
4771 19 Feb 09 nicklas 2984       <helptext external_id="item.overview.validationoptions" 
4771 19 Feb 09 nicklas 2985         title="Validation options">
4771 19 Feb 09 nicklas 2986         <para>
4771 19 Feb 09 nicklas 2987           The validation procedure is highly 
4771 19 Feb 09 nicklas 2988           configurable and you can select what you want to
5684 02 Aug 11 nicklas 2989           ignore, and what should be displayed as an error
4771 19 Feb 09 nicklas 2990           or warning.
4771 19 Feb 09 nicklas 2991         </para>
4771 19 Feb 09 nicklas 2992         
4771 19 Feb 09 nicklas 2993         <variablelist>
4771 19 Feb 09 nicklas 2994           <varlistentry>
4771 19 Feb 09 nicklas 2995             <term>
4771 19 Feb 09 nicklas 2996             <guilabel>Presets</guilabel></term>
4771 19 Feb 09 nicklas 2997             <listitem>
4771 19 Feb 09 nicklas 2998               <para>
4771 19 Feb 09 nicklas 2999               The list contains predefined and
4771 19 Feb 09 nicklas 3000               user defined validation options.
4771 19 Feb 09 nicklas 3001               Use the <guibutton>Save as&hellip;</guibutton>
4771 19 Feb 09 nicklas 3002               button to save the current options as a user defined
4771 19 Feb 09 nicklas 3003               preset. The <guibutton>Remove&hellip;</guibutton>
4771 19 Feb 09 nicklas 3004               button is used to remove the currently selected
4771 19 Feb 09 nicklas 3005               preset. Predefined presets cannot be deleted.
4771 19 Feb 09 nicklas 3006               </para>
4771 19 Feb 09 nicklas 3007             </listitem>
4771 19 Feb 09 nicklas 3008           </varlistentry>
4771 19 Feb 09 nicklas 3009           
4771 19 Feb 09 nicklas 3010           <varlistentry>
4771 19 Feb 09 nicklas 3011             <term><guilabel>Project defaults</guilabel></term>
4771 19 Feb 09 nicklas 3012             <listitem>
4771 19 Feb 09 nicklas 3013               <para>
4771 19 Feb 09 nicklas 3014               The options in this section are used to check
4771 19 Feb 09 nicklas 3015               if your experiment uses the same values as set
4771 19 Feb 09 nicklas 3016               by the project default values of the currently active
4771 19 Feb 09 nicklas 3017               project<nohelp>
4771 19 Feb 09 nicklas 3018               (see <xref linkend="project_permission.projects" />)</nohelp>. 
5815 18 Oct 11 nicklas 3019               If no project is active these options are ignored. 
5815 18 Oct 11 nicklas 3020               The validation is only performed if the project has at least one
5815 18 Oct 11 nicklas 3021               item with a matching type. For example, if no default array 
5815 18 Oct 11 nicklas 3022               design has been added to the project, all array designs
5815 18 Oct 11 nicklas 3023               are allowed. For items that can have a subtype, the 
5815 18 Oct 11 nicklas 3024               subtype is also considered. For example, if only a default
5815 18 Oct 11 nicklas 3025               sampling protocol has been selected, no warnings are
5815 18 Oct 11 nicklas 3026               generated for extraction protocols.
4771 19 Feb 09 nicklas 3027               </para>
4771 19 Feb 09 nicklas 3028             </listitem>
4771 19 Feb 09 nicklas 3029             
4771 19 Feb 09 nicklas 3030           </varlistentry>
4771 19 Feb 09 nicklas 3031           
4771 19 Feb 09 nicklas 3032           <varlistentry>
4771 19 Feb 09 nicklas 3033             <term><guilabel>Missing items</guilabel></term>
4771 19 Feb 09 nicklas 3034             <listitem>
4771 19 Feb 09 nicklas 3035               <para>
4771 19 Feb 09 nicklas 3036               The options in this section are used to check if
4771 19 Feb 09 nicklas 3037               you have specified values for optional items. 
4771 19 Feb 09 nicklas 3038               For example, there is an option that warns you if 
5815 18 Oct 11 nicklas 3039               you have not specified a protocol. For items that
5815 18 Oct 11 nicklas 3040               can have a subtype, the rule here is to use the information 
5815 18 Oct 11 nicklas 3041               about related subtypes before reporting a missing item.
5815 18 Oct 11 nicklas 3042               For example, the <emphasis>labeled extract</emphasis>
5815 18 Oct 11 nicklas 3043               subtype is related to the <emphasis>label</emphasis>
5815 18 Oct 11 nicklas 3044               subtype and if a label is missing it is reported as a
5815 18 Oct 11 nicklas 3045               warning. If there is no related subtype no warning is
5815 18 Oct 11 nicklas 3046               generated.
4771 19 Feb 09 nicklas 3047               </para>
4771 19 Feb 09 nicklas 3048             </listitem>
4771 19 Feb 09 nicklas 3049           </varlistentry>
4771 19 Feb 09 nicklas 3050           
4771 19 Feb 09 nicklas 3051           <varlistentry>
5684 02 Aug 11 nicklas 3052             <term><guilabel>Subtypes</guilabel></term>
5684 02 Aug 11 nicklas 3053             <listitem>
5684 02 Aug 11 nicklas 3054               <para>
5684 02 Aug 11 nicklas 3055               The options in this section are used to check that related items 
5684 02 Aug 11 nicklas 3056               have a subtype that matches the subtype of the main item. For example, 
5684 02 Aug 11 nicklas 3057               if we have an <emphasis>extract</emphasis>
5684 02 Aug 11 nicklas 3058               which is a <emphasis>labeled extract</emphasis> subtype the subtype for 
5684 02 Aug 11 nicklas 3059               the related tag should be <emphasis>label</emphasis>, but if the extract
5684 02 Aug 11 nicklas 3060               is a <emphasis>library</emphasis> the subtype of the tag should be 
5684 02 Aug 11 nicklas 3061               <emphasis>barcode</emphasis>.
5684 02 Aug 11 nicklas 3062               </para>
5684 02 Aug 11 nicklas 3063             </listitem>
5684 02 Aug 11 nicklas 3064           </varlistentry>
5684 02 Aug 11 nicklas 3065
5684 02 Aug 11 nicklas 3066           <varlistentry>
4771 19 Feb 09 nicklas 3067             <term><guilabel>Annotations</guilabel></term>
4771 19 Feb 09 nicklas 3068             <listitem>
4771 19 Feb 09 nicklas 3069               <para>
4771 19 Feb 09 nicklas 3070               The options in this section are used to check 
4771 19 Feb 09 nicklas 3071               problems related to annotations. The most
4771 19 Feb 09 nicklas 3072               important ones are listed here:
4771 19 Feb 09 nicklas 3073               </para>
4771 19 Feb 09 nicklas 3074               
4771 19 Feb 09 nicklas 3075               <itemizedlist>
4771 19 Feb 09 nicklas 3076               <listitem>
4771 19 Feb 09 nicklas 3077                 <simpara>
4771 19 Feb 09 nicklas 3078                 <emphasis>Missing MIAME annotation value</emphasis>:
4771 19 Feb 09 nicklas 3079                 Checks that you have specified values
4771 19 Feb 09 nicklas 3080                 for all annotations marked as 
4771 19 Feb 09 nicklas 3081                 <guilabel>Required for MIAME</guilabel>.
4771 19 Feb 09 nicklas 3082                 </simpara>
4771 19 Feb 09 nicklas 3083               </listitem>
4771 19 Feb 09 nicklas 3084               
4771 19 Feb 09 nicklas 3085               <listitem>
4771 19 Feb 09 nicklas 3086                 <simpara>
4771 19 Feb 09 nicklas 3087                 <emphasis>Missing factor value</emphasis>:
4771 19 Feb 09 nicklas 3088                 Checks that you have specified values for
4771 19 Feb 09 nicklas 3089                 all annotations used as experimental factors in
4771 19 Feb 09 nicklas 3090                 the experiment. This is only checked when an experiment
4771 19 Feb 09 nicklas 3091                 is selected as the root item.
4771 19 Feb 09 nicklas 3092                 </simpara>
4771 19 Feb 09 nicklas 3093               </listitem>
4771 19 Feb 09 nicklas 3094               
4771 19 Feb 09 nicklas 3095               <listitem>
4771 19 Feb 09 nicklas 3096                 <simpara>
4771 19 Feb 09 nicklas 3097                 <emphasis>Missing parameter value</emphasis>:
4771 19 Feb 09 nicklas 3098                 Checks that you have specified values
4771 19 Feb 09 nicklas 3099                 for all protocol parameters.
4771 19 Feb 09 nicklas 3100                 </simpara>
4771 19 Feb 09 nicklas 3101               </listitem>
4771 19 Feb 09 nicklas 3102
4771 19 Feb 09 nicklas 3103               <listitem>
4771 19 Feb 09 nicklas 3104                 <simpara>
4771 19 Feb 09 nicklas 3105                 <emphasis>Annotation is protocol parameter</emphasis>:
4771 19 Feb 09 nicklas 3106                 Checks if an item has been annotated with a 
4771 19 Feb 09 nicklas 3107                 an annotation that is actually a protocol parameter.
4771 19 Feb 09 nicklas 3108                 </simpara>
4771 19 Feb 09 nicklas 3109               </listitem>
4771 19 Feb 09 nicklas 3110
4771 19 Feb 09 nicklas 3111               <listitem>
4771 19 Feb 09 nicklas 3112                 <simpara>
4771 19 Feb 09 nicklas 3113                 <emphasis>Annotation has invalid value</emphasis>:
4771 19 Feb 09 nicklas 3114                 Checks if annotation values are correct with 
4771 19 Feb 09 nicklas 3115                 respect to the rules given by the annotation type.
4771 19 Feb 09 nicklas 3116                 This might include numeric values that are outside 
4771 19 Feb 09 nicklas 3117                 the valid range, or values not in the list
4771 19 Feb 09 nicklas 3118                 of allows values for an enumerated annotation type.
4771 19 Feb 09 nicklas 3119                 </simpara>
4771 19 Feb 09 nicklas 3120               </listitem>
4771 19 Feb 09 nicklas 3121
4771 19 Feb 09 nicklas 3122               <listitem>
4771 19 Feb 09 nicklas 3123                 <simpara>
4771 19 Feb 09 nicklas 3124                 <emphasis>Inheriting annotation from non-parent</emphasis>:
4771 19 Feb 09 nicklas 3125                 Checks if inherited annotations really comes from a
4771 19 Feb 09 nicklas 3126                 parent item. This might happen if you rearrange 
4771 19 Feb 09 nicklas 3127                 parent-child relationship because you found that
4771 19 Feb 09 nicklas 3128                 they were incorrectly linked.
4771 19 Feb 09 nicklas 3129                 </simpara>
4771 19 Feb 09 nicklas 3130               </listitem>
4771 19 Feb 09 nicklas 3131               </itemizedlist>
4771 19 Feb 09 nicklas 3132               
4771 19 Feb 09 nicklas 3133             
4771 19 Feb 09 nicklas 3134             </listitem>
4771 19 Feb 09 nicklas 3135           </varlistentry>
4771 19 Feb 09 nicklas 3136           
4771 19 Feb 09 nicklas 3137           <varlistentry>
5684 02 Aug 11 nicklas 3138             <term><guilabel>Files</guilabel></term>
5684 02 Aug 11 nicklas 3139             <listitem>
5684 02 Aug 11 nicklas 3140               <para>
5684 02 Aug 11 nicklas 3141               The options in this section are related to the validity of 
5684 02 Aug 11 nicklas 3142               data files that can be attached to some items, for example,
5684 02 Aug 11 nicklas 3143               raw bioassays and array designs. The data files are usually
5684 02 Aug 11 nicklas 3144               validated immediately when they are used and the result is saved
5684 02 Aug 11 nicklas 3145               to the database. The options in this dialog can be used to find
5684 02 Aug 11 nicklas 3146               (or ignore) problems with data files.
5684 02 Aug 11 nicklas 3147               </para>
5684 02 Aug 11 nicklas 3148             </listitem>
5684 02 Aug 11 nicklas 3149           </varlistentry>
5684 02 Aug 11 nicklas 3150
5684 02 Aug 11 nicklas 3151           
5684 02 Aug 11 nicklas 3152           <varlistentry>
4771 19 Feb 09 nicklas 3153             <term><guilabel>Denied access</guilabel></term>
4771 19 Feb 09 nicklas 3154             <listitem>
4771 19 Feb 09 nicklas 3155               <para>
4771 19 Feb 09 nicklas 3156               The options in this section are used to
4771 19 Feb 09 nicklas 3157               check if you do not have access (read permission)
4771 19 Feb 09 nicklas 3158               to an item in the experiment hierarchy. If this 
4771 19 Feb 09 nicklas 3159               happens the validation cannot proceed in that branch.
4771 19 Feb 09 nicklas 3160               This might mask other validation problems.
4771 19 Feb 09 nicklas 3161               </para>
4771 19 Feb 09 nicklas 3162             </listitem>
4771 19 Feb 09 nicklas 3163           </varlistentry>
4771 19 Feb 09 nicklas 3164           
4771 19 Feb 09 nicklas 3165           <varlistentry>
5815 18 Oct 11 nicklas 3166             <term><guilabel>Link consistency</guilabel></term>
4771 19 Feb 09 nicklas 3167             <listitem>
4771 19 Feb 09 nicklas 3168               <para>
5815 18 Oct 11 nicklas 3169               The options in this section are used to check
5815 18 Oct 11 nicklas 3170               that links between (multiple) items are consistent
5815 18 Oct 11 nicklas 3171               with each other. The most
4771 19 Feb 09 nicklas 3172               important options are:
4771 19 Feb 09 nicklas 3173               </para>
5815 18 Oct 11 nicklas 3174
4771 19 Feb 09 nicklas 3175               <itemizedlist>
4771 19 Feb 09 nicklas 3176                 <listitem>
4771 19 Feb 09 nicklas 3177                   <simpara>
5684 02 Aug 11 nicklas 3178                   <emphasis>Array design mismatch</emphasis>:
4771 19 Feb 09 nicklas 3179                   Checks if the array design specified for
4771 19 Feb 09 nicklas 3180                   a raw bioassay is the same array design
5684 02 Aug 11 nicklas 3181                   specified for the physical bioassay.
4771 19 Feb 09 nicklas 3182                   </simpara>
4771 19 Feb 09 nicklas 3183                 </listitem>
4771 19 Feb 09 nicklas 3184                 
4771 19 Feb 09 nicklas 3185                 <listitem>
4771 19 Feb 09 nicklas 3186                   <simpara>
4771 19 Feb 09 nicklas 3187                   <emphasis>Multiple array designs</emphasis>:
4771 19 Feb 09 nicklas 3188                   Checks if all raw bioassays in an experiment 
4771 19 Feb 09 nicklas 3189                   use the same array design or not. This is only
4771 19 Feb 09 nicklas 3190                   checked when the root item is an experiment.
4771 19 Feb 09 nicklas 3191                   </simpara>
4771 19 Feb 09 nicklas 3192                 </listitem>
5815 18 Oct 11 nicklas 3193                 
4771 19 Feb 09 nicklas 3194                 <listitem>
4771 19 Feb 09 nicklas 3195                   <simpara>
5815 18 Oct 11 nicklas 3196                   <emphasis>Circular reference to pooled item</emphasis>:
5815 18 Oct 11 nicklas 3197                   If you have used pooling, checks that no 
5815 18 Oct 11 nicklas 3198                   circular references have been created.
4771 19 Feb 09 nicklas 3199                   </simpara>
4771 19 Feb 09 nicklas 3200                 </listitem>
5815 18 Oct 11 nicklas 3201                 
5815 18 Oct 11 nicklas 3202                 <listitem>
5815 18 Oct 11 nicklas 3203                   <simpara>
5815 18 Oct 11 nicklas 3204                   <emphasis>Multiple extracts with same tag+position</emphasis>:
5815 18 Oct 11 nicklas 3205                   Checks if the extracts on a physical bioassay have a
5815 18 Oct 11 nicklas 3206                   unique combination of tag+position. This is usually 
5815 18 Oct 11 nicklas 3207                   required to be able to assign measured data correctly 
5815 18 Oct 11 nicklas 3208                   downstreams.
5815 18 Oct 11 nicklas 3209                   </simpara>
5815 18 Oct 11 nicklas 3210                 </listitem>
5815 18 Oct 11 nicklas 3211                 
5815 18 Oct 11 nicklas 3212               </itemizedlist>
4771 19 Feb 09 nicklas 3213
5815 18 Oct 11 nicklas 3214             </listitem>
5815 18 Oct 11 nicklas 3215           </varlistentry>
5815 18 Oct 11 nicklas 3216           
5815 18 Oct 11 nicklas 3217           <varlistentry>
5815 18 Oct 11 nicklas 3218             <term><guilabel>Other</guilabel></term>
5815 18 Oct 11 nicklas 3219             <listitem>
5815 18 Oct 11 nicklas 3220               <para>
5815 18 Oct 11 nicklas 3221               This section collects options that does not fit
5815 18 Oct 11 nicklas 3222               into any of the other sections. The most
5815 18 Oct 11 nicklas 3223               important options are:
5815 18 Oct 11 nicklas 3224               </para>
5815 18 Oct 11 nicklas 3225               
5815 18 Oct 11 nicklas 3226               <itemizedlist>
4771 19 Feb 09 nicklas 3227                 <listitem>
4771 19 Feb 09 nicklas 3228                   <simpara>
4771 19 Feb 09 nicklas 3229                   <emphasis>Non-unique name</emphasis>:
4771 19 Feb 09 nicklas 3230                   Checks if two items of the same type
5684 02 Aug 11 nicklas 3231                   have the same name. It is usually a good idea to
5684 02 Aug 11 nicklas 3232                   have unique names within an experiment if the data is
5684 02 Aug 11 nicklas 3233                   going to be exported and in other circumstances.
4771 19 Feb 09 nicklas 3234                   </simpara>
4771 19 Feb 09 nicklas 3235                 </listitem>
4771 19 Feb 09 nicklas 3236
4771 19 Feb 09 nicklas 3237               </itemizedlist>
4771 19 Feb 09 nicklas 3238               
4771 19 Feb 09 nicklas 3239             </listitem>
4771 19 Feb 09 nicklas 3240           </varlistentry>
4771 19 Feb 09 nicklas 3241           
4771 19 Feb 09 nicklas 3242         </variablelist>
4771 19 Feb 09 nicklas 3243         
4771 19 Feb 09 nicklas 3244         <para>
4771 19 Feb 09 nicklas 3245           Click on the &gbSave; button
4771 19 Feb 09 nicklas 3246           to use the current settings. The display will
4771 19 Feb 09 nicklas 3247           automatically refresh itself.
4771 19 Feb 09 nicklas 3248         </para>
4771 19 Feb 09 nicklas 3249         
4771 19 Feb 09 nicklas 3250       </helptext>
4771 19 Feb 09 nicklas 3251       
4771 19 Feb 09 nicklas 3252       <helptext external_id="item.overview.validationoptions.savepreset" 
4771 19 Feb 09 nicklas 3253         title="Save preset" webonly="1">
4771 19 Feb 09 nicklas 3254         
4771 19 Feb 09 nicklas 3255         <para>
4771 19 Feb 09 nicklas 3256         Saves all validation options as a preset. 
4771 19 Feb 09 nicklas 3257         </para>
4771 19 Feb 09 nicklas 3258         
4771 19 Feb 09 nicklas 3259         <variablelist>
4771 19 Feb 09 nicklas 3260           <varlistentry>
4771 19 Feb 09 nicklas 3261             <term><guilabel>Name</guilabel></term>
4771 19 Feb 09 nicklas 3262             <listitem>
4771 19 Feb 09 nicklas 3263               <para>
4771 19 Feb 09 nicklas 3264                 The name of the preset. The name must be unique
4771 19 Feb 09 nicklas 3265                 and if a preset with the same name already exists
4771 19 Feb 09 nicklas 3266                 you will be asked if you want to overwrite it or not.
4771 19 Feb 09 nicklas 3267               </para>
4771 19 Feb 09 nicklas 3268             </listitem>
4771 19 Feb 09 nicklas 3269           </varlistentry>
4771 19 Feb 09 nicklas 3270         </variablelist>
4771 19 Feb 09 nicklas 3271         
4771 19 Feb 09 nicklas 3272         <para>
4771 19 Feb 09 nicklas 3273           Click on the &gbSave; button
4771 19 Feb 09 nicklas 3274           to save the preset or &gbCancel;
4771 19 Feb 09 nicklas 3275           to abort.
4771 19 Feb 09 nicklas 3276         </para>
4771 19 Feb 09 nicklas 3277       </helptext>
4771 19 Feb 09 nicklas 3278       
4771 19 Feb 09 nicklas 3279     </sect2>
4771 19 Feb 09 nicklas 3280     
4771 19 Feb 09 nicklas 3281     <sect2 id="webclient.itemoverview.fixfailures">
4771 19 Feb 09 nicklas 3282       <title>Fixing validation failures</title>
4771 19 Feb 09 nicklas 3283       <helptext external_id="item.overview.fixfailures" 
4771 19 Feb 09 nicklas 3284         title="How to fix validation failures">
4771 19 Feb 09 nicklas 3285         
4840 24 Mar 09 martin 3286         <para>        
4771 19 Feb 09 nicklas 3287         The overview includes a function that allows
4771 19 Feb 09 nicklas 3288         you to quickly fix most of the problems found during the 
4771 19 Feb 09 nicklas 3289         validation. The easiest way to use the function is:
4771 19 Feb 09 nicklas 3290         </para>
4771 19 Feb 09 nicklas 3291         
4771 19 Feb 09 nicklas 3292         <orderedlist>
4771 19 Feb 09 nicklas 3293           <listitem>
4771 19 Feb 09 nicklas 3294             <simpara>
4771 19 Feb 09 nicklas 3295             Click on an error or warning in the list of failures in 
4771 19 Feb 09 nicklas 3296             the lower right
4771 19 Feb 09 nicklas 3297             pane. The tree in the left pane and the item overview in the
4771 19 Feb 09 nicklas 3298             top right pane will automatically be updated to show the
4771 19 Feb 09 nicklas 3299             exact location of the faulty item.
4771 19 Feb 09 nicklas 3300             </simpara>
4771 19 Feb 09 nicklas 3301           </listitem>
4771 19 Feb 09 nicklas 3302           <listitem>
4771 19 Feb 09 nicklas 3303             <simpara>
4771 19 Feb 09 nicklas 3304             The upper right pane should contain a list labeled
4771 19 Feb 09 nicklas 3305             <guilabel>Failure details</guilabel> with more information
4771 19 Feb 09 nicklas 3306             about each failure and also one or more suggestions for fixing
4771 19 Feb 09 nicklas 3307             the problem. For example, a failure due to a missing item
4771 19 Feb 09 nicklas 3308             should suggest that you add or select an item.
4771 19 Feb 09 nicklas 3309             </simpara>
4771 19 Feb 09 nicklas 3310           </listitem>
4771 19 Feb 09 nicklas 3311           
4771 19 Feb 09 nicklas 3312           <listitem>
4771 19 Feb 09 nicklas 3313             <simpara>
4771 19 Feb 09 nicklas 3314             The suggestions should also have links that takes
4771 19 Feb 09 nicklas 3315             you to an edit view where you can do the changes.
4771 19 Feb 09 nicklas 3316             </simpara>
4771 19 Feb 09 nicklas 3317           </listitem>
4771 19 Feb 09 nicklas 3318           
4771 19 Feb 09 nicklas 3319           <listitem>
4771 19 Feb 09 nicklas 3320             <simpara>
4771 19 Feb 09 nicklas 3321             After saving the changes you must click on the
4842 25 Mar 09 martin 3322             <guibutton>Validate</guibutton> button to update the
4771 19 Feb 09 nicklas 3323             interface. If you want, you can fix more than one 
4771 19 Feb 09 nicklas 3324             failure before clicking on the button.
4771 19 Feb 09 nicklas 3325             </simpara>
4771 19 Feb 09 nicklas 3326           </listitem>
4771 19 Feb 09 nicklas 3327             
4771 19 Feb 09 nicklas 3328         </orderedlist>
5815 18 Oct 11 nicklas 3329         
5815 18 Oct 11 nicklas 3330         <note>
5815 18 Oct 11 nicklas 3331           <title>Inactive links?</title>
5815 18 Oct 11 nicklas 3332           If you do not have permission to fix a problem the links will be inactive
5815 18 Oct 11 nicklas 3333           and you'll have to talk to someone with more powers.
5815 18 Oct 11 nicklas 3334         </note>
4771 19 Feb 09 nicklas 3335       
4771 19 Feb 09 nicklas 3336       </helptext>
4771 19 Feb 09 nicklas 3337     </sect2>
4771 19 Feb 09 nicklas 3338     
4771 19 Feb 09 nicklas 3339   </sect1>
4771 19 Feb 09 nicklas 3340
3675 16 Aug 07 jari 3341 </chapter>