/
Search Configuration

Search Configuration

Information valid from AMI version 8.0sp5

Summary

The Search Configuration workspace allows you to set which Languages, Attributes and Structures are indexed for advanced searching.

You can also see the progress of indexing jobs in the system.




Features common to all tabs

These features are common to each tab of the Search Configuration workspace.

Tri-state checkboxes

The checkboxes on column headings allow you to select or deselect options for all the listed items, or select and deselect items individually:

  • —select all items
  • —deselect all items
  • —use individual item selections

Changes do not take effect until Apply is selected because they can lead to lengthy processes.

Statuses

Each tab shows the current status of indexing tasks:

  • Invalid Status
  • Indexing error
  • Processing error

Changes that will be applied

As you make changes to the configuration they will be listed. They will not take effect until you select Apply. Once applied, changes will take effect at the next scheduled run of Search Data Sync's High Priority Admin Worker unless you have specified a different priority.

Only the changes listed on the current tab will be applied. Other tabs will be unaffected.

If you leave the Search Configuration workspace then any changes that have not been applied will be discarded.

Languages

Select Index for Search for the language versions you wish to be included in an Elasticsearch index document.

Attributes

These options mirror the Indexing options displayed for attribute definitions.

Select Text, Numeric or Date to list the attributes of that type. However, any Content Gateway attributes will not be listed: their values are dynamic and therefore cannot be indexed.

You can enter a value in the Filter box to filter the list by name.

The search configuration options for attributes are:

  • Index for search—whether values for this attribute are indexed at all.
  • Freetext search—whether values are indexed for freetext searches.
  • Faceting—whether values are indexed for faceted searches, where the values of attribute instances are listed as filters.
    This option is suitable for attributes which will contain a limited set of values: for example Single and Multiple choice list attributes.
  • Same for all Languages—whether values will be indexed separately for different language versions.
    Typically this will match the attribute's Language Independent setting, but you may wish to have this disabled if a Language Independent attribute may contain referenced values that do differ by language: for example, language dependent Glossary Terms or embedded references.
  • Show in Suggested Filters—(previously Auto Suggest) whether the attribute is added to the list of suggested attributes filters.
    Typically you will disable this for commonly used, general attributes such as "Description" or "SKU Code" and enable it for specialised ones such as "Inside Leg" or "Neodymium Grade MGoe".

Structures

You must configure the Languages and Attribute Definitions before configuring the Structures to index, as these will determine exactly which content within the Structure(s) need to be indexed.

We strongly recommend that you enable indexing on Structures in several tranches - with the most important Structure(s) indexed first - as it may take some time to index all Structures.

You must select a Structure Type before any structures are displayed.

The search options for structures are:

  • Index—whether the structure should be indexed at all.
  • Complete—whether the structure should still be indexed after it has been marked as "complete".
  • Bin—whether instances within the structure's BIN should be included in its index.
  • Docs—whether instances within the structure's Document structure should be included in its index.
  • Delta—whether the structure should be monitored for changes and those changes applied to its index incrementally.
    If this is not enabled then changes within the structure will not appear in its index until the whole structure is reindexed.
  • Reindex—a priority for a complete reindexing of the structure. The current index for the structure will be deleted and a new one created.
    When this reindexing takes place is determined by the scheduling of your system's High, Medium or Low Admin Worker Search Data Sync processes.

Monitoring

Delta Indexing

This tab displays the time between a user making a change in AMI and the change being reflected in Elasticsearch. Two sets of information are displayed stacked in the same column to show the total indexing delay:

  • Processing delay—the time taken for Agility to process events into indexing tasks for Elasticsearch.
  • Indexing delay—the time taken for Elasticsearch to update its indexes.

The graph's axes are:

  • Time—the time in seconds since the report on indexing delay. These increments will change if you change the Auto Refresh period.
    Historical information is not tracked: the indexing delay is only tracked while the tab is active.
  • Delay—the indexing delay in seconds.

Incomplete Admin Jobs

This tab shows the High, Medium and Low priority jobs that have not completed. For a list of which indexing tasks fall into each priority, see Installing Search Data Sync.

  • Changes After/Changes Before—set optional datetimes to filter jobs.
  • Users—filter by the username of the user that triggered the indexing job.
  • Status—filter the status of jobs by any or all of the incomplete statuses of Pending, Processing or Errored.

Related pages