BusinessObjects Enterprise Administrator's Guide

Registering processing extensions with the system

Note:    This feature does not apply to Desktop Intelligence and Web Intelligence document objects.

Before you can apply your processing extensions to particular objects, you must make your library of code available to each machine that will process the relevant schedule or view requests. The BusinessObjects Enterprise installation creates a default directory for your processing extensions on each Job Server, Page Server, and Report Application Server (RAS). It is recommended that you copy your processing extensions to the default directory on each server. On Windows, the default directory is C:\Program Files\Business Objects\BusinessObjects Enterprise 11.5\win32_x86\ProcessExt. On UNIX, it is the bobje/processext directory.

Tip:    It is possible to share a processing extension file. For details, see Sharing processing extensions between multiple servers.

Depending upon the functionality that you have written into the extension, copy the library onto the following machines:

• If your processing extension intercepts schedule requests only, copy your library onto each machine that is running as a Job Server.
• If your processing extension intercepts view requests only, copy your library onto each machine that is running as a Page Server or RAS.
• If your processing extension intercepts schedule and view requests, copy your library onto each machine that is running as a Job Server, Page Server, or RAS.

Note:    If the processing extension is required only for schedule/view requests made to a particular Server Group, you need only copy the library onto each processing server in the group.

To register a processing extension with the system

1. Go to the Objects management area of the CMC.
2. Click Object Settings.

 

3. In the Name field, type a display name for your processing extension.
4. In the Location field, type the file name of your processing extension along with any additional path information:
• If you copied your processing extension into the default directory on each of the appropriate machines, just type the file name (but not the file extension).
• If you copied your processing extension to a subfolder below the default directory, type the location as: subfolder/filename

  Note:    Although the actual file name must include the .dll or .so extension (as appropriate to the server's operating system), you must not include the file extension in the Location field.

5. Use the Description field to add information about your processing extension.
6. Click Add.

You can now select this processing extension to apply its logic to particular objects. For details, see Selecting a processing extension for a report.

Tip:    To delete a processing extension, select its check box and click Delete. (Make sure that no recurring jobs are based on this processing extension because any future jobs based on this processing extension will fail.)