Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

commercecontext:getsinglerecommendation

Returns one recommended asset based on the recommendation criteria passed to the tag.

Syntax

<commercecontext:getsinglerecommendation
      collection="recommendationname"  -or-  collectionid="recommendationid"
      [list="inputlist"]
      [value="rating"] 
      varname="assetid" 
      typevarname="assettype"
      [filter="true|false"]
      [engine="enginename"]
      [engineparameters="engineparameters"]/> 

Parameters

collection (required if collectionid not specified)

Input parameter. Name of the recommendation. The sort and selection criteria defined in the recommendation are used to determine which asset to return. If there are any promotions in place that override this recommendation, it substitutes the name of the promotion, instead.

collectionid (required if collection not specified)

Input parameter. ID of the recommendation. The sort and selection criteria defined in the recommendation are used to determine which asset to return. If there are any promotions in place that override this recommendation, it substitutes the ID of the promotion, instead.

list (optional)

Input parameter. Name of the list of assets you want to be used as input for the calculation. This argument is only applicable if the recommendation named by collection is an context-based recommendation. Columns are assettype and assetid.

value (optional)

Input parameter. Default rating for assets that do not have one. If you do not declare a value, unrated assets are assigned a default rating of 50 on a scale of 1-100.

varname (required)

Input and output parameter. Name you want to assign to the variable that holds the ID of the asset that is returned on output.

typevarname (required)

Input and output parameter. Name you want to assign to the variable that holds the type of asset that is returned on output.

filter (optional)

Input parameter. A boolean value: true specifies that no assets in the input list can be returned as output; false (default) allows input assets to be returned as output.

engine (optional)

Input parameter. This argument is used to optimize the recommendations using an external engine. This must be used in conjunction with engineparameters parameter.

engineparameters (optional)

Input parameter. This is a generic list of arguments required as parameters for the engine. This argument is used to optimize the recommendations using an external engine. This must be used in conjunction with the engine parameter.

Description

This tag is a convenience version of the commercecontext:getrecommendations tag. It returns zero or one recommended asset. The actual recommendation is based on the details of the referenced recommendation asset. This tag automatically calculates segment affinity and promotion affinity for the current visitor, if they have not yet been calculated. For information about creating recommendations, including context-based recommendations, see the Sites Developer's Guide.

NOTE: This tag also causes compositional dependencies to be recorded for all assets that contribute to the returned lists, and may, under the right conditions, have the same effect as a render:unknowndeps tag.

		Home >	Contents >	Index >
	Oracle JSP Tag Reference Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.