KRYSTAL DMS - Standard Edition - 2019 - Users Guide

Getting Started


KRYSTAL DMS - Standard Edition can be accessed using any standard Java enabled web browser from anywhere on your corporate intranet / extranet or internet.

To access KRYSTAL DMS - Standard Edition server, you can open the browser and visit http://localhost:portno/ to get connected on the server where it is installed.

If you are on a machine other than on which KRYSTAL DMS - Standard Edition is installed then visit http://hostname:portno/ where hostname is the name / IP address of the machine where it is installed and 'port number' on which it is configured to be running.


Login Screen

To gain access to KRYSTAL DMS - Standard Edition, users need to supply their secure user name and password. Once logged in, users can navigate through all accessible documents using My Workspace.

On logging to the KRYSTAL DMS - Standard Edition, user is presented with his / her workspace. This area is designated as My Workspace.


My Workspace

This module provides a snapshot of the entire document library and applications available to the logged-in user.

User can access every function of the system from right within the My Workspace. Here user is presented with following applications.

  • Document Classes
  • DocViews
  • Checked Out Documents
  • Announcements
  • Discussions
  • Recent Access History
  • My Profile
  • Document Charts
  • Bookmarks
  • Document Tags

The Main Menu of the system enables user to access various features of the system.

Logged-in users can access each and every module of the system using the main menu of the application. This is a drop down menu which contains following sub menus

  • My Workspace
  • Control Panel (Only for Administrators)
  • Add Document
  • My Profile (Icon)
  • Help (Icon)

Along with the sub menus the menu also contain a global search feature that enables user to enter any term which s/he would like to search in the entire document repository.


Main Menu

My Workspace

Under this sub menu of the application, users can access following menu items / actions

  • Document Classes
  • DocViews
  • Checked Out Documents
  • Announcements
  • Discussions
  • Bookmarks
  • Search Notes
  • View Exception Logs

Control Panel (Only for Administrators)

Under this sub menu of the application, administrator type of users can access following menu items / actions

  • Manage User
  • Manage Groups
  • Manage Document Classes
  • Manage Indexes
  • Manage Lists
  • Manage ACL Templates
  • Manage Hotlinks
  • Manage Announcements
  • Manage Discussions
  • Manage Global Settings
  • Manage Jobs
  • System Reports
  • Recycle Bin
  • Utilities

This feature allows user to search across all document classes to which s/he has at least read permissions.

Users can use operators like 'OR', 'AND', 'NOT' along with wildcard characters to search documents. For example :

  • Trey OR 60035 - This will search all documents which will contain either Trey or 60036 anywhere in the document indexes and other meta-data fields.
  • Trey AND 60035 - This will search all documents which will contain both the term Trey and 60036 anywhere in the document indexes and other meta-data fields.
  • Trey NOT 60035 - This will search all documents which will contain only the term Trey and not 60036 anywhere in the document indexes and other meta-data fields.
  • Gains* - This will search all the terms which starts with Gains anywhere in the document indexes and other meta-data fields.
Global Search Results

Add Document

Users can upload / store documents using this function of the system

User

Here user can see and edit his/her profile, preferences , password and picture

  • My Profile
  • Logout

Help

  • User's Guide
  • Administrator's Guide

Document Classes are nothing but a group of similar documents. Document which are similar in its functional capabilities are grouped under a particular document class. You can also consider a Document Class as category of document. For example, Invoices, Purchase Orders, Shipping Confirmations etc.

On clicking My Workspace -> Document Classes link on the main menu of the system, user will be presented with a list Document classes to which s/he has at least read permissions. The number of document classes on the page is restricted by the hit-list size parameter of user’s preferences.

Document Classes

To view all the documents in a particular document class, user can click on name of the document class. This will open up a hit list of documents.

Open Document Class

Please refer to Document Hit-list section of this guide for further details.

Logged-in user can perform various searches on a particular document class on document indexes and meta-data. To search within a document class user can click on Search icon associated with document class. User is presented with Basic Search and Advance Search option in this module of the system.

Basic Search

User can search across all document indexes using this simple search feature. User can use BOOLEAN search mechanism by using keywords like "AND" , "OR" , and "NOT" to perform searches across all indexes and other meta data of the document.

Basic Search

To search documents user can enter any of the criteria and click on Show Hits button. The resultant document hit-list will display all documents which matches users search criteria.

 

Advance Search

Users can perform searches across all indexes in a document class. User can select from multiple operators to perform a search across indexes.

Advance Search

These operators are as given below.

  • Is
  • Is Not
  • Like
  • Not Like
  • Is Greater Than
  • Is Lesser Than
  • Between
  • Is Empty
  • Is Not Empty

Along with indexes, users can also perform searches on following meta-data fields

  • Document ID
  • Creation Date (Created On)
  • Last Modification Date (Last Modified On)
  • Expiry Date (Expiry On)
  • Document Type
  • Created By
  • Last Modified By
  • Search all revisions

Document class statistics are also displayed with the search filters.

To search documents user can enter any of the criteria and click on Show Hits button. The resultant document hit-list will display all documents which matches users search criteria.

 

Search Results

User can perform index search across all the document classes to which s/he has at least read permissions. User will enter search text and click on the Search button to get a search result.

All the indexes across each of the document classes are queried by the system and matching results are displayed to the user. If matching value is found in the document class and if user has access to this document class then it will be displayed along with matching number of documents.

Advance Search Results

Please refer to Document Hit-list section of this document for further details.

To add a new document into existing document class, user can use this option. The option of adding a document is available only to those users who have create/add permissions on the document class. Clicking on Add Document link will open a page where user can select a document to upload from his/her workstation.

User must select a document and a document class to upload/capture a document into the system. User must also enter all the required / mandatory indexes defined for document class in order to store / upload the document to the system.

Add Document Form
Users can add document to the repository directly from the main menu Add Document action as well. In this case user first have to select a Document Class, on selection of the class, all other meta-data indexes and document selection control will be displayed to the user.

On clicking the Submit button, the document will be uploaded to the server system and stored in the selected document class along with index information.

User must input all mandatory fields in order to upload the document to the system.

Users can also upload more than one document in a single go using the Bulk Upload feature of the system. Once user clicks on Bulk Upload link, bulk upload page is displayed to the user.

User can select documents to be uploaded by clicking on the Add Document button or by simply dragging and dropping documents on the area marked.

Bulk Upload Document Form

On clicking the Save button, the documents will be uploaded onto the server in bulk mode.

Users have access to a dashboard for each document class. The Document Class Dashboard provides a birds-eye view of documents available in the document class.

Document Class Dashboard

To get notifications on changes made on documents, user can subscribe to various events on a document classes. User can subscribe to following events for a particular document class.

  • Batch Import
  • Document is added
  • Document is edited
  • New version of document added
  • Document marked as deleted
  • Document marked as expired
  • Document is expiring in X-days
Manage Subscriptions

User can choose appropriate check boxes and click on a Save button to subscribe.

KRYSTAL DMS - Standard Edition provides a highly sophisticated mechanism to display document classes in a tree format.

Document Class Tree View

Users can view Document Classes and on expanding them they can see indexes associated with it. On expanding the indexes, users can view the values assigned to the indexes.

Document Class Tree View - Hitlist

On clicking the index values, user will be redirected to the page where all documents having the same index value will be displayed to the user.

Document Hit-list displays all the matching documents from various searches or all documents from document classes.

Document Hitlist

Depending upon the permissions assigned to logged-in user, s/he can perform many actions on a document. Please refer following section for more details

Document Hit-list can be exported in excel format by clicking on Export to Excel button available below the document list.


The resultant excel sheet will contain all matching records which are available in hit-list and shown on the screen in Microsoft Office Excel 2007 format (.xlsx).

If users have delete permissions assigned on the document class then a Delete link will be available to the user to delete documents. User must select at least one document by selecting the document to be deleted using associated checkbox.

Users can perform this activity on head revision of the document and only on those documents which are not locked. On clicking the link a confirmation is taken from the user and then delete operation is carried out.

Delete Documents

On completion of delete operation, documents are moved to Recycle Bin of the system (accessible to administrators only) in Control Panel. These documents are no longer accessible by other end users unless they are restored back from Recycle Bin.

If users have download permissions assigned on the document class then a Download as Zip link will be available to the user to download documents in zip file format. User must select at least one document by selecting the document to be downloaded using associated checkbox.

Users can perform this activity on head revision of the document and only on those documents which are not locked. On clicking the link a zip file is generated by the system and made available for download to the end user.

If users have applied any filter while searching the Document Class then a link will be available to the user Save as DocView.

On clicking this link, user will be redirected to a page where s/he need to enter DocView Name and DocView Description and save the hit-list as DocView

Save as DocView

 

The resultant document-hitlist will be shown as given below when users click on the DocView

 

Save as DocView from HitList

User can perform diverse range of operation on the documents by clicking on and selecting any of the following action available according to access permissions from resultant hit list.

User can view the document by using this action. KRYSTAL Document Viewer will display the document from within the browser directly if it is supported. Otherwise document can be opened by native application installed on the logged in user’s desktop.

KRYSTAL Document Viewer is a pure HTML based document viewer that enables users to perform a variety of imaging functions like zoom-in, zoom-out, rotate, annotate etc.

View Document

Users can toggle the display of the thumbnails for each page of the document.

If users have appropriate permissions then s/he can create annotations like highlights, blackout, sticky notes, rubber stamps, notes etc.

Users with write permissions can edit the indexes associated with the document.

Indexes are displayed besides the document in editable format if user has permissions to edit values.

This action is available only if the document is not checked out by any user. If the document is checked out then the indexes will not be available for editing to the users of the system.

Edit Document Indexes

Apart from index values users can also define the expiry date for the document using this feature of the system.

Properties of the document is displayed in a tabular manner in this section of the View Document module.

Properties like Document ID, Revision ID, File Name, File Size, Created By etc are displayed here.

Document Properties

If a document is stored in a document classes with revision control enabled, then this section will be displayed to the user. User can view the complete revision history of the document by using this feature.

 

Revision History

Document can be rated using this feature of the system.

Document Rating Form

User can only rate a document revision once. Total ratings and number of votes are also displayed on the document view page.

Document can be shared as an attachment in an email by users who have email permission.

Share Document

User must enter a valid email addresses separated by commas and provide the comments before sharing the document. The comments entered by the user will be added to the email and sent to the email addresses.

User can select email addresses to which s/he has shared documents earlier by clicking on the "Select..." button available.

On clicking the button, a popup window is displayed to the user from where user can search email and select email addresses by clicking on the checkbox associated with each email address. User can click on "Done" button to close the popup window after selecting the desired email addresses.

Select Email Addresses

User can bookmark the document for future retrieval and easy access.

Bookmark Document

User can input the name for the bookmark and click on the save button and the bookmark will be available in bookmarks section of the My Workspace.

Document Tags are labels that you can add on documents to help you describe them.

Unlike subjects in the meta-data indexes of the document, you don't have to choose tags in a closed list. You are free to apply the labels that describe the document best.

Document Tag Form

Users can add any labels / tags on a document for quick and easy searching. Users can add and delete document tags created by him/her using this feature of the system. Administrator user can delete any tag applied by any user.

Users with write /edit permissions can move document from one Document Class to another. User will be presented with a page which will allow user to select a Document Class to which the document needs to be moved to.

On selecting the Document Class, all indexes from that class will be displayed to the user with matching indexes being populated from source Document Class.

Move Document Form

Only document the initial revision of the document can be moved from one document class to another. Any revision of document greater than 1.0 is not allowed to move from one class to another.

Document Actions

Users can also perform many other actions on the document depending upon the rights (permissions) assigned to the users and the staus of the document.

Users can download document, download document's content and revise document with check-out and check-in features available in the system.

User with download permissions can download the document by clicking this action button. On clicking this action the document will be downloaded on the logged in user’s desktop and user can save this document on his/her desktop

Download Document

KRYSTAL DMS - Standard Edition allows users to check-out and check-in documents in to repository. Users with check-out permissions can check out document from a document class by clicking the Check-out button. The document is then downloaded on the local machine into a pre-defined path set by user in the preferences.

If revision control is enabled on the document class and if the document is not checked-out and if the logged in user has checkout permissions then s/he can check out the document to his/her desktop for modifications.

Document Checkout Done

The original document will not be edited / changed / modified in the repository.

To check-in the document back into repository, users can use this feature of the system.

Document Check-in

If document is checked out and if the user has check in privileges / permissions then and then only this action will be available on the document. User must select a document and define the version (Major / Minor) and submit the form to check in the document in the repository.

Comments added while check in of the document will be considered as a note on the document. Both, old and new version of the document will be available in repository for searching and access.

User can cancel the checkout of the document by clicking on this button. The document will then be marked as available for checkout. This action of cancelling the checkout will be registered in Revision History of the document.

Cancel Document Checkout

 

Cancel Checkout

The document will now be available again for editing by other users who have checkout permissions on the document class.

Users with delete permissions can delete the document if the document is not checked out. On clicking the Delete Document button, an alert will appear for confirmation to delete the current document.

 

Delete Document Alert

On confirming the delete action, the document will be marked as deleted.

Delete Document

Document will then move to Recycle Bin from where it can be restored or deleted permanently by the administrator user.

Certain documents are difficult to be classified in document classes as they are supporting documents for a specific document. Such files / images / documents can be added as an attachment to a document.

While viewing a document, user gets an option to add attachment to the document. User can click on the attachment tab associated with the document to manage attachments for the document.

Document Attachments

Users can view attachment by clicking on the attachment title on the attachment list page or by clicking on the attachment title available on document window.

Add Attachment

A form is available to the user where user can choose the file / document to be added as an attachment along with title and keywords for attachment.

Add Document Attachment

User can click on Submit button to add the attachment

Remove / Delete Attachment

Administrators or users who have created or added the attachments can remove these attachments by using delete action associated with the attachment.

This feature displays a complete access history of the document by all users. It displays the action, user name, IP address, date and time of the action, type of object, parameters and comments as given below.

Document Access History

This action provides a complete Audit Log Details of the document, starting from the day it is created. Users will be able to track every activity performed on a particular document using this feature of the system.

Users can also filter the access history by date using the form available on this section.

Users can access documents which are hot-linked to current document using this tab of the system. If there are multiple document classes linked with current document's document class then multiple hot-link items will be displayed.

Document Hotlink

List of all matching documents from hot-linked document class will be displayed on click of the menu item. If no documents are matching then appropriate message is displayed to the user.

DocViews are similar to the views made on database tables or can be used as saved searches. In this case the database tables are replaced by Document Classes. A snapshot of Document Class is known as a DocViews.

DocViews (Document Views)

Just like database views, DocViews also provides a read only access to the selected Document Classes. Users with administrative privileges can create Public and Private DocViews. Normal users can create views which are Private and are accessible only by them.

Users can access public DocViews created by administrator and his/her own private DocViews from DocViews section of My Workspace. DocViews can also be accessed from My Workspace -> DocViews menu from top navigation bar.

User can perform various actions on the DocViews using this section of the system.

To create a DocView, click on Add DocView link on this section.

Following steps are required for creation of DocView.

Select Document Class

In STEP 1 of the process, the user is asked to select a document class from the available Document Classes to create a DocView.

DocViews - Step 1

Select Document Class Indexes

In STEP 2 of the process, the user is asked to select at least one index from the selected document class to create a DocView.

DocViews - Step 2

After selecting Document Class, user will be asked to select indexes from the selected document class. User can set search criteria at this stage for each of the index available in selected document class.

If the user has administrative privileges then option of creating a public DocView will be present for this user, otherwise the DocView will be private.

User must enter all mandatory fields and click on the Save button to create the DocView.

The newly created DocView will appear under DocViews section of My Workspace. User can click on Open link to view all the documents qualified by the DocView or can use Search link to further refine the search of the documents.

Public DocViews are accessible by all the users of the system. Private DocViews are only accessible to the logged in user. Administrator user can however manage all the DocViews.

Administrator or users who have created the DocView can delete a DocView by selecting the DocView and clicking on the Delete link associated with the DocView

On clicking the Delete link, a confirmation is taken from the user and on confirming the delete operation DocView will be deleted from the system. DocView deleted once cannot be recovered.

Checked Out document can be accessed through My Workspace -> Checked out Documents menu of the top navigation bar. Here list of checked out document will be displayed to the user.

Checked Out Documents

User can view document, view document properties, revision history by clicking on appropriate link associated with the checked-out document.

This section also displays name of the document class, checkout path and date and time of the checkout along with actions to cancel the checkout or check in the document in the repository.

User can view all the announcements by clicking on My Workspace -> Announcements menu on top navigation bar.

Announcements

In this module all the available announcements are displayed to the user. To view the details about the announcement, user can click on the title of the announcement.

View Announcements

User can view all the discussions which are active, by clicking on My Workspace -> Discussions menu on top navigation bar.

Discussions

In this module all the available discussions are displayed to the user. To view the details of the discussion, user can click on the title of the discussion.

View Discussion

User can enter a comment / posting for the current discussion and click on the SUBMIT button to post a comment on the discussion.

Users can bookmark documents to retrieve the documents at later date in a single click.

Users can have multiple bookmarks for multiple documents. User can manage all these bookmarks using this module of the system.

To gain access to the bookmarks module, user can click on My Workspace -> Bookmarks link from the main menu of the system. Alternately, user can also click on Bookmarks title link available on the Bookmarks section of the My Workspace screen.

Bookmarks

User can delete a bookmark by clicking on the Delete Bookmark link associated with the bookmark

This section details Utilities available to the user of KRYSTAL DMS - Standard Edition.

Users can use Search Notes utility from My Workspace module to search notes by particular user, on particular document class.

Users can search notes by using My Workspace -> Search Notes menu from top navigation bar.

Search Document Notes

User need to enter search text and select at least one document class and at least one user to perform the search.

On clicking the Search button, matching records are displayed to the user as depicted below.

Search Document Notes Results

Here user can view the document on which note is posted by clicking on View Document link.

Exceptions occurred during the current session of the user can be viewed using this module of the system. Users can view exception logs by clicking on My Workspace -> View Exception Logs menu on top navigation bar.

As shown below, this module will display Exception Title and Date time when the exception has occurred.

Exceptions

View Exception Details

To view details of the exception user can click on Exception Title or Date time. Here following details are displayed for each exception.

  • Exception Title
  • Exception Date Time
  • Exception Details

 

Exception Details

The My Profile menu item allows users to manage their profile information. Users can use following options.

Logged-in user can view his/her details and can change his/her profile picture.

My Profile

User can click on the profile picture and choose a picture to change profile picture.

Other details of user like email, groups assigned etc are available on this section of the system

Logged-in user can change his/her Real Name and Mobile number using this module of the system.

Profile picture can also be deleted by the user by clicking on the Delete link listed below the profile picture. On clicking the link, confirmation dialog is displayed to the user and on confirmation of the delete operation the profile picture of the user is deleted from the system.

Change password utility will help user to change his / her password.

The password must match following criteria.

  • Must of 8 character or more in length
  • Must contain at least one UPPER CASE letter
  • Must contain at least one LOWER CASE letter
  • Must contain at least one NUMERIC character
  • Must contain at least one SPECIAL character
Change Password

Only if the current password is matching with the user’s current password and new password and confirm password are same and at least 8 characters in length then it will be changed by clicking on the Submit button.

Users of KRYSTAL DMS - Standard Edition can customize various settings for the application using this module. This module allows user to set system preferences. User can define settings for hit-list size, hits columns, checkout path etc here. User can turn-on or turnoff the hit list columns and thumbnails in document viewer.

Preferences

To save these preferences user should click on SAVE button. The preferences will take effect immediately for the user in current logged in session.

To logout from the system, users can use this menu item under My Profile menu of the system. On click of the logout menu, confirmation is taken from the user and on confirming the action user is logged out from the system and appropriate message is displayed to the user. Logout Confirmation

To gain access to the system, user must enter his/her credentials.

This module allows users to gain access to his/her password. Users must enter his/her Username and registered email id to gain access to password.

Forgot Password

On submitting the details, if the details are valid then KRYSTAL DMS - Standard Edition will generate a link to reset the password and send the link to the registered email address (Email ID) of the user.

Reset Password Email

User can now use this link to reset the password. The link is valid only until next 30 minutes only.

Reset Password Form

Documents in KRYSTAL DMS - Standard Edition are viewed using KRYSTAL Document Viewer. This is pure HTML based viewer. The KRYSTAL Document Viewer comes bundled with KRYSTAL DMS - Standard Edition system.

The KRYSTAL - Document Viewer provides following functionalities to the in the browser.

  • Zoom In / Zoom Out
  • Rotate Document
  • Page Thumbnails
  • Pan Document
  • Annotations
    • Highlight
    • Readact / Blackout
    • Stick Notes
    • Notes
    • Rubber Stamps
    • Ellipse
  • Print Document (If print permission is assigned)
  • Full screen
Document Viewer

If document format is not supported by KRYSTAL - Document Viewer then it will allow user to view the document in its native application installed on clients desktop.

Document Viewer - Un supported document

KRYSTAL DMS - Standard Edition supports following formats to be viewed in the KRYSTAL - Document Viewer

  • Tagged Image File Format (*.TIF)
  • Portable Document Format (*.PDF)
  • Portable Network Graphics (*.PNG)
  • Joint Photographic Experts Group (*.JPG and *.JPEG)
  • Bitmaps (*.BMP)

Users with edit permissions on the document can create following annotations on the document.

  • Highlight
  • Readact / Blackout
  • Stick Notes
  • Notes
  • Rubber Stamps
  • Ellipse

Users can annotate document with any of the annotation type mentioned above.

Document Viewer - Highlight document
Document Viewer - Readact document
Document Viewer - StickyNote
Document Viewer - RubberStamp document
Document Viewer - Ellipse Annotation

User can delete the annotation created by him/her by selecting the annotation and then clicking on the Delete icon available on the annotation toolbar.

Delete Annotation

On clicking the delete icon, a confirmation is taken from user to delete the annotation. The changes are only saved once the user clicks the save icon on annotation toolbar.

Notes can also be added to the document using the notes feature of the KRYSTAL Document Viewer.

Document Viewer - Notes

User can only delete notes on the document which are posted by him or her. To delete a note user can click on delete icon associated with the note and on confirming the delete operation the note will be deleted.

Document Viewer - Delete Notes

Administrators and users who have created annotations can modify the annotations. Users can delete annotation created by him or her by selecting the annotation and then clicking on the delete icon on annotation toolbar.