Skip to main content

Release notes

This topic contains the Spring '25 release notes for Komodo Care Connect. The release notes are organized into these high-level sections:

As this page is maintained and updated over time to ensure accurate and timely information, Komodo Health recommends referencing the release notes online rather than printing and referencing static versions of the page. The Changelog page lists all notable changes made to this page.

For the release notes from earlier versions of Komodo Care Connect, visit the Archive.

Installation and upgrades

The Komodo Care Connect Spring '25 release can be installed with the Komodo Install Service at https://install.komodohealth.com/products/kcc/4.0.0.1. New installs of Komodo Care Connect will be on the latest release while current customers will need to run and deploy the latest update.

Note

If you are using the Komodo Install Service and installing Komodo Care Connect for the first time, do not select the "*For upgrades only ...*" step. This is an optional step for upgrades only and should be unchecked for new installs.

Warning

Remember to complete the steps in the Required pre-install & pre-upgrade actions and Required post-upgrade actions sections below as appropriate.

New features

The new release of Komodo Care Connect contains several new features whose functionalities are detailed below. Details about enablement and configuration are included within the product documentation.

New Home page and Today's Progress component

A new Home (PJN_Home) FlexiPage is available for users to quickly get started with their day. The Home page appears automatically when a user opens Komodo Care Connect and can also be accessed through Komodo Care Connect's navigation menu. By default, the Home page shows the user's progress for the day, most recent items, open enrollment requests, open cases, care plans by status, and open activities by subject. To display the user's progress for the day, the Home page uses the new Today's Progress (pjnTodaysCasesProgressBar) Lightning Web Component (LWC), which contains a progress bar that updates automatically to show how many cases a user has open and closed for the day. To display the user's care plans and activities, the Home page uses template reports that Komodo Care Connect offers out of the box and will add to in this new release, as described in the New dashboards and reports section below. For product documentation, including setup steps, reference Home page.

PSP_HomePage.png

Related work item(s): PJN-3673, PJN-3734

Start, skip, and remove multiple stages programmatically

Users have been able to manually start, skip, and remove individual stages from a single care plan via the action icons in the care plan progress bar. With the new release, users will now be able to programmatically start, skip, and remove multiple stages from multiple care plans via the new Care Plan API (PJN_CarePlanAPI) global Apex class. The Care Plan API class has an invocable method so that it can also be called from within a Salesforce Flow. For product documentation, reference Care Plan API.

Related work item(s): PJN-3241, PJN-3336, PJN-3662

Milestone event automation

Admin users can now automate the creation of events based on key milestones in a patient’s program journey. A new Event Automation Handler (PJN_EventAutomationHdlr) global Apex class is available to be called by either a Trigger Handler Setting (mvn__PJN_Trigger_Handler_Setting__mdt) metadata record or a custom trigger. The Event Automation Handler class retrieves a list of records from the new Event Configuration (mvn__PJN_Event_Configuration__mdt) custom metadata type on the triggered object to determine whether or not an event should be created. If so, then an Event (mvn__PJN_Event__c) record of the specified record type is created with the status and sub-status values specified on the event configuration and is related to the patient's Care Plan (Case) record. For product documentation, reference Milestone event automation.

Related work item(s): PJN-3659

Updated features

The new release of Komodo Care Connect also contains several improvements and optimizations to existing features and functionalities to better align with customer feedback and provide an enhanced user experience. Unless noted otherwise, all updated features are shipped "off" by default for existing customers and "on" by default for new customers.

Configure New Activity button for additional activities outside of care plan stages

There are two types of New Activity buttons in the care plan activity timeline that lets users add new activities to a care plan. The first enables users to add new activities to a specific care plan stage and has been configurable by the New Activity Button Override (mvn__PJN_New_Activity_Button_Override__c) field on the Program Problem (mvn__PJN_Program_Problem__mdt) custom metadata type. The second lets users add new activities to the overall care plan and is currently not configurable. In the new release, admin users can use the New Additional Activity Button Override (mvn__PJN_New_Addtnl_Activity_Button_Override__c) field on the Program (mvn__PJN_Program__mdt) custom metadata type to configure the label on the button as well as the type(s) of activity (i.e., Case record type) that can be created, similar to the New Activity Button Override field. For product documentation, reference Activities.

Related work item(s): PJN-3458

New dashboards and reports

In the new release Komodo Care Connect ships with six dashboards that provide overviews of different entities in the product as well as five new operational reports of Care Plan (Case) records grouped by different attributes. Additionally, two new permission sets, KCC - Read Only - Run Reports (PJN_Read_Only_Run_Reports) and KCC - User - Run Reports (PJN_User_Run_Reports), are available. The template dashboards and reports and the permission sets enable users to get quick insights into the data captured inside Komodo Care Connect. For product documentation, reference the Dashboards and reports page.

Related work item(s): PJN-3479, PJN-3481, PJN-3482, PJN-3483, PJN-3484, PJN-3485, PJN-3486, PJN-3735

Enhanced eRX feature

The electronic prescription enrollment (eRX) feature has been enhanced to capture and retrieve additional information via eRX API (PJN_ErxApi) calls as well as avoid duplicate records from getting created. For product documentation, reference Electronic prescription enrollment (eRX).

Capture and retrieve additional information

A new eRX Request (mvn_­_­PJN_­eRX_­Request_­_­c) custom object now stores the JSON payload that is passed in every eRX API call as well as the status of the care plan creation process. Files that are attached to the eRX request now also roll up to the parent care plan. Additionally, more fields have been added to the default eRX configuration, including email address, fax number, phone number, NPI number, and postal/zip code. This means that admin users no longer have to manually configure these fields to be available keys in the JSON payload.

Related work item(s): PJN-3492, PJN-3605

Deduplication logic

A general deduplication logic and a patient deduplication logic are available out of the box to help prevent eRX from creating multiple records with the same information or with information that already exists. The general deduplication logic defines a record as a duplicate if there exists another record in Komodo Care Connect of the same record type with the same value on a given field. However, admin users can create custom handlers to define duplicate records differently. The patient deduplication logic does not have a default configuration that defines a patient account as a duplicate, so admin users must create matching and duplicate rules that determine when a patient account is considered to be a duplicate. When the patient deduplication logic does find potential duplicate patient accounts, patient merge requests are automatically created.

Related work item(s): PJN-3490, PJN-3491

Defect fixes and maintenance

Table 5, “Fixed items details defects and maintenance items identified in V2, including V2.0.0, V2.1.0, V2.1.3, V2.1.4, V2.1.5, V2.2.0, V2.2.1, V2.2.2, and V2.2.3, that are fixed in the Spring '25 release.

Table 5. Fixed items

Work item

Description

New behavior

PJN-829

When two patient accounts and their care plans were merged with the Patient Merge Tool and the child records of the losing care plan were reparented to the winning care plan, none of the child records were populated with the winning patient account aside from Medical History (mvn__PJN_Medical_History__c) records. This was an issue particularly for Member Plan (mvn__PJN_Member_Plan__c) records because the Primary Member Plan (mvn__PJN_Primary_Member_Plan__c) and Secondary Member Plan (mvn__PJN_Secondary_Member_Plan__c) lookup fields on the Care Plan (Case) object had lookup filters that required a Patient (mvn__PJN_Patient__c) value. Since the winning patient was not populated on the member plans, the Patient value on the Member Plan records would be null and cause the entire merge to fail.

All child records of the losing care plan are populated with the winning patient account, including Consent (mvn__PJN_Contact_Point_Type_Consent__c), Event (mvn__PJN_Event__c), Fulfillment Request (mvn__PJN_Fulfillment_Request__c), Member Plan (mvn__PJN_Member_Plan__c), and Prescription (mvn__PJN_Prescription__c) records. Additionally, the lookup filters on the Case object for the primary and secondary member plans, like tertiary member plans, no longer require a patient value. Users can now merge member plans with the Patient Merge Tool even if the patient account on the member plan is not the winning patient.

Warning

To obtain the new behavior in an upgrade to the new release, you must complete the steps in the Required post-upgrade actions section below.

PJN-1446

The Program Case Dependency (mvn__PJN_Program_Case_Dependency__mdt) custom metadata type configures the dependencies between activities in a care plan stage. Previously, however, if an activity was dependent on multiple other activities, then the dependent activity would be created once every time the controlling activities were either canceled or completed. For example, if Case C was dependent on both Case A and Case B, then Case C would first be created after Case A was closed and then be created again after Case B was closed. This meant that there were duplicate dependent activities based on the number of controlling activities.

The logic behind program case dependencies has been updated. Now, if an activity is dependent on two or more other activities, then the dependent activity would be created after all of the controlling activities have been either canceled or completed. For example, if Case C is dependent on both Case A and Case B, then Case C will only be created after both Case A and Case B are closed. This means that the dependent activity will only be created once for the configured care plan stage.

PJN-1600

When the Contact Information - KCC Before Create Update (mvn__PJN_Contact_Information_Before_Create_Update) flow set the Value (mvn__PJN_Value__c) field on Contact Information (mvn__PJN_Contact_Information__c) records of the Address (PJN_Address) record type, the flow only used commas to concatenate and separate the different address field values. This meant that the generated address did not have proper spacing and was difficult to read (e.g., "123 Main St,The Loop,Chicago,IL,60606").

The flow has been updated to add a space after each comma so that the concatenated address appears more readable (e.g., "123 Main St, The Loop, Chicago, IL, 60606").

PJN-1997

If multiple objects have a record type with the same API name and an Enrollment Wizard Record Form (mvn__PJN_Enrollment_Wizard_Record_Form__mdt) metadata record references the record type API name for one of the objects, the step in the Enrollment Wizard that creates a record of that object would throw a “No form definition found” error, even if none of the other objects are used in the Enrollment Wizard.

The Enrollment Wizard now queries for the object that the record type is on so that it knows what record form to display.

PJN-3315

The ePA Information section in Prior Authorization (mvn__PJN_Prior_Authorization__c) record pages appeared empty for users who did not have electronic prior authorization (ePA) permissions. This was because the fields in the ePA Information section were only visible to users with ePA permissions.

The ePA Information section has been removed, and the fields that were originally in the ePA Information section have been moved to the System Information section in the Prior Authorization page layout.

The Related tab and the right-hand side of the Details tab of Assistance Program (mvn__PJN_Assistance_Program__c) record pages were both empty.

Both tabs have been removed, and the fields that were originally in the Details tab now span the entire width of the Assistance Program FlexiPage.

When users clicked the + Follow button that appeared in the top right corner of every Account record page, the label would change from "+ Follow" to "✓ Following" but nothing else seemed to happen.

The + Follow button was intended to be used with Chatter, which Komodo Care Connect does not utilize, and has therefore been removed from all Account FlexiPages.

PJN-3498

The records in the Events and Shipments related lists on the CarePlan (PJN_CarePlan) Lightning record page were not sorted in a consistent order.

The Event (mvn__PJN_Event__c) and Shipment (mvn__PJN_Shipment__c) records are sorted in descending order by their Name values, similar to how Member Plan (mvn__PJN_Member_Plan__c) and Coverage Investigation (mvn__PJN_Coverage_Investigation__c) records are sorted. Since the Name field is an auto-number field, this ensures that the most recent record appears at the top of the related lists on the Care Plan page.

PJN-3505

Read-only users with the KCC - Read Only - Account Management (PJN_Read_Only_Account_Management) permission set should not have been able to create new Contact Information (mvn__PJN_Contact_Information__c) records but were able to do so with the Contact Information (PJN_ContactInformation) component. The users subsequently encountered error messages when creating the Contact Information records, which were empty, and when opening the related Account records from Account Search.

Note

This issue was previously identified in KI-133.

The New button in the Contact Information component only appears for users who have Create and Edit permissions on the Contact Information object to prevent read-only users from creating empty Contact Information records.

PJN-3581

If a user clicked Create Care Plan in the Enrollment Wizard and then clicked either Cancel or X to close out of the wizard without completing the rest of the enrollment form, the Request (Case) record remained open in its original main tab.

Note

This issue was previously identified in KI-134.

If a user creates a care plan and then immediately exits out of the Enrollment Wizard, the request moves from its main tab into a subtab the same way that it does when a user completes the entire enrollment form.

Note

The other issue described in KI-134 where the care plan tab does not open automatically will be addressed in a subsequent release. Users can still open the care plan manually via the Parent Case field on the request.

PJN-3641

Users can create Contact Information (mvn__PJN_Contact_Information__c) records both through Account Search and through the Contact Information (PJN_ContactInformation) component on an Account record page, but the Contact Information fields that were marked as required differed in the two locations. For example, the New Address form in Account Search required users to populate the Address Line 1 and Type fields, but the New Address form in the Person Account record page did not have any required fields.

The same Contact Information page layout for each record type is now used in both Account Search and the Account record pages. In the default page layouts, the Address Line 1 and Type fields are required for Address records, the Email and Type fields are required for Email records, the Fax field is required for Fax records, and the Phone and Type fields are required for Phone records.

PJN-3667

The Start Pre-Install Validation button in the Komodo Install Service (or the Log In to Start Pre-Install Validation button if you have not yet authenticated into a Salesforce org) did not appear to perform any pre-installation check.

The pre-installation validation now checks that the connected Salesforce org is either an Enterprise Edition or an Unlimited Edition. If the connected Salesforce org does not meet this requirement, then the validation will throw an error and Komodo Care Connect cannot be installed.

PJN-3672

If a user tried to merge three patient accounts and created three requests with the Patient Merge Tool, the third patient merge request to be submitted still had the Pending status but would have one or more empty patient accounts. For example, a user may first create a request to merge Patient 1 and Patient 2, then create another request to merge Patient 1 and Patient 3, and then create a third request to merge Patient 2 and Patient 3. If the user submitted the second and third merge requests such that Patient 1 and Patient 2 were both merged into Patient 3 and were therefore the losing accounts, then the two patient accounts in the first merge request no longer existed. However, the first merge request still appeared in the Patient Merge Tool but without any patient accounts.

After Update: Cleanup Orphaned DCRs (PJN_After_Update_Cleanup_Orphaned_DCRs) is a new Trigger Handler Setting (mvn__PJN_Trigger_Handler_Setting__mdt) metadata record that calls the PJN_CancelOrphanedDCRs class to cancel any patient merge requests where one or both patient accounts no longer exist. In the aforementioned example, the status of the first merge request will change from Pending to Cancelled and the request will no longer appear in the Patient Merge Tool.

PJN-3676

When recurring activities were created, the Case Owner (OwnerId) and Program Case DeveloperName (mvn__PJN_Program_Case_DeveloperName__c) fields on the Activity (Case) records were empty, preventing certain functionalities from working as intended.

The Case Owner and Program Case DeveloperName fields have been added to the Recurring Case Clone Fields (mvn__PJN_Recurring_Case_Clone_Fields) field set on the Case object. This ensures that the values from the original activity are stamped on any recurring activities that are created.

Warning

To obtain the new behavior in an upgrade to the new release, you must complete the steps in the Required post-upgrade actions section below.

PJN-3815

When a patient was enrolled into a care plan, the Program (mvn__PJN_Program__c) field on the Request (Case) record remained empty.

When a patient is enrolled into a care plan, the original request is automatically stamped with the program of the care plan.



Metadata changes

The following subsections capture the changes against entities in key areas of Komodo Care Connect that have been introduced in the latest release. This list is not exhaustive, as it does not contain changes that are internal to the application and that are not exposed to customers for customization, extension, or integration.

Apex class changes are listed in the table(s) below:

Table 6. New Apex classes

Work item(s)

Apex class

PJN-3241, PJN-3336, PJN-3662

PJN_CarePlanAPI

PJN-3490

PJN_ErxDedupeIntf

PJN-3659

PJN_EventAutomationHdlr



Custom label changes are listed in the table(s) below:

Table 7. New custom labels

Work item(s)

Custom label(s)

PJN-1997

PJN_No_Form_Definition_Found

PJN-3490

PJN_eRx_Address_City_Required

PJN_eRx_Address_Country_Required

PJN_eRx_Address_Id_Required

PJN_eRx_Address_Line_1_Required

PJN_eRx_Address_Postal_Code_Required

PJN_eRx_Address_State_Required

PJN_eRx_Address_Type_Required

PJN_eRx_Email_Email_Address_Required

PJN_eRx_Email_Id_Required

PJN_eRx_Email_Type_Required

PJN_eRx_Payload_Data_Not_Set

PJN-3659

PJN_Event_Care_Plan_Id_Required

PJN_Event_Patient_Id_Required

PJN_Event_Record_Type_Not_Found

PJN-3673

PJN_Progress_Bar_Assistive_Text

PJN_Progress_Bar_Label



Custom metadata type changes are listed in the tables below:

Table 8. New custom metadata types

Work item(s)

Custom metadata type(s)

PJN-3659

mvn__PJN_Event_Configuration__mdt



Table 9. New custom metadata fields

Work item(s)

Custom metadata type(s)

Field(s)

PJN-3458

mvn__PJN_Program__mdt

mvn__PJN_New_Addtnl_Activity_Button_Override__c

PJN-3490

mvn__PJN_eRX_Field__mdt

mvn__PJN_Is_Additional_Field__c

mvn__PJN_Is_Deduplication_Field__c

mvn__PJN_eRX_Object__mdt

mvn__PJN_Dedupe_Interface__c

mvn__PJN_Overwrite__c



Table 10. New custom metadata records

Work item(s)

Custom metadata type

Metadata record name

PJN-3490

mvn__PJN_eRX_Field__mdt

PJN_Email

PJN_Fax

PJN_Phone

PJN_Physician_NPI

PJN_PostalCode

mvn__PJN_eRX_Object__mdt

PJN_Contact_Information_Email

PJN_Contact_Information_Fax

PJN_Contact_Information_Phone

PJN_Physician

PJN-3491

mvn__PJN_Trigger_Handler_Setting__mdt

PJN_After_Update_Patient_Duplicate

PJN_After_Insert_Patient_Duplicate

PJN-3492

mvn__PJN_File_Rollup_Setting__mdt

PJN_eRx_Request

mvn__PJN_Trigger_Handler_Setting__mdt

PJN_After_Update_File_Rollup_eRX

PJN-3672

mvn__PJN_Trigger_Handler_Setting__mdt

PJN_After_Update_Cleanup_Orphaned_DCRs



Table 11. Modified custom metadata records

Work item(s)

Custom metadata type

Metadata record name(s)

Modification description

PJN-829

mvn__PJN_Merge_Tool_Setting__mdt

PJN_Consent

PJN_Event

PJN_Fulfillment_Request

PJN_Member_Plan

PJN_Prescription

The Field API Name to Account (mvn__PJN_Field_API_Name_to_Account__c) value has been set to mvn__PJN_Patient__c.



Dashboard and report changes are listed in the table(s) below:

Table 12. New dashboards

Work item(s)

Folder

Dashboard(s)

PJN, 3481, PJN-3482, PJN-3483, PJN-3485, PJN-3486

KCC Operation Dashboards

KCC Operational Dashboard - Activities & Requests

KCC Operational Dashboard - Coverage & Assistance Programs

KCC Operational Dashboard - Patients & Consent

KCC Operational Dashboard - Care Plans, Stages, Events

KCC Operational Dashboard - Fulfillment Requests & Shipments

PJN-3484

KCC End User Dashboards

KCC End User Dashboard



Table 13. New reports

Work item(s)

Folder

Report(s)

PJN-3479

KCC Operational Reports

Care Plans by Access Type

Care Plans by Age

Care Plans by Owner

Care Plans by Physician

Care Plans by Status



Lightning Web Component changes are listed in the table(s) below:

Table 14. New Lightning Web Components

Work item(s)

Object

Lightning Web Component

PJN-3673

N/A

pjnTodaysCasesProgressBar



Object changes are listed in the table(s) below:

Table 15. New objects

Work item(s)

Object

PJN-3605

mvn__PJN_eRX_Request__c



Table 16. Modified object fields

Work item(s)

Object

Field(s)

Modification description

PJN-829

Case

mvn__PJN_Primary_Member_Plan__c

mvn__PJN_Secondary_Member_Plan__c

Updated the lookup filter so that PJN_Member_Plan__c.PJN_Patient__r.Id is optional.



Table 17. Modified object field sets

Work item(s)

Object

Field set

Modification description

PJN-3676

Case

mvn__PJN_Recurring_Case_Clone_Fields

The field set will include the Case Owner (OwnerId) and Program Case DeveloperName (mvn__PJN_Program_Case_DeveloperName__c) fields.



Table 18. Deprecated object record types

Work item(s)

Object

Record type

Description

PJN-3605

mvn__PJN_Event__c

PJN_External_Enrollment

An enrollment from an external source.



Permission changes are listed in the table(s) below:

Table 19. New permission sets

Work item(s)

Permission set(s)

PJN-3735

PJN_Read_Only_Run_Reports

PJN_User_Run_Reports



Table 20. Modified permission set groups

Work item(s)

Permission set group(s)

Modification description

PJN-3735

MVN_Read_Only_User

Added the PJN_Read_Only_Run_Reports permission set.

MVN_User

Added the PJN_User_Run_Reports permission set.



Required pre-install & pre-upgrade actions

This section includes the required actions administrators must take before installing and upgrading to the Komodo Care Connect Spring '25 release.

Enable Lightning Web Security

Lightning Web Security (LWS) must be enabled to install and upgrade to the Komodo Care Connect Spring '25 release. For instructions, reference Salesforce's documentation on how to Enable Lightning Web Security in an Org.

Required post-upgrade actions

This section includes the required actions administrators must take after upgrading to the Komodo Care Connect Spring '25 release.

Add new custom metadata fields to page layouts

New custom metadata fields must be manually added to page layouts upon upgrades. For the list of new custom metadata fields, reference Table 10, “New custom metadata records above.

Update Case field set

To ensure that the appropriate Case values are stamped from the original activity onto newly created recurring activities, add the following fields to the existing Case field set. This reflects the changes in Table 17, “Modified object field sets above.

Table 21. Case field set

Field set

Field(s)

mvn__PJN_Recurring_Case_Clone_Fields

mvn__PJN_Program_Case_DeveloperName__c

OwnerId



Update Merge Tool Setting custom metadata records

To use the Patient Merge Tool, update the following Merge Tool Setting (mvn__PJN_Merge_Tool_Setting__mdt) custom metadata records with the new values accordingly. These reflect the changes in Table 11, “Modified custom metadata records above.

Table 22. Merge Tool Setting custom metadata records

Record name

Field

New value

PJN_Consent

mvn__PJN_Field_API_Name_to_Account__c

mvn__PJN_Patient__c

PJN_Event

PJN_Fulfillment_Request

PJN_Member_Plan

PJN_Prescription



Deprecated and deleted items

The following entities have either been deprecated or deleted from the latest version of Komodo Care Connect and will no longer be available or supported in future releases.

Table 23. Deprecated object record types

Work item(s)

Object

Record type

Description

PJN-3605

mvn__PJN_Event__c

PJN_External_Enrollment

An enrollment from an external source.