Commit c687326b0cbefcb52be6aa9500da0246fd48bcd3

Authored by Philip Arkcoll
1 parent 26903572

KTS-2685

"Update Onscreen Help"
Fixed. Updated user-side HTML help files
Committed By: Philip Arkcoll
Reviewed By: 

git-svn-id: https://kt-dms.svn.sourceforge.net/svnroot/kt-dms/trunk@9023 c91229c3-7414-0410-bfa2-8a42b809f60b
kthelp/ktcore/EN/user/portlets/Browse By.html
@@ -2,10 +2,24 @@ @@ -2,10 +2,24 @@
2 <head> 2 <head>
3 <title>Browse By</title> 3 <title>Browse By</title>
4 </head> 4 </head>
5 -<h2>Browse By</h2> 5 +
6 <body> 6 <body>
7 -You use the Browse Documents section to navigate the repository - either by <b>folder</b>, by <b>document type</b>, or by <b>lookup value</b> - the default is browse by folder.  
8 -<br></br>  
9 -<b>Note:</b> The system only returns folders where you have read and/or write permissions. 7 +<h2>Browse By</h2>
  8 +<p>
  9 +The Browse by ... menu in the Browse Documents tab allows you to select a 'browse mode' for navigating the document management system.
  10 +</p>
  11 +<br />
  12 +<p>
  13 +KnowledgeTree's default 'browse mode' is browse by Folder.
  14 +</p>
  15 +<br />
  16 +<h3>Browse Modes</h3>
  17 +<ul>
  18 +<li>Folder - allows you to browse the folder through the folder hierarchy</li>
  19 +<li>Document Type - allows you to filter content to browse only documents of a selected document type.</li>
  20 +<li>Lookup Value - allows you to filter content to browse only documents that contain a selected lookup value. </li>
  21 +</ul>
  22 +
  23 +
10 </body> 24 </body>
11 </html> 25 </html>
kthelp/ktcore/EN/user/portlets/Document Actions.html
@@ -3,89 +3,89 @@ @@ -3,89 +3,89 @@
3 <title>Document Actions</title> 3 <title>Document Actions</title>
4 </head> 4 </head>
5 <body> 5 <body>
  6 +<h2>Document Info menu</h2>
6 7
  8 +<h3>Display Details </h3>
7 9
8 -  
9 -<h2>Document Actions</h2>  
10 -  
11 -<h3>Document Details</h3>  
12 -  
13 -The Document Detail screen summarizes key information about the currently selected document. The Document Actions pane on the left of the screen provides a set of buttons for working with the document.  
14 - 10 +Displays information about a currently selected document; e.g. filename, custom document number, file type, document version, created by, owned by, last update by, document type, workflow, document id, tags, category, author, media type, associated fieldsets, fields, field values
  11 +<br /><br />
15 <h3>Download</h3> 12 <h3>Download</h3>
16 -  
17 -You can download a file to open it, or to save it, without checking it out of the repository.  
18 -  
19 -  
20 -  
21 -  
22 -  
23 - 13 +Downloads a copy of the current document without checking it out of the document management system. You can open the document to view it and/or save it to your local computer.
  14 +<br /><br />
  15 +<h3>Permissions</h3>
  16 +Displays the current permissions setup on the document.
  17 +<br /><br />
  18 +<h3>Transaction History</h3>
  19 +Displays a transaction history on the currently selected document, and includes a record of all transactions performed on the document.
  20 +<br /><br />
  21 +<h3>Version History</h3>
  22 +Displays a record of past content versions and past metadata versions of a currently selected document, and allows you to compare versions.
  23 +<br /><br />
  24 +<h3>View Roles</h3>
  25 +Displays current role allocations on the selected document.
  26 +<br /><br />
  27 +
  28 +<h2>Document Actions menu</h2>
  29 +<h3>Archive</h3>
  30 +Archives a currently selected document and renders the document invisible to non-administrative users. Only administrative users are allowed to restore archived documents. Archiving clears space in the repository in order to speed up search and document viewing.
  31 +<br /><br />
  32 +<h3>Change Document Ownership</h3>
  33 +Changes the document ownership. The new user becomes the document 'owner'. Note that changing the document owner may restrict access to the document if the new owner does not have the correct permissions on the document.
  34 +<br /><br />
24 <h3>Check-out</h3> 35 <h3>Check-out</h3>
25 -  
26 -This procedure allows you to save a document to your computer for editing.  
27 -<br></br>  
28 -The system locks the version in the repository while it's checked out. Other users are still able to download the document to view it, but they cannot change it.  
29 -<br></br>  
30 -An administrator can override the checked out status of a document. The user who checked the document out to edit it will need to check it out again and redo their changes. The Dashboard displays a list of documents that you have checked out when you log on. This reminds you to check in documents where you may have forgotten to do so.  
31 - 36 +Checks the document out of the document management system, updates the transaction history, locks the document against check out and editing by other users, and downloads the document to your local computer, where you can edit the document before checking it back in to KnowledgeTree.
  37 +<br /><br />
  38 +<h3>Cancel Checkout</h3>
  39 +Displays only if you have the current document checked out. This action overrides the document's checked out status. The pre-checkout version of the document is restored to the document management system. To add any changes you made to your local copy of the document you will have to check it out again, add your changes, and check the document back in.
  40 +<br /><br />
32 <h3>Check-in</h3> 41 <h3>Check-in</h3>
33 -  
34 -This procedure checks in a document that you have previously checked out of the repository.  
35 -<br><br>  
36 -If you have checked out a document, you need to check it back in to make it available for other users to edit, move, delete, or archive. The system increments the version by 0.1 when the file is checked in.  
37 -  
38 -<h3>Edit Metadata</h3>  
39 -  
40 -Metadata is the information about a document that describes how, and when, and by whom, a particular set of data was collected, and how the data is formatted.  
41 -  
42 -KnowledgeTree groups metadata fields into fieldsets.  
43 - 42 +Displays only if you have the current document checked out. This action allows you to update the current document with the changes you made to your local, checked out copy, and increments the version by 0.1 on check-in.
  43 +<br /><br />
  44 +<h3>Copy</h3>
  45 +Copies the currently selected document to another location in the repository.
  46 +<br /><br />
44 <h3>Delete</h3> 47 <h3>Delete</h3>
45 -  
46 -Deleted documents remain in the repository (in DMS Administration) until the KnowledgeTree administrator either expunges them or restores them.  
47 -  
48 -See Administration Document Storage Restore or Expunge Deleted Documents.  
49 -  
50 -<h3>Move</h3>  
51 -  
52 -Only users with the required permissions for a folder are allowed to move an item to another location in the repository.  
53 -  
54 -<h3>Transaction History</h3>  
55 -  
56 -This feature provides a record of all transactions performed on the document: create date, uploads, downloads, check-out, check-in and the previous deletion of the document if it has been restored.  
57 -  
58 -<h3>Version History</h3>  
59 -  
60 -This feature provides a record of all past and current versions of a document. A new document version is created whenever a document is checked-out then subsequently checked-in again. The version history feature allows you to download older documents and compare them with more recent versions.  
61 - 48 +Moves a document out of the folder hierarchy so that it is no longer available to system users. Deleted documents may be restored or expunged by the KnowledgeTree administrator.
  49 +<br /><br />
  50 +<h3>Discussion</h3>
  51 +Displays discussion threads on the document (if any) and allows you to create new threads, add to existing threads or add a post to an existing thread. Discussions are a low level collaboration tool that provides a forum for users to share their ideas on a document.
  52 +<br /><br />
  53 +<h3>Edit Metadata</h3>
  54 +Displays existing metadata on the currently selected document and allows you to edit the document's generic metadata.
  55 +<br /><br />
  56 +<h3>Email</h3>
  57 +Allows you to send an email message to one or more KnowledgeTree users or groups, and provides a link to the currently selected document.
  58 +<br /><br />
  59 +<h3>Generate PDF</h3>
  60 +Converts a currently selected document to PDF format. To view the file you need to have a PDF Reader installed. KnowledgeTree supports PDF conversion for the following file formats: doc, ods, odt, ott, txt, rtf, sxw, stw, xml, pdb, psw, ods, ots, sxc, stc, dif, dbf, xls, xlt, slk, csv, pxl, odp, otp, sxi, sti, ppt, pot, sxd, odg, otg, std, asc
  61 +This action displays only when the file format of the currently selected document is one of the supported options.
  62 +By default, the converted PDF is downloaded to your desktop. You may browse to select another location.
  63 +<br /><br />
62 <h3>Links</h3> 64 <h3>Links</h3>
  65 +Allows you to display or remove existing links and create new links, and to open linked documents on a currently selected document. Document links establish associations between documents in the repository, and link to pages or sites on the Internet. Note that when creating document link types, the administrator specifies the type of relationship that the link implies between the linked documents โ€“ i.e. โ€˜associated withโ€™, or โ€˜duplicated byโ€™. KnowledgeTree ships with the following predefined link types: Attachment, Reference, Copy.
  66 +<br /><br />
  67 +<h3>Make Immutable</h3>
  68 +Locks the currently selected document so that no further content changes can be made to this document, and only administrators (in administration mode) can make changes to the metadata or can move or delete it. If you require assistance from an administrator to perform one of these tasks, use the Request Assistance action.
  69 +<br /><br />
  70 +<h3>Move</h3>
  71 +Moves the currently selected document to another location in the repository. Only users with the read and write permissions on a folder are allowed to move an item to another location in the repository.
  72 +<br /><br />
  73 +<h3>RSS</h3>
  74 +Generates a link on a currently selected document. You may copy the document link to an external aggregator to create a RSS Feed on the document in the repository. Ensure that your RSS reader is RSS 2.0 compatible.
  75 +<br /><br />
  76 +<h3>Rename</h3>
  77 +Renames the file name of a document, if you have 'write' permissions on the document. This action does not change the document title. It only changes the file name. For example, if you have a jpeg image file in the repository, and you want to change it into a bitmap. This involves renaming the file from filename .jpg to filename .bmp; then, checking out the .jpg file and checking in the bitmap version.
  78 +<br /><br />
  79 +<h3>Request Assistance</h3>
  80 +Sends a request for assistance on a document to the system administrator and the document owner.
  81 +<br /><br />
  82 +<h3>View Inline</h3>
  83 +Displays the content of a document within the document management system so that you can view it inline. Currently (April 2008), the View Inline plugin supports the following file types: png, jpeg, gif, tiff, html, xml, plain text documents
  84 +Future versions of KnowledgeTree may support additional file types. To preview other file types, convert the document to PDF, then download the document to view it. This action displays only when the current document is of a supported file type.
  85 +<br /><br />
  86 +<h3>Workflow</h3>
  87 +Displays assigned workflows (if any), and allows you to perform transitions on an existing workflow. This action also allows you to start a workflow on a currently selected document (if there is no existing workflow on the document).
63 88
64 -Document links allow you to establish associations between documents in the repository. Your KnowledgeTree administrator needs to create the Document Link Types that you use to link documents. When creating a document link, the administrator specifies the type of relationship that the link implies between the linked documents i.e. 'associated with', or 'duplicated by'.  
65 -  
66 -<h3>Version Control</h3>  
67 -  
68 -KnowledgeTree has powerful document version control features, which ensure that the editing and versioning of documents is done in a controlled and auditable manner. Newly created documents are assigned as version 0.1. The first time you check it out for editing and then check it back in again, the version number increments to version 1. Each subsequent check out / check in causes the version number to increment by 1.  
69 -<br></br>  
70 -A document may only be checked out for editing by a single user at a time. When a document is checked back in, you need to specify the changes you made.  
71 -<br></br>  
72 -Users and groups who have read or write access to a document are allowed to download it for viewing only ย– you can choose to open the document in your Web browser or save it to your local computer. You can view a version history of all changes to the document, and you can download previous versions for comparison.  
73 -<br></br>  
74 -Any changes you make to the document you downloaded won't display in the version in the repository unless you check out the document, and then check it back into the repository with your changes.  
75 -<br></br>  
76 -Any user that logs in to KnowledgeTree can view the list of documents they have checked out (if any) in the Checked-out documents section of the Dashboard.  
77 -  
78 -<h3>Permissions</h3>  
79 -  
80 -Permissions in KnowledgeTree are folder-based - permissions that have been allocated for a specific folder apply to all the documents in that folder.  
81 -<br></br>  
82 -There are four default types of permissions: <b>Read</b>, <b>Write</b>, <b>Add Folder</b>, and <b>Manage Permissions</b>.  
83 -<br></br>  
84 -Users that have only Read permission on a document can view the document and its metadata, but are not allowed to change it. Users that have Read and Write permissions are allowed to change the contents of a document, as well as its metadata.  
85 -<br></br>  
86 -Users with the Add Folder permission are allowed to create and edit sub-folders within their group folder.  
87 -<br></br>  
88 -Users with the Manage Permissions permission are able to edit permissions within the  
89 89
90 </body> 90 </body>
91 </html> 91 </html>
kthelp/ktcore/EN/user/portlets/Folder Actions.html
@@ -3,81 +3,45 @@ @@ -3,81 +3,45 @@
3 <title>Folder Actions</title> 3 <title>Folder Actions</title>
4 </head> 4 </head>
5 <body> 5 <body>
6 -<h2>Folder Actions</h2>  
7 -  
8 -<p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">This menu displays the functionality available to the logged in user for the folders listed on the right of the page in </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Browse Documents</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">.&nbsp; </span></p>  
9 -  
10 -<p class="p_Fieldgroup"><span class="f_Fieldgroup"><h3>Using Folder Actions</h3></span></p>  
11 -<p class="p_BodyText"><span class="f_BodyText">The options that the  
12 -system displays in this menu are permissions-based. If you do not have  
13 -permissions to perform one or more of the folder actions, you will not  
14 -see the option for that action in this menu when you log on to  
15 -KnowledgeTree:</span></p>  
16 -  
17 -<div style="margin: 0px; padding: 0px; text-align: left; text-indent: 0px;"><table style="border: medium none ; -x-border-x-spacing: 0px; -x-border-y-spacing: 0px;" border="0" cellpadding="4" cellspacing="0">  
18 -<tbody><tr style="text-align: left; vertical-align: top;">  
19 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px; background-color: rgb(243, 243, 243);" bgcolor="#f3f3f3" valign="top" width="94"><p><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Action</span></p>  
20 -</td>  
21 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px; background-color: rgb(243, 243, 243);" bgcolor="#f3f3f3" valign="top" width="459"><p><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Result</span></p>  
22 -</td>  
23 -</tr>  
24 -<tr style="text-align: left; vertical-align: top;">  
25 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px;" valign="middle" width="94"><p><span style="font-family: 'Verdana'; font-style: italic; color: rgb(0, 0, 0);">Add Document</span></p>  
26 -</td>  
27 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px;" valign="top" width="459"><p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">&nbsp;</span></p>  
28 -<p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">Opens the </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Add a document</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);"> page, where you can add a document to the currently selected folder.</span></p>  
29 -  
30 -</td>  
31 -</tr>  
32 -<tr style="text-align: left; vertical-align: top;">  
33 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px;" valign="middle" width="94"><p><span style="font-family: 'Verdana'; font-style: italic; color: rgb(0, 0, 0);">Add a Folder</span></p>  
34 -</td>  
35 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px;" valign="top" width="459"><p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">&nbsp;</span></p>  
36 -<p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">Opens the </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Add a folder</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);"> page, where you can add a folder to the repository.</span></p>  
37 -</td>  
38 -</tr>  
39 -  
40 -<tr style="text-align: left; vertical-align: top;">  
41 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px;" valign="middle" width="94"><p><span style="font-family: 'Verdana'; font-style: italic; color: rgb(0, 0, 0);">Rename</span></p>  
42 -</td>  
43 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px;" valign="top" width="459"><p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">Opens the </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Rename</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);"> page, where you can change the name of the currently selected folder.</span></p>  
44 -</td>  
45 -</tr>  
46 -<tr style="text-align: left; vertical-align: top;">  
47 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px;" valign="middle" width="94"><p><span style="font-family: 'Verdana'; font-style: italic; color: rgb(0, 0, 0);">Permissions</span></p>  
48 -</td>  
49 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px;" valign="top" width="459"><p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">&nbsp;</span></p>  
50 -<p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">Opens the </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Folder permissions</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);"> page, where you can view or edit group permissions.</span></p>  
51 -  
52 -</td>  
53 -</tr>  
54 -<tr style="text-align: left; vertical-align: top;">  
55 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px;" valign="middle" width="94"><p><span style="font-family: 'Verdana'; font-style: italic; color: rgb(0, 0, 0);">Bulk Upload</span></p>  
56 -</td>  
57 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px;" valign="top" width="459"><p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">&nbsp;</span></p>  
58 -<p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">Opens the </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Bulk import</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);"> page, where you specify a path to an </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">archive (ZIP) folder</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);"> on your local computer that you want to add to the repository.</span></p>  
59 -</td>  
60 -</tr>  
61 -  
62 -<tr style="text-align: left; vertical-align: top;">  
63 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px; height: 75px;" valign="middle" width="94"><p><span style="font-family: 'Verdana'; font-style: italic; color: rgb(0, 0, 0);">Allocate Roles</span></p>  
64 -</td>  
65 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px; height: 75px;" valign="top" width="459"><p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">&nbsp;</span></p>  
66 -<p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">Opens the </span><span style="font-family: 'Verdana'; font-weight: bold; color: rgb(0, 0, 0);">Allocate Roles</span><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);"> page, where you can set up or change roles.</span></p>  
67 -</td>  
68 -</tr>  
69 -<tr style="text-align: left; vertical-align: top;">  
70 -<td style="border: 1px solid rgb(0, 0, 0); width: 94px;" valign="middle" width="94"><p><span style="font-family: 'Verdana'; font-style: italic; color: rgb(0, 0, 0);">Bulk Export</span></p>  
71 -  
72 -</td>  
73 -<td style="border: 1px solid rgb(0, 0, 0); width: 459px;" valign="top" width="459"><p><span style="font-family: 'Verdana'; color: rgb(0, 0, 0);">Allows you to download (for viewing only) the entire contents of the currently selected folder, in one zipped file. </span></p>  
74 -</td>  
75 -</tr>  
76 -</tbody></table>  
77 -</div>  
78 -<p><span class="f_BodyText">&nbsp;</span></p>  
79 -  
80 6
81 7
  8 +<h2>About this folder</h2>
  9 +<h3>Display Details</h3>
  10 +Displays folder content.
  11 +<br /><br />
  12 +<h3>Folder Transactions</h3>
  13 +Displays a transaction history for the currently selected folder. Details include: username, action taken, date, comment.
  14 +<br /><br />
  15 +<h2>Actions on this folder</h2>
  16 +<h3>Add Document</h3>
  17 +Allows you to add a new document to the currently selected folder in KnowledgeTree's web interface. The document is uploaded from your local computer.
  18 +<br /><br />
  19 +<h3>Add a Folder</h3>
  20 +Adds a new sub folder (child folder) to the currently selected folder. Only users with the 'Add Folder' permission on a parent folder may add folders to the that parent folder in the repository.
  21 +<br /><br />
  22 +<h3>Allocate Roles</h3>
  23 +Only the KnowledgeTree administrator may allocate and edit roles. This action displays only for administrative users.
  24 +<br /><br />
  25 +<h3>Bulk Download</h3>
  26 +Downloads the entire contents of a folder stored in the document management system to a zipped file, which you can save to your computer for local viewing. This action displays only when you have permissions for this action on the folder.
  27 +<br /><br />
  28 +<h3>Bulk Upload</h3>
  29 +This action is only available where the functionality is available for your installation. Files should be placed in a zipped archive at the source location before performing this action. Bulk uploaded files retain the directory structure defined in the zip archive. Ensure that you use a supported compression format for bulk uploads to KnowledgeTree: Tgz, Tar, Zip, Deb, Ar
  30 +<br /><br />
  31 +<h3>Import from Server Location</h3>
  32 +Adds all documents and folders that are located at a specified location on your local server. This action is only available to the KnowledgeTree administrator.
  33 +<br /><br />
  34 +<h3>Permissions</h3>
  35 +Displays permissions setup on the currently selected folder. This action displays only if you have permissions for this action on the folder.
  36 +<br /><br />
  37 +<h3>RSS</h3>
  38 +Generates a link on a currently selected folder. You may copy the document link to an external aggregator to create a RSS Feed on the folder. Ensure that your RSS reader is RSS 2.0 compatible.
  39 +<br /><br />
  40 +<h3>Rename</h3>
  41 +Allows you to change the name of the currently selected folder. This action displays only if you have the required permissions on the folder, and is only allowed on the root folder.
  42 +<br /><br />
  43 +<h3>Usage Information</h3>
  44 +Displays reports on how the folder and its sub folders have been used. Usage information may be filtered by user, by general activity (date range, transaction type), and by folder content (workflow and document type).
  45 +<br /><br />
82 </body> 46 </body>
83 </html> 47 </html>
kthelp/ktcore/EN/user/portlets/Subscriptions.html
@@ -4,8 +4,16 @@ @@ -4,8 +4,16 @@
4 </head> 4 </head>
5 <body> 5 <body>
6 <h2>Subscriptions</h2> 6 <h2>Subscriptions</h2>
7 -<p>Subscribing to a document or folder will cause email notifications to be sent to you via email, when actions are performed on a document or folder that you have subscribed to - i.e you will be notified when a document or folder is checked in, checked out, deleted, moved, archived etc.</p>  
8 -  
9 -<p>Your notifications also display on the Dashboard. Unsubscribing prevents further notifications from being sent to you when further actions are performed on the document or folder after you have removed your subscription. </p> 7 +<p>
  8 +Use the <b>Subscriptions</b> menu to view and remove existing subscriptions, and add new subscriptions on documents and folders.
  9 +</p>
  10 +<br />
  11 +<p>
  12 +Subscribing to a document or folder allows notifications to be sent to you via email (if you have this feature activated on your system) when the document or folder is checked in/checked out, deleted, moved, archived, etc.
  13 +</p>
  14 +<br />
  15 +<p>
  16 +User-specific notifications display on the Dashboard as internal RSS Feeds. Remove a subscription (unsubscribe from the document or folder) to stop receiving notifications.
  17 +</p>
10 </body> 18 </body>
11 </html> 19 </html>
kthelp/ktcore/EN/user/workflow.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html> 2 <html>
3 <head> 3 <head>
4 -  
5 -  
6 - <title>Workflow Overview</title> 4 + <title>Workflow Overview</title>
7 </head> 5 </head>
8 6
9 <body> 7 <body>
10 -<h2>Workflow Overview</h2>  
11 -<p>Workflow allows you to assign a series of steps to the document creation and  
12 -management process. For example, a "News" workflow might have documents which  
13 -go from <strong>Research</strong> to <strong>Draft</strong> to <strong>Under Review</strong>  
14 -to <strong>Published</strong>,  
15 -with different people participating in the document's  
16 -lifecycle at each stage. &nbsp;Naturally, not all documents have the  
17 -same needs in terms of workflow: &nbsp;Invoices (which must be <span style="font-weight: bold;">drawn up</span>, <span style="font-weight: bold;">maile</span>d, and then marked as <span style="font-weight: bold;">paid</span>) are very different from Marketing documents.&nbsp;</p>  
18 -<p>To facilitate this, KnowledgeTree allows the Administrator to  
19 -define a number of different workflows, each of which can be applied to  
20 -different documents as their organisation requires.</p> 8 +<h2>View Assigned Workflows on a Selected Document</h2>
  9 +<ul>
  10 +<li>1. Open the Document Details page of the document.</li>
  11 +<li>2. Click Workflow.</li>
  12 +<li>3. View settings for the workflow.</li>
  13 +</ul>
  14 +<br />
  15 +<h2>Start a Workflow on a Document</h2>
  16 +You cannot override an existing workflow on a document.
  17 + <ul>
  18 +<li>1. Open the Document Details page of the document.</li>
  19 +<li>2. Click Workflow.</li>
  20 +<li>3. Select a workflow.</li>
  21 +<li>4. Click Start Workflow.</li>
  22 +</ul>
  23 +<br />
  24 +<h2>Transition a Workflow</h2>
  25 +<ul>
  26 +<li>1. Open the Document Details page of the document.</li>
  27 +<li>2. Click Workflow.</li>
  28 +<li>3. View settings for the workflow.</li>
  29 +<li>4. Select a transition. Provide a reason for the transition. </li>
  30 +<li>6. Click Perform Transition.</li>
  31 +</ul>
  32 +<br />
  33 +<h2>Working with Workflows</h2>
  34 +The KnowledgeTree administrator defines and manages document workflows in DMS administration. When adding workflows, the administrator defines the workflow states, transitions, and workflow effects.
  35 +<br /><br />
  36 +<h3>Assigning workflows</h3>
  37 +A document may only have one workflow attached to it at any time. Workflows may be assigned manually on a per document basis, or automatically to specified documents.
  38 +<br /><br />
  39 +
  40 +<h3>States and Transitions</h3>
  41 +Workflows consist of States and Transitions. Transitions point to the next step in the workflow, and represent actions that may be performed on a document. For example, on a workflow called 'invoicing', 'billed may be a starting state, and 'paid' the end state; the workflow may be moved into the final state by the transition 'payment received'. Each state can have one or more transitions, depending on the workflow configuration. Some transitions may be 'guard transitions' that may only be performed by specified users.
  42 +<br /><br />
21 43
  44 +<h2>Adding and Using Workflows</h2>
  45 +<h3>Workflow planning</h3>
  46 +1. Define the following details and business process of the workflow:
  47 +<ul>
  48 +<li>define a name for the workflow</li>
  49 +<li>plan workflow states</li>
  50 +<li>plan the transitions that lead to the states</li>
  51 +<li>consider workflow security at the various states and transitions - i.e. Will you only allow users that have been allocated to specific roles to perform one or more transitions? Must users have permissions to perform some transitions? </li>
  52 +</ul>
  53 +<br />
  54 +<h3>Getting Started</h3>
  55 +1. Add the workflow to KnowledgeTree:
  56 +<ul>
  57 +<li>1.1. define the workflow name</li>
  58 +<li>1.2. list the states</li>
  59 +<li>1.3. list the transitions</li>
  60 +<li>1.4. connect transitions and states (configure the workflow process)</li>
  61 +</ul>
  62 +<br />
  63 +2. Configure the workflow - set up security by state; assign permissions that are controlled by each state in the workflow; allocate state controlled permissions to groups and roles
  64 +<br /><br />
  65 +2.2. Set up notifications by state - select groups and roles who will receive notifications at specified states
  66 +<br /><br />
  67 +2.3. Configure transitions - set up guard triggers, and add transition effects (actions), which define what happens after the transition occurs, e.g. perhaps the document moves to a particular folder.
  68 +<br /><br />
  69 +
  70 +<h3>Working with existing workflows</h3>
  71 +After adding and configuring the workflow, you can perform the following tasks, if required:
  72 +<ul>
  73 +<li>edit the workflow name</li>
  74 +<li>enable / disable the workflow</li>
  75 +<li>add new states</li>
  76 +<li>add new transitions</li>
  77 +<li>edit the workflow process - i.e. change the connections you set up between states and transitions</li>
  78 +<li>view permissions that are currently controlled by states</li>
  79 +<li>remove state control of permissions</li>
  80 +<li>remove state-controlled permissions from groups and roles</li>
  81 +<li>view actions that are blocked by each state in the workflow</li>
  82 +<li>unblock document actions that are currently blocked by states in the workflow</li>
  83 +<li>view existing notifications</li>
  84 +<li>edit notifications</li>
  85 +<li>change the transition name</li>
  86 +<li>edit the transition restrictions</li>
  87 +<li>edit transition actions</li>
  88 +</ul>
22 </body> 89 </body>
23 </html> 90 </html>