Release Notes for Oracle Health Insurance Value-Based Payments Release 3.21.2.0.0

This document contains the release notes for Oracle Health Insurance Value-Based Payments Release 3.21.2.0.0.

NOTE

Version compatibility: Oracle Health Insurance Value-Based Payments Release 3.21.2.x is only compatible with other Oracle Health Insurance applications release version 3.21.2.x unless explicitly stated otherwise.

NOTE

In accordance with the OHI error correction policy (Document 1494031.1 on My Oracle Support), error correction support will be provided for this release and the previous two releases.

Enhancements

ID	Summary	Description	Included in Patch
CPN-1235	Remove codeDescr referenced types from contract page	JET support for LOV reftype type codeDescr is removed and is replaced by entity specific refType types.
NXT-20585	JET - Reference Sheet Page	A UI page to manage reference sheets is added to Claims, Policies, and Capitation JET application.
NXT-21417	PHI Audit logs must be written in the same transaction as PHI / PII access occurs	PHI logs were initially written to a local buffer file before being persisted in the database. For compliance it is required to persist PHI audit logs in the same transaction as PHI access occurs. If system property 'ohi.logging.target' is set to value 'database', OHI applications persist PHI access in the database as part of the HTTP API or ADF UI request in which PHI data was accessed. If the value for system property 'ohi.logging.target' is set to 'log', which is also the default if no value is specified, then PHI access continues to be logged using any configured Logback Appender for which the PHI filter is applied.
NXT-21687	Extend the length of Relation and Provider Identifier	This enhancement focuses on increasing the length of the Relation and Provider Identifiers from 30 to 100 char.Increased the length of the Identifier attribute from 30 to 100 char on the Relation Identifier entity. Increased the length of the Identifier attribute from 30 to 100 char on the Provider Identifier entity.
OIG-1446	Generate Signatures for Dynamic Logic as part of meta object creation	This enhancement adds the generation of skeleton dynamic logic groovy files along with generation of objects to assist in groovy coding. These signatures are generated as part of 'Generate Objects' feature in the View Objects page(ADF) and as part of the Objects Integration Point.
POL-6890	Retire Address Type Domain	In release 3.21.1, the fixed address type domain was replaced by a user configurable address type domain as a separate entity. The integration points and API supported both versions. From this release, the type attribute is removed.
POL-7036	LOV enhancement : Search on all the fields by default, the gear (for field selection) is made optional.	In JET application, LOVs have a field selection feature, the search is then performed on the selected fields. This selection feature is made optional. By default search will be enabled on all the properties. To enable this feature property propertySelection must be set to true in the lov floorplans.
POL-7040	Ability to make search criteria for quick search and LOVs mandatory	With this enhancement, it is possible to make criterion mandatory for quick search in pages and LOV search. This can be achieved by setting criteriaMandatory property in quick search / referenced property configuration to true.
POL-7124	Theming Changes to JET application	Oracle Javascript Extension Tool Kit ( JET) support for Alta Theme is deprecated with newer Oracle JET versions. A new theme - Redwood is now introduced from Oracle JET version 9. This theme is designed for better usability and responsiveness in comparison to Alta. In addition, to make use of newer and better components and features introduced with newer JET versions, it is important for the OHI application to be continuously on the latest version of JET, and therefore OHI javascript-based applications are now migrated to a new theme. Key changes : Overall color scheme Search page template Forms - Field layouts
POL-7238	Ability to specify whether a floorplan applies for create mode or not	Before this release, all the floorplans that are configured are shown under the "add"/"create" options. The user can make use of tagging to select appropriate detail object plans but it is not possible to further filter out floorplans that should be shown under the "add" action. This enhancement makes it possible that the floor plan is available for view/edit, but not for action create.
POL-7886	Extend dynamic Fields on Relation	The number of supported dynamic fields on relations entity are now increased from Small to Medium (which has - among others - 20 character dynamic fields)

Upgrade Steps for Installation

To perform the upgrade, perform the following steps:

1. Perform any pre-upgrade steps.

2. Stop all the managed nodes running the .existing version of the application.

3. Perform any pre-undeploy steps.

4. Undeploy the existing version of the application.

5. Back up the database.

6. Perform any post-undeploy steps.

7. Unpack the release bundle into a directory that we refer to as OHI_ROOT from now on.

8. Change Installation Configuration: In <OHI_ROOT>/util/install, make a copy of ohi_install.cfg.template and name it ohi_install.cfg.

9. Edit ohi_install.cfg to contain your specific database connection data and other configuration settings. The settings are explained in the file itself.

10. Make sure NO connections are present to the database using the OHI_xxx_USER account (where xxx is the abbreviation of the application)

11. Run the Upgrade script:

    1. Open a command window and browse to <OHI_ROOT>/util/install.

    2. Run the upgrade by executing ./ohi-update.sh .

12. Make the required changes to the ohi properties file

13. Perform any post-upgrade steps

14. Start WebLogic application server

15. Deploy the Application

16. Perform any post-deploy steps

Additional Upgrade Steps for Installation

The following phases are defined: pre-upgrade: Application is still running pre-undeploy: Application is stopped, but not undeployed. post-undeploy: Application is undeployed. Database is backed up post-upgrade: Released upgrade script has run. post-deploy: New application is deployed and is up and running.

The OHI Logback Database Appender can no longer be configured for logType 'phi'. Remove any appender of class 'com.oracle.healthinsurance.loggingsupport.appender.impl.OhiAppender' for logType 'phi' from the Logback configuration. To continue persisting PHI access in the database, set system property 'ohi.logging.target' to value 'database'. Note that use of the appender of class 'com.oracle.healthinsurance.loggingsupport.appender.impl.OhiAppender' for logType 'application' or logType 'dylo' is unaffected.

Run the following SQL statement as ohi_capitation_owner and commit any changes:

update log_phi_events
set    event_doc =
json_mergepatch(
json_mergepatch(
nvl(event_doc, '{}'), json_object('sourceapp' value nvl(json_value(event_doc, '$.sourceapp' returning varchar2(30 char)), 'capitation'))
), json_object('sourceappversion' value nvl(json_value(event_doc, '$.sourceappversion' returning varchar2(60 char)), 'pre-3.21.1.0.0'))
)
where  virtual_application is null
or     virtual_application_version is null;

Configuration Properties

Ref	Action	Subject	Description
NXT-21417	Added	ohi.logging.target	Defines the target for logging PHI access. Possible values are 'database', for logging to the database, or 'log' for logging PHI access to the Logback appender configured for it. Default value is 'log'.

Web Services

Ref	Action	Subject	Description
NXT-20585	Modified	referencesheetlines API	Added an operation to support collection patch
NXT-21417	Modified	logphievents API	The following attributes are removed: eventDoc; eventTimestamp; eventLevel; eventThread; contextItemId; contextItemType
NXT-21687	Modified	Provider Integration Point	The length of identifier attribute of provider identifier is extended to 100 characters
NXT-21687	Modified	Relation Integration Point	The length of identifier attribute of relation identifier is extended to 100 characters
POL-6890	Modified	addresses API	The type attribute on address is removed
POL-6890	Modified	Relation Integration Point	The type attribute on address is removed
POL-6890	Modified	relations API	The type attribute is removed
POL-7238	Modified	floorplans API	Added createEnabled attribute

Data Conversion

Ref	Action	Subject	Description
NXT-21417	Modified	Log PHI Events	Newly added attributes are derived from event_doc
POL-7238	Modified	Floor Plan	IND_CREATE_ENABLED is set to 'Y' for all floor plans with template set to 'HIERARCHICAL RECURSIVE'

Dynamic Logic

This section intentionally left blank.

UI Changes

Ref	Action	Subject	Description
NXT-20585	Added	FN0044 Reference Sheets	Reference Sheets page
POL-7036	Modified	All JET pages having LOV’s	By default search on all properties for an lov
POL-7040	Modified	All JET pages having Quick Search and LOV’s	Added criteriaMandatory property in Quick Search and LOV component
POL-7238	Modified	Floorplan	Floorplans with createEnabled set to false are not shown as an option under "create" (top-level") or "add" detail level

Deprecated items (to be removed in future release)

This section intentionally left blank.

Breaking Changes

Ref	Action	Subject	Description
NXT-21417	Modified	log_phi_events	Column event_doc is removed
POL-6890	Modified	addresses API	The type attribute is removed
POL-6890	Modified	Relation Integration Point	The type attribute on address is removed
POL-6890	Modified	relations API	The type attribute on address is removed

Bug Fixes

BugDB	SR	Internal	BP	Summary
30682384		CPN-1021		User is not able to update dimensions in rate schedule lines page as its disabled.
Description:		Rate schedule lines dimensions are disabled and user can not enter any details for the same on Rate Schedule Line page.
Resolution:		The user is now able to add rate schedule lines.
32007876		CPN-1161		Popup to add adjustments was not loading under contracts page
Description:		When user tries to add adjustment, page hangs on and user needs to refresh or logout
Resolution:		User is able to add adjustments
32007885		CPN-1164		Rate Schedule Lines - Add button on Rate Schedule lines is not working
Description:		Steps - Click on Manage Rate Schedules Menu Tile Click on Rate schedule lines object navigation link Click on add button for a rate schedule line. Result - Add button does not work
Resolution:		Add button on Rate Schedule lines is adding a new row and working as expected.
32007867		CPN-1166		Adjustment schedule line conveyor belt not loading the details for time periods
Description:		On Adjustment Schedule Line page, conveyor belt does not load the details for time periods or allow to add a new Adjustment line.
Resolution:		Adjustment schedule lines now show the details for the selected time period and allow the user to add a new adjustment line.
32585731		CPN-1436		User is able to update the enabled status of an identifier even after not having the update access
Description:		For both provider and relation identifiers it is not possible to update the identifier itself when a user is not having update access, however it is possible to update other attributes, like enabled and/or dynamic fields/records. This should not be allowed.
Resolution:		Removed restriction on update of identifier only: it now checks whether relation identifier/provider identifier is updated regardless.
32560865		CPN-1491		Issue with http api access restriction name 'base view generation IP'
Description:		The documentation incorrectly states that the name of the http api access restriction is 'base view generation IP' while it should be 'baseviewgenerations IP'
Resolution:		Documentation is corrected with the name of the http api access restriction as 'baseviewgenerations IP'
32574115		CPN-1498		Un saved popup is displayed while saving the provider group with required data.
Description:		When user try to save the Provider group details, page display confirmation message along with un-saved changes popup message.
Resolution:		Unsaved popup is not getting displayed after save now
32581687		CPN-1501		Create-form link shall not be available for baseviews, baseviewgeneration and baseviewcolumn resources
Description:		Before this release, create-form link is visible for baseviews, baseviewgeneration and baseviewcolumn resources. Also baseviewerrors is not listed as a resource.
Resolution:		Create-form links for baseviews, baseviewgeneration and baseviewcolumn resources are removed. Baseviewerrors resource is now listed as a resource.
32716009	3-25216584731	CPN-1541		Immediately after configuring these, change event rules generate change events
Description:		Configure an update change event rule with fields. Change the operational data immediately following the configuration. In that case the expected contract event was not generated. Only after restarting the system are contract events generated when operational data for which the change event was configured is changed.
Resolution:		A restart of the system is no longer required for update change event rules to generate contract events.
30271566		CPN-994		Member age range not visible on JET UI for Rate Schedule Lines
Description:		Member has age range and it is not visible in UI. At IP it is member age from and member age to is present.
Resolution:		Member age range is now visible in UI.
32007445		CPN-997		JET-Contract rate schedule lines do not show Rate schedule definition fields.
Description:		Its expected to see the Schedule definition fields in the contract rate schedule lines, which are not displayed currently.
Resolution:		The Schedule definition fields in the contract rate schedule lines are displayed as expected.

Issues that were backported in previous Release / Patch

No backports.

Known Issues

BugDB	SR	Internal	Summary
31520192		CPN-1105	Access: Application does not support portrait mode.
Description:		Application is not supporting portrait mode.
31539986		CPN-1109	Access: Users are not able to access menu items with 300% zoom
Description:		Access: On zooming in to 300% the menu items are not accessible.
31540050		CPN-1110	Access: Save status messages are not captured through screen reader
Description:		While saving, a save message is shown which is not being captured through screen reader.
31540221		CPN-1111	Access: Search and gear icon is not accessible on create and edit pages
Description:		User can not access search and gear icons for accessibility runs on create and edit pages
31540188		CPN-1112	Access: Advanced search functionality is not accessible on pages through keyboard.
Description:		Access: Advanced search functionality is not accessible on pages and users can not move to advanced search through keyboard.
32477683		CPN-1431	Base View Generator for Reference sheets is not supported
Description:		Reference sheet(line)s use a different storage structure (JSON) for the dynamic fields. The base view generator does not support that yet. So the reference sheet line columns can’t be queried using base views.
32945341		CPN-1613	New time periods and contract adjustments are showing after page refresh after navigating to other object navigation links (refresh issue)
Description:		New time periods and contract adjustments are showing after page refresh after navigating to other object navigation links (refresh issue)
28358450		CPN-231	Access: There is no high contrast mode enabled for Capitation JET UI.
Description:		There is no high contrast mode for Capitation JET UI. Investigate how to implement and apply high contrast mode for capitation
28393599		CPN-235	Access: No documentation to define for accessibility and compatibility features
Description:		No documentation to define for accessibility and compatibility features.
30087839		CPN-669	User receives "CPN-ASLN-001" error and error details on adjustment schedule lines while system does not indicate the line causing the error.
Description:		User receives "CPN-ASLN-001" error and error details on adjustment schedule lines while system does not indicate the line causing the error. { "errorDetails" : [ { "errorCode" : "CPN-ASLN-001", "title" : "CPN-ASLN-001: Exactly one of amount, percentage and function must be specified", "errorPath" : "$" } ] } It should be o:errorDetails, o:errorCode and so on. Also the errorPath should specify on which line the error is
29421521		CPN-890	Access: Accessibility issues in capitation UI 3.19.1.0.0
Description:		There have been number of observations during accessibility run for 3.19.1.0.0, which are documented in respective task for a suitable action.