FileTransform@2: Dateitransformation v2-Aufgabe

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

# File transform v2
# Replace tokens with variable values in XML or JSON configuration files.
- task: FileTransform@2
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #xmlTransformationRules: '-transform **\*.Release.config -xml **\*.config' # string. XML Transformation rules. Default: -transform **\*.Release.config -xml **\*.config.
  # Variable Substitution
    #jsonTargetFiles: # string. JSON target files. 
    #xmlTargetFiles: # string. XML target files.

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

Dateipfad zum Paket oder Ordner.

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

Beispiel: $(System.DefaultWorkingDirectory)/**/*.zip. Bei gezippten Ordnern werden die Inhalte an den TEMP-Speicherort extrahiert, Transformationen ausgeführt und die Ergebnisse in den ursprünglichen Artefaktspeicherort gezippt.

xmlTransformationRules - XML-Transformationsregeln
string. Standardwert. -transform **\*.Release.config -xml **\*.config.

Stellt eine durch Zeilen getrennte Liste von Transformationsdateiregeln mithilfe der Syntax bereit: -transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>. Der Pfad der Ergebnisdatei ist optional, und wenn nicht angegeben, wird die Quellkonfigurationsdatei durch die transformierte Ergebnisdatei ersetzt.

jsonTargetFiles - JSON-Zieldateien
string.

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

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: Nur benutzerdefinierte Variablen, die in Build-/Releasepipelines definiert sind, werden als Ersetzung verwendet. Standard-/systemdefinierte Pipelinevariablen werden ausgeschlossen. Wenn dieselben Variablen in der Releasepipeline und in der Phase definiert sind, ersetzen die Phasenvariablen die Releasepipelinevariablen.

xmlTargetFiles - XML-Zieldateien
string.

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

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 einer beliebigen Konfigurationsdatei und parameters.xmlabgeglichen.

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.

Keine.