Skip navigation FileNet logo
Glossary  |  Help Directory  
  Help for Process Configuration Console
  Search  |  Index
Process Reference  
Process Configuration Console
Getting started
Isolated regions
Queues
  Manage user queues
  Configure work queues
    Create a work queue
    Modify queue properties
      Edit description
      Manage system fields
      Manage data fields
      Manage indexes
      Set security levels
      Define queue operations
    Move queues across servers
  Configure component queues
    Configure a component queue
    Define component queue operations
    Modify component queue properties
    Enable Content Engine operations
Rosters
VWServices
Process Engines
Workflow database
Events and statistics
   

Define queue operations

An operation is a function within a step processor that performs a specific task. In the Process Configuration Console, you can associate an operation with a queue. Before you can do so, you need the following details from the developer of each step processor that will use the operation:

  • The name of the operation
  • The name of each parameter that the operation expects, and an optional description
  • The data type of each parameter
  • How the data for each parameter passes between the operation and the work item

For more information, see About operations.

To add an operation

  1. If the Properties dialog box is not already displayed, select the icon of the queue you wish to modify and click Properties on the toolbar.
  2. Select the Operations tab.
  3. In the first available line in the Name box, enter the name of the operation. The name must conform to standard Process Engine naming conventions.
  4. TIP To copy from an existing operation, select the operation and click Copy .

  5. Optionally, enter an Operation Description for the highlighted operation.
  6. Add the parameters belonging to the operation.
  7. Click OK when done.
  8. Click Commit Changes on the toolbar to apply this change to your isolated region. You can commit the changes immediately, or you can wait until you have finished all your changes. You cannot delete an operation once it has been committed.

    NOTE The commit process suspends all other database transactions within the isolated region until it finishes. We strongly recommend that you accumulate all changes and commit them once when you're done, or that you commit changes when the isolated region is relatively inactive. Avoid committing changes after every modification whenever possible.

To delete an operation

  1. If the Properties dialog box is not already displayed, select the icon of the queue you wish to modify and click Properties on the toolbar.
  2. Select the Operations tab.
  3. Select the operation you want to delete, and click Delete .
  4. Click OK when done.
  5. Click Commit Changes on the toolbar to apply this change to your isolated region. You can commit the changes immediately, or you can wait until you have finished all your changes.

    NOTE The commit process suspends all other database transactions within the isolated region until it finishes. We strongly recommend that you accumulate all changes and commit them once when you're done, or that you commit changes when the isolated region is relatively inactive. Avoid committing changes after every modification whenever possible.

To add or delete a parameter in an operation

  1. If the Properties dialog box is not already displayed, select the icon of the queue you wish to modify and click Properties on the toolbar.
  2. Select the Operations tab.
  3. Select the operation whose parameters you want to change.
  4. To add a parameter, enter the following information in the Parameters box:
    • Name: The name must conform to standard Process Engine naming conventions.
    • Type: Select the data type of the parameter from the drop-down list.
    • Access: Select the direction of the data passing between the operation and the work item:
      • Read: A data value that passes from the work item to the operation.
      • Write: A data value that is generated by the operation and then passed to the work item.
      • Read/Write: A data value that passes from the work item to the operation, where it is processed and then passed back to the work item.
    • Description: Enter an optional description.
  5. To remove a parameter, click Delete.

    CAUTION Use caution when deleting parameters from and re-transferring an operation that already exists in the workflow database. If no work items have entered queue on which the operation is defined, you can safely delete operation parameters. However, if any work items have entered the queue and you subsequently delete an operation parameter, the commit action will fail.

  6. Click OK when done.
  7. Click Commit Changes on the toolbar to apply this change to your isolated region. You can commit the changes immediately, or you can wait until you have finished all your changes.

    NOTE The commit process suspends all other database transactions within the isolated region until it finishes. We strongly recommend that you accumulate all changes and commit them once when you're done, or that you commit changes when the isolated region is relatively inactive. Avoid committing changes after every modification whenever possible.

   

NOTE  When defining an operation and its parameters, the workflow author, workflow administrator, and application developer typically work together to determine its names and usage. A step processor must use the operation name when referencing the operation. In addition, the properties you enter for each parameter must correspond to the properties expected by a step processor processing work items in the selected queue.

TIP In general, operations are defined on queues for work items that will be processed by automated programs. Though less common, operations can also be defined on queues from which participants process work items, including user inboxes.

Related topics

Edit the description

Manage system fields

Manage data fields

Manage indexes

Set security levels