Skip to content

Latest commit

 

History

History
123 lines (86 loc) · 4.99 KB

README.md

File metadata and controls

123 lines (86 loc) · 4.99 KB
Raw

Release Notes

19-09-2023

  • Added the ability to lift an enviroment variable from the agent to a workflow variable.

05-12-2022

  • Changed: Upped version to 3.*
  • Updated to Azure-pipelines-task-lib@4
  • Updated to Node 16 (available in @3)
  • Removed Node 6 support from v3 (available for backwards-compat through @2)
  • Dropped dependency on core-js for v3.

19-10-2021

  • Added: Ability to update ReleaseName with the new command string required in Azure DevOps 2020.
  • Added: Backwards compat option for Azure DevOps 2019 and below
  • Changed: Upped version number to 2.*

15-04-2020

23-01-2018

  • Changed: Re-implemented Variable-Set in v3 PowerShell handler for better performance.
  • Fixed: Pad-left and Pad-right now uses core-js library.
  • Updated: moved to latest Task SDK and dependencies.

17-11-2017

  • Fixed: Set Build.BuldNumber doesn't work on most recent Windows Build agents. Updated to VSTS-Task-Lib 2.1.0 to fix.

1-9-2016

  • Fixed: Expand Variable Task throws an error on Agent 2.x, you can now remove this task, it is no longer needed. The new agent will automatically expand all variables.

20-5-2016

  • Removed: Preview flag

19-5-2016

  • Fixed: Replace with "" would result in "nullOriginalValue"

Description

This Extension contains a slowly growing collection of tasks that help you manipulate and (soon) validate the values of build variables.

Set Variable

Have you ever wanted to change the value of a variable between multiple build steps? Simply add the Set Variable task to your workflow and tell it which value you want to assign to which variable.

You can use the value of other build variables to setup the value.

Set: 'Build.DropLocation' to '\\share\drops$(Build.DefinitionName)$(Build.BuildNumber)'

  • Variablename: Build.DropLocation
  • Value: \\share\drops\$(Build.DefinitionName)\$(Build.BuildNumber)

By assigning to the Build.BuildNumber variable, the build number of the Build will be updated/overwritten.

Transform value and assign to Variable

If you need to do more advanced transformations of your values, use the transform task. You can use it to encode/decode the value and apply a number of simpe string manipulations, including Search & Replace, Change Case, Trim, Pad etc.

You can use the value of other build variables to setup the value.

Transform: 'your value here' and assign to Variable: VariableName'

  • Input Value: \\share\drops\$(Build.DefinitionName)\$(Build.BuildNumber)
  • Variablename: Build.DropLocation

By assigning to the Build.BuildNumber variable, the build number of the Build will be updated/overwritten.

You can apply the following manipulations (they'll be exectuted in the specified order):

Manipulation

  • Search & Replace
  • Use: Basic
  • Search: $Build.DefinitionName
  • Replacement: %%Placeholder%%
  • Trim
  • Slice
  • Substring
  • Change Case
  • Pad

And finally you can transform (encode/decode) the string using:

  • Base64
  • Uri
  • UriComponent
  • AddSlashes / StripSlashes

Expand Variables [DEPRECATED]

Have you ever wanted to use the value from one variable in another variable? Unfortunately, that's not possible with the standard Variables screen.

Variable Value
Build.DropLocation \\share\drops$(Build.DefinitionName)$(Build.BuildNumber)

Will simply send the literal text to the tasks in your workflow.

Add the Expand Variable(s) task to the top of your build steps and it will take care of the expansion for you. It even supportes multiple levels of nested variables!

Expand variable: 'Build.DropLocation'

  • Variablename(s): Build.DropLocation

Will expand your drop location variable to:

Variable Value
Build.DropLocation \\share\drops\My Definition\My Definition_1.2.123

And to make your life easier it now supports simply expanding all your variables!

Expand variable: '*'

  • Variablename(s): *

Documentation

Please check the Wiki.

If you like this extension, please leave a review and feedback. If you'd have suggestions or an issue, please file an issue to give me a chance to fix it.