You are on page 1of 21

SharePoint Search String Highlighter

Installation & User Guide

Copyright 2005-2009 KWizCom Corporation. All rights reserved.

Company Headquarters KWizCom 148 Castle Rock Dr. Richmond Hill, Ontario L4C 5K5, Canada E-mail: info@KWizCom.com Web site: http://www.KWizCom.com Sales E-mail: sales@KWizCom.com Telephone: +1-905-370-0333

2 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Table of Contents
Introduction ............................................................................................... 4
Overview _____________________________________________________________ 5 Key Features & Benefits _______________________________________________ 6 Installation ___________________________________________________________ 7 Software prerequisites ________________________________________________ 7 Installation Procedure ________________________________________________ 7 Post Installation ______________________________________________________ 8

Component Localization ....................................................................... 10 Component Activation .......................................................................... 10 User's Guide.............................................................................................. 13 SharePoint Search String Highlighter Configuration Utility ... 15 FAQ............................................................................................................... 17
How do I use the SharePoint Search String Highlighter? ____________ 17 Does it work on SPS, WSS, both? ____________________________________ 17 Does it work on the new MOSS 2007? _______________________________ 17 I searched for a word, and it is not highlighted _____________________ 17 How do I get the words to be highlighted in the documents I go to from the search? ____________________________________________________ 18 I changed some settings using the configuration utility, but it doesnt have any effect _____________________________________________________ 18 I did something wrong and the Highlighter stopped working ________ 18 Do I have to install anything on my company's client-PCs? __________ 18 What happens with non-Office 2003 documents? ___________________ 19 Which MS Office versions are supported? ___________________________ 19 What about PDF documents? ________________________________________ 19

Version Release Notes .......................................................................... 20


Version History _____________________________________________________ 20

Technical Support ................................................................................... 21

3 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Introduction
KWizCom SharePoint Search String Highlighter is an add-on to Microsoft SharePoint that adds word highlighting to the default search page of the SharePoint portal (SPS 2003/MOSS 2007) and SharePoint team sites (WSS 2003/2007). When the user searches for a word, the string marker highlights the word in the search results if it is found in the result documents description. The String Highlighter also marks the words that were searched for inside documents of various formats: .doc, .rtf, .txt, .html, .pdf.

This document provides all the information needed to install, evaluate and deploy this KWizCom product:

Product overview Installation guide Component localization Component activation User guide FAQ Version release notes

4 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Overview
SharePoint searches for it You will Find it!
You searched for some phrase, you got several documents returned in SharePoint's search results page you click one of the documents and WHERE is that phrase you were looking for in the document?? KWizCom SharePoint Search String Highlighter is an add-on to Microsoft SharePoint that adds word highlighting to the search results page of the SharePoint (MOSS/WSS) and more important it highlights the searched phrase inside the found documents!
(PDF, .doc, .docx. .txt. .html and more)

5 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Key Features & Benefits


Feature KWizCom Search String Highlighter MOSS 2007/ WSS 3.0

Supports both WSS 3.0 and MOSS 2007 Provides for free-text searches a more clear result page with highlighting of the searched phrase Supports highlighting the searched words in various document formats (PDF, .doc, .docx, .rtf, .txt, .htm and more). Configuration utility allows the system administrator to change the behavior of key functions like how the highlight looks, minimum string length to highlight and more. Cross-browser support IE, Firefox and Google Chrome Multi-lingual (standard for all KWizCom components)

6 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Installation
Software prerequisites
Server Requirements
1. Microsoft Windows SharePoint Services 3.0 or 2. Microsoft Office SharePoint Server 2007 (MOSS 2007)

Client PC Requirements
1. Microsoft Windows XP (SP2)/ Windows Vista 2. Microsoft Internet Explorer/Microsoft Internet Explorer 7 or Mozilla Firefox 2+ or Google Chrome 3. Microsoft Office 2003/2007

Installation Procedure
1. Log in to your SharePoint server as a local admin. 2. Unzip the KWizCom SharePoint Search String Highlighter .zip file on your SPS Windows 2003 Server. 3. Double-click the .msi file in order to begin the web installation. 4. When the installation process is complete, you need to restart the IIS Server: Open the Command Prompt on your server. Type iisreset

7 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Post Installation
1. After completion of the installation, you will see a new KWizCom entry in Windows Start -> All Programs -> KWizCom containing 4 programs: About SharePoint Search String Highlighter Display general information about the component.

Activate SharePoint Search String Highlighter This utility enables you (the SharePoint Administrator) to activate the downloaded evaluation version.

SharePoint Search String Highlighter Configuration Utility this utility enables you (the SharePoint Administrator) configure the highlighter module preferences (please review details in the "User guide" section). SharePoint Search String Highlighter User Guide Link to this user guide document.

Please review the next sections for further details about component localization and activation. 2. Before users can use the new offline feature added to your existing SharePoint sites, they will have to configure the following Internet Explorer settings:

Empty Internet Explorer's cache. This is done by selecting "Tools->Internet Options" on the Internet Explorer menu bar.
8

Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Set the SharePoint server as a Trusted Site. This is done be selecting "Tools->Internet Options->Security", and adding the SharePoint server's URL to the Trusted sites list.

On the "Internet Options" dialog click the "Delete Files" button, and then click "OK".

9 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Component Localization
SharePoint Search String Highlighter is multi-lingual and requires no localization actions. It works on SharePoint Portal Server regardless of the portal's language.

Component Activation
KWizCom components are available for evaluation prior to purchase. This way you can try our components and verify that they indeed meet your needs. An evaluation version for each KWizCom component contains all features of the component's production version. The only difference is that an evaluation version is time-limited, and will operate for a period of one month. Once you decide to order a KWizCom component, you will need to follow the following steps: 1. Order The component on the KWizCom website www.KWizCom.com 2. Send us the installed evaluation version's product Code (you will see the product Code on the "About" product page:

10 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Product Code

Please use the Activation Request web form, on KWizCom web site to send us your product code. 3. Get the component activation key this key will be sent to you by email once your order is processed. 4. Activate your installed evaluation version click Start -> All Programs -> KWizCom -> Activate SharePoint Search String Highlighter

11 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Copy the received activation key into Activation Code text field, and press Activate Product button. That's it! Your product is fully operational.

12 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

User's Guide
Well..there's nothing much really to explain. Once the component is installed, users will notice that when they search the SharePoint portal or a SharePoint team site, the search results page will appear a bit different, as in the following example:

User searches for the word "kwizcom"

The searched string is highlighted in the search results

13 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

User clicks a document link.

The searched string is also marked inside the document.

14 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

SharePoint Search String Highlighter Configuration Utility


The configuration utility is a Windows Application that is installed on the SharePoint server as a part of the component installation.

This utility allows you to change the Highlighter's behavior. Using this utility you can: Set the HTML code that is used to highlight (use this to change the color or background color of the highlight) REMARK: You can only define the highlighting color in SharePoint search result page. In order to set highlighting color inside documents you have to define it in MS WORD / ADOBE Reader. Set the list of ignored characters. These characters will not be highlighted in the search results. It is not recommended to change the default setting.
15 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Set the list of file extensions whose links will be modified to be opened with Microsoft Word. This means that you can also cause the highlighter mark search results in non-Office documents such as text files (.txt).

Set the minimum number of characters for a word to be highlighted. Define if highlighting should be done in the SharePoint search results page (You may not want it to be active on MOSS 2007, since MOSS 2007 already displays the searched string in bold format).

Define if highlighting should be done inside documents. Set if errors in the application will be shown to user in message boxes. The administrator can choose not to show the errors, and enable this only to debug.

16 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

FAQ
How do I use the SharePoint Search String Highlighter?
Simply open your SharePoint portal search page and write some words to search for. The words you write will be highlighted in the search results.

Does it work on SPS, WSS, both?


SharePoint Search String Highlighter supports both SPS and WSS.

Does it work on the new MOSS 2007?


Yes. SharePoint Search String Highlighter V2 supports both SharePoint 2003/WSS 2.0 and MOSS 2007/WSS 3.0.

I searched highlighted

for

word,

and

it

is

not

1. Make sure the word you searched for is more than 2 characters long. 2. Please note that special characters are ignored. If your query contained special characters such as ! or @ (for example) it may be the cause of the problem. Try running a simpler search (for example sharepoint or page) and verify that the SharePoint Search String Highlighter works. 3. Try clearing your Microsoft Internet Explorer 6 cache. This is done by closing all instances (windows) of Microsoft Internet Explorer and then opening Control Panel>Internet Options and on the General tab pressing the Delete Files button.

17 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

How do I get the words to be highlighted in the documents I go to from the search?
The SharePoint Search String Highlighter supports highlighting the searched words in Microsoft Word documents opened from the search page. For this to work, you must have the portal registered as a safe site in the Internet Explorer options in the client machines.

I changed some settings using the configuration utility, but it doesnt have any effect
Try clearing your Microsoft Internet Explorer 6 cache. This is done by closing all instances (windows) of Microsoft Internet Explorer and then opening Control Panel>Internet Options and on the General tab pressing the Delete Files button.

I did something wrong and the Highlighter stopped working


To reset the highlighter to its starting state, open the configuration utility (Start>Program>KWizCom> Reset to Defaults SharePoint Search String Highlighter> SharePoint Search String Highlighter Configuration Utility) and press

Do I have to install company's client-PCs?

anything

on

my

No. KWizCom SharePoint Search String Highlighter is a server installation. Once you install it on your SharePoint server, all users can start using it.

18 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

What happens documents?

with

non-Office

2003

The document marking is done using Office Word 2003 API. However, there are additional document types besides ".doc" that can be viewed using MS Word (for example: .rtf, .txt). So, for the SharePoint Search String Highlighter to mark non-MS Office files you should define these types in the configuration utility.

Which MS Office versions are supported?


Office 2003 and Office 2007.

What about PDF documents?


.PDF files are also supported. When you click a .pdf file from the search results page, it'll be opened in Search format, showing all searched phrase occurrences.

19 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Version Release Notes


Primary Software Version Base version Release date Module Configuration Utility 3.0.0 2.1.00 February-20-2009 Sub-Modules Version 2.2.00

Version History
CR #
51 52 53 1.6.00-1 1.5.01-1 1.5.01-2

Description
Highlight whole words only and not part of words. Cancel highlighting in the search results information bar highlight in WORD documents without enabling change tracking Add support for MOSS 2007 Cancel the 15 days expired message Fix bug: User doesn't see highlighting when he has the white default highlight color in MS word. Now when the user open the word he has yellow highlight color as default

Version 3.0.00, February-20-2009

Version 2.1.00, November-20-2007

1.5.01-3 1.5.00-1 1.4.0-1 1.4.0-2 1.2.0-1

Fix bug: Sometimes there's a Javascript code load error in run time. Fix Bug: Resolve ATL install problem Support highlighting in WSS search results page Support .PDF files Writing the combination closing parenthesis + space + closing parenthesis will stop the application from recognizing any words after that combination. For example, searching for hello ) ) world will only highlight the word hello and not the word world.

1.2.0-2

Some special characters cause the highlighter not to function properly. It is recommended that you do not change the settings in the configuration utility and you should avoid using either of the following characters: !@#$%^&*()-=_+{}[]:;<>,.?/ in your search query. 20

Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

Technical Support
You can obtain technical support using any of the following methods: The KWizCom Web site The KWizCom website at www.KWizCom.com contains the most updated valuable information, including:

Answers to frequently asked questions (FAQ's) about our products usability and technical questions. Product updates, which provide you with bug fixes and new features.

The Web Form For technical support through the Internet, please fill in our support web form on our web site For more information on technical support, please review our support programs page.

21 Copyright 2005-2009 KWizCom corp. All rights reserved. www.KWizCom.com

You might also like