Using the bpUtil Utility

Process Director provides a utility, bpUtil, for passing commands to Process Director, usually on a scheduled basis. For customers, nearly all use cases only use a single command ,SU, which calls a URL. There are several reason why you might wish to do this, such as scheduling an Active Directory synchronization, or scheduling a Knowledge View to export an Excel or CSV file, or to run a process for each row of the Knowledge view.

You should use bpUtil to run all scheduled commands on Process Director. You should not call a Process Director URL directly from the Windows Scheduler Utility. The Windows Scheduler will not release the page after running, and keep it in memory, which can cause performance issues. bpUtil, on the other hand, will call the page and release it immediately after it runs. This utility was specifically constructed for this reason.

So, instead of calling the page directly through the Windows Scheduler, you would use Windows Scheduler to call bpUtil, passing the SU command and the fully qualified URL as a parameter. For example to schedule an Active Directory synchronization, you would place the following command into the Windows Scheduler:

"LocalPath\bputil.exe" SU "http://localhost/WD/admin/ad_sync.aspx?ads=ProfileName"

...Where LocalPath is the drive path on the local computer where bpUtil is located, and ProfileName is the name of the actual AD Synchronization Profile to run when the page is called.

This command calls bpUtil from the Windows Scheduler. bpUtil, in turn, will call the page to run the appropriate synchronization profile, then release the page from memory when the synchronization begins.

The appropriate Windows Scheduler command used to call bpUtil is provided in the documentation for each Process Director object to which it is relevant.

Like the bpImport or bpEmailImport utilities, bpUtil can be installed on any computer. Unlike the other utilities, bpUtil does not have a graphical user interface. It is generally only addressed via Windows Scheduler commands.