Difference between revisions of "Organisation"

From Hornbill
Jump to navigation Jump to search
(85 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
__NOTOC__[[Main Page|Home]] > [[Administration]] > [[Users, Roles, & Organisation]] > Organisation
+
This document can now be found at its new location in the [https://docs.hornbill.com/esp-config/organizational-data/organization/ Hornbill Document Library].
−
==Introduction==
+
 
−
The Hornbill platform allows a hierarchical Organisational Structure to be defined within your instance which, when members are added to each of the business units, can greatly assist in providing a solid foundation on which current and future Hornbill Application functionality operates.
+
[[file:hornbill-document-library.png|Hornbill Cloud|link=https://docs.hornbill.com/esp-config/organizational-data/organization/]]
 +
<!--
 +
 
 +
{{bluebanner|[[Main Page|Home]] > [[Configuration]] > [[Platform Configuration]] > Organisation|[[:Category:Configuration|Index]]}}
 +
{{IntroAndLinks|
 +
The Hornbill platform allows for the creation of a hierarchical organisational structure. Create and manage organisation groups, teams. and their members.
 
<br>
 
<br>
 
<br>
 
<br>
−
Whether your structure is as simple as a single "Company", "Department", and Support Team, or a more complex and multi-layered configuration including multiple Divisions, and Cost Centers, the correct definition is a key aspect in utilising the Hornbill Platform to it's maximum.
+
Whether your structure consists of simply a single "Company", "Department", and Support Team (which is all you need to get started) or a more complex and multi-layered configuration including multiple Divisions, and Cost Centers, the correct definition is a key aspect in utilizing the Hornbill Platform to it's maximum.|
 +
:* [[Users]]
 +
:* [[Sites]]
 +
:* [[Custom Buttons]]
 +
}}
  
−
==Types of Business Units (Groups)==
+
== Organization List==
−
Each business unit you define within Hornbill should be considered a Group. When creating a Group you will be required to specify a Type against that Group.
+
[[file:Organisation_breadcrumb.PNG|350px|right]]
 +
The Organization List contains the groups that make up your organization. The list forms a hierarchical structure where you can create and browser through the different levels of your organization. The ''Breadcrumb'' displayed at the top of the list highlights where you are within each level of your organization and lets you navigate back up to the higher levels.
 +
 +
===Types of Groups===
 +
{{#ev:youtube|SmS_rCkX-w4|400|right}}
 +
Groups are available to define different business units. When creating a Group you will be required to specify a Type against that Group.
 
There are six Group Types available, the default being "General".
 
There are six Group Types available, the default being "General".
 
<br>
 
<br>
−
* '''Company''' – Logically, this will be the Type set against the Group that sits at the top of your heirarchy, and which all other Groups sit beneath. It's entirely possible that you have more than one Group of Type "Company", where they sit in the heirarchy will be dependant on a "Parent" Group being specified upon creation.
+
:* '''Company'''
 +
::Logically, this will be the Type set against the Group that sits at the top of your hierarchy, and which all other Groups sit beneath. It's entirely possible that you have more than one Group of Type "Company", where they sit in the hierarchy will be dependent on a "Parent" Group being specified upon creation.
  
−
* '''Division''' – This is a section of a large company that can be divided into an organisational function – often by product or geography. Each Division can contain the necessary resources to support that product line or geography (i.e. its own Departments)
+
:* '''Division'''
 +
::This is a section of a large company that can be divided into an organizational function – often by product or geography. Each Division can contain the necessary resources to support that product line or geography (i.e. its own Departments)
  
−
* '''Department''' – This is a specialised functional area within a Company (or Division) – this is often based on functions, products, customers, geographies or processes.  
+
:* '''Department'''
 +
::This is a specialized functional area within a Company (or Division) – this is often based on functions, products, customers, geographies or processes.  
  
−
* '''Costcenter''' – This is a defined area or person to which direct and indirect costs are allocated.  
+
:* '''Costcenter'''  
 +
::This is a defined area or person to which direct and indirect costs are allocated.  
  
−
* '''Team''' – A team is a group of users with a set of complimentary skills, organised to work together to complete a task job or project. In Hornbill, a team is a group to which requests can be assigned. If you wish to define other teams in your structure, but do not want them to be visible in a Hornbill Service Manager Request-assignment situation, then you should specify the Group Type as "General".
+
:* '''General'''
 +
::This is a generic container that can be used for any area that has not been defined above, or to collate a set of users for a specific functional need in Hornbill E.g. a group may be created to allow the us to easily subscribe a set of users to a service.
  
−
* '''General''' – This is a generic container that can be used for any area that has not been defined above. For example, a team that should not be assigned requests may fall under this group type.  
+
:* '''Team'''
 +
::In Hornbill, a team is a group to which requests can be assigned. Team members can only consist of users that have a subscription to Hornbill.
  
−
==Create a New Group==
+
<br>
−
Your Organisational Structure is created and managed via Hornbill Administration. In the context of Instance Configuration, click the ''Users, Roles & Organisations'' menu item, and then the ''Organisation'' option. You will be presented with an empty list.
+
{{infobox|'''Reporting Hint'''
 +
::Groups are stored in the table ''h_sys_groups'' and the types described above are represented by an integer value between 0 and 5 in a column called ''h_type''. These are as follows: <nowiki> 0=general, 1=team, 2=department, 3=costcenter, 4=division, 5=company</nowiki>. The group type may be useful when creating measures, widgets, and reports.}}
  
 +
===Creating a New Group===
 +
[[File:Creating_a_new_group.PNG|350px|right|link=https://wiki.hornbill.com/images/9/96/New_Organisation_Form.png|New Group Form]]
 +
Your Organizational Structure is created and managed via Hornbill Configuration.  Select "Platform Configuration" and then "Organization".  Using the ''Create New Group'' button located to the top right you can begin to add the groups which make up your organization structure.
 +
 +
:* '''Organization Id'''
 +
:: This is the unique identification of the group. This value should not contain any spaces or special characters. Organisation ID's cannot begin with a numeric digit, must be at least two characters long and are limited to a maximum of 160 characters and can only contain: Letters, Numbers and Underscores. Please be aware, that once the ID has been saved, it cannot be amended. If this new Group has a parent, then the ID will be constructed using the ID that you specify as well as being prefixed (upon clicking create) with the ID(s) of any parent groups.
 
   
 
   
−
[[Category:Administration]]
+
:* '''Name'''
 +
:: This is the user friendly name for the group. This can be amended at any time after the Group has been created.
 +
 
 +
:* '''Parent'''
 +
:: This is how the hierarchy is defined. Here, the direct parent of the group should be specified. For example, if creating a division, the organisation may be selected as a parent. Be aware, that once the Parent has been saved, it cannot be amended.
 +
 
 +
:* '''Type'''
 +
:: This is a drop-down list, specifying the type of group that is being created (Company, Division, Department, Costcenter, Team or General)
 +
 
 +
:* '''Allow Task Assignment'''
 +
:: This flag indicates whether activities can be assigned to the Group as a whole. It is possible to configure the Business Process Workflow to assign tasks to a group.
 +
 
 +
:* '''Attributes 1 to 9'''
 +
:: These fields are currently not used.
 +
 
 +
:* '''Notes'''
 +
:: A free text field to record any additional information regarding the group.
 +
<br>
 +
 
 +
===Editing an Existing Group===
 +
To edit an existing group:
 +
<ol>
 +
<li> Go to ''Hornbill Configuration > Platform Configuration > Organizations''</li>
 +
<li> Click the group that requires editing</li>
 +
<li> The following options are available to edit:</li>
 +
a. Name<br>
 +
b. Type <br>
 +
c. Allow Task Assignment (only applicable if the group is of type team)<br>
 +
d. Attributes and Notes<br>
 +
 
 +
It is not possible to edit the ID or the Parent of the group.
 +
<li> Click the “Save Changes” button to confirm any amendments</li>
 +
</ol>
 +
<br>
 +
 
 +
===Deleting a Group===
 +
[[File:Deleting_a_Group_in_Hornbill.PNG|350px|right|link=https://wiki.hornbill.com/images/9/94/Deleting_a_Group.png|Deleting a Group]]
 +
To delete an existing group, go to ''Hornbill Configuration > Platform Configuration > Organizations'' and do the following:
 +
<br>
 +
<ol>
 +
<li> Ensure that there are no users assigned to that group (this can be checked by clicking the "Assigned Users" tab available when viewing the Group details). If there are, remove them by following the process described in the section ''Removing Users from a Group''. '''If the Group is of type "Team", it is also prudent to check that there are no Service Manager requests currently assigned to that team and take action to re-assign those requests before the Group is deleted.''' </li>
 +
<li> From the Organization Structure list, select the group to be removed by ticking the checkbox on the left hand side of its name</li>
 +
<li> Click the trash can icon</li>
 +
 
 +
<li> Click OK when presented with the “Are you sure" prompt</li>
 +
<li> The group has now been removed from your Organizational Structure</li>
 +
</ol>
 +
<br>
 +
 
 +
===Group Membership - Associating Users to a Group===
 +
[[File:Associating_users_to_a_group.PNG|350px|right|link=https://wiki.hornbill.com/images/8/81/Search_and_Associate_Users.png|Associating Users to a Group]]
 +
Once you have created a group, users can be given Group Membership by assigning them to the desired group. Go to ''Hornbill Configuration > Platform Configuration > Organizations'' and do the following:
 +
<br>
 +
<ol>
 +
<li>Click the group in which user(s) need to be assigned</li>
 +
<li>Click the “Assigned Users” Tab</li>
 +
<li>Click the “Associate User” button. A form is displayed with the following options:</li>
 +
:* '''Search Users'''
 +
:: Begin typing the name of an individual user to assign to the group, click the name to select them
 +
:* '''By Organization'''
 +
:: If the members of the group need to be the same as another existing group, use this field to search and select the group. This will add all the members of that existing group to your new group.
 +
:* '''By Role'''
 +
:: If the members of the group can be selected based on a common Hornbill Security Role, use this field to search and select the role. Any user who possess that role will be added to your new group.
 +
:* '''Membership'''
 +
:: Select whether the user is a Member, Team Leader, or Manager of the group.
 +
:* '''Allow Viewing Tasks'''
 +
:: Allows the User to view tasks that are assigned to the Group (viewing of tasks is only relevant to groups of type Team)
 +
:* '''Allow Actioning Tasks'''
 +
:: Allows the User to action tasks that are assigned to the Group (actioning of tasks is only relevant to groups of type team)
 +
 
 +
<li>Once complete, click the ''Save''button”.</li>
 +
</ol>
 +
<br>
 +
 
 +
===Removing Users from a Group===
 +
[[File:Managing_assigned_users.PNG|350px|right|link=https://wiki.hornbill.com/images/f/f7/Removing_Users_from_a_Group.png|Associating Users to a Group]]
 +
If a user(s) no longer needs to reside in a group, go to ''Hornbill Configuration > Platform Configuration > Organizations'' and do the following:
 +
<br>
 +
<ol>
 +
<li>Click the group from which user(s) need to be removed</li>
 +
<li>Click the “Assigned Users” Tab</li>
 +
<li>Select the users to be removed by ticking the checkbox on the left hand side of their name</li>
 +
<li>Click the trash can icon located at the top right of the list</li>
 +
<li>Click OK when presented with the “Are you sure" prompt</li>
 +
<li>The user(s) is now removed from the group.</li>
 +
</ol>
 +
 
 +
== Team List ==
 +
A team is a group of users with a set of complimentary skills, organized to work together to complete a task job or project. In Hornbill, a team is a group to which requests can be assigned. Team members can only consist of users that have a subscription to Hornbill.
 +
 
 +
 
 +
[[Category:Configuration]]
 +
-->

Revision as of 23:50, 20 November 2023

This document can now be found at its new location in the Hornbill Document Library.

Hornbill Cloud

Retrieved from "https://wiki.hornbill.com/index.php?title=Organisation&oldid=31566"