Overview
With this plugin it is possible to create a collection of user-defined properties for each repository. These properties are defined as key-value pairs. To see an overview of the existing properties in tabular form, you can click on the 'Custom Properties' entry in the repository navigation.
In this overview it is possible to view, edit, and delete already created properties or create a new property. With the 'Add new custom property' button, which is located below the table, the user can navigate to another view to create a new property.
Creation of Custom Properties
In this view, the key and the corresponding value can be defined using two text inputs. The property is created by clicking the 'Submit' button.
When entering a key, it is also possible to select from predefined keys. To do this, these keys must be defined in the global or respective namespace configuration (see documentation on configuring the plugin). To display the available suggestions, focus on the text input for the key. Then press the down arrow key to display all suggestions in a combo box. The list of suggested keys can be filtered by entering characters in the text input field. The filter checks whether the current user input is present in the keys as a substring. The filter is case-insensitive.
When creating the property, make sure that the key
- is not longer than 255 characters,
- consists only of letters, numbers, periods, spaces, underscores, slashes, colons, dashes, and the @ character,
- is unique within a repository(each key can be assigned only once).
If you need to enter multiple values for the same key, you can define the custom property to be a multiple choice property within the configuration. There are no restrictions on the value, unless a predefined key is being used with predefined values. If this is the case and the custom property is not a multiple choice property, then the user can select one of the allowed values within a dropdown element.
If the custom property is a multiple choice property, then the user can select at least one value from the list of allowed values with the use of checkboxes.
Editing and Deletion of Custom Properties
For each custom property in the overview, there is a separate button for editing and deleting properties. A property is edited in a similar way as it is created.
To edit, delete, and create properties, it is necessary to have the permission to modify the repository metadata. If the user does not have this permission, the corresponding buttons will not be displayed.
Default Custom Properties
If custom properties with a default value have been defined in the configuration at global or namespace level, then will those appear as default custom properties in the respective repositories, unless they have been explicitly created. Default custom properties differ in that the value is marked with a "Default Value" tag and cannot be deleted.
Mandatory Custom Properties
If mandatory custom properties have been defined in the configuration at global or namespace level, then those will be marked in two different ways within a repository. If the respective custom property has been defined for the repository, the value is marked with a "Mandatory Value" tag. If the respective custom property is not defined, the key appears at the bottom of the table with the other missing mandatory custom properties.
Hint for missing Mandatory Custom Properties
If mandatory custom properties have been defined but not created in a repository, a banner will be displayed below the title in the respective repository. This banner informs the user that mandatory custom properties are missing and need to be created. It also contains a link to the overview page with the custom properties of the respective repository.