Creating a Participant

Participants are used to identify who or what (a REST end-point or an e-mail server) performs an activity.

For more information, see the "Participants" topic in the TIBCO® BPM Enterprise Concepts Guide.

    Procedure
  1. In the Project Explorer, expand the package where you want to add a participant.
  2. Right-click Participants, click New and then, select Participant. The New Participant dialog box is displayed.
  3. Click the Back button to change either the name of the Project or Package where the participant is created. If you want to change any one of the names, click the Project or Package button respectively.

    Participants can be created at either the package level or at the process level. Creating them at the package level is recommended which ensures that they are shared among processes. Select the Process check box and specify a process if you want to create the participant at the process level.

    Note: If the Participants folder is empty at the Process level, it is hidden by default. This is because the preferred usage is to define Participants at the Package level.
    Click Next.
  4. Specify the Label and Name of the participant (either a Basic Type, or an External Reference as previously described in this section) and click Finish.
    To create a basic type participant, select Basic Type and choose from the System and Organization Model Query radio buttons, and click Finish.

    If you select the Organization Model Query radio button, you can then enter the Organization Model Query Script in Resource Query Language (RQL) by using a script or expression on 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 the Select a reference icon to select a type from the organization model.

    Choose a type from those shown in Matching items, or enter 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.

    Note:
    • 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.