File Transformation (variable substitution) and issues faced in Azure Devops  -  YAML

Variable substitution in Azure Devops | File Transformation in azure devops using YAML | Troubleshooting File Transformation in Azure Devops

File Transformation (variable substitution) and issues faced in Azure Devops  -  YAML
Sanjeevi Subramani's photo
Sanjeevi Subramani

Published on Mar 9, 2021

1 min read

Subscribe to my newsletter and never miss my upcoming articles

Following this document used file transformation task in Azure Devops to substitute variables in json and xml files:

# File transform
# Replace tokens with variable values in XML or JSON configuration files
- task: FileTransform@1
 #folderPath: ‘$(System.DefaultWorkingDirectory)/**/*.zip’ 
 #enableXmlTransform: # Optional
 #xmlTransformationRules: ‘-transform **\*.Release.config -xml **\*.config-transform **\*.$(Environment.Name).config -xml **\*.config’ # Optional
 #fileType: # Optional. Options: xml, json
 #targetFiles: # Optional

When using this you will get following error message: “changes already present message”.

Got the changes already present message when directly targeting the source folder. The idea is that the build package is edited by this task, so configuration is updated before test or deployment.

This worked for me (note the **/):


task: FileTransform@1
displayName: ‘File Transform: appsettings.json’
folderPath: ‘$(System.DefaultWorkingDirectory)’
fileType: json
targetFiles: ‘**/appsettings.json’

To prevent another error that will be experienced if doing variable substitution for non-windows app : “Cannot perform XML transformations on a non-Windows platform”

you need to specify an empty xmlTransformationRules. This works against a Linux app service:

task: FileTransform@2
    folderPath: $(Pipeline.Workspace)/path-to/
    jsonTargetFiles: appsettings.json
    xmlTransformationRules: '' # disabled

Referred this issue in GitHub repo — hope it helps someone:

Refer videos in my channel for live explanations.

Youtube Channel

Share this