EnterpriseItems bean

See Also  

This managed bean is the source for a collection of BusinessObjects Enterprise objects such as reports, folders, or programs. This bean provides information and adds functionality to the UI components.

To learn more about core BusinessObjects Enterprise functionality and application development, consult the BusinessObjects Enterprise Java SDK Guide.

Click the appropriate link to jump to that section:

Overview

The EnterpriseItems bean is the source of a collection of BusinessObjects Enterprise objects, and is used to represent a collection of objects on the page. Collections are queried from the BusinessObjects Enterprise system by using query strings in the code-behind. These query strings are constructed in the same manner as the EnterpriseItem bean by setting bean properties. For more information on the BusinessObjects Enterprise query language, see the BusinessObjects Enterprise Java SDK Guide.

enableDefaultParent and parentItemID are the two key properties that determine the parent item used when querying for objects. The possible values for the enableDefaultParent property are fields of the com.businessobjects.jsf.sdk.properties.DefaultParentType class:

The parentItemID specifies the ID or CUID of the parent of all objects in the collection to be queried. This property can be set in many different ways. For example, you may want to set the parentItemID property programmatically to the itemID property value of a folder when the user clicks a folder from a list. This ID can then be used to query for a collection of reports within that parent folder.

The fields property defines the database fields you want to query for. See EnterpriseItem bean for a complete description of this property and its values.

Set the itemTypes property to one or more kinds of BusinessObjects Enterprise objects you want to query for and return in the collection. Examples of valid strings (ProgIDs) include:

So, for example, "All" would return all fields, whereas {"CrystalEnterprise.Report", "CrystalEnterprise.Pdf", "CrystalEnterprise.Txt"} would return only items that are Crystal reports, PDFs, or plain text files.

Note:    For more information on BusinessObjects Enterprise ProgIDs, see the BusinessObjects Enterprise Java SDK Guide.

The searchFields and searchText properties must be used together to perform a wildcard search on the BusinessObjects Enterprise system. Set the searchFields property to the field you wish to search on, and set the searchText property to the text you want to match for. For example, set the searchFields property to Name and the searchText property to World Sales Report to search for reports with a name of "World Sales Report". Only certain fields are optimized and recommended for searching:

Several other properties control specific aspects of querying for collections of objects. Set the filterByOwner property to true to query only for items owned by the user. By default, this property is false. The instances property determines whether instances are included in the collection of objects returned and set to the EnterpriseItems bean. This property must be set to fields of the com.businessobjects.jsf.sdk.properties.InstanceFilter class: IncludeInstances, to include instances in the query results; ExcludeInstances, to exclude instances from the query results; and InstancesOnly, to return a collection that contains only instances of objects.

In addition to the general attributes of the bean, two properties access classes that contain further properties:

Note:    For a comprehensive reference of all EnterpriseItems bean members, see the IEnterpriseItems interface in the JavaServer Faces Components for BusinessObjects Enterprise Java API Reference.

Example faces-config.xml declaration

<managed-bean>

    <description>Source for a collection of folders.</description>

    <managed-bean-name>folders</managed-bean-name>

    <managed-bean-class>

        com.businessobjects.jsf.appcontrols.model.EnterpriseItems

    </managed-bean-class>

    <managed-bean-scope>session</managed-bean-scope>

    <managed-property>

        <property-name>parentItemID</property-name>

        <value>0</value>

    </managed-property>

</managed-bean>



Business Objects
http://www.businessobjects.com/
Support services
http://www.businessobjects.com/services/support/