Sync (SYNC)

Sync objects help coordinate the processing of multiple executable objects. They are synchronization mechanisms that let you assign logical resources to certain processes based on how much they consume. Then they regulate the process flow by consuming and releasing these resources.

You use Sync objects to define states and status transitions that you link to actions and (optionally) to values. These definitions control when and how executable objects will be processed. You then assign the Sync object to the executable objects you want to control this way. You can assign a Sync object to as many other objects as you need. As soon as the executable objects are activated, the system checks what is the current state of the Sync object and, depending on the action (and value, if set) assigned to that state, the executable object is processed or not.

Example

Sync objects help you deal with cases like these:

• Two processes in your organization are completely independent from each other; you have created two Workflows to automate them, which also run independently. However, these processes share a Job, which is therefore included in both Workflows. You want the Job in one of the Workflows to be started only if it has already finished in the other one.
• You want to prevent too many concurrent processes against the database while preserving just-in-time execution.

See also Examples of Sync Objects.

First, you define the start state of a Sync object and determine what should be its subsequent state in case the first one is reached. Then, you associate states first to values and then to actions, thus establishing the dependencies you need:

1. In the Process Assembly perspective click Add Object. On the Add Object dialog, select Sync. For information on how to add objects, see Adding Objects.

   A Sync object definition is made up of the following pages:

   • Standard pages that are always available, no matter what type of object you are defining:

     • General Page
     • Version Management Page
     • Documentation Page
   • The object-specific page described here.

2. On the Object Name dialog enter the name of the new object. Choose it carefully. For more information, see Best Practices: Naming Conventions.

3. Click OK to open the object definition pages.

4. In the State Definition section define the states that can be assumed by the Sync object.

   1. Enter a state in the first input field.
   2. Optionally, enter a short description that helps you recognize the purpose of this state when you later on assign this object.
   3. Click the Add button to insert the state in the list below.
   4. If you want to edit this entry, click it to expand it in edit mode, for example:
   5. 
   6. Make your changes and click the icons on the right hand side to either confirm or cancel your changes, or to remove the entry from the list.

5. Optionally, assign values to the states in the Default/Current Settings section. The execution of the actions you define below depend on the values assigned to the states.

   1. Select an entry from the State dropdown list. It contains all the states you added in the previous section.
   2. Use the spin button or type to enter the Value you want to assign to the selected state.
   3. Click the Refresh button to display the current state and value of the Sync object.

6. In the Action Definition section you define the actions that can be called by an executable object and establish dependencies that determine when they can be called.

   1. Click on the first row of the Action Name column and type the name of the action. Make sure that you use short, descriptive names that you can easily recognize when assigning the Sync object to other objects.
   2. In the State column choose the state that the Sync object must have for this action to be executed.
   3. In the Value column you can (but must not) assign a value to this combination of action and state.
   4. Open the dropdown list to select a comparison operator and specify the value.
   5. In Change State to specify what should happen if the action reaches the state and value you have just entered. To do so, select a status from the dropdown list.
   6. Assign a value to this combination of action and state.
   7. Save the object.
   8. You can now assign it to other executable objects on their General > Sync page.

7. Save the object.

After defining and assigning Sync objects, you can check the executable objects that will be affected by them. Right-click the Sync object on the Explorer list in the Process Assembly perspective and select Monitoring > Open Sync Monitor.