Related Topics
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.
Documentation Feedback and Questions
If you notice some way that this document can be improved, we're happy to hear your suggestions. Similarly, if you can't find an answer you're looking for, ask it via feedback. Simply click on the button below to provide us with your feedback or ask a question. Please remember, though, that not every issue can be addressed through documentation. So, if you have a specific technical issue with Process Director, please open a support ticket.