Define Lifecycle Properties for a Business Object

Use the Lifecycle page in the Business Object Properties window to define which Field holds the lifecycle state value, the list of lifecycle states, and whether records are automatically added to or removed from Queues based on lifecycle states.

Note for new Business Object lifecycle (CSM 10.2.0 or later)

For CSM 10.2.0 or later versions, use the Business Object Lifecycle Editor to add a lifecycle to a Business Object. See: Open the Lifecycle Editor.

Lifecycle states can be used throughout the system to determine behaviors. For example, you can define automatic Actions that are executed when a record changes states, require a Field to contain a value before a record can change states, or order the lifecycle states in a Lookup Object and then use it to validate Status fields.

To define lifecycle properties for a Business Object:

1. Open the Business Object Properties window:
   1. In the CSM Administrator main window, click the Blueprints category, and then click the Create a New Blueprint task. If you are working on a saved Blueprint, open the existing Blueprint.

      The Blueprint Editor opens, showing the Object Manager in its Main Pane. The Object Manager lists the existing Business Objects.

   2. In the Object Manager, click a Business Object in the Object tree, and then click the Edit Business Object task in the Structure area.
   3. Click the Bus Ob Properties button.
2. Select the Lifecycle page.
3. Select the Has Lifecycle check box.
4. Define lifecycle states for the Business Object:
   • State Field: In the drop-down, select a Field (example: Status) to hold the value (example: New, In Progress, Closed, etc.) of the lifecycle state.
   • States: Lists the lifecycle states that have been defined for the Business Object. You can add, edit, or delete lifecycle states.
   • Final State: Click this button to designate a selected lifecycle state that generally indicates that a Business Object record has completed its lifecycle. Common values include Closed, Retired, or Completed.
   • Recall State: Click this button to designate a selected lifecycle state that indicates that a Business Object record that was in a final state has been reopened. This allows for special behavior and security to limit who can recall a record and what can be done with a recalled record.
   • Clear State: Click this button to clear the final or recall designation from a selected lifecycle state. The Clear State button is only active if you have a final or recall state selected.
   • Not in Final State Text: Provide text that describes Business Object records that are not in a final state (example: Open). This is useful for Search Groups (example: A search for Open Incidents will return all Incident records in a state other than Closed, which is the final state). If a specific value is not provided, the system will build a string based on the final state (example: Not closed).
   • Show Goto Final State Option in Application (the gavel): Select this check box to display the Gavel button on the CSM Desktop Client toolbar. Users can click this button as a shortcut option to put Business Object records in a final state.
5. Define Queue options based on the defined lifecycle states. This allows Business Object records to be automatically added to or removed from Queues when their states change. These options are only available if Uses Queues is selected on the General page in the Business Object Properties window.
   • Auto-add to User Queue: Select this check box to automatically add a Business Object record to the User’s Queue when it enters its initial lifecycle state and the record is associated with a particular User.
   • Remove from User Queue when put in Final State: Select this check box to automatically remove a Business Object record from the User’s Queue when it reaches a final state.
     • Field with User ID: In the drop-down, select the Business Object Field that holds the ID of the User.
   • Auto-add to Team Queue: Select this check box to automatically add a Business Object record to a Team’s Queue when it enters its initial lifecycle state and the record is associated with a particular User.
   • Remove from Team Queue when put in Final State: Select this check box to automatically remove a Business Object record from the Team’s Queue when it reaches its final state.
     • Field with Team ID: In the drop-down, select the Business Object Field that holds the ID of the Team.
   • Remove from All Queues when put in Final State: Select this check box to automatically remove a Business Object record from all Queues when it reaches its final state.

6. Select OK.

7. Publish the Blueprint (File > Publish Blueprint) to commit the changes, or save the Blueprint (File > Save Blueprint) to continue making other changes.