General
1. Is Kayxo Insight the right product for me?
- The Kayxo Insight is designed as a departmental or small-to-medium company product. If you have up to 1000* Microsoft Outlook users who need to cross-reference information from various back-end databases (Microsoft SQL Server, Oracle, etc.) and local storages (Microsoft Office Excel or Access, comma-separated files, XML files, etc.) this product will be extremely helpful to increase the productivity of information workers.
* The number of concurrent users that can use Kayxo Insight application without performance problems depends on hardware, network, databases involved and on Data Source component(s) used.

2. What is Kayxo Insight Client Application?
- Kayxo Insight comes as an SDK and it needs to be configured in order to be able to use it. The configuration and custom data source components and custom inspectors (when needed) together with the database make Kayxo Insight work. All these elements are called Kayxo Insight Application.

3. What is the Kayxo Insight configuration?
- Kayxo Insight configuration defines all the necessary parameters for the Kayxo Insight to work, i.e. open Kayxo Insight Message Store in Microsoft Outlook, show folders within this store, show data in Microsoft Outlook Explorer views, allow inspecting objects, etc. The configuration is created inside Microsoft Outlook. Redistribution of the configuration for workstations is performed by exporting it to a PST file and then importing it to Microsoft Outlook.

4. How difficult is it to configure Kayxo Insight?
- Any junior IT professional with understanding of database structures and query languages can easily configure Kayxo Insight. Being familiar with Kayxo Insight is required. The basic knowledge of Microsoft Outlook custom forms development, and MAPI properties is recommended.

4. How much time does it take to implement a basic configuration to retrieve data from a SQL Server?
- It is only a matter of an hour or two to understand the configuration basics and to create/debug a configuration.

5. Do I have to learn MAPI to configure the Kayxo Insight Message Store Provider?
- You do not need to understand MAPI to configure folders or data sources. The only exception is mapping fields to MAPI properties, in such cases, basic knowledge of MAPI properties is required. All the necessary information is provided in the product reference and examples.

6. Why do I need to be familiar with database structure and class model before configuring the system?
- Configuring data presentation for Kayxo Insight Message Store in Microsoft Outlook requires configuring data sourcing. That cannot be done without being familiar with the database structure and class model to be used.

7. How do I plan and start creating Kayxo Insight Configuration?
- You should start with opening the Kayxo Message Store in Microsoft Outlook. Continue by configuring folders and data sources for folders in steps. Do not configure the whole folder structure at once - do it step by step. Finally you create/configure inspectors.
See: “Kayxo Insight - Application Programmer's Tutorial” for details.

8. Does Kayxo Insight work with mail clients other than Microsoft Outlook?
- No, the Kayxo Message Store Provider was designed for Microsoft Outlook. It cannot be used with Outlook Express or any other mail client.

9. Does the Kayxo Insight support off-line working?
- Kayxo Message Store Provider requires particular implementations of the data and folder providers to support off-line working. These implementations are not part of the standard product.

10. What are the minimal software requirements to install the Kayxo Insight?
- Windows XP SP2 or later or Windows Vista,
Microsoft .NET Framework 2.0,
Microsoft Outlook 2003 with SP2 or Microsoft Outlook 2007 with its license activated.

11. How can I map Attachments and Recipients in Kayxo Insight?
- Because attachments and Recipients are created, maintained, and accessed only through their messages, they are considered message sub-objects.
As messages, attachments need two datasources, one to show the list of all attachments for a given message and the other one to open/update/delete/insert a specific attachment. Recipients only need to have a List Datasource configured.

12. Is possible source recipient information from a different data source?
- Yes, you can source attachments and recipient tables from the same or different data source than the one used for the messages.

13. Is there any way to search in multiple folders at once using Kayxo Insight?
- Yes, there is. You can find information throw the folders just like Outlook/Exchange does. You have to create a search data source which implements IFindDataSource, indicating that the data source acts as an asychronous finder for cross-folder advanced searches.

14. What do I need to source Free/busy data?
- You need to develop and configure custom free/busy providers in order to source free/busy data from many sources at once. Please refer to the Kayxo Insight documentation for details.

15. Can I create my own installer to deploy a custom Kayxo Insight application?
- Yes, Kayxo Insight Run-Time edition allows to the OEM partners create custom applications and deploy them Insight using their own custom installers.

Kayxo Insight Store
16. What is Kayxo Insight Store?
- From a user’s perspective the Kayxo Insight Store is yet another message store available for him/her in Microsoft Outlook (as his Mailbox or Public Folders stores). The Kayxo Insight Store hosts the hierarchical set of folders, and these folders are containers for messages. The difference is that information (folder structure and folder contents) is not sourced from an Exchange Server, but from other sources ranging from locally stored Excel-files to centrally managed accounting systems. Budgets, sales statistics, customer data, and much more may be presented in the familiar Microsoft Outlook user interface providing users with a quick insight into business matters.
All this is done by Kayxo Insight Message Store Provider.

17. What is Kayxo Insight Message Store Provider?
- Kayxo Insight Message Store Provider is a MAPI service provider that presents the services of some underlying storage mechanism to MAPI client applications (Microsoft Outlook) as a hierarchical set of folders and messages that MAPI clients can use.
The Kayxo Insight Message Store Provider is a highly-configurable and extendible adapter between legacy Mail Application Programming Interfaces (MAPI) and modern .NET based interfaces. With this component, application programmers no longer have to implement cumbersome MAPI interfaces in unmanaged COM code. Instead, they build components implementing simple interfaces in managed .NET code. Pre-built configurable components allow rapid development and consistent behavior.
With Kayxo Insight Message Store Provider, showing business information inside of Microsoft Outlook is basically a matter of sourcing and providing folder structures and data sets.

18. Is the Kayxo Insight Message Store Provider implementation based on a Microsoft Outlook feature or is it a “hack” for Microsoft Outlook?
- Kayxo Insight Message Store Provider is not a hack. Microsoft Outlook provides the message and address book store provider interfaces. MAPI SDK (published on MSDN website) contains the necessary information to extend Microsoft Outlook with new store providers. Since MAPI is a native API that uses Component Object Model (COM) to define its components and interfaces, the store provider can only be created using low level languages such as C and C++.

19. Does the Kayxo Insight Message Store Provider replicate external data inside Microsoft Outlook as a local .pst file?
- No, the Kayxo Message Store Provider does not replicate information. The data displayed inside folders and the folders are obtained on-line, querying the back-end systems.

20. Can I have more than one Kayxo Store?
- Yes. You can open more than one Kayxo Insight Message Store if needed.

Folders in Kayxo Insight Store
21. Are folders data containers?
- Not really. Folders within Kayxo Insight Store are not containers for messages but filters that filter data for Microsoft Outlook Explorer views. They are more like Microsoft Outlook search folders. When a folder is selected the data for Microsoft Outlook Explorer view is provided according to folder definition in configuration.

22. How do I build the folder tree structure?
- The folder structure is defined in configuration and can represent any hierarchy. Typical folder tree structure will present the identities hierarchy (recommended). Application programmers should define folder tree structure having in mind user requirements and available data sources.
See: “Kayxo Insight - Application Programmer's Tutorial” for details.

23. What is the difference between static and dynamic folders?
- The configuration of static folders defines the Kayxo Insight Store hierarchical folder structure. This configuration will always generate the same “static” folder structure.
The configuration of dynamic folders allows the dynamical generation of folders from a data source. A different folder structure may be generated depending on data changes.
See: “Kayxo Insight - Application Programmer's Tutorial” for details.

Data for folders in Kayxo Insight Store
24. What is a data source?
- Data Sources are modules responsible for supplying the contents of folders to the Kayxo Insight Message Store Provider and items’ data for Inspectors (Microsoft Outlook forms). They can also provide folders’ data for dynamic folders.

25. What are Microsoft Outlook Explorer Views?
- Microsoft Outlook Explorer View is the right panel of Microsoft Outlook window, in which the messages are displayed.

26. Can I create new data sources using VB.Net?
- You can create data sources for the Kayxo Insight Message Store Provider in any .Net language.

27. Can I create new data sources using VB 6?
- No, you have to use a .Net based language/compiler to create new data sources for the Kayxo Insight Message Store Provider.

28. Can I create new items in a folder displayed using the Kayxo Insight Message Store Provider?
- If the configuration of a folder specifies the Data Source capable of creating items, then items can be created.
Data Sources that implement IDataSourceWrite interface are capable of creating, updating and deleting items (if they implement Create, Insert, Update, and Delete methods).
Refer to Kayxo Insight documentation for details.

29. Can I change the folder structure from Outlook and reflect the changes in my system using Kayxo Insight?”
- Yes, writing capabilities for folders that are dynamically sourced based on LOB data is part of the product. This gives the Data Sources the ability to manage folder’s events like when a folder is created, deleted or renamed by the user in a dynamic folder structure and reflect that change in the LOB

Inspecting
30. How can I view the information contained in an item inside a folder supported by Kayxo Insight Message Store Provider (or, what happens when I double-click an item)?
- Each time you double click an item, Microsoft Outlook searches for a particular entry field that indicates the form to be used to display the item. By creating custom forms and configuring folder and data sources, you can inspect Kayxo Insight Message Store Provider based items as any other common Microsoft Outlook items.

31. How do I define inspectors?
- You specify the inspector by specifying the MessageClass field. The MessageClass value determines the inspector that will be used by Outlook to open an item. If you use custom forms, then they must be published in such a way that the MessageClass matches the published form class.
See: “Kayxo Insight - Application Programmer's Tutorial” for details.

32. How is the inspector to be used selected by Microsoft Outlook?
- When users want to open an item, Kayxo Insight intercepts the Microsoft Outlook open item event and provides item data for Microsoft Outlook to search for the correct inspector. Microsoft Outlook locates the inspector (the best match for the MessageClass of the item) and uses it to open the item. Configuration defines record classes for each type of item (MessageClass field).
See: “Kayxo Insight - Application Programmer's Tutorial” for details.

33. How are data sources defined for inspectors?
- Inspectors use the data source that is defined for the folder. When creating a folder configuration you must map fields to MAPI properties. Then Microsoft Outlook will use the field values to set the values for properties in an item. Alternatively, for user defined properties, mapping is done by specifying the same name for column “name” attribute in configuration and the property name in the Microsoft Outlook form.
You can reuse the view configuration (“List DataSource”) for inspecting items. You can also have items configured differently than for the Microsoft Outlook view (“DataSource” and/or “Fields Mapping”). All scenarios are allowed.
See: “Kayxo Insight - Application Programmer's Tutorial” for details.

34. How do I distribute Kayxo Insight configuration?
- Once you have configured Kayxo Insight on one workstation, you can export the configuration, and then, import it to other workstations using Kayxo Insight Configuration Import/Export Tool.
See: Kayxo Insight documentation for details.

Troubleshooting
35. I cannot filter items in Microsoft Outlook view
- Fields mapped to standard Microsoft Outlook MAPI properties are used for filtering. Fields mapped to named properties are not included in filtering.
Use “Advance Find” (or a search folder) where you can specify named properties and use them for filtering (one by one). The result view is the standard view.
This problem is data source dependant and does not apply to all data sources.

36. No Microsoft Outlook response when selecting a folder
- When a large number of items are being refreshed, the refresh process takes control and no user action is processed (Microsoft Outlook does not respond, but the cursor does not change to hourglass).
This happens when the folder is selected for the first time or when a large number of items have been deleted/changed/added. This behavior is data source dependant. Performance may improve when other data sources (custom) are used.

37. How can I add the fields that I have previously removed from the Microsoft Outlook view?
- Fields removed from the Microsoft Outlook view are listed in the Field Chooser. They are mapped to standard MAPI properties and appear under their MAPI names (for instance, Subject instead of Company Name). When added to the view they will be displayed under their MAPI names.

|