FileTransform@1 - ファイル変換 v1 タスク

このタスクを使用して、トークンを 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 」のように入力します。

enableXmlTransform - XML 変換
boolean. 既定値: false。

構成変換は、変数の置換の前に実行されます。

XML 変換は、Windows プラットフォーム向けにのみサポートされています。

xmlTransformationRules - 変換ルール
string. 省略可能。 の場合は enableXmlTransform == trueを使用します。 既定値: -transform **\*.Release.config -xml **\*.config。

構文を使用して、変換ファイルルールの新しい行区切りリストを提供します。

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - ファイル形式
string. 使用できる値: xml、json。

置換が行われるファイル形式を提供します。

XML の場合、ビルドまたはリリース パイプラインで定義されている変数は、構成ファイルと の 、applicationSettings、および セクションの appSettingsまたは name エントリとconnectionStrings照合されますkey。parameters.xml 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で使用できます。

要件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
上で実行	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	サポートされているすべてのエージェント バージョン。
タスクのカテゴリ	ユーティリティ