iShare Publisher allows you to perform on-line searches on any of your back office databases. The data from these databases is first loaded into the iShare database via Data Share and then displayed using the iShare Publisher Templates.

You will need to perform the following steps using iShare Studio.

Create a Data Share Connection for Publisher

You need to configure a Data Share Connection for each Data Source that you wish to be able to search on and also the search fields to use.


Configure the Search fields

Field Settings

Index Name

Enter a name that you wish to give this index field. This will be forced to lowercase alphanumeric.

Index Type

This can be one of the following:-

 

DATE

If you wish this field to be used as a From or To date in your Publisher template

EXACTMATCH

If you select this index type then you must configure a Regular Expression. This could be used for searches on websites where the user will enter www. Or something like a Planning Reference.

FILTERMATCH

This type must be used if you wish this field to be selected from a drop down selection in your Publisher template

FULLTEXT

This type must be selected if you wish this field to be searched using the Lucene search.

NONE

This type is for fields that you do not wish to be used for searching but you do want to be returned in the list of results.

 

Searching will be performed in the following sequence:

  1. Check for Regular Expression match
  2. Full text search

Highlight in results

If this is checked, any matches on this field will be highlighted in the results using HTML tags.

Sample Text

Enter some sample text to match the format required for this field.

Regular Expression

If the Index Type is EXACTMATCH, this textbox will be enabled and it will be mandatory to enter a regular expression here. If the term entered matches this regular expression then the relevant field will be searched for an exact match. If an exact match is not found then any FULLTEXT fields will be searched for the entered term. Below is an example of a Regular Expression.

If you have entered the Regular Expression the correctly matches your Sample Text a Match Result will be displayed; if not this will remain blank.

Index Location

This is the directory where the index files will be stored. This would normally be on the same server as the Data Share database.

Build index on Disk

Checking this option allows you to build the index on the disk rather than in memory. This fixes the problem where creating indexes over an extremely large number of records caused the memory usage to increase until an “OutOfMemory” exception is thrown.

Test Search

If you wish to test your search enter data in the Search Expression and click the Search button. Matching results will be displayed in the Results grid.

Build the Search Index

Now that you have configured your Search Fields you need to build your Search Index. Right click on the Internal Data Share connection and select Rebuild Search Index. This may take a little while depending upon the size of the database. This will populate the directory you have defined as your Index Location.