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
  • Help & Guides

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

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
  • Hotlinks (Only for Administrators)
  • 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
  • Mange Groups
  • Manage Document Classes
  • Manage Indexes
  • Manage ACL Templates
  • Manage Checkouts
  • Manage Announcements
  • Manage Discussions
  • Manage Global Settings
  • Manage Jobs
  • System Reports
  • Recycle Bin

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

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. 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 the document class user can click on name of the document class. This will open up a hit list of document.

Open Document Class

 

Please refer to Document Hit-list section of this document 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.

Search Document Class

 

Search Criteria

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

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.

Document Hit List

 

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

 

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

Please Note : No index information is added to the document when documents are uploaded using this feature of the system.

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.

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

Document Hit-list

 

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

Export to Excel

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

Download Excel

 

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

Export to PDF

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

Download PDF

 

The resultant PDF will contain all matching records which are available in hit-list in PDF Format. All index information and document properties are available.

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 JAVA™ based applet 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 Index Form

 

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

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

Bookmark Document Form

 

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 can be shared as an attachment in an email by users who have email permission or can be shared as a URL link.

Share Document Form

 

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.

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 Tags 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.

KRYSTAL™ DMS - Standard Edition allows users to checkout 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.

Checkout Document Checkout Document

 

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

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

Check-in Document Form

 

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 Document Checkout

 

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

For document classes with revision control enabled, this action button will be available. Users can view the complete revision history of the document by using this feature.

Revision History

 

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

 

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

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

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

 

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.

Attachments Tab

 

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 Attachments Form

 

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.

A Note is a type of annotation that can be put on the document and it remains throughout the life span of the document.

Notes cannot be modified or deleted by users. Only Administrators can delete notes or the users who have created notes can delete it.

Users can create public as well as private notes. Public Notes are available to all users to view, while private notes are available only to the user who has created these notes.

Document Notes Tab

 

Unlike other annotations, notes are not based on the revisions of the document; it is available for all the revisions of the document.

Add Notes

A form is available to the user where user can choose the type of the note to be added along with the note for the document.

Add Notes Form

 

User can click on Submit button to add the note to the document

Remove / Delete Note

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

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.

Access History Tab

 

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.

Hot-links Tab

 

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 List

 

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 New 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.

Add DocView 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.

Add DocView 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.

Hotlinks features of the KRYSTAL™ DMS - Standard Edition allows administrator to link Document Classes with one another. Hotlinks allow users to view documents from linked classes in a single click.

Hotlinks are available while viewing the document. Users can view documents related to each other by using this feature of the system.

Administrator can create any number of hotlinks for a particular Document Class. Users cannot create hotlinks but they can use hotlinks features to view documents which are linked with each other in other Document Classes.

On clicking the Hotlinks menu item on the main menu of the application available hotlinks are displayed to the ADMINISTRATOR user. Users who have administrative privileges can access this feature.

Hotlink List

 

Administrator can create hotlinks by linking two Document Classes. Two classes must have a common index field in order to be linked with each other.

For example an Invoice class has an index field called PO Number which is also available in the Purchase Order class. On clicking Add a Hotlink link on this screen, Administrator will be taken to a page which will allow him/her to create a hotlink.

Select Document Class

The system will fetch all the active document classes here. Administrator should select a document class in order to create a new hotlink.

Hotlink Step 1

 

After selecting a Document Class, Administrator must click on NEXT button to continue. Matching indexes from both the classes will be displayed in next step.

Select Linked Document Class

Now the system will automatically identify all the document classes which are available in the system having common indexes with the class selected in previous step.

Hotlink Step 2

 

Select Index

Administrator can select one index on which s/he wants to link the original Document Class with Hot-linked Document Class as given below.

Hotlink Step 3

 

After entering the name for the hotlink, user can click on Submit button to save the Hotlink. User must select one index on which s/he wants to link the two document classes.

To delete a hotlink, Administrator user can click on Delete link associated with the hotlink record. On clicking the link a confirmation is taken, and on confirming the delete operation, hotlink is deleted from the system.

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 Document List

 

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.

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.

Bookmark List

 

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

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

Announcement List

 

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 Announcement

 

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

Discussions List

 

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.

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 Notes Form

 

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 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.

Exception List

 

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

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 Form

 

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 Form

 

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 new password and send the password to the registered email address (Email ID) of the user.

Documents in KRYSTAL™ DMS - Standard Edition are viewed using KRYSTAL™ Document Viewer. The KRYSTAL™ Document Viewer comes bundled with KRYSTAL™ DMS - Standard Edition system. The KRYSTAL™- Document Viewer provides following functionalities to the users.

  • Zoom In / Zoom Out
  • Rotate Document
  • Annotations
    • Blackout
    • Highlight
    • Stick Notes
    • Notes
    • Rubber Stamps
  • Print Document
  • Email Document
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 - Native

 

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)