FileTransform@1 — zadanie przekształcania pliku w wersji 1

To zadanie służy do zastępowania tokenów wartościami zmiennych w plikach konfiguracji XML lub JSON.

Składnia

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

Dane wejściowe

folderPath - Pakiet lub folder
string. Wymagane. Wartość domyślna: $(System.DefaultWorkingDirectory)/**/*.zip.

Ścieżka pliku do pakietu lub folderu.

Zmienne to kompilacja i wydanie. Obsługiwane są symbole wieloznaczne.

Na przykład $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - Przekształcanie XML
boolean. Wartość domyślna: false.

Przekształcenia konfiguracji zostaną uruchomione przed zastąpieniem zmiennej.

Przekształcenia XML są obsługiwane tylko dla platformy Windows.

xmlTransformationRules - Reguły przekształcania
string. Opcjonalny. Użyj polecenia , gdy enableXmlTransform == true. Wartość domyślna: -transform **\*.Release.config -xml **\*.config.

Udostępnia nową linię rozdzielaną listą reguł plików przekształcania przy użyciu składni:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Format pliku
string. Dozwolone wartości: xml, json.

Zawiera format pliku, w którym podstawianie jest perfformed.

W przypadku kodu XML zmienne zdefiniowane w potokach kompilacji lub wydania będą dopasowywane do key wpisów lub name w appSettingssekcjach , applicationSettingsi connectionStrings dowolnego pliku konfiguracji i parameters.xml. Variable Substitution polecenie jest uruchamiane po przekształceniu konfiguracji.

Aby zastąpić zmienne JSON, które są zagnieżdżone lub hierarchiczne, określ je przy użyciu wyrażeń JSONPath.

Aby na przykład zastąpić wartość ConnectionString w poniższym przykładzie, należy zdefiniować zmienną tak jak Data.DefaultConnection.ConnectionString w potoku kompilacji lub wydania (lub w środowisku potoku wydania).

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

Podstawianie zmiennych jest uruchamiane po przekształceniach konfiguracji.

Uwaga: w podstawieniu są używane tylko zmienne niestandardowe zdefiniowane w potokach kompilacji/wydania. Domyślne/zdefiniowane przez system zmienne potoku są wykluczone. Jeśli te same zmienne są zdefiniowane w potoku wydania i na etapie, zmienne etapu zastąpią zmienne potoku wydania.

targetFiles - Pliki docelowe
string. Opcjonalny. Użyj polecenia , gdy fileType = xml || fileType = json.

Udostępnia listę plików rozdzielanych nowym wierszem, aby zastąpić wartości zmiennych. Nazwy plików należy podać względem folderu głównego.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

W FileTransform@2 jest dostępna nowsza wersja tego zadania.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	Wszystkie obsługiwane wersje agenta.
Kategoria zadania	Narzędzie