The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

Team Concert Plugin

rtcBuild: Step for interacting with EWM (RTC) Build

  • task

    Request Build

    Request a EWM (RTC) build from the Jenkins pipeline. When a request is successfully created, the step returns the build result UUID in the property "buildResultUUID".


    Wait for Build

    Wait for a EWM (RTC) build result to attain a specific state. Default states to wait for are COMPLETED and INCOMPLETE. If a timeout period is provided, then the task does not return until the specified state is reached or the time period expires. By default, the task will wait indefinitely till the build result reaches the specified states.


    List Logs

    Retrieve the details of the one or more logs from an EWM (RTC) build result. Logs appear in the "Logs" tab of the EWM build result. This task will retrieve the details of the logs whose content is stored in the EWM repository.


    List Artifacts

    Retrieve the details of the artifacts from an EWM (RTC) build result. Artifacts appear in the "Downloads" tab of the EWM build result. This task will retrieve the details of the artifacts whose content is stored in the EWM repository.


    Download Log

    Download a log from an EWM (RTC) build result. You can download a log using the log’s name or content ID. To retrieve the name or contentId of the log, use the "List Logs" task.


    Download Artifact

    Download an artifact from an EWM (RTC) build result. You can download an artifact using the artifact's name or content ID. To retrieve the name or contentId of the artifact, use the "List Artifacts" task.


    Get SCM Snapshot from Build

    Retrieve the Jazz SCM snapshot details for a given EWM (RTC) build result. If the build result has a Jazz SCM snapshot contribution, then the task returns the snapshot's name and UUID. If the build result does not have such a contribution, then the task returns empty values for snapshot name and UUID.

      Nested Object
    • name : String
    • name : String
    • addOrOverrideProperties : boolean
    • addOrOverrideProperties : boolean (optional)
    • buildDefinitionId : String
    • buildDefinitionId : String (optional)
    • buildResultUUID : String
    • buildResultUUID : String (optional)
    • buildStates : String
    • buildStates : String (optional)
    • componentName : String
    • componentName : String (optional)
    • contentId : String
    • contentId : String (optional)
    • deleteProperties : boolean
    • deleteProperties : boolean (optional)
    • destinationFileName : String
    • destinationFileName : String (optional)
    • fileName : String
    • fileName : String (optional)
    • fileNameOrPattern : String
    • fileNameOrPattern : String (optional)
    • linkEWMBuild : boolean
    • linkEWMBuild : boolean (optional)
    • maxResults : int
    • maxResults : int (optional)
    • propertiesToAddOrOverride
    • propertiesToAddOrOverride (optional)
        Array / List of Nested Object
      • propertyName : String
      • propertyName : String (optional)
      • propertyValue : String
      • propertyValue : String (optional)
    • propertiesToDelete
    • propertiesToDelete (optional)
        Array / List of Nested Object
      • propertyName : String
      • propertyName : String (optional)
      • propertyValue : String
      • propertyValue : String (optional)
    • waitBuildInterval : long
    • waitBuildInterval : long (optional)
    • waitBuildTimeout : int
    • waitBuildTimeout : int (optional)
  • taskName : String
  • buildTool : String (optional)

    The RTC build toolkit to use when running the tasks. The toolkits available are defined in the system configuration (with the other tools like Ant and Java). If the task is run in an agent, then the build toolkit should be available in the agent, either at the same location as the master build toolkit or an overridden location of your choice.

  • credentialsId : String (optional)

    Credentials for the build user. Make sure a name and password credential for the Jazz Repository should be configured.

  • serverURI : String (optional)

    The Jazz Repository connection URI for the EWM (RTC) server.

  • timeout : int (optional)

    The timeout period in seconds for establishing a connection to the Jazz repository when running this step. Default value is 120 seconds.

step([$class: 'RTCPostBuildDeliverPublisher']): RTC Post Build Deliver

Perform post build deliver for Rational Team Concert(RTC) SCM configuration in the Jenkins build.

In a Pipeline job where RTC SCM can be called multiple times, post build deliver will be attempted for each invocation of RTC SCM.

Currently, post build deliver is performed only if a build definition is used as the build configuration. The step uses the post build deliver configuration information from the build definition.

  • failOnError : boolean

    If post build deliver operation fails, set the build's status to FAILURE.

teamconcert: Team Concert

  • buildType
      Nested Object
    • value : String
    • value : String
    • buildDefinition : String
    • buildDefinition : String
    • buildWorkspace : String
    • buildWorkspace : String
    • buildSnapshot : String
    • buildSnapshot : String
    • buildStream : String
    • buildStream : String
    • acceptBeforeLoad : boolean
    • acceptBeforeLoad : boolean (optional)
    • addLinksToWorkItems : boolean
    • addLinksToWorkItems : boolean (optional)
    • buildSnapshotContext
    • buildSnapshotContext (optional)
        Nested Object
      • snapshotOwnerType : String
      • snapshotOwnerType : String
      • processAreaOfOwningStream : String
      • processAreaOfOwningStream : String
      • owningStream : String
      • owningStream : String
      • owningWorkspace : String
      • owningWorkspace : String
    • clearLoadDirectory : boolean
    • clearLoadDirectory : boolean (optional)
    • componentLoadConfig : String
    • componentLoadConfig : String (optional)
    • componentsToExclude : String
    • componentsToExclude : String (optional)
    • createFoldersForComponents : boolean
    • createFoldersForComponents : boolean (optional)
    • currentSnapshotOwnerType : String
    • currentSnapshotOwnerType : String (optional)
    • customizedSnapshotName : String
    • customizedSnapshotName : String (optional)
    • generateChangelogWithGoodBuild : boolean
    • generateChangelogWithGoodBuild : boolean (optional)
    • loadDirectory : String
    • loadDirectory : String (optional)
    • loadPolicy : String
    • loadPolicy : String (optional)
    • overrideDefaultSnapshotName : boolean
    • overrideDefaultSnapshotName : boolean (optional)
    • pathToLoadRuleFile : String
    • pathToLoadRuleFile : String (optional)
    • pollingOnly : boolean
    • pollingOnly : boolean (optional)
    • pollingOnlyData
    • pollingOnlyData (optional)
        Nested Object
      • snapshotUUID : String
      • snapshotUUID : String
    • processArea : String
    • processArea : String (optional)
    • useDynamicLoadRules : boolean
    • useDynamicLoadRules : boolean (optional)
  • changelog : boolean (optional)
    Enable or Disable 'Include in changelog':

    If 'Include in changelog' is enabled for an SCM source, then when a build occurs, the changes from that SCM source will be included in the changelog.

    If 'Include in changelog' is disabled, then when a build occurs, the changes from this SCM source will not be included in the changelog.

  • overrideConfig (optional)
      Nested Object
    • serverURI : String
    • serverURI : String
    • credentialsId : String
    • credentialsId : String
    • buildTool : String
    • buildTool : String
    • avoidUsingToolkit : boolean
    • avoidUsingToolkit : boolean (optional)
    • serverUri : String
    • serverUri : String (optional)
    • timeout : int
    • timeout : int (optional)
  • poll : boolean (optional)
    Enable or Disable 'Include in polling'

    If 'Include in polling' is enabled or 'Include in changelog' is enabled, then when polling occurs, the job will be started if changes are detected from this SCM source.

    If 'Include in polling' is disabled and 'Include in changelog' is disabled, then when polling occurs, changes that are detected from this repository will be ignored.


Was this page helpful?

Please submit your feedback about this page through this quick form.

Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

    


See existing feedback here.