FileTransform@1 - Attività Trasformazione file v1

Articolo
03/24/2025

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

Questa versione dell'attività è deprecata; usare FileTransform@2.

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

Sintassi

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

Ingressi dati

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

Percorso del file del pacchetto o di 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.

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

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

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

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

Fornisce il formato di file in cui viene eseguita la sostituzione.

Per XML, le variabili definite nelle pipeline di compilazione o versione verranno confrontate con le voci key o name nelle sezioni appSettings, 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 versione).

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

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

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

targetFiles - file di destinazione
string. Opzionale. Usare quando fileType = xml || fileType = json.

Fornisce un elenco di file delimitato da nuova riga per sostituire i valori delle variabili. I nomi di file devono essere forniti in relazione alla cartella radice.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

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

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	Tutte le versioni dell'agente supportate.
Categoria attività	Utilità

Condividi tramite