Some of the ISYS search setup can be changed via the Developer Configurations.
To change any Developer Configurations, you must be logged in as an install or site administrator.
From iAPPS 5.0, developers and administrators can invoke the ISYS search indexer from the Admin UI.
The version of ISYS used by iAPPS has changed to ISYS 9.7. This will solve some existing issues such as limits on transactional indexing.
However, while upgrading ISYS 9.6 to ISYS v9.7 all the index files have to be re-indexed once. For SaaS customers in the initial upgrade Bridgeline R&D has a tool to pull indexes from the scheduled server (where ISYS is scheduled to run every night), which will run off-line to re-index the site and upload the updated index back to the scheduled server. To re-index a site, this will make a copy of ISYS.CFG and ISYSPDR.CFG file. If the site has some custom search additions, such as metadata injections or synonym files, local offices and partners need to send R&D the path and file names that have to exist prior to the indexing. For example : ISYSSCRIPT.XML. Otherwise you will need to re-index the site yourself.
Perpetual customers will need to complete this re-indexing process themselves as part of the upgrade process.
Indexing can now be invoked from the Admin, but will need adjustments the first time if you have customized the search files.
(i.e. IsysScript.xml)
used for the indexing on your site or other custom search additions, such as metadata injections or synonym files, will need to placed with the other search files before indexing, or the indexing may fail or not deliver the expected results.In addition, if you are calling ISYS directly from template code or an .exe and have called the ISYSEngineClass,
it has been renamed to simply ISYSEngine
. You will need to update your code accordingly.
See Content Manager > Administration > Site Functions. > Developer Configurations > Search Indexer.
Any current search indexes will be listed.
You can invoke a new indexing process for either the front-end website or the Admin UI,
Depending on the size and complexity of the website, it can take several hours to reindex the front-end site.
If you need to index a site using Unicode rather than ANSI in order to index a multi language or variant site with special characters, you need to index with Unicode support enabled.
To do that the top of the isys.cfg file should look like this:
Version 9
Language Unicode
NonUnicodeCodePage 1252
Ensure that the unicode number is correct for whichever language you want to index in.
Once you make the change, you need to run a reindex.
Some of the most common ISYS search features (such as metadata weighting, conflation and synonyms) can be enabled from the Admin UI.
From iAPPS 4.8 forward, you can turn these options on or off via the CMS Admin UI. See Content Manager > Administration > Site Functions > Developer Configurations > Search Site Settings. For earlier versions, see the Search Scenario in the iAPPS 4.7 Developer Scenario Guide. The affected Search capabilities are:
Allows you to control how hits in metadata are relevance ranked compared to hits occurring in the body of documents. When set to none, then hits in metadata are considered only slightly more relevant than comparable hits in non-metadata, and it is very likely that highly relevant hits in non-metadata will rank ahead of hits in metadata. This control determines the amount of "relevance boost" is applied to metadata hits. When set to maximum (10) relevance ranking operates in a special mode where even the least relevant hit in metadata is considered more relevant than the most relevant hit in the non-metadata, regardless of other merits.
The word may have been expanded using tense conflation. For example, "run" can be expanded into runner, runs, running, etc.
Synonyms are words or phrases with a similar meaning. ISYS allows you to collate words into a ring of similar meanings, and return results for all meanings by searching for a single word. For example, you can configure synonym rings so that when you search for 'coffee', you also get results that contain 'espresso', 'cappuccino' and 'mocha'. All the words in a ring will be retrieved in a synonym search. This is a useful way to expand a search into multiple meanings, without having to list of all the possible words in your search.
Synonyms must be set up, while the Thesaurus is built in.
The Thesaurus is a built-in ISYS feature of common synonyms. When the Thesaurus is activated, ISYS will look for definitions of the given term, and then include all the words that have similar meanings to the definitions.