Using Custom Lifecycles in Patient Journey Steps
To enable distinct data models for patient programs, users can associate custom objects and lifecycles with Patient Journey Steps. This ensures accurate reporting for programs requiring specific details, for example titration, while also maintaining a unified workflow.
Who can use this feature?
- Business Admin Users – Browser
- Adding Custom Lifecycles to Patient Journey Steps
- End Users - Browser
- Using Custom Lifecycles
- Users require a Patient CRM License
Configuring Custom Lifecycles for
To configure this feature, ensure the following features are configured:
Adding Custom Lifecycles to Patient Journey Steps as
Business admin users can create and define custom objects and their associated lifecycles, then associate that object with a Patient Journey Step:
- Navigate to Admin > Configuration > Objects.
-
Create the appropriate custom object.
Ensure the name__v field on the custom object is system-managed.
- Navigate to Admin > Configuration > Objects > patient_journey_step__v > Object Types.
- Create a new object type with a name matching the custom object.
- Grant the new object type access to all of the same fields as the adherence__v object type, except for the adherence__v field.
- Navigate to Admin > Configuration > Objects > patient_journey_step_detail__v > Object Types.
- Create a new object type with a name matching the custom object.
- Grant the new object type access to all of the same fields as the adherence__v object type, except for the adherence__v field.
- Navigate to Fields.
-
Create an Object Reference field referencing the custom object.
Ensure the new field is made available to the newly created object type.
Creating the Custom Lifecycle
Once the object, fields, and object types have been defined, business admin users can create the appropriate custom lifecycle:
- Navigate to Admin > Configuration > Object Lifecycles.
-
Create the appropriate lifecycle for the custom object. See Configuring Object Lifecycles for more information on creating lifecycles for objects.
Ensure the lifecycle has matching Application Roles to support automatic Care Team assignment.
- Navigate to Admin > Configuration > Objects.
- Select the custom object.
- Update the object lifecycle to the newly created lifecycle.
- Ensure Matching Sharing Rules and/or Custom Sharing Rules are configured to appropriately share records of the custom object with Patient CRM users.
- Navigate to Business Admin > Patient Journey Steps.
- Edit or create the appropriate step.
- Select the newly created object type corresponding to the custom object.
- Select Continue.
-
Populate the following fields:
- Patient Journey – Select the appropriate Patient Journey
- Patient Journey Step Phase – Select the appropriate Patient Journey Step Phase
- Select Save.
Using Custom Lifecycles as
When end users and Care Team Members initiate a Patient Journey Step associated with a custom object and lifecycle, the necessary records for the custom object are automatically created and assigned appropriately.

