FileTransform@1 – Fájlátalakítás v1 feladat

Ezzel a feladattal lecserélheti a tokeneket változó értékekre XML- vagy JSON-konfigurációs fájlokban.

Syntax

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

Bevitelek

folderPath - Csomag vagy mappa
string. Kötelező. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.zip.

A csomag vagy mappa elérési útja.

A változók a buildelés és a kiadás. A helyettesítő karakterek támogatottak.

Például: $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - XML-átalakítás
boolean. Alapértelmezett érték: false.

A konfigurációs átalakítások a változó helyettesítése előtt lesznek futtatva.

Az XML-átalakítások csak Windows-platformon támogatottak.

xmlTransformationRules - Átalakítási szabályok
string. Választható. Használja a következőt: enableXmlTransform == true. Alapértelmezett érték: -transform **\*.Release.config -xml **\*.config.

Az átalakítási fájlszabályok új sorra tagolt listáját tartalmazza a szintaxis használatával:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Fájlformátum
string. Engedélyezett értékek: xml, json.

Azt a fájlformátumot adja meg, amelyen a helyettesítés átformálva van.

XML esetén a buildelési vagy kiadási folyamatokban definiált változók a konfigurációs fájl parameters.xmlés a appSettings, applicationSettingsés connectionStrings szakaszában lévő vagy name bejegyzésekkel lesznek egyezőekkey. Variable Substitution a konfigurációátalakítások után fut.

A beágyazott vagy hierarchikus JSON-változók helyettesítéséhez adja meg őket JSONPath-kifejezések használatával.

Ha például az értékét ConnectionString szeretné lecserélni az alábbi mintában, meg kell határoznia egy változót Data.DefaultConnection.ConnectionString a buildelési vagy kiadási folyamatban (vagy a kiadási folyamat környezetében).

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

A változó-helyettesítés a konfigurációátalakítások után lesz futtatva.

Megjegyzés: Csak a buildelési/kiadási folyamatokban definiált egyéni változók használhatók helyettesítésre. Az alapértelmezett/rendszer által definiált folyamatváltozók ki vannak zárva. Ha ugyanazok a változók vannak definiálva a kiadási folyamatban és a fázisban, akkor a fázisváltozók felülírják a kiadási folyamat változóit.

targetFiles - Célfájlok
string. Választható. Használja a következőt: fileType = xml || fileType = json.

A változóértékeket helyettesítő fájlok új sorba tagolt listáját tartalmazza. A fájlneveket a gyökérmappához viszonyítva kell megadni.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

A feladat egy újabb verziója érhető el a FileTransform@2.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	Minden támogatott ügynökverzió.
Feladatkategória	Segédprogram