Skip to content

Configuration Options

Parameter Type Description
extensionmode option You can choose between the differen extension modes: 'rn = Release Note', 'ki = Knonwn Issue', 'uf = Upcoming Feature'. This determines the default process behavior of the build task.
entryKey option Define the existing entry from the Hub that will be synced and build. Only available in extension mode 'ki' and 'uf'
createEntry boolean true if a release note entry should be created in the hub; otherwise, false.
title string The title to display in the entry.
version string Only needs to be specified if you want a version to be displayed for the entry.
description string Only needs to be specified if you want a description to be displayed for the entry.
placeholders string Only needs to fill the specified placeholder values. To overwrite or fill your placeholders add the following syntax in the textfield: [your_placeholder_name=value]. Multiple placeholders can be specified on separate lines or separated by a comma.
repository string The repository to which the entry should be exported. You can specify the ID or the name of the repository.
branch string The branch name that will be used to check the entry into the repository.
pushMode option The push mode determines how data is exported to the repository, offering three choices: 'Add' creates a new entry, 'Modify' appends the new entry to an existing file (versioning), and 'Replace' substitutes an existing file with the entry. Please note that this option operates based on the 'repoPath' parameter, which specifies the file path.
skipCI boolean Determines whether the commit should be marked with [skip ci]. This is useful if you want to avoid re-triggering the pipeline, especially if the trigger is the branch where the entry is committed.
repoPath string The path to the entry document in the repository. NOTE: The path structure works with "/". For example, if you want to store the document in the entry folder, then enter entry/filename.md.

Placeholder Replacement

To change the value of existing placeholder you need to use the following syntax:

[your_placeholder_name=value]
[your_placeholder_name2=value2]

In a YAML pipeline this looks like this, after you have added the build task to your pipeline.

placeholders: |
    [your_placeholder_name=value]
    [your_placeholder_name2=value2]

The square brackets "[]" must remain, and as you can see, as in the example above, you can fill in more than one placeholder.

To replace the value of placeholder in a classic piepline you need to add them Please define these variables in the Pipeline Variables tab as shown.

Finalization of configuration

Once you have adjusted your configuration, you can add the build task to your pipeline using the Add button. The build task should be listed within the steps section. Here is an example of how to include it:

steps:
- task: Changelogs-for-DevOps-Build-Task@3
  inputs:
    extensionmode: 'rn'
    createEntry: true
    title: '$(Build.Repository.Name) Changelog'
    placeholders: |
      [productVersion=$(App_Version)]
      [buildDate=$(DateTime)]
    repository: '$(Build.Repository.Name)'
    branch: '$(Build.SourceBranchName)'
    pushMode: 'Add'
    repoPath: 'Changelog/$(Build.Repository.Name) - $(Build.BuildNumber).md'

Please check the permissions

To avoid problmens please make sure to set all required permissions!