FileTransform@1 – úloha Transformace souborů v1

Tato úloha slouží k nahrazení tokenů hodnotami proměnných v konfiguračních souborech XML nebo JSON.

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.

Vstupy

folderPath - Balíček nebo složka
string. Povinná hodnota. Výchozí hodnota: $(System.DefaultWorkingDirectory)/**/*.zip.

Cesta k souboru k balíčku nebo složce.

Proměnné jsou Build (Sestavení) a Release (Vydání). Zástupné cardy jsou podporované.

Například, $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - Transformace XML
boolean. Výchozí hodnota: false.

Transformace konfigurace budou spuštěny před nahrazením proměnné.

Transformace XML jsou podporovány pouze pro platformu Windows.

xmlTransformationRules - Pravidla transformace
string. Nepovinný parametr. Použijte, když enableXmlTransform == true. Výchozí hodnota: -transform **\*.Release.config -xml **\*.config.

Poskytuje nový seznam pravidel transformačních souborů oddělených řádky pomocí syntaxe:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Formát souboru
string. Povolené hodnoty: xml, json.

Poskytuje formát souboru, ve kterém je náhrada perfformována.

V případě XML se proměnné definované v kanálech sestavení nebo verze budou shodovat s key položkami nebo name v appSettingsoddílech , applicationSettingsa connectionStrings libovolného konfiguračního souboru a parameters.xml. Variable Substitution se spustí po transformacích konfigurace.

Pokud chcete nahradit vnořené nebo hierarchické proměnné JSON, zadejte je pomocí výrazů JSONPath.

Pokud například chcete nahradit hodnotu ConnectionString v níže uvedené ukázce, musíte definovat proměnnou jako Data.DefaultConnection.ConnectionString v kanálu buildu nebo verze (nebo v prostředí kanálu verze).

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

Nahrazení proměnné se spouští po transformacích konfigurace.

Poznámka: Jako náhrada se používají pouze vlastní proměnné, které jsou definované v kanálech sestavení nebo verze. Výchozí nebo systémem definované proměnné kanálu jsou vyloučené. Pokud jsou stejné proměnné definované v kanálu verze i ve fázi, proměnné fáze nahradí proměnné kanálu verze.

targetFiles - Cílové soubory
string. Nepovinný parametr. Použijte, když fileType = xml || fileType = json.

Obsahuje seznam souborů oddělených novým řádekem, který nahradí hodnoty proměnných. Názvy souborů se zadají vzhledem ke kořenové složce.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Novější verze této úlohy je k dispozici na FileTransform@2.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Nástroj