Using Properties in Deployment and Resolution

Matrix parameters are key-value pair parameters separated by a semicolon (;) that you can place anywhere in a URI. Matrix URI is a method for specifying parameters in HTTP, in addition to querying parameters and path parameters. You can use matrix parameters in Artifactory to add properties to artifacts as part of deployment, and to control artifact resolution.

For example, note the matrix parameters status=DEV and rating=5 in the following URL:

http://repo.jfrog.org/artifactory/libs-releases-local/org/libs-releases-local/org/jfrog/build-info-api/1.3.1/build-info-api-1.3.1.jar;status=DEV;rating=5

These parameters add specifications for artifact resolution or deployment.

For deployment, you can add key-value matrix parameters to deploy (PUT) requests. If you add matrix parameters to the target deployment base URL, the artifact path is added after the matrix parameters at the time of deployment. The matrix parameters are automatically transformed to properties on the deployed artifact.

Dynamic Properties in Deployment

Depending on your deployment framework, you can use dynamic properties. For example, when using Maven, you can add the parameters buildNumber and revision to the deployment URL. At deployment time, Maven replaces the parameters with dynamic values from the project properties.

For example, given the following:

The final deployed item build-info-api-1.3.1.jar has two properties:

buildNumber=249
revision=1052

Matrix Parameters Queries for Artifact Resolution

You can use matrix parameters in artifact resolution to control how artifacts are found and served. Two types of queries are supported:

The following table provides examples of artifact resolution results based on artifact properties and specified matrix parameters.