FileTransform@1 - 파일 변환 v1 작업

이 작업을 사용하여 토큰을 XML 또는 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.

입력

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의 경우 빌드 또는 릴리스 파이프라인에 정의된 변수는 구성 파일 및 의 , applicationSettings및 섹션에 있는 appSettings또는 name 항목과 parameters.xmlconnectionStrings 일치 key 합니다. 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 사용할 수 있습니다.

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	에이전트, DeploymentGroup
요청	없음
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	모두
Settable 변수	모두
에이전트 버전	지원되는 모든 에이전트 버전입니다.
작업 범주	유틸리티