Release Notes for Oracle Health Insurance Authorizations Release 3.21.3.0.0

This document contains the release notes for Oracle Health Insurance Authorizations Release 3.21.3.0.0.

NOTE: Version compatibility: Oracle Health Insurance Authorizations Release 3.21.3.x is only compatible with other Oracle Health Insurance applications release version 3.21.3.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
NXT-19284	File Imports should support JSON file content	OHI Applications have JSON as their preferred mode of communication. However currently file exchanges don’t support the JSON media type. With this enhancement, OHI will start supporting JSON as a file media type.
NXT-21759	Enable search on flex code descriptor through flexcodes query api	This enhancement makes it possible to search on the flex code descriptor field through query API. The descriptor is made as fixed character field in the data model.
NXT-21834	Introduce retry mechanism for dynamic logic import in configuration migration tool	Dynamic logic can refer to another dynamic logic and if the dynamic logic are not imported in the correct order using configuration migration tool, the dynamic logic import fails. This enhancement introduces automatic retry mechanism of dynamic logic.
NXT-21907	Upgrade to groovy 3	As of major release 3.21.3.0.0 OHI applications (are certified to) work with Groovy 3
NXT-22371	Log Member Related IP Activity	Resource auditing feature which monitors user access and user updates to protected health information (PHI) and personally identifiable information (PII) is extended to Relations IP
NXT-23323	Data Exchange/CMT Export/Import notifications should be in common notification structure	Introduced common notification structure which has fixed number of attributes and can be sent in any format (JSON, XML etc.) Introduced new property "ohi.datasetoperations.notification.common.structure" to support both, old as well as new notification structure. It accepts boolean value as "true" or "false". "true" indicates notification should be sent in new notification structure. If property has a value as "false" or has not been set, old notification structure is used always.
OIG-1447	Generate Audit Trail in CMT	This enhancement enables creation of an audit log of what changes happened in a CMT import. This helps the customers to ascertain, if the changes are inline with what was expected, and to also determine the affected usecases for testing. It is switched off by default.
POL-4930	Dynamic Field Configuration Pages	This enhancement introduces new JET pages to configure the following entities: Fields, Flex Code Definitions, Flex Codes, Flex Code Groups, Flex Code Sets, Record Definition and Usages.
POL-5895	Bookmarks	It is now possible to bookmark a page within the JET application. Bookmarks are accessible in the primary navigation menu.
POL-8641	Additional Dynamic Fields on Registration	The registration entity has been extended to support with additional single value non time valid dynamic fields.

Summary

Description

Included in Patch

NXT-19284

File Imports should support JSON file content

OHI Applications have JSON as their preferred mode of communication. However currently file exchanges don’t support the JSON media type. With this enhancement, OHI will start supporting JSON as a file media type.

NXT-21759

Enable search on flex code descriptor through flexcodes query api

This enhancement makes it possible to search on the flex code descriptor field through query API. The descriptor is made as fixed character field in the data model.

NXT-21834

Introduce retry mechanism for dynamic logic import in configuration migration tool

Dynamic logic can refer to another dynamic logic and if the dynamic logic are not imported in the correct order using configuration migration tool, the dynamic logic import fails. This enhancement introduces automatic retry mechanism of dynamic logic.

NXT-21907

Upgrade to groovy 3

As of major release 3.21.3.0.0 OHI applications (are certified to) work with Groovy 3

NXT-22371

Log Member Related IP Activity

Resource auditing feature which monitors user access and user updates to protected health information (PHI) and personally identifiable information (PII) is extended to Relations IP

NXT-23323

Data Exchange/CMT Export/Import notifications should be in common notification structure

Introduced common notification structure which has fixed number of attributes and can be sent in any format (JSON, XML etc.) Introduced new property "ohi.datasetoperations.notification.common.structure" to support both, old as well as new notification structure. It accepts boolean value as "true" or "false". "true" indicates notification should be sent in new notification structure. If property has a value as "false" or has not been set, old notification structure is used always.

OIG-1447

Generate Audit Trail in CMT

This enhancement enables creation of an audit log of what changes happened in a CMT import. This helps the customers to ascertain, if the changes are inline with what was expected, and to also determine the affected usecases for testing. It is switched off by default.

POL-4930

Dynamic Field Configuration Pages

This enhancement introduces new JET pages to configure the following entities: Fields, Flex Code Definitions, Flex Codes, Flex Code Groups, Flex Code Sets, Record Definition and Usages.

POL-5895

Bookmarks

It is now possible to bookmark a page within the JET application. Bookmarks are accessible in the primary navigation menu.

POL-8641

Additional Dynamic Fields on Registration

The registration entity has been extended to support with additional single value non time valid dynamic fields.

Upgrade Steps for Installation

To perform the upgrade, perform the following steps:

Perform any pre-upgrade steps.
Stop all the managed nodes running the .existing version of the application.
Perform any pre-undeploy steps.
Undeploy the existing version of the application.
Back up the database.
Perform any post-undeploy steps.
Unpack the release bundle into a directory that we refer to as OHI_ROOT from now on.
Change Installation Configuration: In <OHI_ROOT>/util/install, make a copy of ohi_install.cfg.template and name it ohi_install.cfg.
Edit ohi_install.cfg to contain your specific database connection data and other configuration settings. The settings are explained in the file itself.
Make sure NO connections are present to the database using the OHI_xxx_USER account (where xxx is the abbreviation of the application)
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 .
Make the required changes to the ohi properties file
Perform any post-upgrade steps
Start WebLogic application server
Deploy the Application
Perform any post-deploy steps

Configuration Properties

Ref	Action	Subject	Description
NXT-21834	Added	ohi.cm.dynamiclogic.import.maxretrycount	Dynamic logic can refer to another dynamic logic and if the dynamic logic are not imported in the correct order, the compilation will fail. If it happens, CMT process retries the failed dynamiclogic. This property determines how many times the dynamic logic import is retried before marking it as 'errored' Suggested is a value between 1 and 9. Default value is 3
NXT-21834	Added	ohi.cm.dynamiclogic.retry.import.batch.size	Defines the batch size that should be read for the failure log table at a time. Default value is 100
NXT-23323	Added	ohi.datasetoperations.notification.common.structure	Can be set as "true" or "false". "true" indicates notification should be sent in new structure otherwise in old structure

Ref

Action

Subject

Description

NXT-21834

Added

ohi.cm.dynamiclogic.import.maxretrycount

Dynamic logic can refer to another dynamic logic and if the dynamic logic are not imported in the correct order, the compilation will fail. If it happens, CMT process retries the failed dynamiclogic. This property determines how many times the dynamic logic import is retried before marking it as 'errored' Suggested is a value between 1 and 9. Default value is 3

NXT-21834

Added

ohi.cm.dynamiclogic.retry.import.batch.size

Defines the batch size that should be read for the failure log table at a time. Default value is 100

NXT-23323

Added

ohi.datasetoperations.notification.common.structure

Can be set as "true" or "false". "true" indicates notification should be sent in new structure otherwise in old structure

Web Services

Ref	Action	Subject	Description
AUT-2142	Modified	RELATION_IMPORT Activity	Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible values as person or organization
AUT-2142	Modified	DIAGNOSIS_IMPORT Activity	Now supports JSON file content for data file
AUT-2142	Modified	REGISTRATION_IMPORT Activity	Now supports JSON file content for data file
AUT-2142	Modified	PROVIDER_IMPORT Activity	Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible values as individualProvider or organizationProvider.
AUT-2142	Modified	PROCEDURE_IMPORT Activity	Now supports JSON file content for data file
AUT-2142	Modified	INSURABLEOBJECT_IMPORT Activity	Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible value from any of the insurable object type.
NXT-19284	Modified	REFSHEETLINE_IMPORT Activity	Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible value as the usage name.
NXT-21759	Modified	flexcodes API	Supports descriptor field in two ways: as identified as a descriptor and as identified by the flex code field usage name
NXT-21759	Modified	flexcodes Query API	It is now possible to search descriptor field
OIG-1447	Added	audittraildetails API	New API
OIG-1447	Added	audittrails API	New API
OIG-1447	Modified	datasetprocesses API	The link to the change log is made available through the response on a GET operation
OIG-1447	Modified	Data Set Operations Integration Point	New attribute enableAuditTrail is added to "Import From File" and "Import From Environment" operations
POL-4930	Modified	flexcodes API	The generic flexcodes API collection patch threw an 'operation not found' error, this is now fixed.
POL-5895	Added	bookmarks API	Added new resource for bookmarks
POL-5895	Modified	userpreferences API	Added bookmarks as child list

Ref

Action

Subject

Description

AUT-2142

Modified

RELATION_IMPORT Activity

Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible values as person or organization

AUT-2142

Modified

DIAGNOSIS_IMPORT Activity

Now supports JSON file content for data file

AUT-2142

Modified

REGISTRATION_IMPORT Activity

Now supports JSON file content for data file

AUT-2142

Modified

PROVIDER_IMPORT Activity

Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible values as individualProvider or organizationProvider.

AUT-2142

Modified

PROCEDURE_IMPORT Activity

Now supports JSON file content for data file

AUT-2142

Modified

INSURABLEOBJECT_IMPORT Activity

Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible value from any of the insurable object type.

NXT-19284

Modified

REFSHEETLINE_IMPORT Activity

Now supports JSON file content for data file. Attribute "elementType" needs to be included with each element in the list with possible value as the usage name.

NXT-21759

Modified

flexcodes API

Supports descriptor field in two ways: as identified as a descriptor and as identified by the flex code field usage name

NXT-21759

Modified

flexcodes Query API

It is now possible to search descriptor field

OIG-1447

Added

audittraildetails API

New API

OIG-1447

Added

audittrails API

New API

OIG-1447

Modified

datasetprocesses API

The link to the change log is made available through the response on a GET operation

OIG-1447

Modified

Data Set Operations Integration Point

New attribute enableAuditTrail is added to "Import From File" and "Import From Environment" operations

POL-4930

Modified

flexcodes API

The generic flexcodes API collection patch threw an 'operation not found' error, this is now fixed.

POL-5895

Added

bookmarks API

Added new resource for bookmarks

POL-5895

Modified

userpreferences API

Added bookmarks as child list

Data Conversion

Ref	Action	Subject	Description
NXT-21759	Modified	COD_FLEX_CODES_TL	A new column with name descriptor is added to store the descriptor value . Updated existing flex codes to store descriptor values in the new descriptor column. Before this release, it was possible that a descriptor is a character or number or date value. If it is a number value, it is converted into a string format. If it is a date value, it is converted into a string value in YYYY-MM-DD format
NXT-21759	Modified	COD_FLEX_CODE_FIELD_USAGES_B	For flex code field usages using number/date field as descriptor field, the field reference is set to C1000

Ref

Action

Subject

Description

NXT-21759

Modified

COD_FLEX_CODES_TL

A new column with name descriptor is added to store the descriptor value . Updated existing flex codes to store descriptor values in the new descriptor column. Before this release, it was possible that a descriptor is a character or number or date value. If it is a number value, it is converted into a string format. If it is a date value, it is converted into a string value in YYYY-MM-DD format

NXT-21759

Modified

COD_FLEX_CODE_FIELD_USAGES_B

For flex code field usages using number/date field as descriptor field, the field reference is set to C1000

Dynamic Logic

This section intentionally left blank.

UI Changes

Ref	Action	Subject	Description
NXT-21759	Modified	Flex Codes Page	A new column with name descriptor is added to store the descriptor value in Flex Codes Table. Before this release, LOV on flex codes assume dyn_char_001 by default to be a descriptor, this is now changed to refer to the fixed descriptor field.
NXT-21759	Modified	Flex Codes LOV JET	Descriptor field is added to the search in flexcodes LOV and flex code definition code is removed.
POL-4930	Added	Jet UI - Configuration - Extensibility	Added 6 new Jet Pages for Field Definitions, Flex Code Definitions, Flex Code Groups, Flex Code Sets, Record Definition and Usages.
POL-5895	Added	bookmarks	Added bookmarks in navigation bar. Under bookmarks, alias and remarks are displayed and clicking on alias navigates to the corresponding bookmarked page.
POL-5895	Added	bookmarks icon	Added bookmarks icon in the header bar on clicking of which a page can be bookmarked and its possible to set alias and remarks and edit and remove them.

Ref

Action

Subject

Description

NXT-21759

Modified

Flex Codes Page

A new column with name descriptor is added to store the descriptor value in Flex Codes Table. Before this release, LOV on flex codes assume dyn_char_001 by default to be a descriptor, this is now changed to refer to the fixed descriptor field.

NXT-21759

Modified

Flex Codes LOV JET

Descriptor field is added to the search in flexcodes LOV and flex code definition code is removed.

POL-4930

Added

Jet UI - Configuration - Extensibility

Added 6 new Jet Pages for Field Definitions, Flex Code Definitions, Flex Code Groups, Flex Code Sets, Record Definition and Usages.

POL-5895

Added

bookmarks

Added bookmarks in navigation bar. Under bookmarks, alias and remarks are displayed and clicking on alias navigates to the corresponding bookmarked page.

POL-5895

Added

bookmarks icon

Added bookmarks icon in the header bar on clicking of which a page can be bookmarked and its possible to set alias and remarks and edit and remove them.

Deprecated items (to be removed in future release)

Ref	Action	Subject	Description
NXT-23323	Modified	Data Set Operations Integration Point	From this release, the notification can be sent in the new or common format. If property "ohi.datasetoperations.notification.common.structure" is not set or set to false, old format is always used. If property "ohi.datasetoperations.notification.common.structure" is set to true, new or common format is used. This property will be removed in a future release and from that release onwards, the data set operations notification will be sent only in the new or common format.

Ref

Action

Subject

Description

NXT-23323

Modified

Data Set Operations Integration Point

From this release, the notification can be sent in the new or common format. If property "ohi.datasetoperations.notification.common.structure" is not set or set to false, old format is always used. If property "ohi.datasetoperations.notification.common.structure" is set to true, new or common format is used. This property will be removed in a future release and from that release onwards, the data set operations notification will be sent only in the new or common format.

Breaking Changes

This section intentionally left blank.

Bug Fixes

BugDB	SR	Internal	Summary
-		AUT-2138	Default package in dynamic logic does not work
Description:	When for instance dynamic logic A is created (without using the the package ohi.dynamiclogic), and B refers to it: gives a compilation error for B (does not recognize A).
Resolution:	When package ohi.dynamiclogic is not specified in the logic, it is automatically added.
33149021	3-26456481851	AUT-2174	Exchange REST client operations sometimes failed with a JAVAX.CRYPTO.BADPADDINGEXCEPTION.
Description:	Sometimes the exchange REST client operations failed with JAVAX.CRYPTO.BADPADDINGEXCEPTION. This is caused by a bug in the JVM (https://bugs.java.com/bugdatabase/view_bug.do?bug_id=8191002) that is only fixed in Java 9 onwards. WebLogic is certified to work with Java 8 in which this is not fixed.
Resolution:	The system no longer calls the Java method that suffers from the bug.
33248062	3-26443621271	AUT-2184	NullPointerException should be replaced with an user friendly error message in ConfigMigrationItemReader
Description:	Nullpointer received when an entity name in the import file doesn’t exist in the application
Resolution:	GEN-MIGR-016 will be shown with the missing entity name in the application

BugDB

Internal

Summary

AUT-2138

Default package in dynamic logic does not work

Description:

When for instance dynamic logic A is created (without using the the package ohi.dynamiclogic), and B refers to it: gives a compilation error for B (does not recognize A).

Resolution:

When package ohi.dynamiclogic is not specified in the logic, it is automatically added.

33149021

3-26456481851

AUT-2174

Exchange REST client operations sometimes failed with a JAVAX.CRYPTO.BADPADDINGEXCEPTION.

Description:

Sometimes the exchange REST client operations failed with JAVAX.CRYPTO.BADPADDINGEXCEPTION. This is caused by a bug in the JVM (https://bugs.java.com/bugdatabase/view_bug.do?bug_id=8191002) that is only fixed in Java 9 onwards. WebLogic is certified to work with Java 8 in which this is not fixed.

Resolution:

The system no longer calls the Java method that suffers from the bug.

33248062

3-26443621271

AUT-2184

NullPointerException should be replaced with an user friendly error message in ConfigMigrationItemReader

Description:

Nullpointer received when an entity name in the import file doesn’t exist in the application

Resolution:

GEN-MIGR-016 will be shown with the missing entity name in the application

Issues that were backported in previous Release / Patch

No backports.

Known Issues

BugDB	SR	Internal	Summary
26392920		AUT-1041	ACCESS - Focus does not reach the overflow icon
Description:	On navigating via the keyboard on persons page, the focus does not reach the overflow icon for existing records.
26392938		AUT-1042	ACCESS : Unopened child sections are not accessible using keyboard
Description:	The user is not able to access unopened child sections using only the keyboard. The user should be able to use all the links, sections and functionalities just by a keyboard.
31533939		AUT-1764	ACCESS : Application does not support the portrait mode of the screen.
Description:	The application needs to support portrait mode as well as landscape mode. Currently, the application does not support when the application is used in portrait mode of the screen.
32477606		AUT-2029	No Base View generated for Reference Sheet Lines
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.
32992615	3-25236236261	AUT-2141	When Auth In IP sends in an update , the authorization processing should start from the first step and not from the last
Description:	When an Auth pends and subsequently, an update to the auth comes in through the Authorization In IP, this resets the authorization to the EDIT status, but as soon as it is resubmitted it seems to skip all processing steps.
33054876		AUT-2155	ACCESS : DOCUMENT TESTING : Expand buttons do not have discernible text
Description:	Expand buttons do not have discernible text
33054874		AUT-2156	ACCESS : DOCUMENT TESTING : Search form element at the home page does not have a label
Description:	Search form element at the home page does not have a label
33054879		AUT-2157	ACCESS : DOCUMENT TESTING : Link for home button do not have discernible text
Description:	Link for home button do not have discernible text
33054881		AUT-2158	ACCESS : DOCUMENT TESTING : Focus doesn’t reach to the menu to select different guides
Description:	Focus doesn’t reach to the menu to select different guides through keyboard
33054884		AUT-2159	ACCESS : DOCUMENT TESTING : Data table / grid do not have accessible text
Description:	Data table / grid do not have accessible text
25437440		AUT-690	ACCESS : Focus should first come to the left hand side menu
Description:	When using the tab the focus should come to the left-hand side menu first instead It’s going towards the right
25437457		AUT-691	ACCESS : CTRL+INS+I shortcut for list items does not work
Description:	List items on the page are not displayed using the CTRIL+INS+I shortcut.
25466241		AUT-716	ACCESS: The Close tab 'X' icon is not accessible via keyboard navigation
Description:	The 'x' icon of any opened page is not accessible if using only Tab (keyboard) navigation.
25466259		AUT-721	ACCESS: Jump to line functionality of JAWS (Screen reader) doesn’t work.
Description:	The user is not able to use the Jump to line functionality of JAWS which enables the user to navigate to a specific line/attribute based on its unique number.
25466289		AUT-725	ACCESS: Persons and Organizations page overflow icon is not accessible
Description:	Persons and organizations page overflow icon is not accessible using only a keyboard.
25466283		AUT-727	ACCESS : Documentation testing : Graphical images are not detected by assistive technology (JAWS)
Description:	Assistive technology (JAWS) is not able to detect available graphical images on any page in the documents.

BugDB

Internal

Summary

26392920

AUT-1041

ACCESS - Focus does not reach the overflow icon

Description:

On navigating via the keyboard on persons page, the focus does not reach the overflow icon for existing records.

26392938

AUT-1042

ACCESS : Unopened child sections are not accessible using keyboard

Description:

The user is not able to access unopened child sections using only the keyboard. The user should be able to use all the links, sections and functionalities just by a keyboard.

31533939

AUT-1764

ACCESS : Application does not support the portrait mode of the screen.

Description:

The application needs to support portrait mode as well as landscape mode. Currently, the application does not support when the application is used in portrait mode of the screen.

32477606

AUT-2029

No Base View generated for Reference Sheet Lines

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.

32992615

3-25236236261

AUT-2141

When Auth In IP sends in an update , the authorization processing should start from the first step and not from the last

Description:

When an Auth pends and subsequently, an update to the auth comes in through the Authorization In IP, this resets the authorization to the EDIT status, but as soon as it is resubmitted it seems to skip all processing steps.

33054876

AUT-2155

ACCESS : DOCUMENT TESTING : Expand buttons do not have discernible text

Description:

Expand buttons do not have discernible text

33054874

AUT-2156

ACCESS : DOCUMENT TESTING : Search form element at the home page does not have a label

Description:

Search form element at the home page does not have a label

33054879

AUT-2157

ACCESS : DOCUMENT TESTING : Link for home button do not have discernible text

Description:

Link for home button do not have discernible text

33054881

AUT-2158

ACCESS : DOCUMENT TESTING : Focus doesn’t reach to the menu to select different guides

Description:

Focus doesn’t reach to the menu to select different guides through keyboard

33054884

AUT-2159

ACCESS : DOCUMENT TESTING : Data table / grid do not have accessible text

Description:

Data table / grid do not have accessible text

25437440

AUT-690

ACCESS : Focus should first come to the left hand side menu

Description:

When using the tab the focus should come to the left-hand side menu first instead It’s going towards the right

25437457

AUT-691

ACCESS : CTRL+INS+I shortcut for list items does not work

Description:

List items on the page are not displayed using the CTRIL+INS+I shortcut.

25466241

AUT-716

ACCESS: The Close tab 'X' icon is not accessible via keyboard navigation

Description:

The 'x' icon of any opened page is not accessible if using only Tab (keyboard) navigation.

25466259

AUT-721

ACCESS: Jump to line functionality of JAWS (Screen reader) doesn’t work.

Description:

The user is not able to use the Jump to line functionality of JAWS which enables the user to navigate to a specific line/attribute based on its unique number.

25466289

AUT-725

ACCESS: Persons and Organizations page overflow icon is not accessible

Description:

Persons and organizations page overflow icon is not accessible using only a keyboard.

25466283

AUT-727

ACCESS : Documentation testing : Graphical images are not detected by assistive technology (JAWS)

Description:

Assistive technology (JAWS) is not able to detect available graphical images on any page in the documents.