FAS 22.1 Upgrade Notes

Introduction

FAS 22.1 is compatible with the previous release.

Changes in facet configuration XML (facet-configuration-1.0.xsd)

A new 'slider' property has been added to the regularfacet type in the facet-configuration-1.0.xsd schema. When it has the value 'true', the facet is rendered as a slider:

<attribute name="slider" type="boolean" default="false">
    <annotation>
        <documentation>
            Flag indicating whether this facet is a slider.
        </documentation>
    </annotation>
</attribute>

Example config of slider facet:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns3:facet-configuration xmlns="http://www.fredhopper.com/schema/knowledge-model/trigger/1.0"
        xmlns:ns2="http://www.fredhopper.com/schema/fas/business-common/1.0"
        xmlns:ns3="http://www.fredhopper.com/schema/fas/facet/1.0"
        xmlns:ns4="http://www.fredhopper.com/schema/knowledge-model/trigger/operation/1.0"
        xmlns:ns5="http://www.fredhopper.com/schema/knowledge-model/trigger/type/1.0"
        xmlns:ns6="http://www.fredhopper.com/schema/knowledge-model/trigger/basetype/1.0"
        name="Price Slider" parentScopeId="catalog01/en_GB">
    <ns3:content xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:facetComposition">
        <ns3:foundation xsi:type="ns3:regularFacet" slider="true" attribute-type="price"/>
    </ns3:content>
</ns3:facet-configuration>

Changes in FAS Query Response

A new value 'slider' has been added to the display-hint property.

New types have been added: globalrange and currentselection, which have 'min' and 'max' fields, representing min and max values for the global range and current selection. When a facet is configured as a slider, then the corresponding `filter` tag will have these types instead of 'intersections':

<xsd:element name="globalrange">
    <xsd:complexType>
        <xsd:attribute name="min" type="xsd:float" />
        <xsd:attribute name="max" type="xsd:float" />
    </xsd:complexType>
</xsd:element>

<xsd:element name="currentselection">
    <xsd:complexType>
        <xsd:attribute name="min" type="xsd:float"/>
        <xsd:attribute name="max" type="xsd:float"/>
    </xsd:complexType>
</xsd:element

Example response of a slider facet:

<filter on="price" facetid="facet-id" basetype="float" show_number_values="0" selected="true" display-hint="slider">
    <title>Price</title>
    <globalrange min="1.0" max="24999.0"/>
    <currentselection min="20.0" max="350.0"/>
</filter>

Migration

Migrating from FAS 21.4 to 22.1 requires no specific migration steps.

However, after downgrading to an older version, all slider facets will start working as regular non-lateral facets.