Property Description Record (PDR)

About PDRs

The Oracle Endeca Server uses a PDR to store metadata about the standard attribute, and must have a PDR created in order to build a schema for your data records. In addition, to create a managed attribute, both one PDR and one DDR are required.

As records, PDRs themselves have required attributes, and can also have arbitrary, user-defined attributes.

For each standard attribute, the attributes in the associated PDR define the attribute's characteristics, including:

Name and type
Display name
Language
Configuration parameters. For example, whether an attribute is searchable.
Navigability settings. For example, whether to show record counts for available refinements, whether to enable multi-select, and how to sort refinements.

Creating and updating PDRs

When an Endeca data domain acquires a new record, it stores it and constructs a PDR for any attributes that it finds in the record.

Updating a PDR immediately changes the navigation behavior of the Oracle Endeca Server. To create or change a PDR, you can use the Data Ingest Web Service, or Integrator.

Required schema attributes of a PDR

PDRs have the following required attributes:

Schema attribute	Type	Description
`mdex-property_Key`	`string`	The name of the standard attribute. The key name must be an NCName. The NCName format is defined in the W3C document Namespaces in XML 1.0 (Second Edition), located at this URL: http://www.w3.org/TR/REC-xml-names/#NT-NCName You can modify the name of the standard attribute. No restrictions on these changes exist.
`mdex-property_DisplayName`	`string`	The name of the standard attribute in an easy-to-understand format. The display name can use a non-NCName format. You can modify the display name of an attribute. No restrictions on these changes exist.
`mdex-property_Type`	`string`	The data type of the standard attribute. The possible values are `mdex:string`, `mdex:int`, `mdex:int64`, `mdex:double`, `mdex:boolean`, `mdex:dateTime`, `mdex:time`, `mdex:duration`, and `mdex:geocode`. The default is `mdex:string`. The data type cannot be modified.
`mdex-property_Language`	`string`	The language of the standard attribute (set as an RFC-3066 language code). The language ID is either the special string `unknown` (the default if not changed) or (if changed) the RFC-3066 language code set by the Configuration Web Service's `setPropertyDefaultLanguage` operation. This schema attribute can be modified, but changing its value has a performance cost.
`mdex-property_IsSingleAssign`	`boolean`	If set to `true`, each record can have at most one value for the standard attribute. If set to `false`, each record may have more than one value for the standard attribute. The default is `true`. Cannot be modified.
`mdex-property_IsUnique`	`boolean`	If set to `true`, no two records can have the same value for the attribute. If set to `false`, then multiple records can have the same value. The default is `false`. You can modify it only if no assignments exist on the records (that is, before loading records). Also, if you set it to `true`, `mdex-property_IsSingleAssign` must also be set to `true`.
`mdex-property_IsTextSearchable`	`boolean`	If set to `true`, then the standard attribute is enabled for text search. If set to `false`, the standard attribute does not support text search. The default is `false`. This schema attribute can be changed only for the standard attributes of type string. Making this change on an attribute that has many assignments on records has a performance cost due to re-indexing.
`mdex-property_TextSearchAllowsWildcards`	`boolean`	If set to `true`, then wildcard search is enabled for this standard attribute. If set to `false`, then wildcard search is not enabled. If this is set to `true`, then `mdex-property_IsTextSearchable` must be set to `true`. The default is `false`. Changing the value for this attribute has a performance cost. A restriction for modifying it is that `mdex-property_IsTextSearchable` must also be set to `true`.
`mdex-property_IsPropertyValueSearchable`	`boolean`	If set to `true`, the standard attribute is enabled for value search. If set to `false`, the attribute is not value-searchable. The default is `true`. This schema attribute can be changed only for the standard attributes of type string. Modifying the value for this schema attribute has a performance cost. This schema attribute does not apply for managed attributes, for which value search is always enabled and cannot be disabled.
`system-navigation_Select`	`string`	Used to configure the multi-select feature for a standard attribute. The values of this attribute supply defaults for query parameters, which you can override. The allowed values are: `single`. Users can select only one refinement from this attribute. `multi-and`. Users can select multiple refinements from the attribute. The returned records must have assignments from all of the selected refinements (from A AND B). Selecting this value only makes sense for those attributes that are multi-assign. `multi-or`. Users can select multiple refinements from this attribute. The returned records must have assignments from at least one of the selected refinements (from A OR B). The default is `single`. No restrictions on modifying the values for this schema attribute exist.
`system-navigation_Sorting`	`string`	The order in which to display refinements in the navigation menu. The allowed values are: `lexical` sorts refinements alphabetically or by number. `record-count` sorts refinements in descending order, by the number of records available for each refinement. The default is `record-count`. No restrictions on modifying the values for this schema attribute exist.
`system-navigation_ShowRecordCounts`	`boolean`	Whether to show record counts for a refinement. If set to `true`, the record counts are shown. If set to `false`, the record counts are not shown. The default is `true`. No restrictions on modifying the values for this schema attribute exist.
`system-property_GroupMembership`	`string`	The groups to which the attribute belongs. Values must match names existing attribute groups. No restrictions for modifying this schema attribute exist.

User-defined schema attributes of a PDR

You can add assignments on other, user-defined attributes to PDRs to display various aspects of how your data records are organized. Note that the names of these attributes must not begin with mdex, or system.