## page was renamed from DevCenter/Documentation/ExtensionObjects/Environment
= Environment =

Purpose:
  Enable XSL transforms to query the current system environment for the location and state of programs and variables.

Namespace:
  {{{urn:WebWorks-XSLT-Extension-Environment}}}

Prefix:
  {{{wwenv}}}

Methods:
  JDKHome():
    Determine the path to the default Java Developer Kit install directory.
    <<BR>>

    Returns:
      Platform path as string.

    Example:
      Determine the path to the current JDK and jar some files.

      {{{
<xsl:variable name="VarJDKHome" select="wwenv:JDKHome()" />
<xsl:variable name="VarJarPath" select="wwfilesystem:Combine($VarJDKHome, 'jar')" />
<xsl:variable name="VarJarCommand" select="wwexec:ExecuteCommand($VarJarPath, 'cvf', 'output.jar', '.')" />
}}}

  !RequestedPipeline(string pipelineName):
    Determine if a named pipeline was specifically requested as a generation target.
    <<BR>>

    Returns:
      Boolean.

    Example:
      Generate a given report only if specifically enabled in a project or a user has specifically requested that report.

      {{{
<xsl:variable name="VarGenerateReportSetting" select="wwprojext:GetFormatSetting('report-filenames-generate', 'true') = 'true'" />
<xsl:variable name="VarRequestedPipeline" select="wwenv:RequestedPipeline($GlobalPipelineName)" />
<xsl:variable name="VarGenerateReport" select="($VarGenerateReportSetting) or ($VarRequestedPipeline)" />
}}}