FileTransform@1 - Tugas transformasi file v1

Artikel
05/16/2024

Gunakan tugas ini untuk mengganti token dengan nilai variabel dalam file konfigurasi XML atau JSON.

Sintaks

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

Input

folderPath - Paket atau folder
string. Wajib diisi. Nilai default: $(System.DefaultWorkingDirectory)/**/*.zip.

Jalur file ke paket atau folder.

Variabel adalah Build dan Release. Penggunaan wildcard didukung.

Contohnya,$(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - Transformasi XML
boolean. Nilai default: false.

Transformasi konfigurasi akan dijalankan sebelum Substitusi Variabel.

Transformasi XML hanya didukung untuk platform Windows.

xmlTransformationRules - Aturan transformasi
string. Pilihan. Gunakan saat enableXmlTransform == true. Nilai default: -transform **\*.Release.config -xml **\*.config.

Menyediakan daftar aturan file transformasi yang dipisahkan baris baru menggunakan sintaks:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

xmlTransformationRules - Aturan transformasi
string. Pilihan. Gunakan saat enableXmlTransform == true. Nilai default: -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config.

Menyediakan daftar aturan file transformasi yang dipisahkan baris baru menggunakan sintaks:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Format file
string. Nilai yang diizinkan: xml, json.

Menyediakan format file tempat substitusi diformat.

Untuk XML, variabel yang ditentukan dalam alur build atau rilis akan dicocokkan dengan key entri atau name di bagian appSettings, applicationSettings, dan connectionStrings dari file konfigurasi apa pun dan parameters.xml. Variable Substitution dijalankan setelah transformasi konfigurasi.

Untuk mengganti variabel JSON yang berlapis atau hierarkis, tentukan menggunakan ekspresi JSONPath.

Misalnya, untuk mengganti nilai ConnectionString dalam sampel di bawah ini, Anda perlu menentukan variabel seperti Data.DefaultConnection.ConnectionString dalam alur build atau rilis (atau lingkungan alur rilis).

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

Penggantian Variabel dijalankan setelah transformasi konfigurasi.

Catatan: Hanya variabel kustom yang ditentukan dalam alur build/rilis yang digunakan sebagai pengganti. Variabel alur default/yang ditentukan sistem dikecualikan. Jika variabel yang sama didefinisikan dalam alur rilis dan dalam tahap, maka variabel tahapan akan menggantikan variabel alur rilis.

targetFiles - File target
string. Pilihan. Gunakan saat fileType = xml || fileType = json.

Menyediakan daftar file yang dipisahkan baris baru untuk menggantikan nilai variabel. Nama file harus diberikan relatif terhadap folder akar.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Ada versi yang lebih baru dari tugas ini yang tersedia di FileTransform@2.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	Semua versi agen yang didukung.
Kategori tugas	Utilitas

Share via