<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><strong>In this guide we will cover:</strong></p><p><strong>- Turning on and Configuring the Module</strong></p><p><strong>- Agent Permissions</strong></p><p><strong>- Documents Area</strong></p><p><strong>- Folder Access Control</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">Turning on and Configuring the Module</span></strong></p><p>Halo has a dedicated area for document management. Here you can create folders, upload new documents, and manage versions of documents. First head into Configuration and hover to enable the module:</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM1N2M5YjQwLTQwOGMtNDFmNC1iZWMwLWRjN2RlMzg1MTIwYyJ9.Ijj7xIxvLOC9kJ4RHtyq0fcq8AJnBQMJCmNBivCLQHQ" class="fr-fic fr-fil fr-dib" width="190" height="211"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the Documents module</span></strong></p><p><br></p><p>The following configuration options will be available after clicking into the configuration module:</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFhOTBjYWYxLWI3ZWEtNDJjNy04NDg0LTg4ZGFkNmZiM2U5YiJ9.SDdkMM3QuqQuLNKeDMcFM25PoeiHOZfp0MB-wUA2H9E" class="fr-fic fr-fil fr-dib" width="424" style="width: 426px; height: 174.145px;" height="174"></p><p><strong><span style="font-size: 10pt;">Fig 2. Configuration options in the Documents module</span></strong></p><p><br></p><p>When adding a new folder using the button, it will default to the parent folder you were currently viewing. You can set a note and add the attachment as either an upload or as a link if this functionality is enabled using the setting "Allow link attachments".</p><p><br></p><p><strong><span style="font-size: 14pt;">Agent Permissions</span></strong></p><p>There is an agent permission for document management, allowing agents to be restricted to no access, read access, or read and write access, this must be set in order for agents to view this area.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ1MzQ2Njk0LTI0OWItNDFiZi1hMDFjLTIyZjU1ZWZiNDJjYSJ9.mpZ9cEYNV5nfUUsvH2JoiQfGLlNnnSUkJOJSG54QsEM" class="fr-fic fr-fil fr-dib" style="width: 591px;"></p><p><strong><span style="font-size: 10pt;">Fig 3. Setting agent permissions for the documents area</span></strong></p><p><br></p><p><strong><em>Note: By default, admins will not have access to this area, so you must add it to the administrator role and then log out and login, as this is how you inherit the new roles.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Documents Area<br></span></strong></p><p>After enabling the module, setting the correct permissions under your agent and logging out and back in, you will notice this new area on the navigation bar:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJmYmM2ZmMzLWYxNjctNDZmNy05NDI0LWU0MzQ2MDcwYTQ5YyJ9.aIaUkotDadpx7Srdq1bMQcIBbx6oKGVOI_nbnUUS5pA" class="fr-fic fr-fil fr-dib" width="670" height="646"></p><p><strong><span style="font-size: 10pt;">Fig 4. Documents area on the navigation bar</span></strong></p><p><br></p><p>The document management area can be displayed as either a table or a catalogue view based on a global setting.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc1YzRiZmRmLTQ1NmYtNDAyNS1hMzM4LTE3ZTAxNmFlYWQzYyJ9.kP3XglMP5CNdcb8KMWv1ymqW1HEqJGEET9uqbtKTfR0" class="fr-fic fr-fil fr-dib" width="792" height="223"></p><p><strong><span style="font-size: 10pt;">Fig 5. Documents area in table view</span></strong></p><p><br></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc1MzdmNDdmLTY5OTAtNDhlZS1hNmNjLTY1NjYxMmU1MWY5OSJ9.jDanF1p4WNg8GNisq70QdMoIAt80H7uBSYKcVazvKEY" class="fr-fic fr-fil fr-dib" width="310" height="244"></p><p><strong><span style="font-size: 10pt;">Fig 6. Documents area in catalogue view</span></strong></p><p><br></p><p>From here you can add new folders or files. Folders can be added using the new button and can be edited by right-clicking on them. Folder names must be unique within a parent folder. Clicking on a folder will take load the contents of that folder.</p><p><br></p><p>New documents can be added using the new button, or by dragging an attachment onto the list, which adds the attachment to the current folder.</p><p><br></p><p>Attachments follow the file limit size set in Configuration > Advanced Settings > "Attachment Upload Size Limit (MB)". The attachment limit should be between 0 and 28 MB due to IIS restrictions.</p><p><br></p><p>Once a document has been added you can download the current version of the attachment or upload a new version. The new version you upload must have the same name as the existing document. All previous versions can be viewed and downloaded from the versions tab of the document.</p><p><br></p><p>Deleting a document will delete all of it's versions and deleting a folder will delete all documents within the folder.</p><p><br></p><p>With the document management module enabled, if an agent has at least read access to it they can select documents to attach to tickets and actions. This can be done using the "Add Attachment" button and selecting "Attach Document". This will allow you to search for documents to attach. You can filter on the parent folder of the document and sort by filename and creation date.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA1NDA2ZDc0LTUzNDUtNDUxMy1iYWMyLWZhZTM2OWY4ZTk1YSJ9.ANusjein-EWfaxfZehVmVlKJopRPl-hIG2vx9ts_bew" class="fr-fic fr-fil fr-dib" width="812" style="width: 812px; height: 199.987px;" height="199.987"></p><p><strong><span style="font-size: 10pt;">Fig 7. Searching for a document to attach</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Folder Access Control</span></strong></p><p><span style="font-size: 11pt;">Access control can be used to control which Agents have access to view/create/modify folders. This includes adding documents to the folder and downloading documents from the folder.</span></p><p><br></p><p><span style="font-size: 11pt;">First you will need to enable the Access Control functionality for folders, if this is not enabled an agent's access will be determined by their permissions. To enable the functionality head to configuration > Documents > enable 'Enable Access Control for Folders'. </span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZjNDU0Zjg4LTI5YzEtNDYxNS04NDY5LWEyYmQxNTdkY2VkNyJ9.J9vamI4vYvHOc9gEYSlG7Io8dthGt3J5g2OMROOrq8k" class="fr-fic fr-fil fr-dib" width="1323" style="width: 1325px; height: 401.762px;" height="402"></span></p><p><br></p><p><br></p><p><strong>Fig 8. Enable Access Control for folders</strong></p><p><br></p><p><br></p><p><br></p><p><br></p><p><span style="font-size: 11pt;">Now you can add Access Control using the 'Access Control' button when editing the folder. </span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZjYjkyNjlkLWM2MWItNGNkOS1hZWU2LTQ3NmM3MGVhMTZmNiJ9.yCuOTAzcupEHaVKmY2wzoMszRqz0a363sHZ-vHPAx9A" class="fr-fic fr-fil fr-dib" width="553" style="width: 555px; height: 370.612px;" height="371"></span></p><p><strong><span style="font-size: 10pt;">Fig 9. Folder access control</span></strong></p><p><br></p><p>Here, you can choose which Role/Agent/Team/Department you would like to have access and the level of access they should have. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM0ZTZiNTAwLTQ5MzAtNDcyYS04ZTFhLWQ2ZTQxMTBhYmMwZCJ9.eCWl-dldcB_JDcORsctiMyO2orf87YfVBLc9SRNTvzA" class="fr-fic fr-fil fr-dib" width="616" style="width: 618px; height: 333.796px;" height="334"></p><p><strong><span style="font-size: 10pt;">Fig 10. Giving access control</span></strong></p><p><br></p><p id="isPasted"><strong>None </strong>- Agent cannot see folder or it's contents.</p><p><strong>Read </strong>- Agent can see folder and it's contents, and can download the files but not add new documents to the folder.</p><p><strong>Read and Modify</strong> - Agent can see folder and download it's contents, and upload new documents within this folder.</p><p><strong>Owner/Administrator</strong> - All of Read and Modify with the ability to set Access Control on the Folder.</p><p><br></p><p>If you would like Agents to require 'Read and Modify' access control in order to download documents within a folder rather than just 'Read' this can be changed. Do this using the setting 'Folder Access control restriction type for 'Read'' found in Configuration > Documents. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE5ODAwOGY0LTBlYTgtNDBmMy1hZDdiLTRhZWU1ZjI0YjMxYSJ9.kVbT2cWUYZgvTJEtu5_AwEkwwQNo0aHduCeXHWputGA" class="fr-fic fr-fil fr-dib" width="723" style="width: 725px; height: 422.995px;" height="423"></p><p><strong><span style="font-size: 10pt;">Fig 11. Folder Access control restriction type for 'Read'</span></strong></p>
