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.

Syntax

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

Entradas

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

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.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

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

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	Todas las versiones de agente compatibles.
Categoría de la tarea:	Utilidad