Retrieving InfoObjects created with a desktop plugin

Each object that is created with a desktop plugin is stored in either the CI_INFOOBJECTS or the CI_SYSTEMOBJECTS category in the APS InfoStore, and is marked with a programmatic identifier (ProgID). Using SI_PROGID, you can query the APS InfoStore for a collection of objects.

Example

The following query selects the names, full names, and IDs of all users in the APS:

var Users = IStore.Query("SELECT SI_ID, SI_NAME, SI_USERFULLNAME FROM CI_SYSTEMOBJECTS WHERE SI_PROGID='CrystalEnterprise.User'");

The Query method returns a collection of InfoObjects, which in this case are user objects. Like other InfoObjects, user objects are uniquely represented by their ID property. For each user object in the collection, you can access general InfoObject properties, such as the Title property, Description property, and ID property.

Continuing with the above code sample, the following piece of code uses the PluginInterface Property to retrieve the User plugin's default object, which is the User object:

var UserInterface = Users.Item(1).PluginInterface("");

Once you have retrieved the plugin interface, you can access plugin-specific properties and methods.

A list of the available desktop plugins, as well as the ProgIDs of the objects that are created from them, follows. The objects that are created with the plugins below must be retrieved from CI_INFOOBJECTS:

Plugin SI_PROGID

Crystal Enterprise Excel PlugIn Library

CrystalEnterprise.Excel

Crystal Enterprise Pdf PlugIn Library

CrystalEnterprise.Pdf

Crystal Report Plugin Library

CrystalEnterprise.Report

Crystal Enterprise Rtf PlugIn Library

CrystalEnterprise.Rtf

Crystal Enterprise Shortcut Plugin Library

CrystalEnterprise.Shortcut

Crystal Enterprise Txt PlugIn Library

CrystalEnterprise.Txt

Crystal Enterprise Word PlugIn Library

CrystalEnterprise.Word

The objects that are created with the plugins below must be retrieved from CI_SYSTEMOBJECTS:

Plugin SI_PROGID

Crystal Enterprise Connection PlugIn Library

CrystalEnterprise.Connection

Crystal Enterprise Event PlugIn Library

CrystalEnterprise.Event

Crystal Enterprise LicenseKey PlugIn Library

CrystalEnterprise.LicenceKey

Crystal Enterprise Server PlugIn Library

CrystalEnterprise.Server

Crystal Enterprise ServerGroup PlugIn Library

CrystalEnterprise.ServerGroup

Crystal Enterprise User PlugIn Library

CrystalEnterprise.User

Crystal Enterprise UserGroup PlugIn Library

CrystalEnterprise.UserGroup



Crystal Decisions, Inc.
http://www.crystaldecisions.com
Support services:
http://support.crystaldecisions.com