Application Properties

System properties influence the behavior of the system. Administrators use them to set timeout values, url addresses, processing settings, and many other properties.

System properties can be set:

  • in the ohi-claims.properties file

  • by the Properties API.

A new Claims release may have a different set of properties that is supported.

The Property Definitions Integration Point contains the list of all available properties.

The following tables describe all properties. The property names are formatted for readability, note that the property names and associated values should always be specified on one line in the properties file.

Name Description Default Value Possible Values Change Effective

ohi.properties.file.
poll.interval

Changes made to any of these properties are not immediately picked up by the application. That only happens when it reads the properties-file again. This property specifies how often the system will read the file, in minutes. Default value, every 10 minutes. Minimum value, 1 minute. Values lower than that are ignored, meaning the default value is used.

10

Integer ≥ 1

Next Execution

Base View Generator

Name Description Default Value Possible Values Change Effective

ohi.baseview.generation.
worker.count

The number of worker threads to start for a base view generation process

8

Integer ≥ 1

Immediate

Dynamic Logic

Name Description Default Value Possible Values Change Effective

ohi.dynamiclogic.
classes.directory

Path to directory in which the system places the generated Dynamic Logic classes.

/tmp

String

Next Execution

ohi.dynamiclogic.
startup.compile

An optional property that determines whether to compile the Dynamic Logic (those who are not compiled before) at the startup of the application or not.

true

Boolean

Next Execution

ohi.dynamiclogic.timeout

An optional property that determines the timeout of a running Dynamic Logic. If the timeout expires, the system interrupts the Dynamic Logic and throws an exception. The value is in seconds. Please note that when you add/update a Dynamic Logic timeout property, the Dynamic Logic needs to recompile for the property change to take effect. You can do this by using the "Invalidate Dynamic Logic Integration Point" that we explain in the Integration Guide.

300

Integer ≥ 0

Next Execution

ohi.dynamiclogic.
timeout.<0>

An optional property that determines the timeout of the running Dynamic Logic. If the timeout expires, the system interrupts the Dynamic Logic and throws an exception. The value is in seconds. This property is for a particular Dynamic Logic code, so replace the placeholder <0> with the Dynamic Logic code for which you want to specify the timeout. Please note that when you add/update a Dynamic Logic timeout property, the Dynamic Logic needs to recompile for the property change to take effect. You can do this by using the "Invalidate Dynamic Logic Integration Point" that we explain in the Integration Guide. If this property is not set, it takes the value of ohi.dynamiclogic.timeout (which in its turn has a default of '300').

Integer ≥ 0

Next Execution

Logging Support

Name Description Default Value Possible Values Change Effective

ohi.logging.fileset.max.
timespan

Maximum time in days between start and end time for bundling log events in a file set

2

Integer ≥ 1

Immediate

ohi.logging.phi.min.
retentionperiod

Minimal number of days for retaining PHI log events

1825

Integer ≥ 1

Immediate

ohi.logging.target

Determines whether logging persists to the database or uses any configured Logback Appender. Possible values are 'database' and 'log' respectively

log

String

Next Execution

Incident Reports

Name Description Default Value Possible Values Change Effective

ohi.incident.
datafileset.
retentionperiod

Whenever OHI Incident storage in datafile sets activates, this property defines the number of days that the system will keep OHI Incident datafile sets, and remove OHI Incident datafile sets that are older.

10

Integer ≥ 1

After Restart

ohi.incident.rootdir

OHI Components makes use of the Logback library for generating log output. In the event of an unanticipated application exception, the system writes more detailed exception trace information to an individual exception trace file. This property controls the location of these exception trace files. By default, the location 'target/trace' is relative to the directory where the WebLogic server starts. When changing the value for this property, make sure that the OS user that executes the WebLogic server processes needs to create (and read/write files in) the directory that the property refers to.

target/trace

String

After Restart

ohi.incident.target

OHI Incident files can be stored in the database, in a datafile set. Whenever you set this property to "datafileset" this feature activates. Otherwise, the default mechanism of writing incident files to an OS file system directory. The OHI Incident datafile sets will have a Code with a following pattern: "OHIIncidents<yyyyMMdd>". Note that the value for this property must be set in the properties file, not using properties API.

file

"file" or "datafileset"

After Restart

Cache Control

Name Description Default Value Possible Values Change Effective

ohi.httpapi.cache.
control.cachesetting.
metadata

This property specifies the code of a OHI_RESOURCE_CACHE_SETTING for metadata settings. See ohi.httpapi.cache.control.enable.

String

Next Execution

ohi.httpapi.cache.
control.enable

Property to enable HTTP API Caching, which is disabled by default. When enabled, HTTP API will add a Cache-Control header in the response it sends.

false

Boolean

Next Execution

ohi.messagegroup.
cachesize

Use it as an initial sizing element for the number of cached message groups

1000

Integer ≥ 1

Next Execution

ohi.process.cache.
disabled

This property enables or disables business process cache facilities.

false

Boolean

Next Execution

ohi.process.cache.push_
wait

The time in milliseconds to back-off invalidating the business process cache for consecutive bursts of invalidations.

250

Integer ≥ 0

After Restart

Web Service Connection Settings

Name Description Default Value Possible Values Change Effective

ohi.ws.client.
retrytimeout

MANDATORY
The time in milliseconds that the system will wait before it makes another attempt to access a failing service. A value of 0 means no timeout before retrying.

1000

Integer ≥ 0

After Restart

ohi.ws.fileimport.
filesrootdirectory

MANDATORY
Use this property to give the root directory path that the File Import uses. This is for security reasons, it ensures that the files are in a specific area only.

String

Next Execution

ohi.rest.client.logging

Enable or Disable logging for rest clients. When "true" will log traffic to external system.

false

Boolean

Immediate

ohi.service.client.
cache.size

The rest client cache size.

500

Integer ≥ 1

Immediate

ohi.service.client.pool.
active

Enable or disable to leverage connection pool functionality

true

Boolean

After Restart

ohi.service.client.pool.
destination.
maxconnections

The maximum number of connections in the pool per destination. Effective immediately for non-cached clients.

64

Integer ≥ 1

After Restart

ohi.service.client.pool.
destination.maxqueued

The maximum number of connections in the pool allowed to be queued per destination. Effective immediately for non-cached clients.

1024

Integer ≥ 1

After Restart

ohi.service.client.pool.
timeout.
addressresolution

The max time, in milliseconds, to resolve the host address. Effective immediately for non-cached clients.

15000

Integer ≥ 1

After Restart

ohi.service.client.pool.
timeout.connection

The time in milliseconds before the attempt to connect to an outbound service times out. Effective immediately for non-cached clients.

15000

Integer ≥ 1

After Restart

ohi.service.client.pool.
timeout.idle

The max time, in milliseconds, a connection can be idle. Effective immediately for non-cached clients.

60000

Integer ≥ 1

After Restart

ohi.service.client.
response.content.maxsize

Maximum allowed response content size in MegaBytes (MB).

2147

Integer ≥ 1

After Restart

ohi.service.<0>.client.
authentication

This property specifies the (Jersey/REST specific) authentication mechanism to use for machine-to-machine communication. Allowable values are 'None', 'BasicAuthentication' (and 'OAuth'). The notification key replaces the <0>.

BasicAuthentication

String

Next Execution

ohi.service.<0>.client.
pool.destination.
maxconnections

The maximum number of connections in the pool per destination for client <0>. Effective immediately for non-cached clients.

Integer ≥ 1

After Restart

ohi.service.<0>.client.
pool.destination.
maxqueued

The maximum number of connections in the pool allowed to be queued per destination for client <0>. Effective immediately for non-cached clients.

Integer ≥ 1

After Restart

ohi.service.<0>.client.
pool.timeout.
addressresolution

The max time, in milliseconds, to resolve the host address. This property is specific to client <0>. Effective immediately for non-cached clients.

Integer ≥ 1

After Restart

ohi.service.<0>.client.
pool.timeout.connection

The max time, in milliseconds, a connection can take to connect to destinations. A value of 0 means never timeout. This property is specific to clientId <0>. Effective immediately for non-cached clients.

Integer ≥ 1

After Restart

ohi.service.<0>.client.
pool.timeout.idle

The max time, in milliseconds, a connection can be idle. This property is specific to client <0>. Effective immediately for non-cached clients.

Integer ≥ 1

After Restart

ohi.service.<0>.media.
type

For the notification media type. Notification key replaces the <0>.

application/json

String

Next Execution

ohi.service.<0>.method.
type

This property is for the notification method type. The notification key replaces the <0>.

POST

String

Next Execution

ohi.ws.api.default.
pagesize

Number of items fetched in a HTTP API request.

50

Integer ≥ 1

Next Execution

ohi.ws.client.
connectiontimeout

The time in milliseconds before the attempt to connect to an outbound service times out. A value of 0 means never timeout.

60000

Integer ≥ 0

Immediate

ohi.ws.client.
maxconnectionsperhost

The maximum number of concurrent connections the HTTP client will allow to a certain host at any given moment.

2

Integer ≥ 1

Immediate

ohi.ws.client.
maxtotalconnections

Sets the maximum number of total concurrent connections the HTTP client will allow at any given moment.

20

Integer ≥ value of ohi.
ws.client.
maxconnectionsperhost

Immediate

ohi.ws.client.
readtimeout

The time in milliseconds that the client will wait for the server to respond to the request. A value of 0 means never timeout.

60000

Integer ≥ 0

Immediate

ohi.ws.
enrollmentresponse.
request.enabled

Allows the enrollment step to be disabled from the claims flow (typically for pricing only installation).

true

Boolean

Next Execution

ohi.ws.
enrollmentresponse.
responsedefinition.code

Can be specified to be included in enrollment requests to drive response generation based on a specific (dynamic logic) function.

String

Next Execution

ohi.ws.last.login.
update.threshold

The number of hours that need to pass between logins before updating the user’s last login timestamp. By default, the last login timestamp will not update more than once per hour. This only applies to logins through a web service, not the ADF UI.

1

Integer ≥ 1

Next Execution

ohi.ws.
paymentstatusresponse.
request.enabled

The use of the Payment Status integration point is optional. In the event that the payment status information is provided through another integration point (or not at all) this integration point can be disabled by setting the value to false.

true

Boolean

Next Execution

ohi.ws.
replicationevents.
pagination.limit

Number of replication events that the system will pull across (over REST/HTTP) from replication source as one 'page'.

1000

Integer ≥ 1

Immediate

Configuration of External Web Services Endpoint URI’s

Claims can call external Web Services. The endpoint URI’s for these services are configured using properties. The following table describes the Web Services endpoint URI parameters.

Name Description Default Value Possible Values Change Effective

ohi.claimsout.datafile.
notification.endpoint

MANDATORY
Used to specify the URI for sending out 'completion message' for claims out (FileBased).

String

Next Execution

ohi.paymentstatus.
endpoint.response

MANDATORY
The replyTo URI for the Payment Status Response service that is provided by the OHI Claims system. This URI is passed in the Payment Status Request message. Typically, this is a reference to a loadbalancer or a service endpoint on a service bus that forwards the request to a physical machine that executes the Web Service.

String

Next Execution

ohi.
policyaccounttransaction.
endpoint.request

MANDATORY
Reference to the Policy Account Transactions URI of OHI Policies that OHI Claims uses to deliver Policy Account Transaction events if no specific URL is defined.

String

Next Execution

ohi.
policyaccounttransaction.
<0>.endpoint.request

MANDATORY
Reference to the Policy Account Transactions URI of OHI Policies that OHI Claims uses to deliver Policy Account Transaction events for the specific event rule.

String

Next Execution

ohi.reprocessclaims.
datafile.notification.
endpoint

MANDATORY
Used to specify the URI for sending out 'completion message' for claims reprocessing (FileBased).

String

Next Execution

ohi.claimevent.endpoint.
request

Reference to the Web Service endpoint that OHI Claims uses to deliver Claim events (if configured). Multiple Web Service endpoints can be specified as comma separated URLs.

String

Next Execution

ohi.claimevent.<0>.
endpoint.request

Claim Event Rule specific reference to the Web Service endpoint that OHI Claims uses to deliver Claim events (if configured). Multiple Web Service endpoints can be specified as comma separated URLs. <0> is replaced by the Claim Event Rule code. If specified, this property value takes priority over the value specified for ohi.claimevent.endpoint.request.

String

Next Execution

ohi.ctrclaimevent.
endpoint.request

Reference to the Web Service endpoint that OHI Claims uses to deliver Claim Transaction events (if configured). Multiple Web Service endpoints can be specified as comma separated URLs.

String

Next Execution

ohi.ctrclaimevent.<0>.
endpoint.request

Reference to the Web Service endpoint that OHI Claims uses to deliver Claim Transaction events (if configured). Multiple Web Service endpoints can be specified as comma separated URLs. <0> is replaced by the Claim Transaction Event Rule code. If specified, this property value takes priority over the value specified for ohi.ctrclaimevent.endpoint.request

String

Next Execution

ohi.financialmessage.
datafile.notification.
endpoint

For sending out financial message data file creation notification in Generate Financial Message Activity. For FileBased requests. Sample value is http://machine.domain:port/financialmessage/datafile

String

Next Execution

ohi.financialmessage.
endpoint.request

For sending out financial message in Generate Financial Message Activity. For MessageBased requests. Sample value is http://machine.domain:port/financialmessage

String

Next Execution

ohi.paymentstatus.
endpoint.request

Reference to the Web Service endpoint which the OHI Claims system uses to request for Payment Status information. Required when ohi.ws.paymentstatusresponse.request.enabled = true

String

Next Execution

ohi.
resendfinancialmessage.
datafile.notification.
endpoint

For re-sending financial message data file creation notification in Resend Financial Message Activity. For FileBased requests. Sample value is http://machine.domain:port/resend/financialmessage/datafile

String

Next Execution

ohi.
resendfinancialmessage.
endpoint.request

For sending out financial message in Resend Financial Message Activity. For MessageBased requests. Sample value is http://machine.domain:port/resend/financialmessage

String

Next Execution

ohi.<0>.endpoint.request

Allows for web service client interactions to identify their request URI destination. The system uses this property to get the URI for the end point. The notification key replaces the <0>. Sample value is http://machine.domain:port/<0>.

String

Next Execution

Oracle recommends to enable payload logging for a short period of time and for diagnostic purposes only.

Web Service Client Authentication

Claims secures Outbound RESTful invocations using either Basic Authentication or OAuth2. For details, refer to the relevant chapter in the Security Guide. Each client needs to be configured separately. The applicable properties all follow the same naming convention: ohi.service.<0>.client.authentication. The default value is "BasicAuthentication". The placeholder <0> is the name of the client. Oracle Health Insurance defined client names are listed as follows:

Web Service: Activity Notification
Client Name: ActivityResponseClient

Web Service: Claim Event
Client Name: ClaimEventClient

Web Service: Claims Out File Delivery
Client Name: ClaimsTransactionOutNotificationClient

Web Service: Claim Transaction Event Rules
Client Name: PolicyAccountTransactionClient

Web Service: Data Exchange Export Notification
Client Name: DataExchangeExportNotificationClient

Web Service: Data Exchange Import Notification
Client Name: DataExchangeImportNotificationClient

Web Service: Data Replication Authorization Events
Client Name: DataReplicationAuthorizationEvents

Web Service: Data Replication Authorization Entities
Client Name: DataReplicationAuthorizationEntities

Web Service: Data Replication Person Events
Client Name: DataReplicationPersonEvents

Web Service: Data Replication Person Entities
Client Name: DataReplicationPersonEntities

Web Service: Enrollment
Client Name: PolicyEnrollmentClient

Web Service: Financial Message Notification
Client Name: FinancialMessageNotificationClient

Web Service: Reprocess Claims Criteria
Client Name: ClaimReprocessCriteriaResponseNotificationClient

Web Service: Send Financial Message
Client Name: SendFinancialMessageClient

Web Service: Resend Financial Message
Client Name: ResendFinancialMessageClient

Web Service: Workflow Notification
Client Name: WorkflowEventClient

Web Service: Workflow Task Done Notification
Client Name: TaskDoneEventClient

Defining the property for the authentication mechanism needs to be done in conjunction with defining the credentials that the web service client will use when making the request. How to enter credentials is outlined in the Security Guide.

Web Service Media Type

Certain outbound RESTFul invocation support multiple output formats (that is, XML or JSON). This can be configured via the media type property. If unspecified, the default value is "application/json". The property name follows the naming convention: ohi.service.<0>.media.type. The placeholder <0> is the name of the client. The names of the clients that support a configurable media type are listed as follows:

Web Service: Activity Notification
Client Name: ActivityResponseClient

Web Service: Claim Event
Client Name: ClaimEventClient

Web Service: Claims Out File Delivery
Client Name: ClaimsTransactionOutNotificationClient

Web Service: Claim Transaction Event Rules
Client Name: PolicyAccountTransactionClient

Web Service: Reprocess Claims Criteria
Client Name: ClaimReprocessCriteriaResponseNotificationClient

Web Service: Workflow Notification
Client Name: WorkflowEventClient

Web Service: Workflow Task Done Notification
Client Name: TaskDoneEventClient

Web Service Validation

Name Description Default Value Possible Values Change Effective

ohi.ws.<0>.request.
validate

If set to true, the request will be validated against an XSD when it is received. For production systems, with extensively tested integrations, the recommended value is false.

false

Boolean

Next Execution

ohi.ws.<0>.response.
validate

If set to true, the response will be validated against an XSD when it is received. For production systems, with extensively tested integrations, the recommended value is false.

false

Boolean

Next Execution

Single Sign-On and Web Gate

The following table lists properties that need to be set when Oracle Health Insurance application take part in Single Sign-On (SSO) scenarios or when Oracle Health Insurance applications are fronted by a gateway that is responsible for handling authentication:

Name Description Default Value Possible Values Change Effective

ohi.security.sso.enabled

The application will check for an SSO header, and if it does not find one, it will present the user with a login screen.

false

Boolean

Next Execution

ohi.security.sso.header

The header value in which to check for an SSO principal if servlet security does not map it.

OAM_REMOTE_USER

String

After Restart

ohi.security.sso.
required

The application will reject traffic without an SSO header.

false

Boolean

Next Execution

Cross Origin Resource Sharing

See the Security Guide for an introduction to Cross Origin Resource Sharing (CORS). For further explanation the reader is referred to W3C’s CORS specification.

The following table lists CORS related properties:

Name Description Default Value Possible Values Change Effective

ohi.cors.access.control.
allow.origin

MANDATORY
Comma-separated list of allowed origins. The value '*' effectively allows all origins.

String

Next Execution

ohi.cors.access.control.
allow.credentials

Header that shows whether the system can expose the response to a request when the omit credentials flag is unset. When this is part of the response to a preflight request, it shows that the actual request can include user credentials.

true

Boolean

Next Execution

ohi.cors.access.control.
allow.headers

Header that shows, as part of the response to a preflight request, which header field names can be useful for during the actual request. Allows all headers by default. The value is a comma-separated list of allowed headers.

String

Next Execution

ohi.cors.access.control.
allow.methods

Header that shows, as part of the response to a preflight request, which methods the system can use during the actual request. Allows all methods by default. The value is a comma-separated list of allowed methods.

String

Next Execution

ohi.cors.access.control.
expose.headers

Header that shows which headers are safe to expose to the API of a CORS API specification. The value is a comma-separated list of all exposed headers.

String

Next Execution

ohi.cors.access.control.
max.age

Header that shows how long the preflight result cache stores the results of a preflight request, number representing seconds.

1800

Integer ≥ 0

Next Execution

ohi.vary.header

Property to set Vary HTTP Header. Value is a comma-separated list

Accept,Accept-
Encoding,Accept-
Language,Origin

String

Next Execution

Intrusion Detection

Oracle Health Insurance applications safeguard against Cross-Site Scripting (XSS) attacks by checking "untrusted" data that may be entered in HTTP API requests (see the Security Guide for intrusion detection principles). Detection behavior can be customized using the properties that are listed in the following table:

Name Description Default Value Possible Values Change Effective

ohi.untrusteddata.check

The application enables the XSS vulnerability detection by default. Disable it bysetting the value for this parameter to false. You should use this property if other components in the landscape perform vulnerability detection.

true

Boolean

Next Execution

ohi.untrusteddata.
domain.attribute.length

The system checks the domain attributes of type string by default if the length ≥ 30 characters. To be more stringent, decrease the default value using this property.

30

Integer ≥ 1

Next Execution

ohi.untrusteddata.
whitelist.
domainattribute

The system checks the domain attributes by default. Use this property to define a comma-separated list of excluded customer-specific attributes from intrusion detection checking. Format: <DOMAIN OBJECT SIMPLE NAME>.<ATTRIBUTE NAME>.

String

Next Execution

ohi.untrusteddata.
whitelist.httpheader

The property checks the HTTP Headers by default. Use this property to define a comma-separated list of customer-specific headers that need exclusion from intrusion detection checking. Format: <HEADER NAME>,<HEADER NAME>.

String

Next Execution

ohi.untrusteddata.
whitelist.queryparameter

The system checks HTTP Query Parameters by default. Use this property to define a comma-separated list of customer-specific query parameters that need exclusion from intrusion detection checking. Format: <QUERY PARAMETER NAME>,<QUERY PARAMETER NAME>.

String

Next Execution

For example, to prevent mixed encoded Cookies that a client like a browser sends as part of the request to result in a Bad Request, allow the Cookie header as follows:

ohi.untrusteddata.whitelist.httpheader=Cookie

Data Set Operations

Name Description Default Value Possible Values Change Effective

ohi.datasetoperations.
notification.endpoint.
export

This property is about the Data Set Operations Integration Point, for export usages. It contains a URI that refers to the notification message, once the process of uploading the data set payload completes this message is sent.

String

Next Execution

ohi.datasetoperations.
notification.endpoint.
import

This property is about the Data Set Operations Integration Point, for import usages. It contains a URI that refers to the notification message, once the process of uploading the data set payload completes this message is sent. Error messages prevent the import from happening.

String

Next Execution

Using OAuth2 for REST Client Invocations

Oracle Health Insurance application’s RESTful services can be OAuth2 protected. In that case the application validates and / or introspects OAuth2 access tokens that are sent as Bearer tokens in the HTTP Authorization header. See the Security Guide for further details about OAuth2 support in Oracle Health Insurance applications.

The following table lists OAuth2 properties:

Name Description Default Value Possible Values Change Effective

ohi.oauth.accesstoken.
expiry.time.delay

To model the overhead of fetching an access token from an OAuth2 authorization server for caching the access token in the REST client, e.g. to account for some network delay between the client and the authorization server.Example: if the authorization server returns a token with an expiry time of 3600 seconds and if the network delay is expected to be 100 ms, then 100 ms could be configured for this key. The resulting access token will be cached for the original expiry time minus overhead time, i.e. 3600000 - 100 = 3599900 ms. The value should be specified in milliseconds.

10

Integer ≥ 0

Immediate

ohi.oauth.jwk.set.url

URL value for the OAuth2 authorization server JSON Web Key (JWK) Set endpoint. The OAuth2 authorization server should support RFC 7517. Token Validation Method is JWKSET.

String, URL

After Restart

ohi.oauth.jwk.set.
validation.audience

Client Id or audience claim for token validation. Token Validation Method is JWKSET.

String

After Restart

ohi.oauth.jwk.set.
validation.issuer

Issuer for token validation. Token Validation Method is JWKSET.

String or URL

After Restart

ohi.oauth.jwk.set.
validation.jws.signing.
algorithm

Signing algorithm used by the Authorization Server. Token Validation Method is JWKSET.

RS256

String

After Restart

ohi.oauth.jws.signing.
algorithm

Algorithm used for signing the JWT token that an OHI application generates for obtaining an OAuth2 access token through the assertion grant type (where the JWTis used as assertion). Note that only RSA algorithms are currently supported.

RS512

RS256, RS384, RS512

Immediate

ohi.oauth.jwt.
expiration.period

Expiration period (in seconds) for the JWT token that an OHI application generates for obtaining an OAuth2 access token through the assertion grant type (where the JWT is used as assertion).

600

0 ≤ Integer ≤ 9999

Immediate

ohi.oauth.jwt.userid.
claim

Specifies the claim in the JWT that can be used to identify the user for which the OAuth2 access token was created. Token Validation Method is JWKSET.

sub

String

Immediate

ohi.oauth.openidconnect.
accesstoken.client_id

Client ID of the OpenID Connect client that has to be present to acquire an access token.

String

Immediate

ohi.oauth.openidconnect.
accesstoken.credential

Credential associated with the OpenID Connect client that has to be present to acquire an access token.

String

Immediate

ohi.oauth.openidconnect.
accesstoken.validation.
clockskew

Defines the maximum acceptable clock skew (in seconds) for validating timestamps of ID tokens that are issued by an OpenID Provider.

60

Integer ≥ 1

After Restart

ohi.oauth.token.
introspection.endpoint.
client_id

Unique client id for resolving the username and password credentials that are used to construct the Basic Authentication Authorization header when calling the OAuth2 authorization server token validation or introspection endpoint. Token Validation Method is OAUTH2_ENDPOINT.

String

Immediate

ohi.oauth.token.
introspection.endpoint.
url

URL value for the OAuth2 authorization server token validation or introspection endpoint. It is assumed that the endpoint supports Basic Authentication. Token Validation Method is OAUTH2_ENDPOINT.

String, URL

After Restart

ohi.oauth.token.
introspection.response.
username

RFC 7662 defined Introspection Response element that will be used to derive the username from. Token Validation Method is OAUTH2_ENDPOINT.

sub

String

Immediate

ohi.oauth.token.issuer.
<0>

For token validation. Specific issuer identifier. Requires use of properties ohi.oauth.token.issuers and ohi.oauth.token.issuer.<0>.user.claim.

String or URL

After Restart

ohi.oauth.token.issuer.
<0>.user.claim

For token validation. Issuer-specific user claim. Requires use of properties ohi.oauth.token.issuers and ohi.oauth.token.issuer.<0>.

String

After Restart

ohi.oauth.token.issuers

For token validation. Comma-separated string of possible token issuers. Requires use of properties ohi.oauth.token.issuer.<0> and ohi.oauth.token.issuer.<0>.user.claim.

Comma-
separated string,
e.g. oracle_idcs,
azure_ad

After Restart

ohi.oauth.token.
validation.method

Determines the access token validation method. Possible values: JWKSET: OAuth2 access tokens are validated by the resource server. Assuming the token is a JWT, validates it against a JSON Web Key (JWK) Set as defined by RFC 7517. The source of the JWK Set is an endpoint exposed by an OAuth2 authorization server. Use this method to validate ID tokens issued by an OpenID Provider.OAUTH2_ENDPOINT: validates the token using an OAuth2 authorization server’s token introspection endpoint as defined by RFC 7662.

JWKSET

JWKSET, OAUTH2_
ENDPOINT

Immediate

Claims in an OAuth2 token may differ per token issuer. The following example demonstrates mapping a specific claim in an access token to Oracle Health Insurance User based on the issuer of the token:

# configure multiple token issuers as comma-separated string

ohi.oauth.token.issuers=oracle_idcs,azure_ad

# configure issuer to user claim mapping for issuer oracle_idcs
ohi.oauth.token.issuer.oracle_idcs=https://identity.oraclecloud.com/
ohi.oauth.token.issuer.oracle_idcs.user.claim=sub

# configure issuer to user claim mapping for issuer azure_ad
ohi.oauth.token.issuer.azure_ad=https://sts.windows.net/fa15d692-e9c7-4460-a743-29f29522229/
ohi.oauth.token.issuer.azure_ad.user.claim=oid

Activity and Task Processing

Name Description Default Value Possible Values Change Effective

ohi.claims.ignore.
history

MANDATORY
Controls with what value the indicator ignore history of ClaimLine should be switched on or off.

false

Boolean

Next Execution

ohi.activityprocessing.
notification.endpoint

RESTful Service endpoint URL for delivering the response notification after activity processing completes. OHI Components applications will use a POST operation by default. You can overwrite this by using ohi.service.<0>.method.type, where the notification key must replace the <0>. Sample value is http://machine:port/api/generic_notification_service.

String

Next Execution

ohi.activityprocessing.
notification.endpoint.
<0>

Activity type-specific RESTful Service endpoint URL for delivering the response notification once activity processing completes. The activity type code must replace the <0>. For example, REFSHEETLINE_IMPORT. When you do not set this property, the property uses the value of ohi.activityprocessing.notification.endpoint. OHI Components applications will use a POST operation by default. You can overwrite this by using ohi.service.<0>.method.type, where the notification key must replace the <0>. Sample value is http://machine:port/api/generic_notification_service.

String

Next Execution

ohi.amount.scale

By default, amounts are stored with the scale of 2 (two digits after the decimal point). A subset of amounts allows for a higher scale. For example, the premium amounts in calculation results allow up to 12 digits after the decimal point. How many of those additional digits the system actually uses depends on this property. The system can use it to store calculation result amounts with greater scale. An increase of scale allows for sending financial data on a detail level (For example, VAT on a premium for a member) to the financial system and round only after aggregation (For example, on a group account); rounding in an early stage to two decimals leads to a substantial difference with the expected outcome on an aggregate level.

2

2 ≤ Integer ≤ 12.

Next Execution

ohi.claims.future.
servicedate.allow

This property allows / not allows future service dates for claims. default value is 'false', which means future service dates are not allowed for claims.

false

Boolean

Next Execution

ohi.claims.quote.
financial

Property to configure whether financial transactions for claims of process type Q(uote) should be created or not.

false

Boolean

Next Execution

ohi.claims.reservation.
financial

Property to configure whether financial transactions for claims of process type R(eservation) should be created or not.

true

Boolean

Next Execution

ohi.financialmessage.
create.
noninvoiceaccdetail

Decides the creation of non-invoice accounting details in financial message. If set to true, activity creates non-invoice account details in financial message. If the property is set to 'false', non-invoice accounting details won’t be created

true

Boolean

Next Execution

ohi.fsli.batch.commit.
limit

Factor with which a collection of fee schedule lines of a particular fee schedule is partitioned over a cluster wide feeschedule line import.

500

Integer ≥ 1

Next Execution

ohi.fsli.batch.
concurrency.limit

Number of concurrent threads that are allowed to run on a single JVM, as part of a clustered wide feeschedule line import.

5

Integer ≥ 1

Next Execution

ohi.max.headroom

The maximum number of tasks to load into the processing grid.

2000

Integer ≥ 1

Next Execution

ohi.max.headroom.<0>

The maximum number of tasks to load into the processing grid - per given activity type.

2000

Integer ≥ 1

Next Execution

ohi.processing.
attemptLogLevel

A non-zero value for this property means that the system retains data (That is, extra_info) for failed attempts.

0

Integer ≥ 0

Next Execution

ohi.processing.
bucketsize.SELECT_
EXTRACT_ITEMS

This property controls how many items the system exports in one transaction during extract items bucketing, to improve performance. We suggest a value between 1 and 1000.

500

Integer ≥ 1

Next Execution

ohi.processing.
bucketsize.SELECT_
TRANSACTIONS_IN_SET

Utilized for Select Transactions In Set activity bucketing. It decides how many sub-activities will run in one transaction to improve performance. This one utilizes a technical table to bucketise the working set.

5000

Integer ≥ 1

Next Execution

ohi.processing.cache.
externalinterventionrules.
spec

A specification of Google Guava’s CacheBuilder configuration. It configures a cache for external intervention rules. Defined as a string which is a series of comma-separated keys or key-value pairs, each corresponding to a CacheBuilder method. See CacheBuilderSpec http://docs.guava-libraries.googlecode.com/ for additional detail.

maximumSize=1000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
flexcodekeyvaluecache.
spec

Specification for a cache that caches the results (Flex Code entity) of queries on Flex Code by key value and Flex Code system code. For more information, see CacheBuilderSpec’s javadoc: https://guava.dev/releases/19.0/api/docs/com/google/common/cache/CacheBuilderSpec.html

maximumSize=10000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
flexcodesystemcache.spec

Specification for a cache that caches the results (Flex Code system code) of queries on Flex Code system by ID. For more information, see CacheBuilderSpec’s javadoc: https://guava.dev/releases/19.0/api/docs/com/google/common/cache/CacheBuilderSpec.html

maximumSize=1000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
fsli.duplicity

Guava cache setting for FeeScheduleLineDuplicityCache. See https://guava.dev/releases/19.0/api/docs/com/google/common/cache/CacheBuilderSpec.html for additional details.

maximumSize=1

String

Next Execution

ohi.processing.cache.
ingroup

This property allows for caching of the responses of the "InGroup" family of function calls.

false

Boolean

Next Execution

ohi.processing.
defaultdelay

Default amount of delay in seconds when a failed task re-queues for another attempt. The system can override this property if a delay is set on the task type.

3

Integer ≥ 0

Next Execution

ohi.processing.
enrollment.cacheexpiry

Number of minutes gathered enrollment data can be considered as 'up-to-date' (i.e. not expired).

5

Integer ≥ 1

Next Execution

ohi.processing.filldepth

Specifies a target number of work items to process at a time - to best utilize processing capacity. We suggest a value that is a multiple of the number of CPU cores available to the managed server. The system will take the maximum of 2x the number of processors available to the JVM and the value of this property (which has in its turn a default of 3).

3

Integer ≥ 0

Next Execution

ohi.processing.
fillthreshhold

Determines the number of tasks that the system submits for processing. Suggested is a value that is 1 less than the number of CPU cores available to the managed server. The system will take the maximum of the number of processors available to the JVM minus 1 and the value of this property (which has in its turn a default of 1).

1

Integer ≥ 1

Next Execution

ohi.processing.finalize.
attempts.constraint

Total maximum number of times to attempt finalization of a claim.

1000

Integer ≥ 1

Next Execution

ohi.processing.groupsize

The number of tasks to group (when applicable) into a collection of tasks to put into the processing grid as one atomic unit. This complete collection will process on one processing node.

400

Integer ≥ 1

Next Execution

ohi.processing.
groupsize.CREATE_CLAIMS_
OUT_RESPONSE

Utilized for activity grouping. It decides how many sub-activities will run in one transactionto improve performance. This directly groups child activities according to groupSize.

500

Integer ≥ 1

Next Execution

ohi.processing.
groupsize.GENERATE_
FINANCIAL_MESSAGES

Utilized for Generate Financial Message activity grouping It decides how many sub-activities will run in one transaction to improve performance. This directly groups child activities according to groupSize.

500

Integer ≥ 1

Next Execution

ohi.processing.
groupsize.SUBMIT_PEND_
RESO_CRITERIA_REQ

Utilized for activity grouping. It decides how many sub-activities will run in one transactionto improve performance. This directly groups child activities according to groupSize.

100

Integer ≥ 1

Next Execution

ohi.processing.
groupsize.SUBMIT_
REPROCESSCLAIM_REQ

Utilized for activity grouping. It decides how many sub-activities will run in one transactionto improve performance. This directly groups child activities according to groupSize.

100

Integer ≥ 1

Next Execution

ohi.processing.
groupsize.SUPERSEDE_
REVERSE

Utilized for activity grouping. It decides how many sub-activities will run in one transaction to improve performance. This directly groups child activities according to groupSize.

500

Integer ≥ 1

Next Execution

ohi.processing.
groupsize.<0>

The number of tasks to group (when applicable) into a collection of tasks to put into the processing grid as one atomic unit - per activity type. This complete collection will process on one processing node.

400

Integer ≥ 1

Next Execution

ohi.processing.
loadercount

The number of loader tasks the system has to spawn, whenever an activity of that type needs to be processed and has child tasks spawned into the grid. These loaders work concurrently on the set of child tasks to spawn.

1

Integer ≥ 1

Next Execution

ohi.processing.
loadercount.<0>

The number of loader tasks the system has to spawn for a specific activity type, whenever an activity of that type needs to be processed and has child tasks spawned into the grid. These loaders work concurrently on the set of child tasks to spawn.

1

Integer ≥ 1

Next Execution

ohi.processing.
loaderyield

This property specifies the time (in seconds) the system holds back a loader task in the grid, in the event it reaches its maximum allowed number of tasks to load and spawn into the grid.

3

Integer ≥ 1

Next Execution

ohi.processing.
loaderyield.<0>

This property specifies the time (in seconds) the system holds back a loader task in the grid, in the event it reaches its maximum allowed number of tasks to load and spawn into the grid.- per given activity type.

3

Integer ≥ 1

Next Execution

ohi.processing.max.
numberofretries

The maximum amount of times activity processing will try to send out an 'activity processed' event to an external system.

3

Integer ≥ 0

Next Execution

ohi.processing.max.
numberofretries.<0>

The maximum amount of times activity processing will try to send out an 'activity processed' event to an external system - per activity type.

3

Integer ≥ 0

Next Execution

ohi.processing.
maxErrorAttempts

Number of times a task can resolve as 'errored' before it stops a task flow.

3

Integer ≥ 0

Next Execution

ohi.processing.
maxIncompleteAttempts

Determines how many times a specific incomplete task will reschedule for processing, before marking it as 'errored'.

10000

Integer ≥ 0

Next Execution

ohi.processing.pagesize.
GENERATE_FINANCIAL_
MESSAGES

Utilized for reading financial message chunks to generate financial messages in flat files or XML. It is used to determine how records will be processed.

5000

Integer ≥ 1

Next Execution

ohi.processing.
paymentstatuscomplete.
interval

Value (in seconds) - time interval that the application uses to check if all Payment Status response messages for a claim are received. For example: if this value is configured to be 5 seconds then the application will check every 5 seconds (until the period that is specified by property ohi.processing.paymentstatuscomplete.timeout is reached) if all Payment Status response messages for a claim are received. Falls back to ohi.processing.paymentstatuscomplete.timeout when not specified.

1≤ Integer ≤ value of ohi.
processing.
paymentstatuscomplete.
timeout

Next Execution

ohi.processing.
paymentstatuscomplete.
timeout

Value (in seconds) that the application uses to determine if all Payment Status response messages for a claim are received in time; if a response is not received before the time out period is exceeded, the Payment Status Complete task ends in an errored state. Increase this value if the Payment Status service does not respond to requests within 60 seconds. Provides a fallback to ohi.processing.paymentstatuscomplete.interval in case that property has not been specified.

60

Integer ≥ 1

Next Execution

ohi.processing.
pricingfinalize.
attempts.constraint

Total maximum number of times a claim can attempt to be finalized for pricing.

1000

Integer ≥ 1

Next Execution

ohi.processing.
retryimmediate

Determines if a failed task retries immediately, or re-queues for another attempt after a delay.

true

Boolean

Immediate

ohi.processing.yield.
default

This property specifies the default time (in seconds) that the system holds back a task in the processing grid, in between execution steps. This is typical for parent-child task relationships, where a parent task will has to regularly check on the status of its children.

3

Integer ≥ 1

Next Execution

ohi.processing.yield.
taskcompletion

This property specifies the time (in milliseconds) the system will hold an (aggregate) task backfor task loaders to complete their work.

3

Integer ≥ 1

Next Execution

ohi.processing.yield.<0>

This property specifies the default time (in seconds) that the system holds back a task in the processing grid, in between execution steps. This is typical for parent-child task relationships, where a parent task has to regularly check on the status of its children - per activity type.

3

Integer ≥ 1

Next Execution

ohi.startup.start.task.
processing

Controls task processing for a managed server. By default, if a managed server that executes an OHI Components application starts, then it will start processing tasks from the work backlog queue. You can override the default behavior by setting command-line parameter ohi.startup.start.task.processing; if it is set to false, a managed server that executes the OHI Components application will not process tasks after it starts. The default value is true, meaning the managed server that executes the OHI Components application will start processing tasks from the work backlog queue after it starts.

true

Boolean

Next Execution

Specifying Yields, Submission Count, Group Size, and Loader Count Per Activity Type

Claims allows to individually specify some of the aforementioned application properties on a per-activity-type basis. This provides finer grained control of loading and processing semantics. The way to accomplish this is to concatenate the mnemonic for the specific activity type after the specific property key, for example:

ohi.processing.groupsize.CALCULATE_PREMIUM=250

This mechanism is available for the following properties:

  • ohi.processing.yield.<activity_type>

  • ohi.max.headroom.<activity_type>

  • ohi.processing.groupsize.<activity_type>

  • ohi.processing.loadercount.<activity_type>

  • ohi.processing.loaderyield.<activity_type>

  • ohi.processing.max.numberofretries.<activity_type>

For the mnemonic of individual activity types, check the "Application Properties" page of the Installation Guide.

Group membership information can be cached under ohi.processing.cache.ingroup.<cacheName>.spec. For each use case there is a separate cacheName. All those caches are Google Guava caches. The .spec property defines the specification of the Google Guava’s CacheBuilder configuration. It is a string which is a series of comma-separated keys or key-value pairs, each corresponding to a CacheBuilder method. Example (make sure to specify on one line!): "maximumSize=10000, expireAfterWrite=5m,softValues". For more information, see CacheBuilderSpec’s javadoc: http://docs.guava-libraries.googlecode.com/git/javadoc/com/google/common/cache/CacheBuilderSpec.html

Name Description Default Value Possible Values Change Effective

ohi.processing.cache.
ingroup.countryregion.
spec

This cache maintains the result if CountryRegion is in CountryRegionGroup, where the system creates a key using the CountryRegion.Id and CountryRegionGroupCode

maximumSize=1000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.diagnosis.spec

Specification for the cache storing diagnosis group membership. Value should be a valid Google Guava specification. See the CacheBuilderSpec’s javadoc: http://docs.guava-libraries.googlecode.com/

maximumSize=100000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.flexcode.spec

Cache for Flex Codes in a Flex Code Group

maximumSize=100000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.locationtype.
spec

This cache maintains the result if LocationType is in LocationTypeGroup, where a key is created using the LocationType.Id and LocationTypeGroupCode.

maximumSize=1000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.message.spec

Cache for messages in a message group.

maximumSize=1000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.procedure.spec

Specification for the cache storing procedure group membership. Value should be a valid Google Guava specification. See the CacheBuilderSpec’s javadoc: http://docs.guava-libraries.googlecode.com/

maximumSize=100000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.productprovider.
spec

A specification of Google Guava’s CacheBuilder configuration. It configures a cache for products in a provider group. Defined as a string, which is a series of comma-separated keys or key-value pairs, each corresponding to a CacheBuilder method. See CacheBuilderSpec for additional detail.

maximumSize=10000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.provider.spec

A specification of Google Guava’s CacheBuilder configuration. It configures a cache for providers in a provider group. Defined as a string, which is a series of comma-separated keys or key-value pairs, each corresponding to a CacheBuilder method. See CacheBuilderSpec for additional detail.

maximumSize=10000,
softValues,
recordStats

String

Next Execution

ohi.processing.cache.
ingroup.
unfinalizereason.spec

This cache maintains the result if UnfinalizeReason is in UnfinalizeReasonGroup, where a key is created using the UnfinalizeReason.Id and UnfinalizeReasonGroupCode.

maximumSize=1000,
softValues,
recordStats

String

Next Execution

Data File Import

The following table lists (technical) properties that influence data file (batch) processing performance. Only change these after consulting with Oracle:

Name Description Default Value Possible Values Change Effective

ohi.consumptionimport.
filereader.chunk.size

The number of importable data units to collect as one processable group from a external insurable objects source file

1000

Integer ≥ 1

Next Execution

ohi.diagnosisimport.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of diagnoses of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.
draftproviderpricingclause.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of draft provider pricing clauses of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.
feeschedulelinesimport.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of fee schedules of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.
insurableobjectimport.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of insurable objects of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.
pendresolutionimport.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of pend resolution of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.procedureimport.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of procedures of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.
productbenefitspecification.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of product benefit specifications of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.providerimport.
filereader.chunk.size

A separate processing activity spawns for processing a chunk or batch of providers of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.
referencesheetimport.
filereader.chunk.size

The system spawns a separate processing activity to process a chunk or batch of reference sheet lines of the specified size.

5000

Integer ≥1

Next Execution

ohi.registrationimport.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of registrations of the specified size.

1000

Integer ≥ 1

Next Execution

ohi.relationimport.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of relations of the specified size.

5000

Integer ≥ 1

Next Execution

ohi.reprocessclaims.
filereader.chunk.size

A separate processing activity is spawned for processing a chunk or batch of reprocessed claims of the specified size.

5000

Integer ≥ 1

Next Execution

Claims In Integration Point

Name Description Default Value Possible Values Change Effective

ohi.claimsin.provider.
autocreate

When the this property is set to true, provider matching in claims-in integration point is done on code and flexCodeDefinitionCode of the provider only. If no matching record could be found, the system creates a new provider with the information (e.g. name) that is included in the message. When the code and flexCodeDefinitionCode of the provider could be matched to an existing provider, then the provider is updated with the element values in the message if they are different from the values in the OHI reference data.

false

Boolean

Next Execution

ohi.claimsin.relation.
autocreate

When the this property is set to true, relation matching in claims-in integration point is done on code of the relation only. If no matching record could be found, the system creates a new relation (person/organization) with the information (e.g. name and date of birth) that is included in the message. When the code of the relation could be matched to an existing relation, then the relation is updated with the element values in the message if they are different from the values in the OHI reference data.

false

Boolean

Next Execution

Claims URL References

In Workflow messages or HTTP API RESTful services links, URL references may be passed. Construction of the URL for these pages is driven by the following parameters:

Name Description Default Value Possible Values Change Effective

ohi.claims.change.url

MANDATORY
Reference to the UI page for change claims, to be contained by a Workflow event.

String

Next Execution

ohi.claims.
manualadjudication.url

MANDATORY
Reference to the UI page for manual adjudication, to be contained by a Workflow event.

String

Next Execution

ohi.claims.
manualbenefits.url

MANDATORY
Reference to the UI page for application of manual benefits, to be contained by a Workflow event.

String

Next Execution

ohi.claims.
manualpricing.url

MANDATORY
Reference to the UI page for manual pricing, to be contained by a Workflow event.

String

Next Execution

ohi.claims.
manualpricingadjudication.
url

MANDATORY
Reference to the UI page for application of manual pricing adjudication, to be contained by a Workflow event.

String

Next Execution

ohi.<0>.application.
baseurl

MANDATORY
This is the default URL for accessing the application. It is used in asynchronous responses and notifications containing links. It typically includes the machine or load balancer, the domain, and a port number. The placeholder <0> in this property name must specify the application name. Use a custom header to overwrite the default behavior. Set the custom header value to true to ignore the property and allow the application to create URLs based on the request URL.

String

After Restart

ohi.<0>.deeplink.url

MANDATORY
The base URL of an application for ADF/JET UI deep linking URL formation. It includes the machine or load balancer, the domain and a port number. It is mandatory to set a correct link in the deep linking URL. The application name must replace the Placeholder <0>. An example of the value is http://localhost:7001.

String

After Restart

ohi.http.api.path

The context root of the application. For example, /<application>-ws/api. We do not anticipate for this property to be hot reloadable.

api

String

Next Execution

Before sending URI’s out, the system will encode these. The receiving system is expected to decode the URI.

Callout Rules

Name Description Default Value Possible Values Change Effective

ohi.servicecallout.<0>.
url

MANDATORY
The media type to be used for REST call outs for a specific <calloutdefinition_code>. If this property is not set for a specific Callout definition, the system will throw an error upon use.

String

Next Execution

ohi.servicecallout.
media.type

The media type to be used for REST call outs. Can be overriden per call out, see 'ohi.servicecallout.<0>.media.type'.

application/json

String

Next Execution

ohi.servicecallout.<0>.
completeness.interval

Time interval in seconds used by the system to check if a response for the Callout Rule is received. The <0> placeholder should match the calloutdefinition code that is configured for a specific rule. Rule: 1 ≤ completeness.interval ≤ completeness.timeout. This is verified at system startup. If the completeness interval parameter is not specified for a Callout Rule, the system will use the value of 'ohi.servicecallout.<0>.completeness.timeout' (which has in its turn default value '5').

Integer ≥ 1

Next Execution

ohi.servicecallout.<0>.
completeness.timeout

Time interval in seconds used by the system to determine if a response for the Callout Rule is received in time. If a response is not received before the time out period is exceeded, the system raises an error. The <0> placeholder should match the calloutdefinition code that is configured for a specific rule. Rule: completeness.timeout > 1. This property also provides a fallback value when completeness.interval is not set.

5

Integer > 1

Next Execution

ohi.servicecallout.<0>.
media.type

The media type to be used for an individual REST call out, <0> to be replaced with callout definition code. When this property is not set, the value of 'ohi.servicecallout.media.type' will be used.

application/json

String

Next Execution

Data Exchange

Name Description Default Value Possible Values Change Effective

ohi.application.uri.<0>

MANDATORY
Reference to URI of the source application to retrieve data-sets metadata to be processed. Either "CONF" or "PRD" as values replace the <0>. It is possible to define multiple URI’s, with ";" separating each.

String

Next Execution

ohi.cm.concurrency.limit

This property specifies the number of parallel threads in configuration migration tool for export and import processes. For better performance results, we recommend the value of this system property to be equal to the number of CPUs (core). For example, if there are six CPUs and each of them is single-core, then this property must be six

2

Integer ≥ 1

After Restart

ohi.cm.dynamiclogic.
import.maxretrycount

Some Dynamic Logic can refer to another Dynamic Logic and if the Dynamic Logics are not imported in the correct order, the compilation will fail. If this happens, the CMT process retries the failed Dynamic Logic. This property specifies how many times the Dynamic Logic Import retries before marking it as errored. We suggest to use a value between one and nine.

3

Integer ≥ 0

Next Execution

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

The number of records from the failure table that the CMT process reads at once during retry processing.

100

Integer ≥ 0

Next Execution

ohi.cm.
highvolumeentities.
export.page.size

The system uses this property in the export process and it represents the number of high volume entities (For example, Procedure Group detail) to read at a time. We recommend setting this value to N * 1000, where N is the number of JVMs.

1000

Integer ≥ 1

Next Execution

Enrollment Client

Name Description Default Value Possible Values Change Effective

ohi.enrollment.
logtraffic

Can be used to switch on/off HTTP traffic logging for Jersey/REST machine-to-machine enrollment communication. When specified as true - requires additional logback configuration

false

Boolean

Next Execution

ohi.enrollment.server.
connect.timeout

This property specifies the number of milliseconds allowed to establish a connection with the Enrollment Service.

1000

Integer ≥1

Next Execution

ohi.enrollment.server.
read.timeout

This property specifies the number of milliseconds allowed to get the result from the Enrollment Service, once it is invoked.

1000

Integer ≥1

Next Execution

ohi.enrollment.server.
status.operation

This property specifies the request path to identify the Enrollment operation to be invoked. Do not add a leading or trailing slash.

api/enrollments

String

Next Execution

ohi.enrollment.server.
uri

This property specifies the scheme + authority part that hosts the Enrollment system. Example value: 'http://acme.net:7998' (do not add a trailing slash).

String

Next Execution

Enrollment inquiries can be logged at a fairly low level. In particular this enables to trace HTTP request and response between the system that initiates the request for enrollment status information and the enrollment system that responds back to these inquiries. To set this up add the following piece of information to the logging configuration.

<logger name="ohi.enrollment_client" level="info"/>

User Interface

Name Description Default Value Possible Values Change Effective

ohi.
accessibilitypreference.
popup

Use this property to initiate showing a modal pop-up for UI accessibility settings, in case the system hasn’t done that for the user earlier.

false

Boolean

Next Execution

ohi.environment.
identifier

Text string on the home page of the system that helps the user to identify the environment. Samples are 'User Acceptance Test' or 'Development'.

ohi

String

Next Execution

ohi.jsui.cmt.payload.
max.items.limit

This property is used to provide maximum number of items that can be included in a CMT payload

300

Integer ≥ 1

Immediate

ohi.jsui.formatted.
address.organization

This property is used to display the formatted address in context of a organization

String

After Restart

ohi.jsui.formatted.
address.person

This property is used to display the formatted address in context of a person

String

After Restart

ohi.jsui.formatted.name.
individualproviders

This property is used to display the formatted name in context of an individual provider

String

After Restart

ohi.jsui.formatted.name.
persons

This property is used to display the formatted name in context of a person

String

After Restart

ohi.ui.accessToken.root.
url

The webgate URL root (Required for CSP whitelist).

String

After Restart

ohi.ui.accessToken.url

The webgate URL to access accessToken resource.

String

After Restart

ohi.ui.api.
authentication.method

Authentication mechanism for the JET UI. One of OAuth, BasicAuthentication, WebGate (in case a gateway handles authentication) or OpenID (in case OpenID Connect is used - see below table for more properties).

Oauth

String

After Restart

ohi.ui.api.
authentication.oauth.
clientId

The clientId is the public identifier for the JET UI. Mandatory when using OAuth. Not applicable when not using OAuth. Has no default value.

String

After Restart

ohi.ui.backEnd.root.url

The base URL for accessing web services, typically includes the machine or loadbalancer, the domain and a port number.

String

After Restart

ohi.ui.backEndURL

Fully qualified URL for HTTP API resources. The path in the URL should include the context root for HTTP API resources. The default context root for HTTP API resources is '/api'. Note that this could be a load balancer URL and / or that the default context root might have been overwritten using a deployment plan.

String

After Restart

ohi.ui.httplink.<0>

This property is used for defining the address of the http link. <0> to be replaced by a custom identifier to give more context to the http link configuration.

String

Immediate

ohi.ui.logout.url

The URL used by Oracle JET to actively logout a user (session)

String

After Restart

ohi.ui.
maxrecordsofaccesshistory

Maximum number of access history records to be shown/stored for the UI page.

10

Integer ≥ 1

Next Execution

ohi.ui.maxrowstoretrieve

Maximum number of rows retrievable to show in a UI table. Note that this value impacts memory usage and page load times.

200

Integer ≥ 1

Next Execution

ohi.ui.
maxrowstoretrieve.<0>

Maximum number of rows retrievable to show in a UI table for an individual page. The function code is the one shown in the 'About this page' pop-up, and is case-sensitive. Note: It is not possible to change the number of rows that show up for an individual LOV. The ohi.ui.maxrowstoretrieve always restricts the LOV. If this property is not set, it will take the value of ohi.ui.maxrowstoretrieve (which has in its turn a default of '200')

Integer ≥ 1

Next Execution

ohi.ui.pollinterval

This property controls the interval between automatic page refreshes for pages that support it. Value is in milliseconds.

5000

Integer ≥ 1

Next Execution

ohi.ui.pollinterval.<0>

This property controls the interval between automatic page refreshes for pages that support it. The <function_code> is an optional suffix that the system can use to differentiate poll intervals between different pages.

5000

Integer ≥ 1

Next Execution

ohi.ui.session.timeout

The timeout is the time (in milliseconds) after which the current user session expires and displays 'The page has expired' warning dialog. Clicking OK re-directs the user to the login page. The default value is set to 1hr (3600000 ms). A value of 0 means never timeout.

3600000

Integer ≥ 0

After Restart

ohi.ui.waitTime

The waitTime is the time (in milliseconds) between entering a character in a search field, and the search firing. Applies to quick search and LOV, suggested is 1500.

1500

Integer ≥ 1

After Restart

ohi.ui.webgate.logout.
url

Logout from WebGate/SSO external provider

/logout

String

After Restart

ohi.ui.webgate.url

OAM URL (Required for CSP whitelist).

String

After Restart

Specifically for OpenID Connect Support

The following table lists user interface related properties, specifically for OpenID Connect support:

Name Description Default Value Possible Values Change Effective

ohi.oauth.idp.uri

A system property needs to be set to the IDP (IDentity Provider) URL to acquire the OpenID Connect configuration. This property is expected to be set when 'ohi.oauth.use.openidconnect' is set to 'true'.

String

After Restart

ohi.oauth.use.
openidconnect

When set to true, it indicates that Oracle JET UI leverages OpenID Connect authentication.

false

Boolean

After Restart

ohi.security.oauth.
callback

Specifies the OpenID Connect callback URL to be invoked after authentication of the user through OpenID Connect has taken place, but before an access token has been obtained.

oidc/callback

String

After Restart

ohi.security.oauth.
cookie.maxage

This property determines the time (in seconds) until the the OAUTH authentication cookie expires.

3600

Integer ≥ 1

After Restart

ohi.security.oauth.
cookie.name

This property specifies the name of the shared cookie in which the OpenID connect authentication information is stored

OHI_SHARED_AUTH

String

After Restart

ohi.security.oauth.
cookie.path

This property specifies the path of the OHI OAUTH Session Cookie. This path must exist in the requested URL, or the browser won’t send the Cookie header.

/

String

After Restart

ohi.security.oauth.
cookie.secure

This property determines if the OAUTH authentication cookie is set to 'secure'. When set to true, the cookie is only sent to the server when a request is made with the 'https:' scheme.

false

Boolean

After Restart

ohi.security.oauth.
frontend

Specifies the base URL of the JET Application that needs to be secured (e.g. https://host:8909/oig)

/

String

After Restart

ohi.security.oauth.
logout

Specifies the OpenID Connect URL that is to be invoked after a user has selected to logout from the UI.

oidc/logout

String

After Restart

Outbound Restful Service Invocation Specific to Notifications

Name Description Default Value Possible Values Change Effective

ohi.eventing.ui.path

MANDATORY
This is the URI of the deployed ADF UI application - used as the base for creation of ADF Deeplinks. A typical example of this value would be: 'http://acme.net:8090/auths'. Default equals the application name.

String

Next Execution

Replicating Member and Authorizations Data

Member data can be replicated from Policies and authorizations data from Oracle Health Insurance Authorizations. These are referred to as source systems. The following table lists the parameters for that:

Name Description Default Value Possible Values Change Effective

ohi.ws.sourcesystem.<0>.
baseurl

MANDATORY
Base URI to the source system; must include the context root for accessing HTTP API services; by default that context root is '/api', you may change it with a deployment plan.

String

Immediate

ohi.datareplication.
event.retrieval.interval

For specifying the number of seconds between consecutive polls for retrieving events from a replication source.

300

Integer ≥ 1

Immediate

Extract

Name Description Default Value Possible Values Change Effective

ohi.extract.<0>.
notification.endpoint

For sending out an extract completion notification for a specific notification key. The notification key replaces the <0>. An example value would be http://machine.domain:port/notifications.

String

Next Execution

Monitoring and Metrics

Name Description Default Value Possible Values Change Effective

ohi.healthcheck.url.
mapping

Defines the mapping between the Healthcheck servlet and a URL pattern. Value is a URL Mapping (For example, /up).

String

After Restart

ohi.instrumentation.
common.application.tag

Set to true to tag each metric with the name of the application.

false

Boolean

After Restart

ohi.instrumentation.
filter.ohi.nameprefix

Set to false to enable recording of non-OHI metrics.

true

Boolean

After Restart

ohi.instrumentation.
gather.
applicationmetrics

Set to true to enable recording of metrics.

false

Boolean

Immediate

ohi.instrumentation.
gather.jvmtelemetry

Set to true to enable recording of JVM telemetry.

false

Boolean

After Restart

ohi.instrumentation.
resourceclienttimer.
segment.prefixes

Comma-separated list of resource path segment prefixes for resource client timers that the system interprets as not being the last segment of the resource path.

Comma-
separated string,
e.g. api,oig-api,
policies-ws

After Restart

ohi.instrumentation.<0>.
histogram

Determines whether to publish histogram buckets for the timer you configure.

false

Boolean

After Restart

ohi.instrumentation.<0>.
percentiles

Percentiles for the timer you configure.

Comma-
separated string,
e.g. 0.5,0.75,0.
95,0.99

After Restart

ohi.instrumentation.<0>.
regex

The system publishes data for the timer if the tag name that you specify as property ohi.instrumentation.<0>.regex.tagname matches this regular expression.

Regular expression

After Restart

ohi.instrumentation.<0>.
regex.tagname

Tag name subject to testing with the regular expression that you specify as property ohi.instrumentation.<0>.regex. The system publishes data for the timer if the tag name matches the regular expression.

String

After Restart

ohi.prometheusservlet.
url.mapping

Defines the mapping between the Prometheus servlet and an URL pattern

String, URL Mapping

After Restart

See the Operations Guide for details about metric related properties.

Workflow Tasks

Name Description Default Value Possible Values Change Effective

ohi.workflowtaskdone.
enabled

Property that controls whether task done event should be sent out or not

true

Boolean

Next Execution

ohi.workflowtaskstart.
endpoint.request

Reference to the Web Service endpoint which the OHI Claims system uses to initiate a Workflow task. Multiple Web Service endpoints can be specified as comma separated URLs.

String

Next Execution