Post-build Deliver Properties

The following sections describe how to define the Post-build Deliver properties used in a build definition. Each section describes an element that can be specified within the createBuildDefinition or updateBuildDefinition element. These elements are not required and may not be applicable to the type of definition you are creating.

Refer to Build Reference to determine which elements are valid for the build you are defining.

All Post-build Deliver properties support the standard property attributes, but most attributes are ignored as the values for the attributes are set internally and can not be overriden. The following table describes the attributes and what affect, if any, specifying the attributes has on the build property itself.

Attribute Required Description

name

Yes

Name of the build property. Valid names are described in each of the following sections.

value

Yes

Value of the build property. Valid values and restrictions are described in each of the following sections. Restrictions on the valid values are noted in the value column. The restrictions noted are as follows:
Restriction Descritpion
boolean This is a boolean value which must be specified as either true or false.
integer This must be an integer value.
true/false This is a boolean value which must be specified as either true or false.
value list One of the listed values must be specified. For example: ALWAYS, NO_ERRORS, or NO_WARNINGS.

asis

No

Valid values are true and false. The default is false. Specifying this attribute will control how the property is resolved.

description

No

This attribute is ignored.

genericEditAllowed

No

This attribute is ignored.

kind

No

This attribute is ignored.

label

No

This attribute is ignored.

override

No

This attribute is ignored.

required

No

This attribute is ignored.

scheduleOverride

No

This attribute is ignored.

wellKnown

No

This attribute is ignored.

deliverProperty Element

Code deliverProperty elements to specify the trigger policy used to determine when to automatically deliver component changes, the target stream you would like to flow changes to, the components that will be delivered, and the owner of the snapshot created (ownership can only be changed if all components are delivered) for the Post-build Delivery facility. The deliverProperty element accepts two attributes, name and value, which are both required. Other build properties can be referenced when specifying a value using the ${propertyName} format. The following table describes the valid values for the deliverProperty element attributes:

name value Description

team.scm.deliver.abortOnIncompleteActivity

true

false

Abort post-build deliver if there are incomplete build activities.

team.scm.deliver.addNewComponentsToTarget

true

false

Add components to deliver if they do not exist in the deliver target.

team.scm.deliver.changeSnapshotOwner

true

false

Snapshot owner: Specify false to leave the build workspace as the owner. Specify true to set the deliver target as the owner of the snapshot.

team.scm.deliver.componentsToDeliver

 

Components to deliver: Specify a comma separated list of component names to deliver.

team.scm.deliver.deliverAllComponents

true

false

Deliver all components in build workspace. When false is specified, a non-blank team.scm.deliver.componentsToDeliver attribute is required. When true is specified, the team.scm.deliver.componentsToDeliver attribute must not be specified.

team.scm.deliver.enabled

true

false

Enable post-build deliver.

team.scm.deliver.removeComponentsInTarget

true

false

Remove components from deliver target if they do not exist in the build workspace.

team.scm.deliver.targetUUID

 

Deliver Target: Specify the name of the target stream you would like to flow changes to.

team.scm.deliver.triggerPolicy

ALWAYS
NO_ERRORS
NO_WARNINGS
Trigger policy: Specify the trigger policy used to determine when to automatically deliver component changes. Valid values are:
  • ALWAYS - Deliver always.
  • NO_ERRORS - Deliver if build has no errors (warnings allowed).
  • NO_WARNINGS - Deliver if build has no errors or warnings.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki