- Skilled Groups

Skilled Groups

Skilled Groups allow assigning multiple documents to a group of users and monitor their progress, all in one place. It also provides an efficient way to ensure new users are tasked with reading a collection of documents in one operation, by simply adding them to an existing skilled group.
iPassport automatically issues the tasks to the staff members of a skilled group when appropriate, according to the ‘Skilled task settings’ of the OUs where the documents reside. This includes re-issuing tasks if a new version of a document is released or if it was in draft state when added to the skilled group and subsequently authorised. The system will not send a new task to a user if they are already skilled on a particular document version but it still counts them in the group for the other documents and then for all documents, when skilled tasks are next reissued.
A skilled group can have users and documents from different OUs but permissions have to be in place for all staff members to be able to access all of the documents they are tasked to read. When appropriate, the iPassport feature, Document Sharing offers a powerful tool to allow users access to specific documents in other OUs without having to be members of user groups of other departments.

Example
To illustrate, let’s suppose a new user joins an organisation as a lab technician in the Microbiology Lab. This person will probably have to read a set of documents that all new recruits must read (general company policies, employee handbook, etc). In addition, there will probably be a set of technical procedures and manuals, specific to the microbiology lab that the staff in that department must read to do their job properly.
Three elements are required:

  1. Organisational Units (OUs) where the documents are held -
    The general docs can be in an OU called, AllStaff and the technical docs can be in their dedicated OU we’ll call, Microbiology Lab.
  2. User Groups that provide defined access permissions to a team of users within given OUs -
    The associated user groups, AllStaff Viewers and Microbiology Technicians should be in place for their members to be able to open the documents in those OUs.
  3. Skilled Groups to assign collections of documents to teams of users -
    A skilled group called, AllStaff Docs can be created to collect the documents from the OU, AllStaff ; all members of the organisation can be members of that skilled group.
    (NOTE: Through membership, even veteran staff can be automatically requested to read new versions of documents or re-read certain documents to refresh their knowledge periodically.)
    Another skilled group called, Microbiology Docs can be created to collect the documents from the OU, Microbiology Lab. Only technicians that work in the microbiology lab will normally be members of this skilled group.

Upon adding the new user to the system, they should be added to the two user groups and the two skilled groups above. The system will take care of issuing skilled tasks, notified by email and easily accessible within iPassport, for each of the documents in both of the skilled groups. A personnel manager or supervisor with access to the user’s home OU (most likely, Microbiology Lab) will be able to keep track of the new user’s progress from several locations within the system. The user will also be able to access an overview of their personal skills in their own staff profile.

NOTE: Having the Home OU, Microbiology Lab alone won’t provide permissions for the user to view documents in that OU. The user needs to be a member of the user group, Microbiology Docs to be able to view the relevant documents.

When veteran members of staff are added to one of the skilled groups above, they can be added as already skilled if they aren’t required to read the associated documents.

Skilled Groups area

The Skilled Group area is reached by navigating to Competency > Skilled Groups

There are five tabs within the Skilled Groups sub-menu option, these are:

List Skilled Groups

The tab, List Skilled Groups opens by default. It has a general Search filter to enter (even partially) the name or code of a skilled group. There are search filters that allow looking for skilled groups which include a particular User and/or a particular Controlled Document. There is also a filter for Private/Public skilled groups.

The results of any search are displayed below and they can be exported as a CSV spreadsheet by clicking Export Groups. The information on screen shows how many authorised documents are included in each skilled group. The report lists each document for each user, stating if the user is already skilled on that document or not.

Adding a Skilled Group

There is no limit on the number of groups that can be created.

To add a new skilled group:

  1. Go to Competency > Skilled Groups
  2. Click the tab, New Skilled Group (the plus [+] sign next to the Skilled Groups menu item is a shortcut to this page)
  3. A Name must be entered in the field provided
    It should be as descriptive as possible, for example, “Site wide Health & Safety policies”.
  4. A Code is also required in the field provided
    It is a free text field but iPassport does perform a validation check to prevent adding already existing codes. This acts as a second unique identifier for the record.
  5. If appropriate, the group can be made private by ticking the checkbox under, Set as Private
    When the checkbox is ticked, a new filter appears to set an OU Scope (this filter is otherwise not visible). The group will be listed but only the creator and users with permission to edit private skilled groups ("Skilled Groups:Can Edit Private Skilled Groups") in the OU(s) selected will be able to open it or edit it. Other users that click on it to open it will see the message, “This group is private and it is owned by …, only the owner of the group can view it”.
  6. Details can be entered as free text to describe the nature of the skilled group
  7. Click Save to complete the creation stage

Adding Users to the Skilled Group

Once a group has been created, staff and documents can be added to it.

To add staff to the skilled group:

  1. Click the Users tab
    (The tab also displays a count of the staff currently added, in brackets - Users(2).)

  2. Click the (+) Add User option, on the right of the header area of the Users list
    This should open a lightbox to select users and create skilled tasks for them.

  3. Select users from distribution lists (Distribution lists to send this task to) and/or individual users (Users to send this task to) by ticking the appropriate checkboxes next to any of the available choices in both filters provided. The list will only include staff who have ‘Home OUs’ that the user has access to. Members of distribution lists can be viewed by hovering over them.

    If a user is a member of multiple distribution lists selected and/or is also selected as an individual, the system will only add them once to the skilled group.

  4. Tick the checkbox under Add users(s) as already skilled if the users being added are not required to complete a skill confirmation task for the current version of any of the documents listed in the skilled group. They will be added with status, ‘Confirmed’, in each document’s Skilled tab and they will be issued skilled tasks when a new version of the document is published or if it must be re-read periodically.

    If any users added as skilled already had a skilled task to complete for any of the documents, the system will not grant them the ‘skill’ until they complete the task.
    Skills which are granted automatically when this option is ticked, will also appear in the Tasks tab of the skilled group with a comment that the person was added as ‘Trained’.

  5. The overall OU Setting, “Time interval for Due Date on system reissued skilled tasks” (described in the guide, Permissions & Settings), can be overridden by selecting a different date in the future from the pop-up calendar in the field, Due Date

  6. If the field, Active Date is left blank, the associated skilled task will be sent out immediately (if the document is authorised); to set a different date (in the future), click in the field and select one from the calendar that pops up

    It is not possible to be skilled on a ‘Draft’ document. When staff is added to a document in Draft state, the skilled task is prepared but not issued until the document is authorised.
    If the document is already authorised, the task is normally issued immediately.
    However, if an ‘Active Date’ is set in the future, then the skilled task will be held until the activation date is reached.

  7. The task can be made private by ticking the checkbox under, “Make this task private” so that only the creator and recipient can view it

  8. A Priority can be set for this task; the choices are, Low, Medium, High and URGENT; the default is, Low

  9. The Description field constitutes the body of the email that the tasked user will receive; free text can be entered as required

    Text entered here will appear in the task reminder box which appears under the General tab of the document records the user is tasked to read:
    Custom messages can only be entered for the first time tasks are issued to staff members when they are added to the group. Subsequent tasks, reissued manually or automatically (when a new version is authorised or the time interval to reissue the task lapses), will contain standard text generated by the system.

  10. Scroll down and click Create Task(s) to finish

Removing Users

A user can be removed from a skilled group by clicking the trash/bin icon in the Actions column of the Users list, under the Users tab. Any outstanding skilled tasks generated by the skilled group will be invalidated but the user will not lose already confirmed skills.

Adding Documents to the Skilled Group

To add documents to a skilled group:

  1. Click the Documents tab (The tab also displays a count of authorised documents currently added, in brackets - Documents(2).)

  2. Click (+) Add Documents, on the right of the header area of the Documents list

  3. Use the filters available to search and bring up the documents of interest
    There is a general Search filter to enter (even partially) the name or code of a document. The Organisational Units filter will bring up all available documents in the OU selected. There are also filters to refine the search by document Category, Status or Type.

    A user is only able to add documents that reside in an OU they have access to.

  4. Once a document has been located, click its plus (+) sign in the Actions column to add it

  5. If adjustments need to be made to the task details, the section, Enter Task Details in here can be expanded
    It includes fields to set a different Due Date and/or Active Date, Make this task private, adjust the Priority and edit the body of the email in the Description field. Information about these parameters can be found above. As in other areas, these details will only apply to the task being set and subsequent tasks will follow default settings, according to standing OU Preferences.

  6. When done adding documents and details, click Close and Refresh

For all documents added, unless an Active Date was added or the document is not yet authorised, skilled tasks will be issued immediately to all the members of the group who are not yet skilled on the current version of each document. These tasks and associated skills will also appear in the document records’ Tasks and Skills tabs. Both tabs are also found in each individual’s staff profile. The tasks can also be tracked in the Tasks > Users Tasks area and users will see tasks assigned to them in the My Tasks areas. Please see, Viewing Skills & Skilled Tasks for more information.

Permission Check

It is possible to add documents that not all members of the user group can access. When this happens, the user will be notified about the task but won’t be able to open the document assigned. This leads to having to delete the task or granting access to the user through permissions or by sharing the document.
Clicking Permission Check, performs a validation of users’ permissions to access every document in the group. If any document can’t be accessed by any of the members of the group, it will be flagged with a yellow warning triangle. Hover over the document’s row to invoke a pop-up list of those users who can’t access that particular document.

Overriding Permissions

There is a preference which when enabled grants automatic read-only access to users who have been assigned documents they don’t have permission to view. It’s called, “Allow users with a skilled task to view authorised controlled documents without explicit permissions.”, and details about its use are found in the previous article, ‘Skilled Settings’, under ‘Document Control’.

Other ways of adding/removing users and documents

Given permissions are in place, skilled groups can also be managed from user records and from document records.

Adding Users from their user records to Skilled Groups

New users can be added to skilled groups when their user record is being created. Skilled group membership can also be managed from a user’s record at any time. Details can be found in the user guide, User Management.

Adding Documents from their ‘Skilled’ tab to Skilled Groups

Documents can also be added to skilled groups from within the document itself, under the Skilled tab. The same permission required to manage skilled groups applies (‘Skilled Groups:Manage Skilled Groups’).

To add a document from its Skilled tab to a skilled group:

  1. Open the document
  2. Click its Skilled tab
  3. Click the button, ‘Manage Skilled Groups’
  4. In the lightbox which pops up, tick/untick the skilled groups in which the document should/shouldn’t be included
  5. Click Save
    It can take a short while for the tasks to be generated in the background so a message pops up to explain why no users have been automatically added below.
  6. Click the ‘Skilled’ tab to refresh the page and view the new list of skilled staff members

It’s important to be aware that many tasks can be created from performing changes to skilled groups.
Planning the number of documents per skilled group and staggering their scheduling can help manage staff workload.


The following article in this series covers different ways of Viewing Skills & Skilled Tasks.