Skip to content

Latest commit

 

History

History
397 lines (231 loc) · 10.5 KB

searchdescriptor.schema.md

File metadata and controls

397 lines (231 loc) · 10.5 KB

Search Descriptor Schema

https://ns.adobe.com/xdm/common/descriptors/searchdescriptor

Describes how XDM properties are to be handled for search, including the application of analyzers and operation in queries. The search:indexed descriptor is set to true to indicate that a property should be indexed, as specified by the values of the other search descriptor properties. When search:index is false (including by default), the other search descriptors will be ignored.

Descriptors

Descriptor Description Values Default
search:indexed Whether this property is to be indexed true, false false
search:store Whether values are stored in the index and, if so, are included in results by default notStored, stored, storedAndFetchByDefault notStored
search:filterable When this property can be used as a filter in queries true, false false
search:sort Whether and how sorting is applied to this property notSortable, sortedCaseSensitive, sortedCaseInsensitive notSortable
search:analyzers The set of analyzers applied to property values during indexing See Analyzers, below [ noAnalysis ]
search:defaultAnalyzer The analyzer output to be used when a query reference to this property is made without also specifying the analyzer See Analyzers, below noAnalysis

Analyzers

Category Description Values
null Used to pass through property values without analysis noAnalysis
Standard Lower-casing and standard grammar-based tokenization standard
Generic Language Extends the Standard analyzer with better analysis of Asian languages, Unicode normalization, and Unicode-aware case folding langGeneric
Language-Specific Extends the analyzer with language-specific knowledge langFr (French)
langTh (Thai)
langDe (German)
langJa (Japanese)
langZh (Chinese)
Prefix Applies filters and tokenizers to values starting with patterns startsWithDefaultAnalyzer
startsWithWhitespaceAnalyzer
Custom Applies semantics specific to specific value types filename
filenameExtension
Abstract Extensible Status Identifiable Custom Properties Additional Properties Defined In
Can be instantiated Yes Experimental No Forbidden Permitted common/descriptors/search/searchdescriptor.schema.json

Schema Hierarchy

  • Search Descriptor https://ns.adobe.com/xdm/common/descriptors/searchdescriptor

Search Descriptor Example

{
  "@id": "https://ns.adobe.com/xdm/common/descriptors/searchdescriptor",
  "@type": "xdm:searchdescriptor",
  "xdm:sourceSchema": "https://ns.adobe.com/xdm/context/profile",
  "xdm:sourceVersion": 1,
  "search:indexed": true,
  "search:filterable": true,
  "search:store": "storedAndFetchByDefault",
  "search:sort": "sortedCaseInsensitive",
  "search:analyzers": [
    "standard",
    "noAnalysis"
  ],
  "search:defaultAnalyzer": "standard"
}

Search Descriptor Properties

Property Type Required Default Defined by
@id string Optional Schema Descriptor
@type string Optional Schema Descriptor
search:analyzers string[] Optional "noAnalysis" Search Descriptor (this schema)
search:defaultAnalyzer string Optional "noAnalysis" Search Descriptor (this schema)
search:filterable boolean Optional false Search Descriptor (this schema)
search:indexed boolean Optional false Search Descriptor (this schema)
search:sort string Optional "notSortable" Search Descriptor (this schema)
search:store string Optional "notStored" Search Descriptor (this schema)
xdm:sourceItem complex Optional Schema Descriptor
xdm:sourceProperty string Optional Schema Descriptor
xdm:sourceSchema string Optional Schema Descriptor
xdm:sourceVersion number Optional Schema Descriptor
* any Additional this schema allows additional properties

@id

Identifier

The unique identifier for the schema descriptor. This property is required when the descriptor is defined outside of the applicable schema, but is optional when applied via 'meta:descriptors'.

@id

@id Type

string

  • format: uri-reference – URI Reference (according to RFC3986)

@type

Type

The type of descriptor this object represents.

@type

@type Type

string

@type Known Values

Value Description

search:analyzers

Analyzers

A set of analyzers to be applied when indexing this property.

search:analyzers

  • is optional

  • type: string[]

  • default: "noAnalysis"

  • defined in this schema

search:analyzers Type

Array type: string[]

All items must be of the type: string

search:analyzers Known Values

Value Description
noAnalysis noAnalysis
standard standard
langGeneric langGeneric
langFr langFr
langTh langTh
langDe langDe
langJa langJa
langZh langZh
startsWithDefaultAnalyzer startsWithDefaultAnalyzer
startsWithWhiteSpaceAnalyzer startsWithWhiteSpaceAnalyzer
fileName fileName
fileNameExtension fileNameExtension

search:defaultAnalyzer

Default analyzer

Default analyzer to be applied when search queries are made against this property.

search:defaultAnalyzer

  • is optional
  • type: string
  • default: "noAnalysis"
  • defined in this schema

search:defaultAnalyzer Type

string

search:defaultAnalyzer Known Values

Value Description
noAnalysis noAnalysis
standard standard
langGeneric langGeneric
langFr langFr
langTh langTh
langDe langDe
langJa langJa
langZh langZh
startsWithDefaultAnalyzer startsWithDefaultAnalyzer
startsWithWhiteSpaceAnalyzer startsWithWhiteSpaceAnalyzer
fileName fileName
fileNameExtension fileNameExtension

search:filterable

Filterable

Whether the property can be used as a filter in search queries.

search:filterable

  • is optional
  • type: boolean
  • default: false
  • defined in this schema

search:filterable Type

boolean

search:indexed

Indexed

Whether the property is indexable and searchable.

search:indexed

  • is optional
  • type: boolean
  • default: false
  • defined in this schema

search:indexed Type

boolean

search:sort

Sort Type

Whether and how search results can be sorted on this property.

search:sort

  • is optional
  • type: string
  • default: "notSortable"
  • defined in this schema

search:sort Type

string

search:sort Known Values

Value Description
notSortable notSortable
sorted sorted
sortedCaseSensitive sortedCaseSensitive
sortedCaseInsensitive sortedCaseInsensitive

search:store

Stored

Whether the property value is stored in, and therefore can be retrieved from, the index.

search:store

  • is optional
  • type: string
  • default: "notStored"
  • defined in this schema

search:store Type

string

search:store Known Values

Value Description
notStored notStored
stored stored
storedAndFetchByDefault storedAndFetchByDefault

xdm:sourceItem

Source Item

When present, the selector used to match a specific item in the array pointed to by sourceProperty.

xdm:sourceItem

xdm:sourceItem Type

One of the following conditions need to be fulfilled.

Condition 1

Condition 2

Condition 3

Condition 4

xdm:sourceProperty

Source Property

When present, the property of the source schema to which this descriptor applies. This value is a JSON Pointer, applied to an instance of an object described by xdm:sourceSchema.

xdm:sourceProperty

xdm:sourceProperty Type

string

xdm:sourceSchema

Source Schema

The source schema this descriptor applies to. This property is required when the descriptor is defined outside of the applicable schema, but is optional when applied via 'meta:descriptors'

xdm:sourceSchema

xdm:sourceSchema Type

string

  • format: uri – Uniformous Resource Identifier (according to RFC3986)

xdm:sourceVersion

Source Version

Major version being referenced.

xdm:sourceVersion

xdm:sourceVersion Type

number