The Select Records dialog is used in several editors in the core cartridges to enable a content administrator to specify a set of records.
The Select Records dialog is a lightweight search and Guided Navigation application that enables a content administrator to browse to a particular location in the data set (which may include search terms, dimension refinements, or a combination of both). The content administrator can then do one of two things:
An instance of a
Select Records dialog is usually bound to a
<List>
property in a cartridge template, which
contains
<Item>
properties that represent either dimension
refinements or record IDs. The dialog communicates with the MDEX Engine to
retrieve search and navigation results.
Note
In order to enable the Select Records dialog, ensure that you have enabled communication between Experience Manager and the MDEX Engine. For instructions, see "Communicating with the MDEX Engine" in the Tools and Frameworks Installation Guide.
The following editors launch the Select Records dialog:
The Select Records dialog in Experience Manager communicates with the MDEX Engine through a configurable data service. By default, the service is configured to provide relevant record properties for the Discover Electronics reference application.
The service endecaBrowserService in configured in the file,
<app
dir>\config\import\configuration\tools\xmgr\_.json
, as shown
below:
{ "name" : "endecaBrowserService" "host": "myhost.mydomain.com", "port": "15002", "recDisplayNameProp" : "product.name", "recSpecProp": "common.id", "recAggregationKey": "product.code", "recFilter": "", "recImgUrlProp" : "product.img_url_thumbnail", "recDisplayProps": [ "product.name", "product.price", "product.short_desc" ], "textSearchKey": "All", "textSearchMatchMode" : "ALLPARTIAL" }
It specifies the following:
Key |
Value |
---|---|
name |
The name of the service, "endecaBrowserService". |
|
The hostname or IP address of your MDEX Engine server. By
default, this is populated with the same host as the authoring MDEX Engine when
you deploy the Discover Electronics reference application and run the
|
|
The port that the MDEX Engine server listens on. By default, this is populated with the same port as the authoring MDEX Engine. |
|
The dimension used as the record display name in the editor that launches the dialog. |
|
The dimension used as the record specifier. This must be a unique identifier. |
|
Optional. Enables aggregated records mode in the Select Records dialog using the specified property or dimension as the aggregation key when displaying and sorting records. All records with the same value in the selected dimension or property are treated as a single record. |
|
Optional. The property used to filter records for record boost and bury. |
|
Optional. The property used to retrieve the URL for the record thumbnail image. |
|
An array of record properties to display in the dialog. |
|
Optional. Specifies the search key to apply to text searches in the Select Records dialog. |
|
Optional. Specifies the match mode to apply to text searches in the Select Records dialog. |
You can modify these values as necessary for your own application.
Running
<app dir>\control\set_editors_config
pushes
changes to the Discover Electronics reference application.