Testing Thesauri in xPlore

To follow up on my last post about using custom thesauri with xPlore , I thought I would share a little bit about how to debug thesauri in xPlore, and watch term expansion in progress.

  1. Login to the xPlore Admin Console.
  2. Expand the node:  Home >> Services >> Logging
  3. Click the ‘Configuration’ button in the upper right-hand corner of the Logging screen.
  4. Change the configuration setting for ‘dsearch-search’ to ‘DEBUG’, and click ‘OK’
  5. Ensure a thesarus is loaded in xPlore by expanding node: Home >> Diagnostics and Utilities >> Thesaurus.  You should see at least one thesaurus listed in the ‘Thesaurus List’ pane.  If not, please see the xPlore v1.3 Administration and Development Guide, pages 213-217.
  6. In Webtop, perform a full text search using one of the terms in your thesaurus.  To keep with the theme of my previous post, I searched for ‘tylenol’.
  7. Returning to the xPlore Admin Console, Expand the node:  Home >> Instances >> primaryDsearch >> Logging, and click the ‘desearch’ tab.
  8. Peruse the log file for the following key log entries to see the thesaurus at work:
    1. c.e.d.c.f.common.search.impl.SKOSThesaurusHandler – executing the thesaurus lookup query to get related terms for [tylenol]
    2. c.e.d.c.f.i.services.thesaurus.QueryThesaurus – getTermsFromThesaurus returned related terms [acetaminophen, ibuprofin, Motrin]
    3. 2013-10-05 20:38:09,739 DEBUG [pool-13-thread-10] c.e.d.c.f.indexserver.cps.CPSTokenStreamInBinary – Returned token: tylenol
    4. 2013-10-05 20:38:09,752 DEBUG [pool-13-thread-10] c.e.d.c.f.indexserver.cps.CPSTokenStreamInBinary – Returned token: acetaminophen
    5. 2013-10-05 20:38:09,752 DEBUG [pool-13-thread-10] c.e.d.c.f.indexserver.cps.CPSTokenStreamInBinary – Returned token: ibuprofin
    6. 2013-10-05 20:38:09,753 DEBUG [pool-13-thread-10] c.e.d.c.f.indexserver.cps.CPSTokenStreamInBinary – Returned token: motrin
    7. c.e.d.c.f.i.s.s.impl.AbstractSummaryProcessor – Generated Lucene query for summary: text:tylenol text:acetaminophen text:ibuprofin text:motrin
    8. 2013-10-05 20:38:09,780 DEBUG [pool-13-thread-10] c.e.d.c.f.i.services.summary.impl.SummaryProcessor – formattedText = This is a file about Ibuprofin. Ibuprofin is an analgesic.
    9. 2013-10-05 20:38:09,790 DEBUG [pool-13-thread-10] c.e.d.c.f.i.services.summary.impl.SummaryProcessor – formattedText = This file contains Tylenol.
    10. 2013-10-05 20:38:09,799 DEBUG [pool-13-thread-10] c.e.d.c.f.i.services.summary.impl.SummaryProcessor – formattedText = This file contains acetaminophen

What all that means:

  1. This is xPlore executing the thesaurus look up for ‘tylenol’ to see if it has any entries (<prefLabel>) in the thesaurus
  2. This is the returned list of <altLabels> the thesaurus found for the ‘tylenol’ entry
  3. The thesaurus returning a search token for ‘tylenol’
  4. The thesaurus returning a search token for ‘acetaminophen’
  5. The thesaurus returning a search token for ‘ibuprofin’
  6. The thesaurus returning a search token for ‘motrin’
  7. xPlore is generating the search query using the thesaurus terms
  8. This is a snippet from one of the found documents which contains one of the search terms
  9. This is a snippet from one of the found documents which contains one of the search terms
  10. This is a snippet from one of the found documents which contains one of the search terms

UPDATE:  This post resulted in a derivative post here: http://www.armedia.com/blog/2014/03/expanding-documentums-full-text-search-capability-with-a-thesaurus/.

Advertisements

About Scott
I have been implementing Documentum solutions since 1997. In 2005, I published a book about developing Documentum solutions for the Documentum Desktop Client (ISBN 0595339689). In 2010, I began this blog as a record of interesting and (hopefully) helpful bits of information related to Documentum, and as a creative outlet.

One Response to Testing Thesauri in xPlore

  1. Pingback: Expanding Documentum’s Full Text Search Capability with a Thesaurus | Armedia Blog

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: