Create Metafields

The UserMetaFields parameter has the following syntax:

UserMetaFields=OPERATION{UserFieldName}:DocumentFieldName

where:

OPERATION is the operation that you want to perform on the contents of the specified fields in your documents.
UserFieldName is the name of the user metafield that you want to create.
DocumentFieldName is the name of the fields in your documents that you want to run the specified operation on. To specify multiple fields, separate the field names with colons (:) (there must be no space before or after a colon).
NOTE:

UserMetaFields operations are more efficient when you use them on fields that are configured as NumericType, except for the COUNTA operation, which is more efficient on fields that are configured as CountType, MatchType, or ParametricType.

To specify multiple operations, separate the operations with a plus sign (+) or a space.

You can optionally use a constant in the UserMetaFields definition, in the following form:

UserMetaFields=OPERATION{UserFieldName, Constant}:DocumentFieldName

The constants can be positive or negative, and they can include decimals (for example 1.23) and scientific notation (for example 1E2). The meaning of the constants depends on the operation that you use.

NOTE:

The IDOL Content component uses the constant only if the DocumentFieldName contains values. For example, for the operation MIN{MINSCORE,10}:SCORE, Content does not create a MINSCORE user metafield if the SCORE field is missing for a document.

The following table describes the operations that you can perform on document fields.

Operation Description Constant
ADD The sum of all the values in the specified fields. The initial value to add the field values to.
SUB The value of the first field name (or the sum of the values in all instances of the first field name), minus the values of the remaining fields. An additional value to subtract.
MUL The product of all the values in the specified fields. The initial value to multiply the field values by.
DIV The value of the first field name (or the product of the nonzero values in all instances of the first field name), divided by the nonzero values from the remaining fields. An additional value to divide by. If the constant value is 0, the constant is ignored.
MIN The smallest value in the specified fields. An initial value to include in the minimum calculation.
MAX The highest value in the specified fields. An initial value to include in the maximum calculation.
MEAN The mean of the values in the specified fields. No effect.
COUNT The number of numeric values in the specified fields (it does not count any non-numeric values). No effect.
COUNTA  The number of non-empty occurrences of the specified field, regardless of their value. No effect.
ABS The absolute value of the value in the specified field (that is, removing any negative sign). No effect.
ROUND The nearest integer to the value in the specified field, or the nearest multiple of the specified constant. The accuracy to round to. For example, 0.01 rounds to two decimal places.
FLOOR The nearest integer that is lower than the value in the specified field, or the nearest multiple of the specified constant lower than the value. The accuracy to round down to. For example, 0.01 rounds to two decimal places.
LOG The log (to the base of the specified constant) of the value of the first instance in a document of the specified field. The constant is required for this function. The base of the log.
POW The value of the first instance in a document of the specified field, raised to the power of the specified constant. The constant is required for this function. The power to use.
NOTE:

The ABS, ROUND, FLOORLOG, and POW operations act on a single value for each document. HPE recommends that you use these operations on fields that have only a single value, or on the output of other user metafield operations. If you apply these operations to a field with multiple values, it returns the result of the operation on the first field value, which might depend on your configuration.

You can also use the following distance operations. In this case, you must specify two constants and two field names that contain the location information.

Operation Description Constant
DISTSPHERICAL The distance in kilometers between the location specified by the constants, and the location specified by the document fields, in latitude and longitude. You must specify two fields for this operator, in the form :LAT_FIELD:LONG_FIELD. The latitude and longitude of the location you want to calculate distances from. Specify these values as lat,long.
DISTCARTESIAN The distance between the point specified by the constants, and the point specified by the document fields (in Cartesian coordinates). You must specify two fields for this operator, in the form :X_FIELD:Y_FIELD. The X and Y coordinate of the point that you want to calculate distances from. Specify these values as X,Y.
NOTE:

The DISTSPHERICAL and DISTCARTESIAN operations act on a single pair of values for each document (one value for each coordinate field). HPE recommends that you use these operations on fields that have only a single value, or the output of other user metafield operations. If you apply these operations to a field with multiple values, it returns the result of the operation on the first field value, which might depend on your configuration.

If both of your coordinate fields are configured as NumericType, HPE recommends that you set XMLFullStructure to True in your configuration. With this additional configuration, distance-based metafields produce results consistent with distance-based sorting.

You can apply UserMetaFields operations to other user metafields created in the same query. For example, you might use an operation to create one field, and then use that field in a second operation. You must create a metafield before you reference it in another operation (that is, the operation to create the field must appear to the left of the operation that uses it in the UserMetaFields parameter).

When you use your metafield in another operation, the field name has the format autn_user_UserFieldName, where UserFieldName is the value that you specified in the UserMetaField parameter.

For example, the following query creates the TaxAmount user metafield from the document fields, and then uses this new metafield to calculate the total price.

UserMetaFields=MUL{taxAmount}:basePrice:taxRate,ADD{totalPrice}:basePrice:autn_user_taxAmount

_HP_HTML5_bannerTitle.htm