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.

Syntax

# 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.

Indata

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>.

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.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

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

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	Alla agentversioner som stöds.
Uppgiftskategori	Verktyg