Defining Lifecycle Stages for Events

  • Browser (Lightning)

Events Management administrators can map their organization’s event statuses to standardized lifecycle stages that display when viewing an event. This allows event team members to visualize the current event stage within the lifecycle of the event workflow.

For example, if you organized a new Speaker Program event, the lifecycle component displays the event as Requested. When the event is submitted for approval, the event’s status updates to Pending Compliance, a custom event status at your company mapped to the standard Pending Approval lifecycle stage. The lifecycle component updates to Pending Approval, letting you know that after approval is granted, you can execute the event.

Configuration

Before configuring this feature, ensure the following prerequisite features are also enabled:

To configure this feature:

  1. Grant admins the following permissions:

    Object

    OLS

    Record Types

    Fields

    FLS

    EM_Stage_Configuration_vod

    CRUD

    Stage_Configuration_vod

    • Event_Rule_vod
    • Stage_vod
    • Statuses_vod

    Edit

    EM_Event_Rule_vod

    CRUD

    Stage_Settings_vod

    n/a

    n/a

    EM_Event_History_vod

    CRUD

    Stage_History_vod

    • Event_vod
    • Action_Datetime_vod
    • Action_Type_vod
    • Starting_Stage_vod
    • Ending_Stage_vod

    Edit

    EM_Event_vod

    CRUD

    n/a

    • Stage_vod
    • Stage_Setting_vod

    Edit

  2. Grant end users the following permissions:

    Object

    OLS

    Record Types

    Fields

    FLS

    EM_Stage_Configuration_vod

    R

    n/a

    • Event_Rule_vod
    • Stage_vod
    • Statuses_vod

    Read

    EM_Event_Rule_vod

    R

    n/a

    n/a

    n/a

    EM_Event_History_vod

    R

    Stage_History_vod

    • Event_vod
    • Action_Datetime_vod
    • Action_Type_vod
    • Starting_Stage_vod
    • Ending_Stage_vod

    Read

    EM_Event_vod

    CRU

    n/a

    • Stage_vod
    • Stage_Setting_vod

    Edit

  3. Assign the Stage Setting EM_Event_Rule_vod page layout to admins.
  4. Ensure all appropriate Stage_vod picklist values are allowed for each EM_Event_vod record type.

Defining Stages for Events

Lifecycle stage mappings are determined by an EM_Event_Rule_vod record associated with the event. This record determines displayed lifecycle stages and the event statuses mapped to each stage.

Lifecycle stages display in a preset order. Stages can be relabeled, but custom values are not supported.

To define lifecycle stages:

  1. Navigate to the appropriate EM_Event_Configuration_vod record.
  2. Select New in the Event Rules related list.
  3. Select Stage Settings for the record type.

  4. Select Continue.
  5. Enter the appropriate Country Override, if applicable.
  6. Select Save.
  7. Select New Event Stage Configuration.
  8. Populate the following fields:

    • Stage_vod – Available values are:
    • Requested
    • Pending Approval
    • Approved
    • Execute
    • Completed
    • Closed
    • Statuses_vod – A comma delimited list of the appropriate values from the Status_vod picklist on the EM_Event_vod object. For example:

      Requested_vod,Draft_vod

      Canceled_vod status should be configured in the Closed stage.

  9. Select Save.
  10. Repeat this process for all desired lifecycle stages.

If a stage is not applicable to your organization’s event workflow, it can be excluded. Stages without mapped statuses do not display on events.

Creating the Path Element

After all lifecycle stages have been defined, admins can add the Salesforce Path element to the EM_Event_vod object page layout:

  1. Navigate to Setup > Path Settings.
  2. Create a new Path for the appropriate EM_Event_vod record types.

    The Key Fields, Guidance for Success, and Celebrations components of Salesforce Paths are not supported.

  3. Add the newly created Path component to the EM_Event_vod object Lightning record page layout.

  4. Select the Hide Path Update Button check box.

Viewing Lifecycle Stages in an Event

Once at least two lifecycle stages are defined, the lifecycle component displays on new events. Otherwise, it does not display.

When an event is created, the Stage_Setting_vod and Stage_vod fields on EM_Event_vod are stamped based on the configured EM_Event_Rule_vod records.

Existing events may have these fields as blank. To display the lifecycle stages in these events, update existing events to populate these fields.

The current stage of the event is determined by the Event Lifecycle Stage mapped to the event’s Status_vod field. When the user updates the event status and lifecycle stage, for example, if the user submits the event for approval, the lifecycle stage updates accordingly.

Whenever an event changes lifecycle stages, a Event_Stage_History_vod type EM_Event_History_vod record is created to track when the event changed lifecycle stages.