com.sapportals.wcm.service.indexmanagement.retrieval.classification

Interface IQBClassificationIndex

public interface IQBClassificationIndex

This kind of classification index offers functionality working with query based taxonomies

Method Summary

void	deleteQueryFolderExternal(IQueryFolder queryFolder) Deletes a query folder on the external classification engine
com.sapportals.wcm.util.uri.IRidList	getAffectedCategories(IQueryFolder queryFolder, IResourceContext context) Gets a list of categories of a taxonomy that are affected if the query of the query folder has changed.
ISearchResultList	getQueryDocuments(IQueryFolder queryFolder, IResourceContext context) Documents of the index that match the query of the folder.
ISearchSession	getQueryDocumentsPreview(IQueryFolder queryFolder, IResourceContext context) Deprecated. as of NW04. Do not use
IQueryFolder	getQueryFolder(com.sapportals.wcm.util.uri.RID taxonomyClassRid) Gets a query folder instance
void	moveQueryFolderExternal(IQueryFolder queryFolder, com.sapportals.wcm.util.uri.RID destination) Moves the query folder on the external classification engine
void	setQueryFolderExternal(IQueryFolder queryFolder, IQueryEntryList query) Sets the query on the external classification engine.
void	setQueryFolderExternalFast(IQueryFolder queryFolder, IQueryEntryList query) Sets the query on the external classification engine.
void	updateCategoryContents(String taxonomyName, boolean dirtyOnly, IResourceContext context) Starts a process that checks and updates categories of a taxonomy where the query is not in sync with the documents of category.

Method Detail

getQueryFolder

IQueryFolder getQueryFolder(com.sapportals.wcm.util.uri.RID taxonomyClassRid)
                            throws com.sapportals.wcm.WcmException

Gets a query folder instance

Parameters:

taxonomyClassRid - rid of the taxonomy class that is the query folder

Returns:

the query folder instance

Throws:

com.sapportals.wcm.WcmException

deleteQueryFolderExternal

void deleteQueryFolderExternal(IQueryFolder queryFolder)
                               throws com.sapportals.wcm.WcmException

Deletes a query folder on the external classification engine

Parameters:

queryFolder - query folder to delete

Throws:

com.sapportals.wcm.WcmException

setQueryFolderExternal

void setQueryFolderExternal(IQueryFolder queryFolder,
                            IQueryEntryList query)
                            throws com.sapportals.wcm.WcmException

Sets the query on the external classification engine. If the query folder doesn't exist on the external engine it is also created

Parameters:

queryFolder - the query folder to set

query - the new query for the folder

Throws:

com.sapportals.wcm.WcmException

setQueryFolderExternalFast

void setQueryFolderExternalFast(IQueryFolder queryFolder,
                                IQueryEntryList query)
                                throws com.sapportals.wcm.WcmException

Sets the query on the external classification engine. If the query folder doesn't exist on the external engine it is also created. This is a faster version for Trex than setQueryFolderExternal.

Parameters:

queryFolder - the query folder to set

query - the new query for the folder

Throws:

com.sapportals.wcm.WcmException

moveQueryFolderExternal

void moveQueryFolderExternal(IQueryFolder queryFolder,
                             com.sapportals.wcm.util.uri.RID destination)
                             throws com.sapportals.wcm.WcmException

Moves the query folder on the external classification engine

Parameters:

queryFolder - the query folder to move

destination - the new rid of the query folder

Throws:

com.sapportals.wcm.WcmException

updateCategoryContents

void updateCategoryContents(String taxonomyName,
                            boolean dirtyOnly,
                            IResourceContext context)
                            throws com.sapportals.wcm.WcmException

Starts a process that checks and updates categories of a taxonomy where the query is not in sync with the documents of category.

Parameters:

taxonomyName - name of the taxonomy to check

dirtyOnly - if false all categories are checked, if false only categories that are out of sync (dirty) are updated.

context - user context

Throws:

IndexNotReadyException - if not all documents of the classification index can be updated because some documents are still beiing processed on the index server.

com.sapportals.wcm.WcmException

getQueryDocuments

ISearchResultList getQueryDocuments(IQueryFolder queryFolder,
                                    IResourceContext context)
                                    throws com.sapportals.wcm.WcmException

Documents of the index that match the query of the folder.
Since the queries are hierarchical the returned documents also match the queries of the parent folders.

Parameters:

queryFolder - query folder for that the document have to be returned

context - user context

Returns:

list of documents with their rank values that match the query of the folder.

Throws:

com.sapportals.wcm.WcmException

getQueryDocumentsPreview

ISearchSession getQueryDocumentsPreview(IQueryFolder queryFolder,
                                        IResourceContext context)
                                        throws com.sapportals.wcm.WcmException

Deprecated. as of NW04. Do not use

Documents of the index that match the query of the folder.
Since the queries are hierarchical the returned documents also match the queries of the parent folders. The call should only be used to get a preview of the query result.

Parameters:

queryFolder - query folder for that the document have to be returned

context - user context

Returns:

search session object including document IDs with their rank values that match the query of the folder.

Throws:

com.sapportals.wcm.WcmException

getAffectedCategories

com.sapportals.wcm.util.uri.IRidList getAffectedCategories(IQueryFolder queryFolder,
                                                           IResourceContext context)
                                                           throws com.sapportals.wcm.WcmException

Gets a list of categories of a taxonomy that are affected if the query of the query folder has changed.

Parameters:

queryFolder - query folder that has changed

context - user context

Returns:

list of resource IDs of categories that have changed after the query has been changed

Throws:

com.sapportals.wcm.WcmException

Access Rights

This class can be accessed from:

SC	DC	Public Part	ACH
[sap.com] KMC-WPC	[sap.com] tc/kmc/wpc/wpcfacade	api	EP-PIN-WPC-WCM
[sap.com] KMC-CM	[sap.com] tc/km/frwk	api	EP-KM-CM