MarkLogic Server 11.0 Product Documentation
cts:field-reference

cts:field-reference(
   $field as xs:string,
   [$options as xs:string*]
) as cts:reference

Summary

Creates a reference to a field value lexicon, for use as a parameter to cts:value-tuples. Since lexicons are implemented with range indexes, this function will throw an exception if the specified range index does not exist.

Parameters

field A field name.

Parameters
field	A field name.
options	Options. The default is (). Options include: "type=type" Use the lexicon with the type specified by type (int, unsignedInt, long, unsignedLong, float, double, decimal, dateTime, time, date, gYearMonth, gYear, gMonth, gDay, yearMonthDuration, dayTimeDuration, string, anyURI, point, or long-lat-point) "collation=URI" Use the lexicon with the collation specified by URI. "nullable" Allow null values in tuples reported from cts:value-tuples when using this lexicon. "unchecked" Read the scalar type, collation and coordinate-system info only from the input. Do not check the definition against the context database. "coordinate-system=name" Create a reference to an index or lexicon based on the specified coordinate system. Allowed values: "wgs84", "wgs84/double", "raw", "raw/double". Only applicable if the index/lexicon value type is `point` or `long-lat-point`. "precision=value" Create a reference to an index or lexicon configured with the specified geospatial precision. Allowed values: `float` and `double`. Only applicable if the index/lexicon value type is `point` or `long-lat-point`. This value takes precedence over the precision implicit in the coordinate system name.

options

Options. The default is ().

Options include:

"type=type"

Use the lexicon with the type specified by type (int, unsignedInt, long, unsignedLong, float, double, decimal, dateTime, time, date, gYearMonth, gYear, gMonth, gDay, yearMonthDuration, dayTimeDuration, string, anyURI, point, or long-lat-point)

"collation=URI"

Use the lexicon with the collation specified by URI.

"nullable"

Allow null values in tuples reported from cts:value-tuples when using this lexicon.

"unchecked"

Read the scalar type, collation and coordinate-system info only from the input. Do not check the definition against the context database.

"coordinate-system=name"

Create a reference to an index or lexicon based on the specified coordinate system. Allowed values: "wgs84", "wgs84/double", "raw", "raw/double". Only applicable if the index/lexicon value type is point or long-lat-point.

"precision=value"

Create a reference to an index or lexicon configured with the specified geospatial precision. Allowed values: float and double. Only applicable if the index/lexicon value type is point or long-lat-point. This value takes precedence over the precision implicit in the coordinate system name.

Example

cts:field-reference("authors",("collation=http://marklogic.com/collation/en"))
=>
cts:field-reference("authors",
  ("type=string","collation=http://marklogic.com/collation/en"))

MarkLogic Server 11.0 Product Documentationcts:field-reference

Summary

Example

MarkLogic Server 11.0 Product Documentation
cts:field-reference