source: trunk/doc/src/docbook/userdoc/trashcan.xml @ 3364

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC 
    "-//Dawid Weiss//DTD DocBook V3.1-Based Extension for XML and graphics inclusion//EN" 
    "../../../../lib/docbook/preprocess/dweiss-docbook-extensions.dtd">
<!--
  $Id: trashcan.xml 3364 2007-05-23 07:52:38Z martin $
  
  Copyright (C) Authors contributing to this file.
  
  This file is part of BASE - BioArray Software Environment.
  Available at http://base.thep.lu.se/
  
  BASE is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License
  as published by the Free Software Foundation; either version 2
  of the License, or (at your option) any later version.
  
  BASE is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.
  
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place - Suite 330,
  Boston, MA  02111-1307, USA.
-->

<chapter id="trashcan">
  <?dbhtml dir="trashcan"?>
  <title>Trashcan</title>
  <para>
    All items that have been removed and are owned by you are listed in the trashcan. This list
    page is accessed with
    <menuchoice>
      <guimenu>View</guimenu>
      <guimenuitem>Trashcan</guimenuitem>
    </menuchoice>
    and it differs a bit from the other common list pages. The most significant difference is
    that it's able to contain more then one item type, actually all item types in BASE that are
    removable. This exclude ie. items like sessions, that neither can be removed or deleted, and
    clients' helptexts that are deleted from the database immediately in list/item view.
  </para>
  <warning>
    <para>
      Some item types don't have any owner and these are listed in the trashcans for everyone
      with delete - permission on the specific item type.
    </para>
  </warning>

  <para>
    Things that are common with other list pages are the possibility to restore items and to
    view/edit them, see
    <xref linkend="webclient.items.restore" />
    and
    <xref linkend="webclient.items.edit" />
    . If an item is restored, it will of course dissappear from the trashcan.
  </para>

  <sect1 id="trashcan.deleteitem">
    <title>Delete items permanently</title>
    <para>
      Items can be permanently deleted from BASE only if they aren't used by other items.
      Items that are used have the icon
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="figures/isused.gif" format="GIF" align="left" />
        </imageobject>
      </inlinemediaobject>
      in the first column and by clicking on it you can get more information about the
      dependencies, see
      <xref linkend="trashcan.viewdependencies" />
      .
      <note>
        <simpara>
          This is NOT the same view page as when clicking on the item's name, which brings
          you to the item's view page.
        </simpara>
      </note>
    </para>
    <para>
      To delete one or several items permanently from trashcan you first have to select them,
      click then on the
      <guibutton>Delete</guibutton>
      button. Press then on either
      <guibutton>Ok</guibutton>
      (completes the deletion) or
      <guibutton>Cancel</guibutton>
      (no items will be deleted) in the dialog window that appears.
    </para>

    <sect2 id="trashcan.deleteitem.empty">
      <title>Empty trashcan</title>
      <para>
        If all items in the trashcan should be deleted permanently the
        <guibutton>Empty trash</guibutton>
        button can be used. This function will delete all items that are listed in your
        trashcan, except those which other items, that aren't marked for deletion or that
        can't be deleted, are depending on.
      </para>
    </sect2>
  </sect1>

  <sect1 id="trashcan.viewdependencies">
    <title>View dependencies of a trashed item</title>
    <helptext external_id="trash.view.properties" title="Properties for a trashed item">
      <para>
        This view can only be accessed from the trashed items that are linked together with
        other items. Beside the item's
        <guilabel>item type</guilabel>
        ,
        <guilabel>name</guilabel>
        and
        <guilabel>description</guilabel>
        there is a list at the bottom of the view page with those items that are using the
        current item in some way.
      </para>
    </helptext>
    <para>
      <nohelp>
        <figure>
          <title>Item view of a trashed item.</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/trashview.png" format="PNG" />
              </imageobject>
            </mediaobject>
          </screenshot>
        </figure>
      </nohelp>
      <orderedlist>
        <listitem>
          <para>
            This icon indicates that the item can't be deleted permanently cause of some
            dependencies, see #<xref linkend="trashcan.lists.dependentitem3" />.
          </para>
        </listitem>
        <listitem>
          <para>Common properties for all removable items.</para>
        </listitem>
        <listitem id="trashcan.lists.dependentitem3">
          <para>A list of other items that are using the current item.</para>
        </listitem>
      </orderedlist>
    </para>
  </sect1>

</chapter>