FileTransform@1 - Attività trasformazione file v1

Usare questa attività per sostituire i token con valori di variabile nei file di configurazione XML o JSON.

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

folderPath - Pacchetto o cartella
string. Obbligatorio. Valore predefinito: $(System.DefaultWorkingDirectory)/**/*.zip.

Percorso del file per il pacchetto o una cartella.

Le variabili sono Build e Release. Sono supportati caratteri jolly.

Ad esempio: $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - Trasformazione XML
boolean. Valore predefinito: false.

Le trasformazioni di configurazione verranno eseguite prima della sostituzione delle variabili.

Le trasformazioni XML sono supportate solo per la piattaforma Windows.

xmlTransformationRules - Regole di trasformazione
string. facoltativo. Usare quando enableXmlTransform == true. Valore predefinito: -transform **\*.Release.config -xml **\*.config.

Fornisce un nuovo elenco delimitato da righe di regole di file di trasformazione usando la sintassi:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

xmlTransformationRules - Regole di trasformazione
string. facoltativo. Usare quando enableXmlTransform == true. Valore predefinito: -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config.

Fornisce un elenco di regole di file di trasformazione separate da nuove linee usando la sintassi:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Formato file
string. Valori consentiti: xml, json.

Fornisce il formato di file in cui la sostituzione è perfformata.

Per XML, le variabili definite nelle pipeline di compilazione o di rilascio verranno corrispondenti alle keyname voci o nelle appSettingssezioni di , applicationSettingse connectionStrings di qualsiasi file di configurazione e parameters.xml. Variable Substitution viene eseguito dopo le trasformazioni di configurazione.

Per sostituire le variabili JSON annidate o gerarchiche, specificarle usando espressioni JSONPath.

Ad esempio, per sostituire il valore di ConnectionString nell'esempio seguente, è necessario definire una variabile come Data.DefaultConnection.ConnectionString nella pipeline di compilazione o versione (o nell'ambiente della pipeline di rilascio).

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

La sostituzione delle variabili viene eseguita dopo le trasformazioni di configurazione.

Nota: vengono usate solo le variabili personalizzate definite nelle pipeline di compilazione/rilascio. Le variabili della pipeline definite dal sistema/predefinite sono escluse. Se le stesse variabili sono definite nella pipeline di versione e nella fase, le variabili di fase sostituiscono le variabili della pipeline di rilascio.

targetFiles - File di destinazione
string. facoltativo. Usare quando fileType = xml || fileType = json.

Fornisce un elenco di file separati da nuove linee per sostituire i valori delle variabili. I nomi di file devono essere forniti in relazione alla cartella radice.

Nessuno.

Osservazioni

È disponibile una versione più recente di questa attività in FileTransform@2.