Property Sets

JFrog Artifactory Documentation

Products
JFrog Artifactory
Content Type
User Guide
ft:sourceType
Paligo

Artifactory allows you to place properties on both artifacts and folders. Setting (and deleting) properties is supported by local repositories or local-cache repositories. While you cannot set or delete properties on virtual repositories, you can retrieve them.

You can assign properties from the UI, via REST (see below), or on deployment, using Matrix Parameters . Properties can also be used to Control Artifacts Resolution

Properties are searchable and can be combined with Smart Searches to search for items based on their properties and then manipulate all the items in the search result in one go.

Create a Property Set

You can define the collections of properties called 'Property Sets' in the user interface. In each property-set you can define properties and for each property specify whether the property is open, single-value or multi-value.

This impacts the user interface you see when setting a property value and when searching for property values. Using searchable properties in artifact management is a very powerful feature.

Note

Properties are for Guiding, not for Restricting

When you define a property-set with 'strongly-typed' property values, those values are used to provide an intuitive, guiding UI for tagging and locating items.

The actual value does not force a strong relationship to the original property-set's predefined values. This is by design, to not slow-down common repository operations and for keeping artifacts management simple by allowing properties to change and evolve freely over time, without worrying about breaking older property rules.

Properties are therefore a helpful and non-restrictive feature.

To create a new property set, go to Admin | Artifactory | General | Property Sets and click New.

property_sets_new.png

Add a Property Set Name, click New and add properties. The newly created property set will be available to use and add to a repository.

new property sets.png
new property.png

Assign Property Sets to a Repository

To assign a property set to a repository which can then be selected from with the Artifact browser, go to Administration module | Repositories and select a repository.

In the Advanced tab, select the property sets you would like to be available under this repository.

assign a property set to a repository.png

Add Property Sets to a Specific Repository

To add a property set to a specific repository, go to Application module | Artifacts and select a repository.

In the Properties tab, select the property sets you would like to add.

adding property sets to repos.png

Attach Properties via the UI

When selecting any item in the tree browser, you can view its Properties tab to view or edit the properties attached to the item.

editing_property_sets.png

You can edit the value of any property and click Save.

EditMultivalue.jpg
Attach and Read Properties via REST API

Properties are a special form of metadata and are stored on items just like any metadata - in XML form.

In fact, you can view properties not only from the Artifacts:Properties tab, but also from the Artifacts:Metadata tab, in which you can examine properties as they are stored in XML form. The properties XML is using the properties root tag and has a very simple format.

You can set, retrieve, update, and remove properties from repository items via REST API, as you would do with any other XML-based metadata.Set Item PropertiesUpdate Item PropertiesDelete Item Properties