FileTransform@2 - 檔案轉換 v2 工作

使用此工作將令牌取代為 XML 或 JSON 組態檔中的變數值。

使用此工作將令牌取代為 XML 或 JSON 組態檔中的變數值。

# 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.
    #enableXmlTransform: true # boolean. XML transformation. Default: true.
    #xmlTransformationRules: '-transform **\*.Release.config -xml **\*.config' # string. Optional. Use when enableXmlTransform == true. XML Transformation rules. Default: -transform **\*.Release.config -xml **\*.config.
    #errorOnInvalidSubstitution: false # boolean. Error on empty files and invalid substitution. Default: false.
  # Variable Substitution
    #jsonTargetFiles: # string. JSON target files. 
    #xmlTargetFiles: # string. XML target files.

# 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 - 套件或資料夾
string。 必填。 預設值：$(System.DefaultWorkingDirectory)/**/*.zip。

封裝或資料夾的檔案路徑。

變數 組建，版本。 支援通配符。

例如，$(System.DefaultWorkingDirectory)/**/*.zip。 對於壓縮的資料夾，內容會擷取至 TEMP 位置、執行轉換，以及壓縮原始成品位置的結果。

enableXmlTransform - XML 轉換
boolean。 預設值：true。

組態轉換將會在變數替代之前執行。

xmlTransformationRules - XML 轉換規則
string。 自選。 enableXmlTransform == true時使用 。 預設值：-transform **\*.Release.config -xml **\*.config。

使用 語法提供換行符分隔的轉換檔案規則清單：-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>。 結果檔路徑是選擇性的，如果未指定，來源組態檔將會取代為轉換的結果檔。

xmlTransformationRules - XML 轉換規則
string。 預設值：-transform **\*.Release.config -xml **\*.config。

使用 語法提供換行符分隔的轉換檔案規則清單：-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>。 結果檔路徑是選擇性的，如果未指定，來源組態檔將會取代為轉換的結果檔。

jsonTargetFiles - JSON 目標檔案
string。

提供以換行符分隔的檔案清單，以取代變數值。 檔名會相對於根資料夾提供。

例如，若要替換以下示例檔中的值 of ConnectionString ，需要在生成或發佈管道 （或發佈管道的環境） 中定義變數 Data.DefaultConnection.ConnectionString 。

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

變數替代會在組態轉換之後執行。

注意：只有建置/發行管線中定義的自定義變數才會用於替代。 排除預設/系統定義的管線變數。 如果在發行管線和階段中定義相同的變數，則階段變數將會取代發行管線變數。

xmlTargetFiles - XML 目標檔案
string。

提供以換行符分隔的檔案清單，以取代變數值。 檔名會相對於根資料夾提供。

針對 XML，建置或發行管線中定義的變數將會比對任何組態檔和 key中 name、appSettings和 applicationSettings 區段中的 connectionStrings 或 parameters.xml 專案。

變數替代會在組態轉換之後執行。

注意：只有建置/發行管線中定義的自定義變數才會用於替代。 排除預設/系統定義的管線變數。 如果在發行管線和階段中定義相同的變數，則階段變數將會取代發行管線變數。

errorOnInvalidSubstitution - 空檔錯誤和無效替換。
boolean。 預設值：false。

如果選取中，則當目標檔為空或替換失敗時，管道將失敗。

沒有。