FileTransform@1 : Dateitransformation v1-Aufgabe

Artikel
07/02/2024

Verwenden Sie diese Aufgabe, um Token durch Variablenwerte in XML- oder JSON-Konfigurationsdateien zu ersetzen.

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.

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

Eingaben

folderPath - Paket oder Ordner
string. Erforderlich. Standardwert. $(System.DefaultWorkingDirectory)/**/*.zip.

Der Dateipfad zum Paket oder einem Ordner.

Variablen sind Build und Release. Platzhalter werden unterstützt.

Beispiel: $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - XML-Transformation
boolean. Standardwert. false.

Konfigurationstransformationen werden vor der Variablenersetzung ausgeführt.

XML-Transformationen werden nur für die Windows-Plattform unterstützt.

xmlTransformationRules - Transformationsregeln
string. Optional. Verwenden Sie , wenn enableXmlTransform == true. Standardwert. -transform **\*.Release.config -xml **\*.config.

Stellt eine neue zeilentrennte Liste von Transformationsdateiregeln mithilfe der Syntax bereit:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

xmlTransformationRules - Transformationsregeln
string. Optional. Verwenden Sie , wenn enableXmlTransform == true. Standardwert. -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config.

Stellt eine durch zeilentrennte Liste von Transformationsdateiregeln mithilfe der Syntax bereit:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Dateiformat
string. Zulässige Werte: xml, json.

Stellt das Dateiformat bereit, in dem die Ersetzung perfformiert wird.

Für XML werden variablen, die in den Build- oder Releasepipelines definiert sind, mit den key Einträgen oder name in den appSettingsAbschnitten , applicationSettingsund connectionStrings jeder Konfigurationsdatei und parameters.xmlabgeglichen. Variable Substitution wird nach Konfigurationstransformationen ausgeführt.

Um JSON-Variablen zu ersetzen, die geschachtelt oder hierarchisch sind, geben Sie sie mithilfe von JSONPath-Ausdrücken an.

Um beispielsweise den Wert von ConnectionString im folgenden Beispiel zu ersetzen, müssen Sie eine Variable wie Data.DefaultConnection.ConnectionString in der Build- oder Releasepipeline (oder der Umgebung der Releasepipeline) definieren.

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

Variablenersetzung wird nach Konfigurationstransformationen ausgeführt.

Hinweis: Bei der Ersetzung werden nur benutzerdefinierte Variablen verwendet, die in Build-/Releasepipelines definiert sind. Standard-/systemdefinierte Pipelinevariablen werden ausgeschlossen. Wenn dieselben Variablen in der Releasepipeline und in der Phase definiert sind, ersetzen die Phasenvariablen die Releasepipelinevariablen.

targetFiles - Zieldateien
string. Optional. Verwenden Sie , wenn fileType = xml || fileType = json.

Stellt eine durch Zeilen getrennte Liste von Dateien bereit, um die Variablenwerte zu ersetzen. Dateinamen müssen relativ zum Stammordner angegeben werden.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Es ist eine neuere Version dieser Aufgabe unter FileTransform@2 verfügbar.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Hilfsprogramm

Freigeben über