FileTransform@1 - Dosya dönüştürme v1 görevi
Belirteçleri XML veya JSON yapılandırma dosyalarındaki değişken değerlerle değiştirmek için bu görevi kullanın.
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.
Girişler
folderPath
- Paket veya klasör
string
. Gereklidir. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.zip
.
Paketin veya klasörün dosya yolu.
Değişkenler Derleme ve Yayın'dır. Joker karakterler desteklenir.
Örneğin, $(System.DefaultWorkingDirectory)/**/*.zip
.
enableXmlTransform
- XML dönüştürme
boolean
. Varsayılan değer: false
.
Yapılandırma dönüşümleri Değişken Değişiminden önce çalıştırılır.
XML dönüştürmeleri yalnızca Windows platformu için desteklenir.
xmlTransformationRules
- Dönüştürme kuralları
string
. İsteğe bağlı. when enableXmlTransform == true
kullanın. Varsayılan değer: -transform **\*.Release.config -xml **\*.config
.
Söz dizimini kullanarak dönüştürme dosyası kurallarının satırla ayrılmış yeni bir listesini sağlar:
-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>
.
xmlTransformationRules
- Dönüştürme kuralları
string
. İsteğe bağlı. when enableXmlTransform == true
kullanın. Varsayılan değer: -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config
.
Söz dizimini kullanarak dönüştürme dosyası kurallarının satırla ayrılmış yeni bir listesini sağlar:
-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>
.
fileType
- Dosya biçimi
string
. İzin verilen değerler: xml
, json
.
Değiştirmenin perfformed olduğu dosya biçimini sağlar.
XML için, derleme veya yayın işlem hatlarında tanımlanan değişkenler, herhangi bir yapılandırma dosyasının key
ve parameters.xml
içindeki , applicationSettings
ve connectionStrings
bölümlerindeki appSettings
veya name
girdileriyle eşleştirilir. Variable Substitution
yapılandırma dönüştürmelerinden sonra çalıştırılır.
İç içe veya hiyerarşik JSON değişkenlerini kullanmak için JSONPath ifadelerini kullanarak bunları belirtin.
Örneğin, aşağıdaki örnekte değerini değiştirmek ConnectionString
için derleme veya yayın işlem hattında (veya yayın işlem hattının ortamında) olduğu gibi Data.DefaultConnection.ConnectionString
bir değişken tanımlamanız gerekir.
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
Değişken Değiştirme, yapılandırma dönüşümlerinden sonra çalıştırılır.
Not: Değiştirmede yalnızca derleme/yayın işlem hatlarında tanımlanan özel değişkenler kullanılır. Varsayılan/sistem tanımlı işlem hattı değişkenleri dışlanır. Yayın işlem hattında ve aşamasında aynı değişkenler tanımlanmışsa, aşama değişkenleri yayın işlem hattı değişkenlerinin yerini alır.
targetFiles
- Hedef dosyalar
string
. İsteğe bağlı. when fileType = xml || fileType = json
kullanın.
Değişken değerlerinin yerine geçecek dosyaların yeni satırla ayrılmış bir listesini sağlar. Dosya adları kök klasöre göre sağlanmalıdır.
Görev denetim seçenekleri
Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.
Çıkış değişkenleri
Yok.
Gereksinimler
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme, Klasik sürüm |
Üzerinde çalışır | Agent, DeploymentGroup |
Talep | Hiçbiri |
Özellikler | Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi biri |
Ayarlanabilir değişkenler | Herhangi biri |
Aracı sürümü | Desteklenen tüm aracı sürümleri. |
Görev kategorisi | Yardımcı Program |