FileTransform@1: tarea Transformación de archivos v1

Use esta tarea para reemplazar tokens por valores de variable en archivos de configuración 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 - Paquete o carpeta
string. Obligatorio. Valor predeterminado: $(System.DefaultWorkingDirectory)/**/*.zip.

Ruta de acceso del archivo al paquete o a una carpeta.

Las variables son Build y Release. Se admite caracteres comodín.

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

enableXmlTransform - Transformación XML
boolean. Valor predeterminado: false.

Las transformaciones de configuración se ejecutarán antes de la sustitución de variables.

Las transformaciones XML solo se admiten para la plataforma Windows.

xmlTransformationRules - Reglas de transformación
string. Opcional. Use cuando enableXmlTransform == true. Valor predeterminado: -transform **\*.Release.config -xml **\*.config.

Proporciona una nueva lista separada por líneas de reglas de archivo de transformación mediante la sintaxis :

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

xmlTransformationRules - Reglas de transformación
string. Opcional. Use cuando enableXmlTransform == true. Valor predeterminado: -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config.

Proporciona una lista separada por líneas nuevas de reglas de archivo de transformación mediante la sintaxis :

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

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

Proporciona el formato de archivo en el que se performa la sustitución.

Para XML, las variables definidas en las canalizaciones de compilación o versión coincidirán con las key entradas o name de las appSettingssecciones , applicationSettingsy connectionStrings de cualquier archivo de configuración y parameters.xml. Variable Substitution se ejecuta después de las transformaciones de configuración.

Para sustituir variables JSON anidadas o jerárquicas, especifíquelas mediante expresiones JSONPath.

Por ejemplo, para reemplazar el valor de ConnectionString en el ejemplo siguiente, debe definir una variable como Data.DefaultConnection.ConnectionString en la canalización de compilación o versión (o el entorno de la canalización de versión).

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

La sustitución de variables se ejecuta después de las transformaciones de configuración.

Nota: Solo se usan variables personalizadas definidas en canalizaciones de compilación o versión en sustitución. Se excluyen las variables de canalización definidas por el sistema o predeterminadas. Si las mismas variables se definen en la canalización de versión y en la fase, las variables de fase reemplazarán las variables de canalización de versión.

targetFiles - Archivos de destino
string. Opcional. Use cuando fileType = xml || fileType = json.

Proporciona una lista de archivos separados por líneas nuevas para sustituir los valores de variable. Los nombres de archivo se deben proporcionar en relación con la carpeta raíz.

Ninguno.

Comentarios

Hay una versión más reciente de esta tarea disponible en FileTransform@2.