FileTransform@1 — задача преобразования файлов версии 1

Статья
03/24/2025

Используйте эту задачу для замены маркеров значениями переменных в ФАЙЛАх конфигурации XML или JSON.

Эта версия задачи устарела; используйте FileTransform@2.

Используйте эту задачу для замены маркеров значениями переменных в ФАЙЛАх конфигурации XML или 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.

Входные данные

folderPath - пакет или папка
string. Обязательное. Значение по умолчанию: $(System.DefaultWorkingDirectory)/**/*.zip.

Путь к файлу к пакету или папке.

Переменные : сборка и выпуск. Поддерживаются подстановочные знаки.

Например, $(System.DefaultWorkingDirectory)/**/*.zip.

преобразование enableXmlTransform - XML
boolean. Значение по умолчанию: false.

Преобразования конфигурации будут выполняться до подстановки переменной.

Преобразования XML поддерживаются только для платформы Windows.

xmlTransformationRules - правила преобразования
string. Необязательно. Используется при enableXmlTransform == true. Значение по умолчанию: -transform **\*.Release.config -xml **\*.config.

Предоставляет новый разделенный строкой список правил файлов преобразования с помощью синтаксиса:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - формат файла
string. Допустимые значения: xml, json.

Предоставляет формат файла, для которого выполняется подстановка.

Для XML переменные, определенные в конвейерах сборки или выпуска, будут соответствовать key или name записям в appSettings, applicationSettingsи connectionStrings любого файла конфигурации и parameters.xml. Variable Substitution выполняется после преобразования конфигурации.

Чтобы заменить переменные JSON, вложенные или иерархические, укажите их с помощью выражений JSONPath.

Например, чтобы заменить значение ConnectionString в приведенном ниже примере, необходимо определить переменную как Data.DefaultConnection.ConnectionString в конвейере сборки или выпуска (или в среде конвейера выпуска).

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

Подстановка переменных выполняется после преобразований конфигурации.

Примечание. В подстановке используются только пользовательские переменные, определенные в конвейерах сборки и выпуска. Переменные конвейера по умолчанию или системе исключены. Если те же переменные определены в конвейере выпуска и на этапе, переменные этапа заменят переменные конвейера выпуска.

targetFiles - Целевые файлы
string. Необязательно. Используется при fileType = xml || fileType = json.

Предоставляет новый разделенный строкой список файлов для замены значений переменных. Имена файлов должны быть предоставлены относительно корневой папки.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Замечания

В FileTransform@2доступна более новая версия этой задачи.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	Все поддерживаемые версии агента.
Категория задач	Полезность

Поделиться через