This tab allows you to define your own families. You can later add them to the Family Scanner and Family Browser results using the "Add Predefined Families" button at the upper-right corner of the family set.
Adding a project
To add a project to your family you have to click the Add project button in the bottom-right corner of the family panel. A box will be displayed allowing you to choose a project from a list of projects.
You cannot add the same project multiple times. If you try to add the same project another time the following error message will appear in the dialog box:
Adding a permission
On Expand you can see the permissions and sources of the family and add permissions and sources for those permissions.
To add a permission, click the Add Permission link in the expanded table for the corresponding project or global permissions. A dialog will be displayed allowing you to choose a permission.
The dialog for adding Global Permissions will look like this:
The Project Permissions dialog allows you to choose the permission category and then a permission from that category.
After adding the permissions, the family will look like this:
For each permission you have two options:
- Delete - will remove the permission with all its sources.
- Add Permission Source - add more sources for that permission.
Adding permission sources
You can choose the sources for permissions from the dialog which will be displayed when clicking the Add Permission Source link.
The dialog for Global Permissions will look like this:
Global permissions are only granted to groups of users.
Project permissions can be granted to:
- Individual users (Direct permission source)
- Groups
- Project Roles
The dialog which allows you to add sources for the project permissions is presented below:
Adding permission sources that do not already exist will be granted when the first user is assigned to the family. For example, say we have no Browse Project permission for the jira-users group. However, we add this as a permission source in one of the predefined families. When a user is assigned to the family, the Browse Project permission will be granted to the jira-users group. This can impact other families and permissions, so use this feature with care.
For more information about permission sources, see User Guide.
Deleting a permission source
After adding the permission sources the family will look similar to the one below:
You can remove a permission source by clicking the red marker.
Saving your family
You can save your families by clicking the Save button at the bottom of the page. In the Family Scanner and Family Browser tab you will be able to add them using the "Add Predefined Families" button at the upper-right corner of the family set .
The family will be saved with the default name ("Your family name"), unless you change it before saving.
To rename a family, see Managing Families.
You cannot save the family if you defined permissions with no sources.
