Restricting Global Page Blueprints (old)
- Adil Nasri
This is the documentation for Blueprint Creator version 2.x. If you are using the Blueprint Creator in version 3.x click here.
The Blueprint Creator allows you to restrict global blueprints on space category level so they are only available in selected spaces. This is especially helpful when you want to make a blueprint available in multiple (not all!) spaces, but don't want to create the same blueprint in multiple spaces. In order to restrict global blueprints to spaces you must make sure that they are categorized.
Adding Space Categories
You need space administrator permissions to add categories to a space.
- Go to the space and choose Space tools > Overview from the bottom of the sidebar
- Choose Edit next to Space Categories.
- Under Space Categories, enter your category name and choose Add.
Alternatively, choose a category in the list of Suggested Space Categories. - Choose Done.
To restrict global blueprints:
- Choose the cog icon
, then choose General Configuration - Choose Restrict Global Blueprints in the left-hand panel
You will be displayed an overview of all your global blueprints. Global blueprints with no restrictions are visually indicated by an open grey lock. Already restricted blueprints have a red lock.
Select the blueprint you want to limit to one or more space categories and click on 'Restrict blueprint'.
You will be prompted a dialog:
Within the input field you will be displayed all space categories used in your Confluence site. Select the categories and click 'Save'.
Your selected categories will now be displayed under the blueprint next to a red lock.
The blueprint is now only available in the spaces that are labeled with the selected categories (e.g. 'department' and 'projects'). It suffices if the space contains at least one of the categories, hence an OR operator is used.
An OR operator returns a value of TRUE if either (or both) of its operands is TRUE.
To restrict blueprints to spaces that match all selected categories you can enable a dark feature
<BASE_URL>/rest/jnvblueprints/latest/spacerestriction/darkfeature/andlinking/enable
When enabled the OR operator will be replaced with an AND operator. To disable the dark feature use this link:
<BASE_URL>/rest/jnvblueprints/latest/spacerestriction/darkfeature/andlinking/disable
The Base URL is the URL via which users access Confluence.