Add or edit a body mapping
Add or edit a body mapping
The item body is the search-optimized HTML representation of the actual item content. For standard sources, the document processing manager (DPM) generates a representative body once the item reaches the processing stage of the indexing pipeline. This default body is displayed in the Quickview.
However, item bodies aren’t automatically generated when there’s no standard item content layout, or when the content is an assembly of values from all or some key records (each record is typically mapped to a specific field).
If this is the case, you can create an item body manually by adding a
body mapping rule since it will override the item’s default
When an item doesn’t have an item body, the assembled Quickview may not contain the relevant data or may not present it in an appropriate format. Typically, this occurs when indexing content using a Database or Push source. Furthermore, without an item body, the item won’t have a summary, concept, nor language detection.
Without language detection, the item won’t populate the stem expansion, which will then affect the query performance. For example, when searching for the MainIndexLanguages, additional languages are added at query time which means that there are more terms to search. Therefore if items don’t have a set language, it means that Coveo will start searching in more and more languages and the overall query performance will be slower.
The mapping process is similar for the item body (that is, actual content), which is mapped to the
body Coveo index field whenever possible.
When you index a PDF file, the file body contains all the text visible when you print the PDF.
The indexing pipeline handles the
body field in a slightly different way from other fields, since
body is the only field that modifies search results in the free text of an indexed item.
This allows you to customize search results and to update the corresponding Quick View.
However, this works with fairly simple
body mappings only.
To implement a more advanced customization, you must instead leverage indexing pipeline extensions.
An excerpt is generated from segments of the body of an indexed document and it generally includes highlighted occurrences of the queried terms. During the indexing process, the cleaned text of each item’s content is recorded. In a query, relevant segments that include the keywords are extracted from the recorded text to build the excerpt.
The purpose of the excerpt is to provide key pieces of the document to help you identify if the document contains the information you’re searching.
The compressed cleaned text recorded for each item is limited in size to optimize the index size and query performances, therefore excerpts for large documents, such as PDF files with several hundred pages, only show the content from the beginning of the document.
Add or edit an item
When you have the required privileges, you can add custom
body mappings and edit Coveo default
You can define the desired body with static HTML and metadata placeholders to be replaced with item metadata values.
The resulting customized item body is then displayed in the Quick View.
Adding a body mapping rule to an item overrides the default
To add or edit a
body mapping, follow the regular mapping addition procedure.
See Manage source mappings for details.
In the Edit the Mappings of a Source panel, take the following into account:
Under Field, select
Under Apply to, select All items (common) or Specific item types depending on whether you want to apply your item
bodymapping to a certain source item type or to all source content, regardless of the item type.
If you selected Specific item types under Apply to, select the item types on which you want to apply the
You have a Web source for your company website. Without body mapping, the Quick View for each page displays the text on the page. Your Contact Us page Quick View is therefore the following:
Contact Us Your comments and questions are always welcome! Phone: 1-800-555-2222 Email: email@example.com
However, you don’t want the page text to be displayed in the Quick View.
You therefore chose to replace the text with a simple string stating the page title.
Your body mapping rule is therefore:
Page Title: %[title].
As a result, when you open the Quick View for item
Contact Us, the following would be displayed:
Page Title: Contact Us
Ensure that your
body mapping works as expected in the Content Browser.
See Quick view tab for details.