Open

CAMMS is pleased to announce the May Feature Release for cammsincident.

This was released on 29th May 2020 and includes the following new features and enhancements to improve your user experience within the system. 

Admin can now configure what the default status should be, when selected for incidents (out of Open, Closed and None – which behaves as Show all) in your ‘Incident’ tab within the dashboard.

• When accessing the miscellaneous settings area via Framework>Incident Settings, you will find a new configuration where you can select the default status, in the Incident Status Filter within the Dashboard. 

Open

Figure 1.1: The newly available configuration

• This will be set to ‘None’ by default which will show the incidents of all statuses.

• You will be able to select and filter the incidents based on their preference, using the filter in the usual manner.

Administrators, can now configure the standard field ‘Incident Responsible Officer’ to be anywhere in the workflow without it being mandatory for incident creation. 

• A new field type ‘Responsible Officer Dropdown’ is available in the object configurations area, accessed via Framework>Incident settings. You will be able to create a new field selecting the field type as above.

• When you make the field visible for the object, you will be able to use the field in place of the standard field, thereby all its functionality and properties will be inherited to the newly created field.  

• You can configure the existing standard field ‘IncidentResponsibleOfficer’ in the ‘IncidentDetails’ object as non- mandatory by un-ticking the ‘Required in Save’ and ‘Required in Submit’ configurations (based on your set up) from the field configurations, so you can fill in the Incident Responsible Officer field at a later stage in the workflow. 

• You can configure the Incident Responsible Officer field in any of the Standard and Custom Objects except for the Documents, Actions, Linkage, Risk Analysis and Task objects. 

• If you have multiple fields configured in different places in your workflow, the selections will synchronize with each other, so any update in either area will get updated in every place. 

• The rest of the functionality behaves as it currently does for the new fields.

Administrators can now configure to show additional information for the staff fields. 

• The current field type ‘Staff Drop down with Details’ available in the field configurations area, accessed via Cammsrisk>Framework>Incident Settings>Object configurations, has been improved to provide more configurations to display additional information about the staff such as:

  • Position

  • Location

  • Resource Location

  • Phone

  • Email

  • Payroll

  • Organisational Link

  • Reporting Officer

  • This information for the staff will be directly mapped to the same fields available for the staff, under the Administration>Staff area. 

• When selecting the field type ‘Staff Drop down with Details’ from the field configuration area, an additional configuration named ‘Show additional details in the tool tip related to’ will help you select what to show from the above details as a tool tip, next to the staff field. This will be selected as 'None' by default. 

• If you don't want a tool tip against your field, you can do this by not selecting anything from the configuration and leaving it blank as default.

• If you prefer to have the extra fields populated as text fields within the same form/object rather than a tool tip, you can do this via a custom configuration of fields as shown below;

For example, if your main staff field is named ‘StaffDropdown’ and you have selected the field type as ‘Staff Dropdown with Details’, let's assume you'd like to auto populate the staff details, Phone and Email on the incident form, you can do this by configuring two new fields as StaffDropdown_Phone and StaffDropdown_Email. 

• The sequence and the labels for the fields can be anything you choose and the rest of the functionality would follow the existing standard. However it is important to configure the fields following the MainFieldName_StaffDetail format, so the feature can function as expected. 

• Once the configurations are done, the additional information will be shown in either/both ways shown below. 

The administrator can now configure instructional text to show against each category, which will display when an end-user selects a category, to guide them on the categories they select.  

• The existing category settings area which can be accessed via Cammsrisk>Framework>Incident settings, has been improved to have an ‘Edit’ option when clicked on, you then have a rich text editor available to configure the instructional text. 

• You can enter up to 4000 characters of text and also use the available configurations within the rich text editor to be shown to the end-user when selecting a category for the incident. 

• Once you have configured the text for categories, the end-user will see them as below. Only the categories selected for the incident will have the description shown in the tool tip. Each category description will have separate tabs within the pop-up. 

• A Tab will not appear for any categories selected for the incident, but with no text configured.  

As an administrator, you can now enable the ability to have a task list auto-populate for the incidents linked with the category/s they are linked to. 

• We have introduced a new standard object ‘Tasks’ that can be used in your workflows just as other objects. The purpose of this object is to define the fields that are shown for the tasks that will be assigned to the incidents. 

• Via object configurations accessed through Cammsrisk>Framework>Incident Settings, a new object ‘Task’ will be available with the following standard fields:

  • TaskName – The name of the task.

  • TaskStatus – The status of the task (standard statuses Not Started, In Progress, Deferred, Completed and On Going will be available here).

  • TaskStartDate – The start date for the task.

  • TaskEndDate – The end date for the task.

  • TaskTimeFrame - A timer which can be set to run down from the moment of incident creation counting down to task completion. Emails can be configured based on the timer which is explained below.

  • TaskDescription – A description for the task.

  • TaskComment – Comment field to add progress comments on the task performance. 

  • IsMandotory – Whether or not the task is mandatory.

• Once the object configurations are done, if you wish to enable the task object as a separate object in the workflow, you should tick on the ‘Visible’ configuration to make the object visible in the workflow. If you wish to enable the task object as a field on another object in the workflow, you should un-tick the ‘Visible’ configuration from Object configurations>TaskObject.

• Next, add the object to the workflow you desire to have this in. This object cannot be replicated yet, hence in every workflow, the same field configurations will follow. 

• Next, the user roles will have to be given permissions for the task object via Cammsrisk>Framework>Incident settings>User roles area in the standard manner object permissions are given. Any user with access to the incident will be able to add/edit/delete tasks based on the permissions their user roles would have for the Task object. The Incident Responsible Officer will have all permissions to the task object by default as standard behaviour.

• The next step would be to configure the task object visibility on an object in your workflow as a field. A new field type ‘Task’ is introduced within the field configurations area, selecting which the task object can be configured. 

• Additionally, there will be another configuration ‘Enable Adding Tasks Within Task Grid’ to enable adding tasks from within the grid itself for the end user for the incident.

• After the field configuration is done, the next step would be to create tasks globally to later link with categories. This is done via the new ‘Task’ setting accessed via Cammsrisk>Framework>Incident settings. Only the users with permission given via User roles in incident settings, will be able to see and access this area. 

• You can create tasks from here adding the relevant details. This will behave as the task library from which you can link tasks to categories later on. 

• Tasks can then be linked to categories via Category Settings available at Cammsrisk>Framework>Incident Settings from the ‘Task List’ option. All available tasks will be listed here, and you can pick and add those which are applicable to the category. All saved tasks will be shown under each category as shown below.

• Once the configurations are done as above, for any new incident created, upon selecting the categories for the incident, any relevant linked tasks will auto-populate within the tasks grid. The countdown for the time frame will begin from the moment the category is saved for the incident. You will be able to add/edit/delete tasks from the task grid within incident based on the permissions the user has via user roles. 

• A new configuration is available in the standard ‘CloseObject’ object for the ‘CloseIncidentStatus’ field, as ‘Restrict users to close incidents until task completion’ upon enabling which, the incident will not be closed until all linked tasks are in either completed or deferred statuses.

What’s coming up?

• We will soon be introducing email triggers associated with task completion, progress and time frame in the upcoming sprints. 

• There will also be reports and insights datasets providing the ability to report on tasks and their information.

• We are also working on improving this feature to have the task auto-population be based on other key elements of an incident such as incident type, severity, risk rating etc. via the road map. So, stay tuned for these updates!

We have made major improvements to your Incident Portal user experience to make the process more intuitive and user-friendly proving functionality around accessing secure information by your external users.

• We have now introduced the ability for portal users to set up an account in the application where they can access their submitted/draft records in the Dashboard register. They will be able to access their records, edit, filter and submit them. 

Configurations

• As an administrator with access to the ‘Portal configuration’ settings accessed via Cammsrisk>Framework>Incident Settings, three new configurations as below are now available.

• Register Header – Provide the ability to configure the header area for the register for the portal users. This allows you to add a header image/text/description within minimal configurations such as font and background colour. This is also known as the Dashboard.

• Navigation to Page Links – Provide the ability to define what the landing page should be for the portal users once they have successfully submitted a record via the portal. You are able to choose between the Dashboard or Homepage. 

• Login Button - Provide the ability to change the name of the ‘Login’ button, add a font and background colour. This will also provide the ability to configure the visibility of the button on the portal.

• You will also be able to define the filters and fields of the incident as columns appearing in the Dashboard for portal users via the Register Configurations area accessed via Cammsrisk>Framework>Incident Settings where 2 new columns as ‘ Visible in Portal’ and ‘Searchable in Portal’ are available in Incident object based registers. 

• We have also introduced new email triggers and snippets to the Email Type ‘Incident’ as shown below for the modification to set up notifications to be sent out to incident portal users via Email Notifications/Templates area accessed via Cammsrisk>Framework>Incident Settings.

• Web Account created – This will be triggered when a new user accesses the portal and submits a record entering an unregistered email address. This will send a password set up link to the user’s entered email address to guide them to set up their password for the auto created accounts after submission of a record.
  Snippet to be used with this trigger: [PasswordSetupLink]

• Reset Password – This trigger will be triggered when a user requests to reset the password and the email will send a link to reset the password for the user. 

            Snippet to be used with this trigger: [ResetPasswordLink]

• There will be 2 types of users in the system hereafter, as Users and Portal Users in the User area accessed via Cammsrisk>Framework>Incident Settings, and all users who access the application via the portal only and create portal accounts will be shown in the system under Portal users. Any existing users cannot be converted to a portal user within the system and they will need to access the portal and have an account created as any other user as explained above. The portal user accounts will not be shown in the staff drop downs accessed within the application. 

• For the workflow accessed via the portal, the view/add/edit permissions for the portal users are governed by the ‘Standard Incident Creator’ permission accessed via Cammsrisk>Framework>Incident Setting>Standard user roles. 

• The configuration of the permissions is similar to the standard workflow permission assign mechanism. 

• The ‘guest’ role created to grant access for users to the portal and now available at Portal users section accessed via Cammsrisk>Framework>Incident Settings>Users will need to be assigned with a user role with at least the below 2 standard permissions enabled.

• Standard Incident Add Permission

• Standard Unlock All Objects In Incident Drafts For Editing Permission.

Portal user experience 

• Portal users will be able to go to the landing page and submit records in the usual manner by submitting an email address. 

• If the configurations are done as above, an email will be triggered notifying the user of an account being auto created post incident submission with a link to set up the password. 

• The user would be able to navigate via the link and set up the password which they can use to log in to the application via the portal the next time they are recording incidents. This can be done via the Log In button available atop the portal homepage.

• Users are able to log in to the application and access the dashboard that contains all of the records they have submitted so far, saved as draft for them to access/edit and delete.

• In case the user is unsure of the password and would like to request to reset, this can be done via the reset password option. The reset password trigger above will notify the user of a reset password link which will navigate to the password reset screen.

• Introducing a captcha on the login page as an extra step of security. 

• Ability to completely hide the tabs the creator doesn’t have permission to see from the workflow. At the moment they will be notified that they do not have view permissions when they access the tab. Stay tuned for the road map updates!