Defining page and user filters
For every rule you create, you have to define which users should receive a training notification and for which pages.
Procedure
- Create or edit a rule.
- Select Page filters.
- To add just one criterion, choose Add filter:
- In the Type column, select the type of filter you want to use.
- In the Value column, enter the value you want to use.
For example, you choose the type Pages label and the value training_employees. This rule will apply to all pages with the page label training_employees.
- To add multiple filters, choose Add group:
For example, you want the rule to only apply to pages with the training_employees label, if they are also part of the hr space.- In the Type column, select how the filters should be used:
- All criteria need to exist: A page or user needs to match all of the filters to be considered.
For example, a page needs to have the right page label and be in the right space. - Any criteria need to exist: A page or user needs to match at least one of the filters to be considered.
For example, a page needs to have the right page label or be in the right space.
- All criteria need to exist: A page or user needs to match all of the filters to be considered.
- Choose Add filter to add a filter to the group and specify the type and value.
- If necessary, add more groups and filters to combine filter options.
- In the Type column, select how the filters should be used:
- Select User filters and follow the same steps as with Page filters.
For example, you choose the type User group and the value training users. Only users who belong to this user group will receive notifications. - Choose Save.
Page filters
Filter | Description |
---|---|
Pages space name | The rule looks at the space name. Example: You collect all your trainings in a space called Documents |
Pages space key | The rule looks at the key associated with the space. This can be useful if the name of a space can change or is not unique. Example: The name of your space is still a draft, so you use the unique space key 'DOCS' |
Pages label | The rule looks at labels you've attached to certain pages. This can be useful if you don't want to limit your training documents to one particular space. Example: You give all your training pages the label 'training'. |
Pages cql | This rule searches pages using a CQL clause. Refer to Atlassian documentation for complete CQL syntax. Example: 'type=page' will retrieve all pages in your instance. |
Pages metadata | This rule searches pages have metadata. The metadata it refers to is the one provided by Comala Metadata. You can use regex when referencing to metadata values. Example: 'doc type=.*' will retrieve all pages who have the 'doc type' metadata set, whatever the value. |
All pages | The rule applies to all pages. |
User filters
Filter | Description |
---|---|
User group | The rule looks at the user group people belong to. Example: You create the "training group" user group and add all the people who should receive training to this group. |
User email domain | The rule looks at the domain name of the email address associated with a user's Confluence account. Do not include "@" in the value. |
All users | The rule applies to all users. |