Difference between revisions of "Organisation"

From Hornbill
Jump to navigation Jump to search
(Created page with "__NOTOC__Home > Administration > Users, Roles, and Organisation > Organisation ==Introduction==")
 
(92 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__[[Main Page|Home]] > [[Administration]] > [[Users, Roles, and 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==
+
 
 +
[[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>
 +
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]]
 +
}}
 +
 
 +
== Organization List==
 +
[[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".
 +
<br>
 +
:* '''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 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 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.
 +
 
 +
:* '''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.
 +
 
 +
:* '''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.
 +
 
 +
<br>
 +
{{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.
 +
 +
:* '''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