<?xml version='1.0' encoding='UTF-8'?>
<!-- This document was created with Syntext Serna Free. -->
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "../../../User_Guide.ent">
%BOOK_ENTITIES;
]>
<section id="sect-User_Guide-Categories_and_Tags">
  <title>Categories and Tags</title>
  <section id="sect-User_Guide-Categories_and_Tags-Manage_Tags">
    <title>Manage Tags</title>
    <para>
   The <emphasis>Manage Tags</emphasis> form allows you to manage tag styles (the appearance of tags in visual representations). A tag's style changes depending on the number of documents with that tag.
  </para>
    <para>
   Go to <menuchoice>
      <guimenu>Group</guimenu>
      <guimenuitem>Administration</guimenuitem>
   </menuchoice> then click on <menuchoice>
      <guimenu>Categories and Tags</guimenu>
      <guimenuitem>Manage Tags</guimenuitem>
   </menuchoice>.
  </para>
  <para>
     From this page you can add new tags styles or edit existing styles.
  </para>
    <mediaobject>
       <imageobject role="html">
          <imagedata fileref="images/JBoss_product_and_documentation_overview.png" format="PNG" align="center"/>
       </imageobject>
       <imageobject role="fo">
          <imagedata fileref="images/JBoss_product_and_documentation_overview.png" format="PNG" align="center" width="150mm" />
       </imageobject>
    </mediaobject>
    <section id="sect-User_Guide-Manage_Tags-Add_a_tag_style">
      <title>Add a tag style</title>
      <para>
      To add a new tag style, do the following:
   </para>
      <procedure id="proc-User_Guide-Add_a_tag_style-Add_a_Tag_Style">
        <title>Add a Tag Style</title>
        <step>
          <para>
      Click the <guibutton>Add style</guibutton> button. The <guibutton>Add tag style configuration</guibutton> form will appear:
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/editstyletagconfig.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/editstyletagconfig.png" format="PNG" align="center" width="150mm" />
             </imageobject>
          </mediaobject>
          <table>
          <title></title>
                <tgroup cols="2">
                   <thead>
                      <row>
                         <entry>
                            Field
                         </entry>
                         <entry>
                            Details
                         </entry>
                      </row>
                   </thead>
                   <tbody>
                      <row>
                         <entry>
                           <guilabel>Style name</guilabel>
                         </entry>
                         <entry>
                            Give the tag name. You cannot edit it.
                         </entry>
                      </row>
                      <row>
                         <entry>
                            <guilabel>Document Range</guilabel>
                         </entry>
                         <entry>
                            Give the number of documents that must have this tag for this style to apply. The asterix (*) indicates this is a required value.
                         </entry>
                      </row>
                      <row>
                         <entry>
                            <guilabel>HTML style</guilabel>
                         </entry>
                         <entry>
                            Include settings for the font-size, font-weight, color, font-family and text-decoration. The asterix (*) indicates this is a required value.
                         </entry>
                      </row>
                   </tbody>
                </tgroup>
          </table>
        </step>
        <step>
          <para>
      Input values in the fields: <guilabel>Style name</guilabel>, <guilabel>Document range</guilabel>, <guilabel>HTML style</guilabel>, all of which are required.
     </para>
        </step>
        <step>
          <para>
      Click <guilabel>Update</guilabel> to accept adding a new tag style.</para>
        </step>
      </procedure>
      <note>
        <title>Note</title>
        <itemizedlist>
          <listitem>
            <para>
       The format of valid range must be: <replaceable>a</replaceable>..<replaceable>b</replaceable> where <replaceable>a</replaceable>, <replaceable>b</replaceable> are positive integers. You can use <parameter>*</parameter> instead of<replaceable>b</replaceable> to indicate it is unlimited.
       </para>
       <para>
          For example; <emphasis>0..2</emphasis> means that 0, one or two documents must be assigned to a tag for this style to apply while <emphasis>10..*</emphasis> means at least ten documents (with no upper limit) must be assigned for the style to take effect.
      </para>
          </listitem>
          <listitem>
            <para>
       The <guilabel>HTML style</guilabel> text box cannot be empty: you can change values of font-size, font–weight, color, font-family, text-decoration.
      </para>
          </listitem>
        </itemizedlist>
      </note>
    </section>
    <section id="sect-User_Guide-Manage_Tags-Edit">
      <title>Edit</title>
      <para>
    To edit the existing tags do the following:
   </para>
      <procedure id="proc-User_Guide-Edit-Editing_existing_tabs">
        <title>Editing existing tabs</title>
        <step>
          <para>
      Click the pencil icon corresponding to the tag name which you want to edit in the <guilabel>Action</guilabel> column. The <guilabel>Edit tag style configuration</guilabel> form appears like the form to add a tag style.
         </para>
        </step>
        <step>
          <para>
      Change values in the fields <guimenu>Document range</guimenu> and <guimenu>HTML style</guimenu>. Do not change the <guimenu>Style name</guimenu> field, as you are editing an <emphasis>existing</emphasis> tag.
      </para>
        </step>
        <step>
          <para>
      Click <guimenu>Update</guimenu> to save any changes.
     </para>
        </step>
      </procedure>
    </section>
    <section id="sect-User_Guide-Manage_Tags-Delete_a_tag_style">
      <title>Delete a tag style</title>
      <para>
         To delete a tag style:
      </para>
         <procedure>
            <title></title>
               <step>
                  <para>
                     Click the corresponding trash icon,
                  </para>
               </step>
               <step>
                  <para>
                     Click <guilabel>OK</guilabel> in the confirmation message to confirm the deletion.
                  </para>
               </step>
         </procedure>
      <mediaobject>
         <imageobject role="html">
            <imagedata fileref="images/confirmdeletion.png" format="PNG" align="center"/>
         </imageobject>
         <imageobject role="fo">
            <imagedata fileref="images/confirmdeletion.png" format="PNG" align="center" width="101mm" />
         </imageobject>
      </mediaobject>
    </section>
    <section id="sect-User_Guide-Manage_Tags-Tag_Permission_Manager">
      <title>Tag Permission Manager</title>
      <para>
    The <guilabel>Tag permission manager</guilabel> tab helps you set permissions regarding editing and deleting public tags.
   </para>
      <mediaobject>
         <imageobject role="html">
            <imagedata fileref="images/tagpermissionmanager.png" format="PNG" align="center"/>
         </imageobject>
         <imageobject role="fo">
            <imagedata fileref="images/tagpermissionmanager.png" format="PNG" align="center" width="150mm"/>
         </imageobject>
      </mediaobject>
      <procedure id="proc-User_Guide-Tag_Permission_Manager-Set_Permission_To_Tag_Management">
        <title>Set Permission To Tag Management</title>
        <step>
          <para>
      Click the <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/userpermissionbutton.png" format="PNG" width="6mm"/>
              </imageobject>
              <textobject>
                 <phrase>Select user</phrase>
              </textobject>
            </inlinemediaobject> icon beside the <guilabel>Memberships</guilabel> field to select memberships in order to add a permission for those memberships. The Select membership form will appear:
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/selectmembership.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/selectmembership.png" format="PNG" align="center" width="146mm"/>
             </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
      Select a group on the left and the corresponding membership on the right. The selected membership will appear in the <guilabel>Memberships</guilabel> field:
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/memberships.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/memberships.png" format="PNG" align="center" width="150mm" />
             </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
      Click <guibutton>Save</guibutton> to add a permission for the  membership to the <guilabel>Memberships</guilabel> column.
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/managemembership.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/managemembership.png" format="PNG" align="center" width="150mm" />
             </imageobject>
          </mediaobject>
          <para>
      To delete memberships permissions:
         </para>
         <procedure>
            <title></title>
               <step>
                  <para>
                     Click the trash icon corresponding to that membership.
                  </para>
               </step>
               <step>
                  <para>
                     Click <guilabel>OK</guilabel> in the confirmation message.
                  </para>
               </step>
         </procedure>
          <mediaobject>
            <imageobject>
              <imagedata  align="center" fileref="images/accept_delete.png" format="PNG" width="104mm" />
            </imageobject>
          </mediaobject>
        </step>
      </procedure>
    </section>
  </section>
  <section id="sect-User_Guide-Categories_and_Tags-Manage_Taxonomy">
    <title>Manage Categories</title>
    <para>
   Category management can be understood as a classification practice. Categories are used to sort documents, so as to facilitate effective searches.
   </para>
   <para>
      In this section, the concept of categorization and classification will be referred to with the term <emphasis>taxonomy</emphasis>.
   </para>
   <para>
      The &PRODUCT; category management system includes adding, editing and deleting a taxonomy tree.
  </para>
    <para>
   Go to <menuchoice>
      <guimenu>Group</guimenu>
      <guimenuitem>Administration</guimenuitem>
   </menuchoice> then click on <menuchoice>
      <guimenu>Categories and Tags</guimenu>
      <guimenuitem>Manage Categories</guimenuitem>
   </menuchoice>.
  </para>
  <para>
     The <guilabel>Manage Categories</guilabel> form appears.
  </para>
    <mediaobject>
       <imageobject role="html">
          <imagedata fileref="images/manage_taxonomy_trees.png" format="PNG" align="center"/>
       </imageobject>
       <imageobject role="fo">
          <imagedata fileref="images/manage_taxonomy_trees.png" format="PNG" align="center" width="150mm" />
       </imageobject>
    </mediaobject>
  </section>
  <section id="sect-User_Guide-Categories_and_Tags-Add_a_Taxonomy_Tree">
    <title>Add a Taxonomy Tree</title>
    <procedure id="proc-User_Guide-Add_a_Taxonomy_Tree-Adding_a_Taxonomy_Tree">
   <step>
        <para>
     Click the <guibutton>Add Taxonomy Tree</guibutton> button to add a new taxonomy. The <guilabel>Add taxonomy tree</guilabel> form will appear.
    </para>
        <mediaobject>
           <imageobject role="html">
              <imagedata fileref="images/add_taxonomy_tree.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="fo">
              <imagedata fileref="images/add_taxonomy_tree.png" format="PNG" align="center" width="150mm" />
           </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Enter a name for the tree in the <guilabel>Name</guilabel> field. The asterix (*) denotes this as a required field.
    </para>
      </step>
      <step>
        <para>
     Select the workspace you want to work with.
    </para>
      </step>
      <step>
        <para>
     Select the home path by clicking the plus icon. The <guibutton>Select Home Path</guibutton> form will appear:
    </para>
        <mediaobject>
           <imageobject role="html">
              <imagedata fileref="images/select_home_path.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="fo">
              <imagedata fileref="images/select_home_path.png" format="PNG" align="center" width="150mm"/>
           </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Click the tick icon if you want to select the root path or click the arrow icon to go to the up level path. Click the plus sign to expand the folder.
    </para>
      </step>
      <step>
        <para>
     Click the tick icon corresponding to the path that you want to select as a home path.
    </para>
        <para>
     Click <guimenu>Reset</guimenu> if you want to reset values that have just been selected or <guimenu>Next</guimenu> to select permissions for a taxonomy tree.
    </para>
        <mediaobject>
           <imageobject role="html">
              <imagedata fileref="images/taxonomy_permissions.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="fo">
              <imagedata fileref="images/taxonomy_permissions.png" format="PNG" align="center" width="150mm"/>
           </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Click the <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/usericon.png" format="PNG" width="5mm"/>
            </imageobject>
            <textobject>
               <phrase>Select user</phrase>
            </textobject>
          </inlinemediaobject>
      icon to select a user, the <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/grouppermission.png" format="PNG" width="6mm"/>
            </imageobject>
            <textobject>
               <phrase>Select memberships</phrase>
            </textobject>
          </inlinemediaobject>
      icon to select memberships or the <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/alluserpermission.png" format="PNG" width="7mm"/>
            </imageobject>
            <textobject>
               <phrase>Select everyone</phrase>
            </textobject>
          </inlinemediaobject> icon to select everyone in order to set permissions. The user or membership that you have selected will be displayed in the <guilabel>User or Group</guilabel> field.
    </para>
        <para>
     Then, check at least one of the options below to set rights for the selected user to membership:
    </para>
        <variablelist>
          <varlistentry>
            <term>Read Right</term>
            <listitem>
              <para>
        The option is to select the <emphasis>Read</emphasis> right or not.
       </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Add Note Right</term>
            <listitem>
              <para>
        The option is to select the <emphasis>Add Node</emphasis> right or not.
       </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Set Property Right</term>
            <listitem>
              <para>
        The option is to select the <emphasis>Set Property</emphasis> right or not.
       </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Remove Right</term>
            <listitem>
              <para>
        The option is to select the <emphasis>Remove</emphasis> right or not.
       </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </step>
      <step>
        <para>
     Click <guibutton>Save</guibutton> to save all values, or <guibutton>Reset</guibutton> to change values that have just been set.
    </para>
    </step>
    <step>
       <para>
          After clicking <guibutton>Save</guibutton>, click <guibutton>Next</guibutton> to go to the next step.
       </para>
        <mediaobject>
           <imageobject role="html">
              <imagedata fileref="images/action_gimme.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="fo">
              <imagedata fileref="images/action_gimme.png" format="PNG" align="center" width="150mm" />
           </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Enter the name for an action of the taxonomy tree in the Name field. This is a required (*) value.
    </para>
      </step>
      <step>
        <para>
     Select values for <guilabel>Life-cycle</guilabel>, <guilabel>NodeTypes</guilabel>, <guilabel>Target workspace</guilabel>, <guilabel>Target path</guilabel>, <guilabel>Affected Node Types</guilabel>. These fields are required (*).
    </para>
      </step>
      <step>
        <para>
     Click <guibutton>Save</guibutton> to save all values and click <guibutton>Next</guibutton> to go to the next step.
    </para>
      </step>
    </procedure>
    <note>
      <title>Considerations</title>
      <itemizedlist>
        <listitem>
          <para>
      Do not use the following special characters in the <guilabel>Name</guilabel> field like: !,@,#,$,%,&amp;,*,(,).
     </para>
        </listitem>
        <listitem>
          <para>
      Do not add a taxonomy which has the same name and level with existing taxonomies in a node.
     </para>
        </listitem>
        <listitem>
          <para>
      The taxonomy name must contain fewer than thirty (30) characters.
     </para>
        </listitem>
      </itemizedlist>
    </note>
  </section>
  <section id="sect-User_Guide-Categories_and_Tags-Edit_a_Taxonomy_Tree">
    <title>Edit a Taxonomy Tree</title>
    <para>
   To edit a taxonomy tree:
  </para>
    <procedure id="proc-User_Guide-Edit_a_Taxonomy_Tree-Edit_a_Taxonomy_Tree">
      <step>
        <para>
     Click the <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/editicon4.png" format="PNG" width="6mm"/>
            </imageobject>
            <textobject>
               <phrase>pencil</phrase>
            </textobject>
          </inlinemediaobject> icon that corresponds to the taxonomy tree you want to edit.
    </para>
        <mediaobject>
           <imageobject role="html">
              <imagedata fileref="images/edittaxonomytree.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="fo">
              <imagedata fileref="images/edittaxonomytree.png" format="PNG" align="center" width="150mm" />
           </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Click the <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/blueplusicon.png" format="PNG" width="7mm"/>
            </imageobject>
            <textobject>
               <phrase>plus</phrase>
            </textobject>
          </inlinemediaobject> icon in the <guilabel>Action</guilabel> field to add more taxonomy trees. The Edit taxonomy tree will appear:
    </para>
        <mediaobject>
           <imageobject role="html">
              <imagedata fileref="images/edittaxonomytree2.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="fo">
              <imagedata fileref="images/edittaxonomytree2.png" format="PNG" align="center" width="150mm" />
           </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Enter a taxonomy name in the Taxonomy name field. This field is required (*).
    </para>
      </step>
      <step>
        <para>
     Click <guibutton>Save</guibutton>to save the taxonomy name.
    </para>
      </step>
      <step>
        <para>
     Click <guibutton>Previous</guibutton> to return to the previous steps.
    </para>
      </step>
      <step>
        <para>
     Click <guibutton>Save</guibutton> to save all changes and the <guibutton>Previous</guibutton> or <guibutton>Next</guibutton> if you want to edit more.
    </para>
      </step>
    </procedure>
    <note>
      <title>Considerations</title>
      <itemizedlist>
        <listitem>
          <para>
      You can delete a taxonomy by clicking the trash icon corresponding to the taxonomy that you want to delete. Click <guibutton>OK</guibutton> on the confirmation message to accept deleting this taxonomy, or click Cancel to discard this action.
     </para>
        </listitem>
        <listitem>
          <para>
      You cannot delete taxonomies that have been referenced.
     </para>
        </listitem>
      </itemizedlist>
    </note>
  </section>
</section>
