Properties

Skip to end of metadata
Go to start of metadata
Table of Contents

Introduction

Artifactory allows you to put properties on both artifacts and folder.
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.

You to define in the UI collections of properties called 'Property Sets'. In each property-set you can define properties and for each property specify whether the property is open, single-value or multi-value. This affects the UI a user gets when setting a property value and when searching for property values.

Using searchable properties in artifact management are a very powerful feature.

Watch this short screencast to learn more about the power of properties.

Properties are 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, in order 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 helping, non-restrictive feature.

Attaching and Reading Properties via REST API

Properties are a special form of metadata and they 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, get and remove properties from repository items via REST API, as you would do with any other XML-based metadata. Please follow the attaching and reading metadata chapter for instructions on how this can be achieved.

Labels: