Product Selector

Fusion 5.9
    Fusion 5.9

    Ingroup Boost List Rule API ConfigurationsFusion Query Rewrite APIs

    This rule type is used in the Query Rewrite API.

    For a complete list of rule and rewrite types in the Query Rewrite API, see Query Rewrite API Configurations.

    For more information, view the API specification.

    Ingroup Boost List

    The Ingroup Boost List action boosts an item within a product group. This action does not boost the product group.

    General information

    • Endpoint: https://FUSION_HOST:FUSION_PORT/api/apps/APP_NAME/query-rewrite/schema/RULE_TYPE

    • Required parameters are:

      • name

      • field_name

      • field_values

      • groupField_s

      • type

    • The values for the hints parameter include:

      • hidden: Do not display in the Fusion UI, but can be read and written in the schema.

      • readonly: Cannot be set by the user. If attempted, an error is generated and the operation fails.

    Parameter Schema

    type

    type

    string

    properties

    id

        "id": {
          "type": "string",
          "title": "ID",
          "description": "The ID for this Rule. Used in the API to reference this query rewrite rule. Allowed characters: a-z, A-Z, 0-9, dash (-) and underscore (_)",
          "maxLength": 128,
          "pattern": "^[A-Za-z0-9_\\-]+$"
        }

    source

        "source": {
          "type": "string",
          "title": "Source",
          "description": "The source for this query rewrite rule, such as a Spark Job.",
          "hints": [
            "hidden"
          ]
        }

    sourceType

        "sourceType": {
          "type": "string",
          "title": "Source Type",
          "description": "Source type",
          "hints": [
            "hidden"
          ]
        }

    createdOn

        "createdOn": {
          "type": "string",
          "title": "Created Date/Time",
          "description": "Date/Time this rule was created.",
          "format": "date-time"
        }

    updatedOn

        "updatedOn": {
          "type": "string",
          "title": "Updated Date/Time",
          "description": "Date/Time this rule was last updated.",
          "format": "date-time"
        }

    reviewer

        "reviewer": {
          "type": "string",
          "title": "Reviewer",
          "description": "Who reviewed this rewrite rule.",
          "hints": [
            "hidden"
          ]
        }

    reviewedOn

        "reviewedOn": {
          "type": "string",
          "title": "Reviewed Date/Time",
          "description": "Date/Time this rule was last reviewed.",
          "hints": [
            "hidden"
          ],
          "format": "date-time"
        }

    review

        "review": {
          "type": "string",
          "title": "Review",
          "enum": [
            "approved",
            "denied"
          ],
          "default": "approved",
          "hints": [
            "readonly"
          ]
        }

    deployed

        "deployed": {
          "type": "boolean",
          "title": "Deployed Flag",
          "description": "Flag to indicate if this rewrite rule has been deployed.",
          "hints": [
            "hidden"
          ]
        }

    tags

        "tags": {
          "type": "array",
          "title": "Tags",
          "description": "Conditional tags to restrict the triggering of this query rewrite rule.",
          "items": {
            "type": "string"
          }
        }

    name

    Required

        "name": {
          "type": "string",
          "title": "Name",
          "description": "User-friendly name for this rule."
        },

    description

        "description": {
          "type": "string",
          "title": "Description",
          "description": "Short description of what this rule does."
        }

    enabled

        "enabled": {
          "type": "boolean",
          "title": "Enabled",
          "description": "Set to false to disable this rule.",
          "default": true
        }

    matching

        "matching": {
          "type": "string",
          "title": "Match Query Using",
          "description": "Defines how the specified search terms will be compared to the user's query to determine whether this rule applies. 'keywords' means the query must match the keywords of the search terms value exactly. 'phrase' means the search query must contain one of the search terms values as a subphrase. 'text' means that at least one of the search terms values must match the query, but unlike 'phrase', the query only needs to match part of the value.",
          "enum": [
            "keywords",
            "text",
            "phrase"
          ],
          "default": "keywords"
        }

    groups

        "groups": {
          "type": "string",
          "title": "Rule Group",
          "description": "Group for this rule."
        }

    effective_range

        "effective_range": {
          "type": "array",
          "title": "Effective Range",
          "description": "Time range when this rule is in effect.",
          "items": {
            "type": "string"
          }
        }

    priority

        "priority": {
          "type": "integer",
          "title": "Precedence",
          "description": "Used when multiple rules could take effect for a given query - higher number means higher precedence. For example, a rule with precedence of 10 will take effect before a rule with precedence of 3. Ties on precedence are broken based on creation time - the more recently created rule will take effect before the older rule."
        }

    search_terms

        "search_terms": {
          "type": "array",
          "title": "Search Terms",
          "description": "Search terms that trigger this rule.",
          "items": {
            "type": "string"
          }
        }

    filters

        "filters": {
          "type": "array",
          "title": "Filters",
          "description": "Filters used to determine if this rule triggers",
          "items": {
            "type": "object",
            "required": [
              "key",
              "value"
            ],
            "properties": {
              "key": {
                "type": "string",
                "title": "Field Name"
              },
              "value": {
                "type": "string",
                "title": "Field Value"
              }
            }
          }
        }

    response_values

    "response_values": {
          "type": "array",
          "title": "Set Response Values",
          "description": "Key/Value pairs to set in the fusion section of the response.",
          "items": {
            "type": "object",
            "required": [
              "key",
              "value"
            ],
            "properties": {
              "key": {
                "type": "string",
                "title": "Field Name"
              },
              "value": {
                "type": "string",
                "title": "Field Value"
              }
            }
          }
        }

    query_profile_id_ss

        "query_profile_id_ss": {
          "type": "array",
          "title": "Query Profile ID",
          "description": "Query Profile that triggers this rule",
          "items": {
            "type": "string"
          }
        }

    field_name

    Required

        "field_name": {
          "type": "string",
          "title": "Field Name",
          "description": "Set the field name used by this rule to match the specified values.",
          "default": "id"
        }

    field_values

    Required

        "field_values": {
          "type": "array",
          "title": "Field Values",
          "description": "List of values for the specified field.",
          "minItems": 1,
          "items": {
            "type": "string"
          }
        }

    groupField_s

    Required

        "groupField_s": {
          "type": "string",
          "title": "Grouping Field",
          "description": "A single field name that must be grouped on for this rule to be applied. If the request does not have a 'group.field' parameter matching this property, the rule is not applied."
        }

    type

    Required

        "type": {
          "type": "string",
          "title": "Type",
          "enum": [
            "ingroup_boost_list"
          ],
          "default": "ingroup_boost_list",
          "hints": [
            "readonly"
          ]
        }

    doc_type

        "doc_type": {
          "type": "string",
          "title": "Doc Type",
          "enum": [
            "rule"
          ],
          "default": "rule",
          "hints": [
            "readonly"
          ]
        }

    display_type

        "display_type": {
          "type": "string",
          "title": "Display Type",
          "enum": [
            "Ingroup Boost List"
          ],
          "default": "Ingroup Boost List",
          "hints": [
            "readonly"
          ]
        }
      }

    additionalProperties

    additionalProperties

    "additionalProperties": true