FileTransform@1 - Tarefa de transformação de ficheiros v1

Utilize esta tarefa para substituir tokens por valores variáveis em ficheiros de configuração XML ou 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 - Pacote ou pasta
string. Obrigatório. Valor predefinido: $(System.DefaultWorkingDirectory)/**/*.zip.

O caminho do ficheiro para o pacote ou uma pasta.

As variáveis são Compilação e Versão. São suportados carateres universais.

Por exemplo, $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - Transformação XML
boolean. Valor predefinido: false.

As transformações de configuração serão executadas antes da Substituição de Variáveis.

As transformações XML são suportadas apenas para a plataforma Windows.

xmlTransformationRules - Regras de transformação
string. Opcional. Utilize quando enableXmlTransform == true. Valor predefinido: -transform **\*.Release.config -xml **\*.config.

Fornece uma nova lista separada por linhas de regras de ficheiros de transformação com a sintaxe:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

xmlTransformationRules - Regras de transformação
string. Opcional. Utilize quando enableXmlTransform == true. Valor predefinido: -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config.

Fornece uma lista separada por novas linhas de regras de ficheiros de transformação com a sintaxe:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Formato de ficheiro
string. Valores permitidos: xml, json.

Fornece o formato de ficheiro no qual a substituição é perfformada.

Para XML, as variáveis definidas nos pipelines de compilação ou versão serão correspondidas key às entradas ou name nas appSettingssecções , applicationSettingse connectionStrings de qualquer ficheiro de configuração e parameters.xml. Variable Substitution é executado após transformações de configuração.

Para substituir as variáveis JSON aninhadas ou hierárquicas, especifique-as com expressões JSONPath.

Por exemplo, para substituir o valor de ConnectionString no exemplo abaixo, tem de definir uma variável como Data.DefaultConnection.ConnectionString no pipeline de compilação ou versão (ou no ambiente do pipeline de versão).

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

A Substituição de Variáveis é executada após a transformação da configuração.

Nota: apenas as variáveis personalizadas definidas nos pipelines de compilação/versão são utilizadas em substituição. As variáveis de pipeline predefinidas/definidas pelo sistema estão excluídas. Se as mesmas variáveis forem definidas no pipeline de versão e na fase, as variáveis de fase substituirão as variáveis do pipeline de versão.

targetFiles - Ficheiros de destino
string. Opcional. Utilize quando fileType = xml || fileType = json.

Fornece uma lista de ficheiros separada por novas linhas para substituir os valores das variáveis. Os nomes de ficheiro devem ser fornecidos relativamente à pasta raiz.

Nenhum.

Observações

Existe uma versão mais recente desta tarefa disponível em FileTransform@2.