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.
# 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.
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>
.
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\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config
.
Az átalakítási fájlszabályok új sorba 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 |