This article is intended to show the simplest steps required to add SearchUnit to your SharePoint applications. Within a matter of minutes you will have a powerful index based search engine fully integrated within SharePoint as a web part. If you haven't already done so you can download SearchUnit free here.
1. Create a SharePoint Visual Web Part project. a. In Visual Studio select New Project > SharePoint > Visual Web Part project, enter the project name and click OK. Select the instance of SharePoint to use for debugging and click Finish. b. Open your project’s .ascx page designer and drag the SearchResult control to the page. (The SearchUnit controls can be added to your Visual Studio toolbox by manually navigating to the product DLL and dragging ‘Keyotix.SearchEngine.Web.dll’ to the toolbox). c. Create a folder to store the Index Directory files. This folder will need to be accessible to all SharePoint users that have access to the page containing the search control. e.g. C:\inetpub\wwwroot\wss\VirtualDirectories\7803\IndexDirectory Set the IndexDirectory property of the SearchResult control, to the path of the IndexDirectory created above. This will need to be set in code;
2. Creating your Index - Navigate to your 'SearchUnit' installation folder
(Typically under C:\Program Files (x86)\Keyoti Inc\SearchUnit) Under the folder containing the DLL’s for your .Net Framework version (NETCLR_v2_BIN for .NET2 & 3.5) open the ‘Keyoti Search Index Manager Tool Launcher’.
- Enter the path to your Index Directory folder.
e.g. C:\inetpub\wwwroot\wss\VirtualDirectories\7803\IndexDirectory The Configuration file for your Index Directory will need to be changed to allow the crawler to access a SharePoint site using IIS authentication. Click ‘Configuration’ and find the ‘WebsiteCredentials’ section. Enter the path to your SharePoint site followed by the username and password for a user that has access to the parts of the site you want to be searchable (Administrator for example). Save your Configuration changes.
- To begin importing your SharePoint site click on ‘Indexed Sources’. Click ‘Import New Source’. Set the Start URL to the path of your SharePoint site e.g. http://win-bqdrfp492op:7803/int/default.aspx
Under ‘More Options’ you can specify path matches that should be ignored during the import (admin only sections for example) and/or set only those path matches to be included in the import. E.g. "/_" was ignored so all paths containing "/_" will not be indexed. When you have the desired settings close the form and click ‘Import’ to begin indexing your SharePoint site. 3. Deploying your Visual Web Part project. - In your Visual Web Part project select ‘Build’ and ‘Deploy Solution’.
- Navigate to your SharePoint site and select ‘Edit Page’ then ‘Add a Web Part’. Under Categories select your project and click ‘Add’.
That’s it! Try a test search. Should you have any trouble please email support at keyoti.com AJAX Features (AutoComplete & ResultPreviewer)
When enabling the Auto Complete or Result Previewer you will need to add a httphandler in IIS;
1. Open IIS 7 and select the SharePoint site 2. Open Handler mappings 3. Click Add Managed Handler 4. For 'Request Path' enter; Keyoti.SearchEngine.Web.CallBackHandler.ashx For 'Type' enter; Keyoti.SearchEngine.Web.CallBackHandler, Keyoti2.SearchEngine.Web, Version=2012.?.?.?, Culture=neutral, PublicKeyToken=58d9fd2e9ec4dc0e (where 2012.?.?.? should be replaced with the version number of the Keyotix.SearchEngine.Web DLL) For 'Name' enter; Keyoti AJAX 5. Restart IIS
|