Administration: Customizing the Separator and Grouping Characters Used in Effectivity Expressions

An Administrator can customize the separators and grouping characters used in variant/option effectivity expressions throughout the user interface.

Required role: Administrator


Before you begin: Locate the files that need to be customized in the following location: home/data/RTV/<server>/apache-tomcat/webapps/3DSpace/WEB-INF/classes/resources/xsl. The files that you must customize are:
  • CFFEffectivityDisplay.xsl
  • CfgEffectivityDisplay.xsl
  • CfgEffectivityDisplay_Branching.xsl
  • CfgEffectivityDisplay_Description.xsl
  1. Open one of the files to be customized.
  2. To customize the separator used between combinations in a variant/option effectivity expression, do the following:
    1. Locate the following section:

        <!-- template OR -->
        <xsl:template match="cfg:OR">
          <xsl:param name="contextName"/>
          <xsl:for-each select="*">
            <xsl:if test="position() != 1">
              <xsl:text> OR </xsl:text>
            </xsl:if>
            <xsl:apply-templates select=".">
              <xsl:with-param name="contextName" select="$contextName"></xsl:with-param>
            </xsl:apply-templates>
          </xsl:for-each>
        </xsl:template>

    2. Edit the contents of the <xsl:text> OR </xsl:text> tag to indicate which character or word you want to use as the combinations separator in variant/option effectivity expressions. For example: <xsl:text> + </xsl:text>
  3. To customize the characters used group and separate variant values or options from the same variant or option group, do the following:

    1. Locate the following section:
          <xsl:for-each select="cfg:Leaf">
            <xsl:if test="position() = 1">
              <xsl:text> { </xsl:text>
            </xsl:if>
            <xsl:apply-templates select=".">
              <xsl:with-param name="type" select="$type"></xsl:with-param>
            </xsl:apply-templates>
            <xsl:if test="position() != last()">
              <xsl:text> , </xsl:text>
            </xsl:if>
            <xsl:if test="position() = last()">
              <xsl:text> } </xsl:text>
            </xsl:if>
          </xsl:for-each>
    2. Edit the contents of the relevant tags to indicate which characters you want to use to group and separate the elements in variant/option effectivity expressions, as follows:
      • Edit the contents of the <xsl:text> { </xsl:text> tag to indicate which character you want to use to begin the grouping of variant values or options from the same variant or option group. For example: <xsl:text> ( </xsl:text>
      • Edit the contents of the <xsl:text> , </xsl:text> tag to indicate which character you want to use to separate variant values or options from the same variant or option group. For example: <xsl:text> / </xsl:text>
      • Edit the contents of the <xsl:text> } </xsl:text> tag to indicate which character you want to use to end the grouping of variant values or options from the same variant or option group. For example: <xsl:text> ) </xsl:text>

  4. To customize the separator used between variant values or options from different variants or option groups in a variant/option effectivity expression, do the following:
    1. Locate the following section:

        <!-- template AND -->
        <xsl:template match="cfg:AND">
          <xsl:param name="contextName"/>
          <xsl:for-each select="*">
            <xsl:if test="position() != 1">
              <xsl:text> AND </xsl:text>
            </xsl:if>
            <xsl:apply-templates select=".">
              <xsl:with-param name="contextName" select="$contextName"></xsl:with-param>
            </xsl:apply-templates>
          </xsl:for-each>
        </xsl:template>

    2. Edit the contents of the <xsl:text> AND </xsl:text> tag to indicate which character or word you want to use as the combinations separator in variant/option effectivity expressions. For example: <xsl:text> + </xsl:text>
  5. To customize the separator used to reject variant values or options in variant/option effectivity expressions, do the following:
    1. Locate the following section:

        <!-- template NOT -->
        <xsl:template match="cfg:NOT">
          <xsl:for-each select="*">
            <xsl:text> NOT </xsl:text>
            <xsl:text>(</xsl:text>
            <xsl:apply-templates select="."/>
            <xsl:text>)</xsl:text>
          </xsl:for-each>
        </xsl:template>

    2. Edit the contents of the <xsl:text> NOT </xsl:text> tag to indicate which character or word you want to use as the rejection separator in variant/option effectivity expressions. For example: <xsl:text> - </xsl:text>
  6. Save your changes to the file.
  7. Repeat steps 1 through 6 for each file.
  8. Restart the server to enable your customizations.
    The separators and grouping characters used in variant/option effectivity expressions throughout the user interface now reflect your customizations.