Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 7 Working with Process Data : Creating a Participant

Creating a Participant
See "Participants" in the TIBCO Business Studio Concepts Guide.
To create a new participant:
1.
2.
Right-click Participants and select New > Participant. The New Participant dialog is displayed.
3.
Click the Back button if you need to change either the name of the Project and Package where the participant will be created. If you want to change either, click the Project or Package button.
Participants can be created at either the package level or at the process level. Creating them at the package level is recommended as it enables them to be shared amongst processes. Select the Process checkbox and specify a process if you want to create the participant at the process level.
4.
Click Next.
5.
Specify the Name and Type of the participant (either a basic type, or an external reference as described previously in this section) and click Finish.
To create a basic type, select Basic Type and choose from Role, Organization_Unit, Human, System and Organization Model Query, and click Finish.
If you select the Organization Model Query button, you can then enter the Organization Model Query Script in Resource Query Language (RQL) using a script or expression in the General tab of the Properties view. This is evaluated when a referencing task is executed at run-time, so the actual participant is resolved and the activity dispatched and offered to the participant. A query could resolve to a participant in the package/process or to an entity in the organizational model.
To create an external reference to an organization model, select External Reference, and click to select a type from the organization model.
Choose a type from those shown in Matching Items, or key in the first few characters of the name you are looking for in the field under Select type(s)(? = any character, * = any string and choose from those shown. Click OK.
The participant that you created appears in the Project Explorer.
You can import participants from other projects. At the process package level, right-click and select Import Participants Wizard. You can then select which project/s you wish to import participants from.
All external references to participants from within the same project must be to the same major version of the organization model. However, you can reference different minor or micro versions of the model. For example, if you have included a reference to a participant in version 1.0.0.qualifier of the organization model, and the model subsequently changes, you could reference a participant in version 1.1.0.qualifier, but not version 2.0.0.qualifier.
Associating Participants with Activities
You can associate a participant with an activity to identify who or what performs the activity. You can do this either by dragging and dropping the participant onto the activity or in the Properties view for the activity.
Drag and Drop
You can drag a participant onto an activity as follows:
1.
2.
You can select multiple participants for drag and drop operations using the Ctrl (for single selection) or Shift (to select a range) keys.
3.
Add Task Participant(s)  Selecting this option adds the participants to any existing participants for the activity.
Set Task Participant(s)  Selecting this option clears any existing participants associated with the activity, before setting the participants to those you selected.
Properties View
To associate a participant with an activity do the following:
1.
2.
The Select Participants dialog is displayed:
3.
Highlight participants you want to select and click Add to move them to the Selection column. When you have finished selecting Participants, click OK.
You can select multiple participants by pressing either the Ctrl (for single selection) or Shift (to select a range) keys while making your selection.
The wildcard ? returns all matching participants. Use the * wildcard to restrict the results (for example, *2 to return all Participants ending in 2. Note that the wildcard * by itself does not return any results; it only works in conjunction with a string.
4.
Highlighting Participants
To see what tasks a participant is assigned to, click in the Process Editor for the process. On the toolbar, you will see a button:
Click on this to see the dropdown, and select Enable Highlighting.
Alternatively, you can select Diagram > Highlighting > Enable Highlighting.
Select the participant in Process Explorer, and in the Process Editor the tasks which use this participant will be highlighted (framed with green lines). Other tasks in the process will be grayed out.
This behavior also applies to data fields and parameters.
Highlights are cumulative.
The current highlight filter is shown when you use the Process Editor mouse-over tooltip.
Highlights are removed when anything other than the highlighted diagram objects are selected.
Exporting Participants to an Organization Model
To create an organization model based on the participants in a process package, or a number of process packages, use the procedure described in this section.
1.
2.
3.
The existing participants are changed from basic types to external references to the organization model.
Participant to Organization Model Mapping
The following table shows how participants that are not referenced in a process appear in the exported organization model.
The following table shows how participants that are referenced in the process (for example, in a user task) appear in the exported organization model.
Using Participants to Create Tasks
If you have participants, you can drag them to a blank area of a process to automatically create several types of task:
1.
You can select multiple participants for drag and drop operations using the Ctrl (for single selection) or Shift (to select a range) keys.
2.
Create User Task For Participant(s)  Selecting this option creates a user task with the selected participants.
Create Service Task For Participant(s)  Selecting this option creates a service task with the selected participants.
Create Manual Task For Participant(s)  Selecting this option creates a manual task with the selected participants.
Other Task Types  This submenu contains more task types that you can create from a participant.
Deleting Data Fields, Parameters, Participants, and Type Declarations
You can delete a project object such as a data field, parameter, participant, or type declaration by right-clicking it in the Project Explorer and selecting Delete. However, if the project object has been associated with another object such as an activity or a sequence flow, the following message is displayed:
If you click Yes, the project object (in this example, a data field) is deleted, but it will still be referenced in XPDL for the project, which can cause problems. If you click No, the project object is not deleted. You can then go to the Properties view and examine the references to that object:
In this example, the data field is referenced in the service task RequestForAppointment and in the user task ShowAppointmentDetails. Click Go To to show that task in the Process Editor.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved