FileTransform@1 - ファイル変換 v1 タスク
このタスクを使用して、トークンを XML または JSON 構成ファイル内の変数値に置き換えます。
このバージョンのタスクは非推奨です。FileTransform@2を使用します。
このタスクを使用して、トークンを XML または JSON 構成ファイル内の変数値に置き換えます。
構文
# 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.
入力
folderPath
-
パッケージまたはフォルダー
string. 必須。 既定値: $(System.DefaultWorkingDirectory)/**/*.zip.
パッケージまたはフォルダーへのファイル パス。
変数はビルド とリリース
たとえば、$(System.DefaultWorkingDirectory)/**/*.zip のようにします。
XML 変換 を
boolean. 既定値: false.
構成変換は変数置換の前に実行されます。
XML 変換は、Windows プラットフォームでのみサポートされます。
xmlTransformationRules
-
変換ルールの
string. 任意
enableXmlTransform == trueするときに使用します。 既定値: -transform **\*.Release.config -xml **\*.config.
次の構文を使用して、変換ファイルルールの新しい行区切りリストを提供します。
-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.
fileType
-
ファイル形式の
string. 使用できる値: xml、json。
置換が行われるファイル形式を提供します。
XML の場合、ビルドまたはリリース パイプラインで定義されている変数は、構成ファイルと parameters.xmlの appSettings、applicationSettings、および connectionStrings セクションの key または name エントリと照合されます。
Variable Substitution は、構成の変換後に実行されます。
入れ子または階層構造の JSON 変数を置き換える場合は、JSONPath 式を使用して指定します。
たとえば、次のサンプルの ConnectionString の値を置き換えるには、ビルドまたはリリース パイプライン (またはリリース パイプラインの環境) で Data.DefaultConnection.ConnectionString 変数を定義する必要があります。
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
変数の置換は、構成の変換後に実行されます。
注: 代わりに使用されるのは、ビルド/リリース パイプラインで定義されているカスタム変数のみです。 既定またはシステム定義のパイプライン変数は除外されます。 リリース パイプラインとステージで同じ変数が定義されている場合、ステージ変数はリリース パイプライン変数よりも優先されます。
ターゲット ファイルを targetFiles - する
string. 任意
fileType = xml || fileType = jsonするときに使用します。
変数値に置き換えるファイルの改行区切りリストを提供します。 ファイル名は、ルート フォルダーを基準にして指定されます。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクの新しいバージョンは、FileTransform@2で使用できます。