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 == truekullanı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 == truekullanı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.xmliçindeki , applicationSettingsve connectionStrings bölümlerindeki appSettingsveya 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 = jsonkullanı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.

Açıklamalar

FileTransform@2'da bu görevin daha yeni bir sürümü vardır.

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