IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > Enterprise Content Management > Configure the module for deployment > Configure the module for outbound processing

Selecting and configuring business objects

Using the list of Content Management Repositories discovered by the external service wizard, select the Document and Folder types that you need to access in your module, then provide configuration information for your new business objects.

From the Find Objects in the Enterprise System window, you can select and configure objects in any order. You can add objects individually, or all of these objects at one time. You can mix objects from the various nodes of the Discovered objects list.

The high-level flow of selecting and configuring business objects is as follows:

  1. Select one or more Document types and Folders in the Discovered objects list of the Find Objects in the Enterprise System window.

  2. Click the > (Add) button.

  3. The wizard opens the Specify the Configuration Properties for 'object' window.

    • If you select a single object, a single Specify the Configuration Properties for 'object' window is displayed.

      Figure 1. Specifying the configuration properties for a Document Type (Email)

    • For Document types, in the Target folder in the CMIS server field, enter the folder name.

      For more information about the DocumentUrl property, see RetrieveProperties operation

    • Select the optional properties that you want to see in your final business object from the list of Custom Properties and Inherited Properties. These properties are ones that the wizard cannot discover by examining the database and are applicable to both Document and Folder types.

    • If you select multiple objects, the Specify the Configuration Properties for 'object' window displays with one page for each object selected.

      Click the name of each object in turn. The window displays the same information if you select this object individually.

      Important: Do not click OK until you complete the configuration pages for all the objects. The wizard does not close the notebook until you provide all the required fields, but you can close the window before providing optional fields. If you do not configure the optional fields in the wizard, use the business object editor to configure them after exiting the wizard.

    • Choose the operations that need to be added to the service interface for this object type (document or folder). To configure an operation, you can use either the Add or the Remove button.

      If you remove any of these operations, the removed operation is made available in the Add Value window for you to add. Use the Add option again to open the Add Value window and select the operations you want to add.

  4. Click Advanced. Expand the advanced sections to review and specify the following options:

    1. Specify how you want to retrieve the records:

      • If you want the RetrieveAll operation to return all records matching the query, select the Return all records for RetrieveAll operation check box.

      • If you want to specify how many records the RetrieveAll operation must return, enter a value in the Maximum records for RetrieveAll operation field or enter -1 in the appropriate field. The default value is 100.

        The Maximum records for RetrieveAll operation property applies only if you are using the RetrieveAll operation. This property field is disabled (unavailable for use) if you remove the RetrieveAll operation in Step 3 or if you select the Return all records for RetrieveAll operation check box.

    2. Enter the query conditions after expanding the Enter the query condition area.

      • In the SELECT clause field, enter the Select clause from Email, for example, To

      • In the WHERE clause field, enter the Where clause from Email, for example, sender = 'johndoe@us.ibm.com'

  5. For the Delete operation, you can configure how the Delete operation needs to be extended to the subfolders and documents in the parent folder selected for deletion. For this configuration, you need to select the Enable delete options for fileable objects in the current folder tree check box. By default, this property is cleared.

    Figure 2. Specifying the configuration properties for a Folder

    When the Enable delete options for fileable objects in the current folder tree check box is selected, three radio buttons are enabled:

    1. Cascade delete - Delete all the fileable objects, documents, and folders inside the folder selected for deletion.
    2. Conditional cascade delete - If all the parent folders for an object are inside the current folder tree, that is, a document has multiple parent folders, then delete the document. Else, unfile the document from the current folder tree.
    3. Unfile all fileable objects - Unfile all the fileable objects, that is, remove all the reference from the fileable object to the parent folder.

    You can also configure the adapter to continue the delete operation, if the delete operation on any of the folder/document fails using the Continue on error check box. By default, this property is set to false.

  6. Click OK.

  7. The wizard adds the configured object to the Selected objects list.

The target document or folder and its properties should define the appropriate query Name to use the RetrieveAll feature. Refer to the CMIS specification for more details on how to construct a valid query.

Until you do not exit from the wizard, you can work iteratively to select and configure the business objects you need in your module. However, before you start the wizard to add objects to an existing module, understand the requirement of the program that uses the business objects carefully. The wizard overwrites the existing business objects in the same path.

Configure the module for outbound processing


Previous topic: Discovering and selecting objects


Next topic: Configure the selected objects


Related information:

http://docs.oasis-open.org/cmis/CMIS/v1.0/os/cmis-spec-v1.0.html