FileTransform@1 - Attività trasformazione file v1

Articolo
06/11/2024

Usare questa attività per sostituire i token con valori di variabile 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.

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

Input

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.

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
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Utilità

Condividi tramite