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.

Esta versión de la tarea está en desuso; use FileTransform@2.

Sintaxis

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

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

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

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

reglas de transformación de xmlTransformationRules -
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>.

formato de archivo de fileType -
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 se coincidirán con las entradas de key o name de la appSettings, applicationSettingsy connectionStrings secciones 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 nueva lista de archivos separados por líneas 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 sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

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
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	Todas las versiones de agente admitidas.
Categoría de tarea	Utilidad