The categories within your app are displayed in a list. Category management functions can be found under the Actions heading.
The main category action button is Manage documents.
Click this button to see a list of documents included within the category.
To remove a document from the category, click the Remove button.
To add documents to the category, click the Add documents to this category button.
Then, locate the relevant document and click the Add button.
At any time, you can click the Back to list of Categories button to return to the main categories view.
Manage Default Category
If you have document categories enabled, you must always have a default category.
Any new document that is added to Ubiquity will be automatically added to this default category.
The default category has (default) next to its name in the list of categories.
When you first enable categories, a category called 'Other' will be automatically created, and set as the default category.
You cannot delete the current default category.
To change which category is set as the default, click the dropdown arrow under the Actions heading.
Then, select Use as default category.
New documents that are added to Ubiquity will be automatically placed in to this category.
The order in which categories appear in Ubiquity is the same order that they will be displayed in the app.
It is possible to re-order categories by moving them up or down in the list.
To move a category, click the dropdown arrow under the Actions heading.
Then, click Move Up or Move Down.
The category will be re-ordered in the list in Ubiquity, and in the corresponding categories within your app.
Edit Category Details
After a category has been created, it is possible to update its name and icon.
To do so, click the dropdown arrow under the Actions heading.
Then, click Edit Details.
Continue to edit the category's name and icon, then click the Save button.
All changes will take effect within your app immediately. To see the changes on your device, close and relaunch the app.
Delete a Category
To delete a category, simply click the dropdown arrow under the Actions heading.
Then, click Delete.
The category will be deleted immediately.
Deleting a category does not delete any of the content that it contains. However, if a document only appears in the category you delete, it will no longer be visible in the app.
Liquid State Ubiquity users can take advantage of advanced segmentation features to determine exactly which app users and app user groups will see each category in the app.
Category permissions use the same logic as document permissions. Category permissions apply in addition to document permissions.
Any user who has been given permission to access a category will see all of the documents available in the category, regardless of whether they have been granted permissions at the document level.
Furthermore, any user who has been given permission to access a particular document that sits inside of a category will see the relevant document under that category's heading, regardless of category permissions.
To make a category available to certain app users or groups, click the dropdown arrow under the Actions heading.
Then, click Manage Permissions.
You will be taken to a Category permissions screen, where you can specify the Access type of the category:
- Allow all App Users to access All Documents in this Category
- Only allow selected App Users to access All Documents in this Category
By default, all categories in an app that has segmentation enabled will be set to Only allow selected App Users to access All Documents in this Category.
Allow all App Users to access All Documents in this Category
To make the category available to all app users, select Allow all App Users to access All documents in this Category, then click the Save changes button.
All app users will be able to see all documents that are contained in the category.
If you set a category so that all users can access the documents it contains, all app users will have permission to access all documents within the category, wherever they are available.
If a document is in the category is also contained within other categories, all users will be able to see category headings for all of the categories in which that document is available, even if you have not specifically provided permissions for the user to access those categories.
Only allow selected App Users to access All Documents in this Category
To provide specicific users and groups with permission to access the category, ensure it is set to Only allow selected App Users to access All Documents in this Category.
Then, click the Selected Groups or Selected Individuals links.
Select the relevant user(s)/group(s) from the list, and click the Save changes button.
If a document is contained in multiple categories, and you provide a user with access to one of the categories in which it is available, that user will have permission to access the document wherever it is available.
As a result, the user will be able to see category headings for all of the categories in which the document is available, even if you have not specifically provided permissions for the user to access those categories.