com.crystaldecisions.sdk.occa.pluginmgr
Interface IPluginMgr

public interface IPluginMgr

The Plugin Manager manages the deployment of desktop plugins.

The IPluginManager interface can be obtained from EnterpriseSession object by calling the getPluginManager() method. Note that the PluginManager interface cannot be used separately from the EnterpriseSession object.

Nested Class Summary

static interface	IPluginMgr.Category This interface defines possible values for the plugin category.
static interface	IPluginMgr.Type This interface defines possible values for the types of plugin interface retrieval.

Method Summary

IPluginInfo	getPluginInfo(java.lang.Object plgkey) Returns information on an available plugin at the CMS.
java.lang.Object	getPluginInterface(java.lang.Object plgkey, java.lang.String type) Retrieves a specific plugin interface given the ProgID or object type.
IPluginInfo[]	getPlugins(java.lang.String Category) Returns a collection of plugins in a given category that are installed on the CMS.

Method Detail

getPluginInfo

public IPluginInfo getPluginInfo(java.lang.Object plgkey)
                          throws SDKException

Returns information on an available plugin at the CMS.

Parameters:

plgkey - An Object specifying a ProgID or the Type of the plugin for which information is to be retrieved.

Returns:

An IPluginInfo object containing information on the specified plugin.

Throws:

SDKException - This is thrown if the process is unsuccessful.

getPluginInterface

public java.lang.Object getPluginInterface(java.lang.Object plgkey,
                                           java.lang.String type)
                                    throws SDKException

Retrieves a specific plugin interface given the ProgID or object type.

Parameters:

plgkey - An Object specifying a ProgID of the plugin.

type - Specifies the type of plugin interface to retrieve. This should be one of type IPluginMgr.Type.

Returns:

An Object containing the plugin interface specified. The type that this object can be cast as depends on the ProgID or Type of the plugin that was supplied as an argument. For example, if the ProgID supplied was 'CrystalEnterprise.Server' then the returned Object will be of type IServer.

Throws:

SDKException - This is thrown if the process is unsuccessful.

See Also:

IPluginMgr.Category, CePropertyID

getPlugins

public IPluginInfo[] getPlugins(java.lang.String Category)
                         throws SDKException

Returns a collection of plugins in a given category that are installed on the CMS.

Parameters:

Category - The category for which a collection of plugin is to be retrieved.

Returns:

An array of IPluginInfo objects containing the plugins in a given category that are installed on the CMS.

Throws:

SDKException - This is thrown if the process is unsuccessful.

See Also:

IPluginMgr.Category