Content API for FAST Search Server 2010 for SharePoint
FAST Search for SharePoint provides multiple options for crawling and retrieving content for indexing:
- When you use the FAST Content SSA, the feeding/crawling will work in the same way as for SharePoint Server search. This is the recommended approach in most cases.
- FAST Search for SharePoint also supports additional indexing connectors, to solve more advanced needs. For more information, see Plan for crawling and federation (TechNet). There is also a table that provides a comparison of the connectors.
- If you have a custom content source, you can in most cases retrieve data for indexing using the BCS framework.
If you have more specialized needs, there is one more option. The FAST Content API enables you to push content from a client .NET application. This API is mainly provided to enable customers of previous FAST products to migrate their custom content connectors and use them with FAST Search for SharePoint. You may also use this API for other custom applications, but note that there are certain limitations on the support for the API - see the download page for details.
The API provides an asynchronous interface for pushing items to the FAST Search farm from a remote client application. The API communicates with the FAST Search Content Distributor, using WCF. The API is based on .Net Framework 3.5.
If you are familiar with the FAST ESP .NET Content API, you will find it easy to use, but there are some differences:
- The routing attributes are not supported
- You can add multiple attachment documents for each item
- You can add a security descriptor for each item, using a Security Descriptor Definition Language string that describes the security/allowed access for an item
- The API works with crawled properties, and in SharePoint the crawled properties must have a name and a GUID. When you add a crawled property to an item, you can set the crawled property GUID for the IDocumentFeeder instance, or for the property instances
By using the Content API, you create your own custom crawled properties. In the FAST Search Server farm, you should create a new crawled property category for the new crawled properties:
$guid = [guid]::NewGuid()
$cat = New-FASTSearchMetadataCategory -Name xmlprops -Propset $guid
Set-FASTSearchMetadataCategory -Category $cat
Note the GUID value. This is a unique value that you need to use in the API client.
In most cases it is convenient to use one crawled property category for all crawled properties used in the API, and then map the crawled properties to managed properties within the index schema. In that case, you only need to specify the GUID in IDocumentFeeder (PropertySet). You can also specify crawled property category for individual properties. When you create a 'Document', and wants to specify a unique GUID for the crawled properties, you can do that by adding elements of type Property (e.g. StringProperty), and add the GUID you have created above using PropertySet.
You must also create a unique content collection for the Content API client. Do not use the default 'sp' collection.
For detailed documentation of the API interfaces, refer to the .chm help file that is part of the download.