When a Process Timeline process is started, a Process Timeline instance is created. This instance is what is routed to the participants of the Process Timeline. The Process Timeline instance contains the Routing Slip, the Process Timeline objects (documents, Forms, etc.), optional references, and administrative controls. The Process Timeline instance can be viewed by authorized users for running and completed Process Timelines.
Routing Slip #
Authorized users have access to the Routing Slip in the Process Timeline instance by clicking on the Timeline Status Tab. This tab displays a Routing Slip that shows the progress of the route. It displays all users that are participating in this Process Timeline and how far it has progressed in the routing process, including all iterations of an Activity.
The active Activity in a running process will be highlighted in Process Director v4.53 and higher.
Active/Completed Timelines #
When you open a Timeline definition, the folder list on the left side of the Content List screen will automatically expand the Timeline treeview to display the Active Timelines and Completed Timelines branches. Clicking on one of the branches will show all instances of the running or completed Timelines, respectively, on the right side of the Content List. Clicking on any running or completed Timeline instance will open the instance in the Timeline Status view.
Only authorized users will see this button displayed, which opens the Timeline administration view. The user must have Modify permission for the running Process Timeline or have Modify Children permission for the Process Timeline Definition. The Administration button in the Process Timeline instance allows users to modify the running Process Timeline. From this screen, authorized users can change the running Process Timeline by adding users to an Activity, removing them from an Activity, or jumping to a new Activity.
The Process Timeline administration page displays information about the state of the running Process Timeline instance. It can tell you when tasks are expected to complete, and indicates if that means they’ll be late. It can compare the configured run time of an Activity to its actual and predicted run times. To view analyses of average Process Timeline performance, go to the Analyze Timeline page on the Process Timeline definition.
The triangles represent due dates. They can be dragged along the Process Timeline to change the configured due date for a single Process Timeline instance.
The green bar indicates the current date and time, juxtaposed onto the configured dates and times for the Process Timeline.
Green arrows will appear to the left of activities that are currently running.
A checkbox next to an Activity name indicates that Activity has been completed.
If a Process Timeline is in an error state, Process Director will display the Activity in which the error occurred highlighted in red. Rolling your mouse over the Activity will also display an error message.
Administering Process Timeline Activities
You can access the properties for a Timeline Activity displayed in the Administration/Timeline tab by right-clicking on the Activity, and selecting Properties from the pop-up menu.
In the Timeline Instance Activity Properties tab, you can access the full range of Activity and user properties by checking the box next to the Activity's user name in the Participants column of the Activity's Routing Slip.
With the user check box checked, you now have access to the full range of Timeline and User Actions available for the Activity, displayed in a list of links marked "Actions:". The full list of actions are described in the table below:
Cancels this Activity in the Process Timeline.
When a Parent Activity is administratively canceled, the system will ripple the user and cancellation comments to all the child activities that are being canceled because the parent is canceled.
Restarts this Activity in the Timeline. User, Wait, Custom Task, or Script Activities may all be restarted.
Cancels the entire running Timeline instance.
Adds additional users to the Timeline Activity.
Add Me to This Task
Adds you to the Timeline Activity as a participant.
Cancels the user's participation in the task.
Complete User Task
Sets the user's task as complete.
Remove the user from the task.
Restart this user task.
Resend the task notification email to the user.
Assign a different user to the task.
|Open My Task
|If you are the user to whom the task is assigned, this link will open the Form that is associated with the Timeline. The Form will open in the context of the user task, enabling you to complete the task.
When canceling a Parent Activity in a Process Timeline, all child activities will also be canceled.
Restart and Rollback
In addition to viewing an Activity’s properties, you also have the option to restart a task, or rollback to a task.
Restart This Activity: You can choose an Activity that has already completed, and restart it. This will only restart that Activity, and won't restart any subsequent activities in the Process Timeline. Once the restarted Activity completes, no further action is taken. If you are in a later Activity and you restart, the later Activity will still run normally.
Rollback to this Activity: This option only appears when you select an Activity that is on a critical path. If you rollback to an earlier Activity in the same critical path, it will cancel the current Activity, restart the selected Activity, and place all subsequent activities in the critical path into a reset state, so that they can run again. If you rollback to an Activity in a different critical path, it will not cancel the current Activity, it will only restart the critical path for the Activity you selected. In that case, both the rollback Activity and the current Activity will run simultaneously. Only if a previous Activity is in the same critical path as the current Activity will the current Activity be canceled upon rollback.
When viewing a Process Timeline definition, there will be an option to analyze the Process Timeline in the object menu at the upper right portion of the Timeline Definition screen. This analysis view will display data about average predicted run times and start and end dates compared to the configured run times and start and end dates.
A Timeline Analysis page will display the tasks in the Process Timeline definition, and will overlay average times and dates on the times and dates configured in the Process Timeline definition.
Triangles represent start and end dates for each process. If a triangle is red, it means that the start or end date for an Activity is happening after it was configured to. It doesn't mean that the Activity is taking longer than it was configured to. If a triangle is blue, it means that the start or end date is happening approximately when it was configured to happen, and if it is green, it means that it is happening before it was configured to happen.
A line between two triangles indicates the expected (weighted average historical) duration of the Activity, while its color denotes whether it is generally finishing late, early, or as planned. A red line means that the Activity is finishing later than planned; a blue line means that it is finishing as planned, and a green line means that it is finishing earlier than planned. A percentage number on an Activity bar indicates the percentage of time longer that the Activity takes to run than was planned. For example, a number of 80% indicates that the Activity takes 80% longer to run than planned, and a number of -24% indicates that the Activity completes in a time 24% shorter than planned.
Additional options are available by right-clicking the individual bars on the Timeline to bring up a pop-up menu.
Selecting the Properties menu item will display the normal Properties screen for this Timeline Activity.
Selecting the Show Dependencies menu item will display the color-coded view of the Timeline Activity's predecessors and successors.
The menu item will change slightly to analyze either tasks or users depending upon the Activity Type. For example, a user Activity will display a user analysis option, while a parent Activity will display a task analysis option. In either case, selecting the menu item will display an analysis screen that provides a snapshot of how the selected Activity is performing.
The Process Timeline Items page is what is presented to users that are participating in a Process Timeline Activity. This page displays all of the objects being routed in this Process Timeline (e.g. documents, Forms, etc.). A Process Timeline instance can contain multiple objects of any type. If the Form has an attach button, users in that Activity will be able to add objects to the Process Timeline instance. Each new object added is added to the Process Timeline Items page. If a user has Delete permission to the running Process Timeline they'll be able to remove objects from the Process Timeline instance.
To return from the Analysis view to the Process Timeline Definition view, click the Process Timeline Definition menu option.
Processes in Error #
It's not always easy for an administrator to determine if any running processes are in an error state. You can, however, easily create a Knowledge View to return only processes that are in an error state. In the example below, you can access a software simulation that walks through the process of creating a Processes In Error Knowledge View. You can run this Knowledge View at any time to see all of the errant processes on your system.
Process Timelines in the Content List #
Process Timeline Definitions are stored in the Content List just like any other object in the database. When a Process Timeline is started, an entry will be created under the Process Timeline Definition in the Content List as a child object. It will remain there even after the Process Timeline has completed. To access the child instances of a Process Timeline definition, Users can select the View CHilddren menu item from the hamburger menu ().
For versions below Process Director v6.0.300, users can click on the view children () icon next to the Process Timeline Definition name in the Content List. Users can also view the Process Timeline instance for any of the running or completed Process Timelines by clicking on the name or the icon in the Content List.
Viewing Running and Completed Process Timelines
If users have View Children permission to the Process Timeline Definition, they'll automatically be given View permission to any running and completed Process Timelines for that definition. The running and completed Process Timelines are displayed in the Content List showing status, what Activity is running and the user that initiated the Process Timeline.
Running and completed Process Timelines can also be made available to users through a Knowledge View. For example, if users have a need to see only certain types of running Process Timelines, a Knowledge View filter can show a list of the Process Timelines making the actual location of them in the Content List transparent.
Attaching New Process Timeline Objects
A running Process Timeline can allow users to add new objects (e.g. documents, Forms). If a user has an attach button on a Form, they'll be able to add new objects to the running Process Timeline. When a new document is added under the Process Timeline instance it will only be contained under the Process Timeline. The document won't exist anywhere else in the Content List.
When a reference (e.g. shortcut) to an existing object in the database is added, only a reference to the object will be created in the Process Timeline. A reference, or shortcut, is a symbolic link to the original object. Any changes made to the reference will also update the object it is pointing to, except in the case of a Form. If a reference to a Form is added to the running Process Timeline, an instance of the Form will be created and placed under the Process Timeline Items button.
Automatic Process Timelines for Folders
Process Director Process Timeline engine supports the ability to automatically start Process Timelines for certain document events within a folder. Automatic Process Timeline Definitions can be specified for any folder, on the folder's properties page. To see the folder properties, select the check box for the folder, then click the Properties action button.
A Process Timeline Definition can be associated with one of the following document actions:
- When a new document is added to a folder;
- When a document in a folder is updated and checked in;
- When a document is moved into a folder.
If one of these conditions is met, the appropriate Process Timeline will automatically be started against that document.
Running Process Timelines
A Process Timeline can be started by selecting the check box next to a Process Timeline definition in the Content List and choosing the Run Action Button. This will start a new instance of the Process Timeline immediately.
Changes to the Process Timeline Definition will affect all running Process Timelines. Please see the section on Changing Existing Processes for more detailed information.
Task Lists (To Do Lists)
Task Lists are fundamental to Process Timeline management systems. The Process Director Process Timeline engine supports an integrated Task List that provides each user with a list of their assigned tasks, according to priority and due date. As a user completes an assigned task, the item is automatically removed from their Task List.
Permissions and Running Process Timelines
A running Process Timeline will temporarily override the permissions for any object (document, Form, etc.) contained within it, giving the user the necessary access to perform the requested task. When users are assigned to a Process Timeline task, they'll automatically be given Modify permission to the objects until their task is completed. This prevents the object permissions from effecting running Process Timelines.
When Process Director detects a possible loop in a running process instance, it delays the process until the next time that the system's timers run. The system will display a message on the Timeline Status tab for the instance, indicating that the looping condition has been detected.
Running a Timeline from a URL #
Timelines can be run manually, or scheduled to perform an automatic actions. To schedule these Timelines, a web page (a Web Service web page) is executed to run a specific Timeline definition.
Ensure you have enabled Web Services on the Installation Settings page. You can optionally enable security restrictions and authentication. If you pass credentials on the URL, you'll need to set fWebServiceAllowCredentialsURL to true in the custom vars file.
Execute the following URL from a browser on the server that has Process Director:
Be advised that using the bpUSERID or bpPassword parameter requires sending the User ID and Password in clear text, so be mindful of the security implications of transmitting these values.
The wsTimeline.asmx command can take the following parameters on the QueryString URL:
- tlid: The Timeline ID of the Timeline Definition to run;
- bpUserid: A Process Director user ID with permission to run the Process Definition;
- bpPassword: A Process Director password with permission to run the Process Definition;
You may want to automatically schedule the Timeline to run at regular intervals (for example, every night at midnight). To do this, use the bputil.exe utility. This utility enables you to schedule and test commands executed on a regular basis.
Do not schedule IEXPLORE.EXE because the web browser will never close. Rather, use the bputil.exe command to run the web page. For example, enter this command in the “Run” dialog box to schedule the synchronization:
"PATH\bputil.exe" SU https://ServerName.com/services/wsTimeline.asmx/Run?tlid=TLID&bpUserid=USERID&bpPassword=PASSWORD
(Where PATH is the installation directory for Process Director, e.g. c:\Program Files\BP Logix\Process Director\). Enter the appropriate credentials in the Windows Scheduler when prompted. Use the “Schedule” tab to set the times to run the command. Consult the Microsoft help for more information on this utility.
Be advised that using the bpUserID or bpPassword parameter requires sending the User ID and Password in clear text, so be mindful of the security implications of transmitting these values.
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.