Release notes
This topic contains the Spring '25 release notes for Komodo Care Connect. The release notes are organized into these high-level sections:
Installation and upgrades – link to install and/or upgrade to the new version.
New features – new features and functionalities released in the new version.
Updated features – updated features and functionalities released in the new version.
Defect fixes and maintenance – fixed defects and maintenance items within the new version.
Metadata changes – changes to the underlying data models, user permissions, or system configurations included within the new version.
Required pre-install & pre-upgrade actions – required actions administrators must take before installing or upgrading to the new version.
Required post-upgrade actions – required actions administrators must take after upgrading to the new version.
Deprecated and deleted items – components of the product that have been deprecated, removed, or retired from the new version.
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.

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.
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 ( | All child records of the losing care plan are populated with the winning patient account, including Consent ( WarningTo 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 ( | 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 ( | 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 ( | 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 ( | 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 ( | 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 ( | The Event ( |
PJN-3505 | Read-only users with the KCC - Read Only - Account Management ( NoteThis 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 ( NoteThis 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. NoteThe 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 ( | 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 | After Update: Cleanup Orphaned DCRs ( |
PJN-3676 | When recurring activities were created, the Case Owner ( | The Case Owner and Program Case DeveloperName fields have been added to the Recurring Case Clone Fields ( WarningTo 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 ( | 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:
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:
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 9, “New custom metadata fields”
Note
New custom metadata fields are available in the page layouts of initial installations of Komodo Care Connect but must be added manually to page layouts upon upgrades. For more information, reference the Required post-upgrade actions section below.
Table 11, “Modified custom metadata records”
Note
Existing custom metadata records must be updated manually upon upgrades. For more information, reference the Required post-upgrade actions section below.
Work item(s) | Custom metadata type(s) |
---|---|
PJN-3659 | mvn__PJN_Event_Configuration__mdt |
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 |
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 |
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 ( |
Dashboard and report changes are listed in the table(s) below:
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 |
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:
Work item(s) | Object | Lightning Web Component |
---|---|---|
PJN-3673 | N/A | pjnTodaysCasesProgressBar |
Object changes are listed in the table(s) below:
Table 17, “Modified object field sets”
Note
Existing field sets must be updated manually upon upgrades. For more information, reference the Required post-upgrade actions section below.
Work item(s) | Object |
---|---|
PJN-3605 | mvn__PJN_eRX_Request__c |
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 |
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 ( |
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:
Work item(s) | Permission set(s) |
---|---|
PJN-3735 | PJN_Read_Only_Run_Reports PJN_User_Run_Reports |
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.
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.
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.
Work item(s) | Object | Record type | Description |
---|---|---|---|
PJN-3605 | mvn__PJN_Event__c | PJN_External_Enrollment | An enrollment from an external source. |