XML Interface Macros

XML Interface Macros

Macros can be used in a number of locations within the XML file, and allow reference to external or internal data.

Usage: $(MACRO_NAME)

The following macros are supported:

  1. SourceFile Macros
    These macros reference the source file path and name. They can be used in the Params attribute only (Tool or Task elements).
    1. SourceFileName  Source file name with extension
    2. SourceName Source file name without extension
    3. SourcePath Source file full path and file name
    4. SourceDir Source file directory
    5. SourceExt Source file extension
  2. OutputFiles Macros
    These macros reference the output file path and name. They can be used in the Params attribute only (Tool or Task elements). Note that when multiple output files are defined, this macro refers to the first-defined file in the list.
    1. OutputFileName Output file name with extension
    2. OutputName  Output file name without extension
    3. OutputPath Output file full path and file name
    4. OutputDir Output file directory
    5. OutputExt Output file extension
  3. Params Macros
    There is one macro related to the Params attribute: inherited:params.
    This macro can be used in the Params attribute of the Task element only. It references the default parameters defined in the Tool element.
  4. Environment Variable Macros
    Macros can be used to access environment variables. Any defined variable can be accessed by using its name; e.g, $(path) is translated into the 'path' environment variable.