FileTransform@1 - Bestandstransformatie v1-taak

Artikel
07/02/2024

Gebruik deze taak om tokens te vervangen door variabele waarden in XML- of JSON-configuratiebestanden.

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.

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

Invoerwaarden

folderPath - Pakket of map
string. Vereist. Standaardwaarde: $(System.DefaultWorkingDirectory)/**/*.zip.

Het bestandspad naar het pakket of een map.

Variabelen zijn Build en Release. Jokertekens worden ondersteund.

Bijvoorbeeld $(System.DefaultWorkingDirectory)/**/*.zip.

enableXmlTransform - XML-transformatie
boolean. Standaardwaarde: false.

Configuratietransformaties worden uitgevoerd voordat de variabele wordt vervangen.

XML-transformaties worden alleen ondersteund voor het Windows-platform.

xmlTransformationRules - Transformatieregels
string. Optioneel. Gebruik wanneer enableXmlTransform == true. Standaardwaarde: -transform **\*.Release.config -xml **\*.config.

Biedt een nieuwe regel gescheiden lijst met regels voor transformatiebestanden met behulp van de syntaxis:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

xmlTransformationRules - Transformatieregels
string. Optioneel. Gebruik wanneer enableXmlTransform == true. Standaardwaarde: -transform **\*.Release.config -xml **\*.config\n-transform **\*.$(Release.EnvironmentName).config -xml **\*.config.

Biedt een nieuw door regels gescheiden lijst met regels voor transformatiebestanden met behulp van de syntaxis:

-transform <pathToTransformFile> -xml <pathToSourceConfigurationFile>.

fileType - Bestandsindeling
string. Toegestane waarden: xml, json.

Biedt de bestandsindeling waarop de vervanging wordt uitgevoerd.

Voor XML worden variabelen die zijn gedefinieerd in de build- of release-pijplijnen vergeleken met de key of-vermeldingen name in de appSettingssecties , applicationSettingsen connectionStrings van een configuratiebestand en parameters.xml. Variable Substitution wordt uitgevoerd na configuratietransformaties.

Als u JSON-variabelen wilt vervangen die genest of hiërarchisch zijn, geeft u deze op met behulp van JSONPath-expressies.

Als u bijvoorbeeld de waarde van ConnectionString in het onderstaande voorbeeld wilt vervangen, moet u een variabele definiëren zoals Data.DefaultConnection.ConnectionString in de build- of release-pijplijn (of de omgeving van de release-pijplijn).

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

Variabele vervangen wordt uitgevoerd na configuratietransformaties.

Opmerking: alleen aangepaste variabelen die zijn gedefinieerd in build-/release-pijplijnen worden gebruikt voor vervanging. Standaard/door het systeem gedefinieerde pijplijnvariabelen worden uitgesloten. Als dezelfde variabelen zijn gedefinieerd in de release-pijplijn en in de fase, vervangen de fasevariabelen de releasepijplijnvariabelen.

targetFiles - Doelbestanden
string. Optioneel. Gebruik wanneer fileType = xml || fileType = json.

Biedt een nieuwe, door regels gescheiden lijst met bestanden ter vervanging van de variabelewaarden. Bestandsnamen moeten worden opgegeven ten opzichte van de hoofdmap.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Er is een nieuwere versie van deze taak beschikbaar op FileTransform@2.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Hulpprogramma

Delen via