Viewing and Searching for Properties in the UI
There are a number of ways to search and to view properties in the JFrog Platform UI.
Permissions
Only users who haveAnnotate Permissionscan add and edit properties in JFrog; for more information, seePermissions.
Viewing Properties in the Artifact Tree Browsers
When selecting any item in the tree browser, click itsPropertiestab to view or edit the properties attached to the item (if any have been set).
The properties appear in the Properties list at the bottom of the window..
Searching for Properties in the UI
- To search for properties in the UI, go toArtifactoryin the Application tab and selectArtifacts.
- Click theSearch滤波函数,然后在类型下拉lectProperty.
This opens the Search Artifacts dialog. - From the Repository dropdown, select one or more repositories.
- Optional:
- To search for a specific property, click+Addto add the key and value of the property.
- To search for a specific property-set, click+Addto add the key and value of the property set.
- ClickSearchto begin searching.
Adding and Deleting Properties
Adding Properties via the UI
When selecting any item in the tree browser, you can view itsProperties附加选项卡添加和删除属性ed to the item.
- To add a property, open any item in the tree browser and go to the item'sPropertiestab.
- In theAdd Propertyfield, enter a name and value for the property.
You can also add multi-value properties, by entering the values separated with a semi-colon ( ; ). - Optional: To add the property to the selected folder as well as to all of the artifacts, folders and sub-folders under this folder, select theRecursiveoption.
ClickAddto add the new property.
You can add multiple properties to a single item; all properties will then appear at the bottom of the item Properties tab.
Deleting a Property or Removing Recursively
- To delete a property, go to the list of properties, select the property and then click删除or click thexbutton to the right of the property.
You will be asked to confirm your deletion. - To remove recursively, click删除Recursivelyor the Delete Recursively icon to the right of the property.
You will be asked to confirm your deletion.
Adding Properties to Different Types of Resources
You can add properties to different resources including packages, builds, Release Bundles, andartifacts(for example, to binary files).Adding properties to Release Bundles is a particularlypowerful feature, since you can use the Recursive option to apply property toall of the artifacts, folders and sub-folders under the folder.
Using Properties in JFrog
This section provides some examples of how to use properties in JFrog through a wide variety of interfaces and options.
Using Properties in the REST APIs
Properties are a special form of metadata that are stored on items just like any metadata - but in XML form. You can view properties not only from theArtifacts:Properties
tab, but also from theArtifacts:Metadata
tab, in which you can examine properties as they are stored in XML form. The properties XML uses theproperties
root tag and has a very simple format.As such, you can set, retrieve and remove properties from repository items via REST API, as you would do with any other XML-based metadata.For more information, seeArtifactory REST APIs.
Using Properties in theCLI
JFrog CLI is a compact and smart client, which provides a simple interface for automating access to JFrog products. TheCLI command enables you to set properties on any artifact in Artifactory. For more information, seeSetting Properties on Files.
Using Properties in theAQL
An AQL resource creates an Artifactory query using the Artifactory Query Language (AQL). This type of resource can beused in the configuration of a FileSpec resource to specify file properties to match against, and as aninputresource
for theCreateReleaseBundle
step to define the query that is used to create a release bundle. For more information, seeAql.
Using Properties in theUser Plugins
User plugins written in Groovy enable you to adapt Artifactory's behavior to meet your own needs, including responding to any storage events on items and properties. For more information, seeUser Plugins.
Using Property Sets
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 UI you see when setting a property value and when searching for property values; as such, using searchable properties in artifact management is a very powerful feature.For more information, seeProperty Sets.
Matrix Parameters
Matrix parameters are key-value pairs parameters separated by a semicolon (;) that you can place anywhere on a URL.For more information, seeMatrix Parameters.