FileTransform@1 – Filtransformering v1-uppgift

Använd den här uppgiften för att ersätta token med variabelvärden i XML- eller JSON-konfigurationsfiler.

# File transform v1
# Replace tokens with variable values in XML or JSON configuration files.
- task: FileTransform@1
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #enableXmlTransform: false # boolean. XML transformation. Default: false.
    #xmlTransformationRules: '-transform **\*.Release.config -xml **\*.config' # string. Optional. Use when enableXmlTransform == true. Transformation rules. Default: -transform **\*.Release.config -xml **\*.config.
  # Variable Substitution
    #fileType: # 'xml' | 'json'. File format. 
    #targetFiles: # string. Optional. Use when fileType = xml || fileType = json. Target files.

# File transform v1
# Replace tokens with variable values in XML or JSON configuration files.
- task: FileTransform@1
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #enableXmlTransform: false # boolean. XML transformation. Default: false.
    #xmlTransformationRules: # string. Optional. Use when enableXmlTransform == true. Transformation rules. 
  # Variable Substitution
    #fileType: # 'xml' | 'json'. File format. 
    #targetFiles: # string. Optional. Use when fileType = xml || fileType = json. Target files.

folderPath - Paket eller mapp
string. Krävs. Standardvärde: $(System.DefaultWorkingDirectory)/**/*.zip.

Filsökvägen till paketet eller en mapp.

Variabler är Build och Release. Jokertecken stöds.

Till exempel $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - XML-transformering
boolean. Standardvärde: false.

Konfigurationstransformeringar körs före variabelersättningen.

XML-transformeringar stöds endast för Windows-plattformen.

xmlTransformationRules - Transformeringsregler
string. Valfritt. Använd när enableXmlTransform == true. Standardvärde: -transform **\*.Release.config -xml **\*.config.

Innehåller en ny radavgränsad lista över transformeringsfilregler med hjälp av syntaxen:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

xmlTransformationRules - Transformeringsregler
string. Valfritt. Använd när enableXmlTransform == true. Standardvärde: -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config.

Innehåller en ny radavgränsad lista över transformeringsfilregler med hjälp av syntaxen:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Filformat
string. Tillåtna värden: xml, json.

Innehåller det filformat där ersättningen är perfformed.

För XML matchas variabler som definierats i bygg- eller versionspipelines mot key posterna eller name i avsnitten appSettings, applicationSettingsoch connectionStrings i alla konfigurationsfiler och parameters.xml. Variable Substitution körs efter konfigurationstransformering.

Om du vill ersätta JSON-variabler som är kapslade eller hierarkiska anger du dem med JSONPath-uttryck.

Om du till exempel vill ersätta värdet ConnectionString för i exemplet nedan måste du definiera en variabel som Data.DefaultConnection.ConnectionString i bygg- eller versionspipelinen (eller versionspipelinens miljö).

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
    }
  }
}

Variabelersättning körs efter konfigurationstransformering.

Obs! Endast anpassade variabler som definieras i bygg-/versionspipelines används i ersättning. Standard-/systemdefinierade pipelinevariabler undantas. Om samma variabler definieras i versionspipelinen och i fasen ersätter fasvariablerna variablerna versionspipelinen.

targetFiles - Målfiler
string. Valfritt. Använd när fileType = xml || fileType = json.

Innehåller en ny radavgränsad lista med filer som ersätter variabelvärdena. Filnamn ska anges i förhållande till rotmappen.

Inga.

Kommentarer

Det finns en nyare version av den här uppgiften tillgänglig på FileTransform@2.