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.
Properties
ohi.properties.file.poll.interval
The application does not pick up changes to any of these properties immediately. 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. The system ignores values lower than that, meaning it uses the default value.
Possible values: Integer ≥ 1
Default value: 10
Change effective: Next Execution
Dynamic Logic
ohi.dynamiclogic.classes.directory
Path to directory in which the system places the generated Dynamic Logic classes.
Possible values: String
Default value: /tmp
Change effective: 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.
Possible values: Boolean
Default value: true
Change effective: Next Execution
ohi.dynamiclogic.startup.compile.await.timeout
Max time (in milliseconds) for which nodes should wait for the oldest node to mark the status of pre-compilation as complete
Possible values: Integer ≥ 1
Default value: 30000
Change effective: After Restart
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".
Possible values: Integer ≥ 0
Default value: 300
Change effective: 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". If this property is not set, it takes the value of
ohi.dynamiclogic.timeout
(which in its turn has a default of '300').
Possible values: Integer ≥ 0
Default value:
Change effective: Next Execution
Logging Support
ohi.logging.fileset.max.timespan
Maximum time in days between start and end time for bundling log events in a file set
Possible values: Integer ≥ 1
Default value: 2
Change effective: Immediate
Incident Reports
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.
Possible values: Integer ≥ 1
Default value: 10
Change effective: 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.
Possible values: String
Default value: target/trace
Change effective: 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.
Possible values: "file" or "datafileset"
Default value: file
Change effective: After Restart
Cache Control
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
.
Possible values: String
Default value:
Change effective: 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.
Possible values: Boolean
Default value: false
Change effective: Next Execution
ohi.messagegroup.cachesize
Use it as an initial sizing element for the number of cached message groups
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
System Resources
ohi.system.memory.normal.delay
The time before the memory state gets reset to normal from non-normal. This prevents the systemfrom switching to often between
healthy and not-healthy.The value is in seconds
Possible values: Integer ≥ 0
Default value: 60
Change effective: Next Execution
ohi.system.memory.threshold.critical
When the free memory drops below this value, the system enters the critical memory state.The value is in MB
Possible values: Integer ≥ 0
Default value: 64
Change effective: Next Execution
Web Service Connection Settings
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.
Possible values: String
Default value:
Change effective: Next Execution
ohi.rest.client.logging
Enable or Disable logging for rest clients. When "true" will log traffic to external system.
Possible values: Boolean
Default value: false
Change effective: Immediate
ohi.service.client.cache.size
The rest client cache size.
Possible values: Integer ≥ 1
Default value: 500
Change effective: Immediate
ohi.service.client.pool.active
Enable or disable to leverage connection pool functionality
Possible values: Boolean
Default value: true
Change effective: After Restart
ohi.service.client.pool.destination.maxconnections
The maximum number of connections in the pool per destination. Effective immediately for non-cached clients.
Possible values: Integer ≥ 1
Default value: 64
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 1024
Change effective: After Restart
ohi.service.client.pool.timeout.addressresolution
The max time, in milliseconds, to resolve the host address. Effective immediately for non-cached clients.
Possible values: Integer ≥ 1
Default value: 15000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 15000
Change effective: After Restart
ohi.service.client.pool.timeout.idle
The max time, in milliseconds, a connection can be idle. Effective immediately for non-cached clients.
Possible values: Integer ≥ 1
Default value: 60000
Change effective: After Restart
ohi.service.client.response.content.maxsize
Maximum allowed response content size in MegaBytes (MB).
Possible values: Integer ≥ 1
Default value: 2147
Change effective: 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>.
Possible values: String
Default value: BasicAuthentication
Change effective: 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.
Possible values: Integer ≥ 1
Default value:
Change effective: 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.
Possible values: Integer ≥ 1
Default value:
Change effective: 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.
Possible values: Integer ≥ 1
Default value:
Change effective: 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.
Possible values: Integer ≥ 1
Default value:
Change effective: 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.
Possible values: Integer ≥ 1
Default value:
Change effective: After Restart
ohi.service.<0>.media.type
For the notification media type. Notification key replaces the <0>.
Possible values: String
Default value: application/json
Change effective: Next Execution
ohi.service.<0>.method.type
This property is for the notification method type. The notification key replaces the <0>.
Possible values: String
Default value: POST
Change effective: Next Execution
ohi.ws.api.default.pagesize
Number of items fetched in a HTTP API request.
Possible values: Integer ≥ 1
Default value: 50
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 60000
Change effective: Immediate
ohi.ws.client.maxconnectionsperhost
The maximum number of concurrent connections the HTTP client will allow to a certain host at any given moment.
Possible values: Integer ≥ 1
Default value: 2
Change effective: Immediate
ohi.ws.client.maxtotalconnections
Sets the maximum number of total concurrent connections the HTTP client will allow at any given moment.
Possible values: Integer ≥ value of ohi.ws.client.maxconnectionsperhost
Default value: 20
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 60000
Change effective: Immediate
ohi.ws.client.retrytimeout
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.
Possible values: Integer ≥ 0
Default value: 1000
Change effective: After Restart
ohi.ws.enrollmentresponse.request.enabled
Allows the enrollment step to be disabled from the claims flow (typically for pricing only installation).
Possible values: Boolean
Default value: true
Change effective: Next Execution
ohi.ws.enrollmentresponse.request.lob
This property can be set to true if the enrollment request uses the name lineOfBusinessCode as a request parameter
Possible values: Boolean
Default value: false
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 1
Change effective: 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.
Possible values: Boolean
Default value: true
Change effective: Next Execution
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.
ohi.claimsout.datafile.notification.endpoint
MANDATORY
Used to specify the URI for sending out 'completion message' for claims out (FileBased).
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: Next Execution
ohi.reprocessclaims.datafile.notification.endpoint
MANDATORY
Used to specify the URI for sending out 'completion message' for claims reprocessing (FileBased).
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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
Possible values: String
Default value:
Change effective: 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
Possible values: String
Default value:
Change effective: 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
Possible values: String
Default value:
Change effective: 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
Possible values: String
Default value:
Change effective: 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
Possible values: String
Default value:
Change effective: 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
Possible values: String
Default value:
Change effective: 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>
.
Possible values: String
Default value:
Change effective: 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: Claim Transaction Event
Client Name: CtrClaimEventClient
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
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:
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.
Possible values: Boolean
Default value: false
Change effective: 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:
ohi.cors.access.control.allow.origin
MANDATORY
Comma-separated list of allowed origins. The value '' effectively allows all origins.
*Possible values: String
Default value:
Change effective: 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.
Possible values: Boolean
Default value: true
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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:
ohi.untrusteddata.allowlist.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>.
Possible values: String
Default value:
Change effective: Next Execution
ohi.untrusteddata.allowlist.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>.
Possible values: String
Default value:
Change effective: Next Execution
ohi.untrusteddata.allowlist.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>.
Possible values: String
Default value:
Change effective: Next Execution
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.
Possible values: Boolean
Default value: true
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 30
Change effective: Next Execution
ohi.untrusteddata.whitelist.domainattribute
DEPRECATED
Deprecated: use ohi.untrusteddata.allowlist.domainattribute instead. 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>.
Possible values: String
Default value:
Change effective: Next Execution
ohi.untrusteddata.whitelist.httpheader
DEPRECATED
Deprecated: use ohi.untrusteddata.allowlist.httpheader instead. 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>.
Possible values: String
Default value:
Change effective: Next Execution
ohi.untrusteddata.whitelist.queryparameter
DEPRECATED
Deprecated: use ohi.untrusteddata.allowlist.queryparameter instead. 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>.
Possible values: String
Default value:
Change effective: 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
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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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:
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. For example, to account for some network delay between the client and the authorization server. For example, if the
authorization server returns a token with an expiry time of 3600 seconds and if the network delay is 100 ms, then you can
configure 100 ms for this key. The system will cache the resulting access token for the original expiry time minus overhead time,
that is, 3600000 - 100 = 3599900 ms. You must specify the value in milliseconds.
Possible values: Integer ≥ 0
Default value: 10
Change effective: Immediate
ohi.oauth.jwk.set.url
The URL value for the OAuth2 authorization server JSON Web Key (JWK) Set endpoint. The OAuth2 authorization server must support
RFC 7517. Token Validation Method is JWKSET.
Possible values: String, URL
Default value:
Change effective: After Restart
ohi.oauth.jwk.set.validation.audience
Client Id or audience claim for Token Validation. Token Validation Method is JWKSET.
Possible values: String
Default value:
Change effective: After Restart
ohi.oauth.jwk.set.validation.issuer
Issuer for Token Validation. Token Validation Method is JWKSET.
Possible values: String or URL
Default value:
Change effective: After Restart
ohi.oauth.jwk.set.validation.jws.signing.algorithm
Signing algorithm that the Authorization Server uses. Token Validation Method is JWKSET.
Possible values: String
Default value: RS256
Change effective: After Restart
ohi.oauth.jws.signing.algorithm
Algorithm 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 an assertion). Note that it only supports RSA algorithms.
Possible values: RS256, RS384, RS512
Default value: RS512
Change effective: 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 an assertion) .
Possible values: 0 ≤ Integer ≤ 9999
Default value: 600
Change effective: Immediate
ohi.oauth.jwt.userid.claim
Specifies the claim in the JWT that can identify the user for which the system creates the OAuth2 access token. Token Validation
Method is JWKSET.
Possible values: String
Default value: sub
Change effective: Immediate
ohi.oauth.openidconnect.accesstoken.client_id
Client ID of the OpenID Connect client that has to be present to acquire an access token.
Possible values: String
Default value:
Change effective: Immediate
ohi.oauth.openidconnect.accesstoken.credential
Credential associated with the OpenID Connect client that has to be present to acquire an access token.
Possible values: String
Default value:
Change effective: Immediate
ohi.oauth.openidconnect.accesstoken.validation.clockskew
Defines the maximum acceptable clock skew (in seconds) for validating timestamps of ID tokens that an OpenID Provider issues.
Possible values: Integer ≥ 1
Default value: 60
Change effective: After Restart
ohi.oauth.token.introspection.endpoint.client_id
Unique Client Id for resolving the username and password credentials. When calling the OAuth2 authorization server token
validation or introspection endpoint, the system uses this unique Client Id to construct the Basic Authentication Authorization
header. Token Validation Method is OAUTH2_ENDPOINT.
Possible values: String
Default value:
Change effective: Immediate
ohi.oauth.token.introspection.endpoint.url
The URL value for the OAuth2 authorization server token validation or introspection endpoint. It assumes that the endpoint
supports Basic Authentication. Token Validation Method is OAUTH2_ENDPOINT.
Possible values: String, URL
Default value:
Change effective: After Restart
ohi.oauth.token.introspection.response.username
Specifies the RFC 7662 defined Introspection Response element to derive the username from. Token Validation Method is
OAUTH2_ENDPOINT.
Possible values: String
Default value: sub
Change effective: 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
.
Possible values: String or URL
Default value:
Change effective: 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>
.
Possible values: String
Default value:
Change effective: 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
.
Possible values: Comma-separated string, e.g. oracle_idcs,azure_ad
Default value:
Change effective: After Restart
ohi.oauth.token.validation.method
Determines the access Token Validation Method. Possible values: JWKSET: The resource server validates the OAuth2 access tokens .
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 that an OAuth2 authorization server exposes. Use this method to validate ID tokens that an OpenID Provider
issues.OAUTH2_ENDPOINT: validates the token using an OAuth2 authorization server’s token introspection endpoint as defined by RFC
7662.
Possible values: JWKSET, OAUTH2_ENDPOINT
Default value: JWKSET
Change effective: 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
ohi.claims.ignore.history
MANDATORY
Controls with what value the indicator ignore history of ClaimLine should be switched on or off.
Possible values: Boolean
Default value: false
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: Next Execution
ohi.activityprocessing.threadpool.size
This property configures the size of the thread pool used for processing the activities. The default value is used if no correct
value is configured.
Possible values: Integer ≥ 1
Default value: 8
Change effective: Immediate
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.
Possible values: 2 ≤ Integer ≤ 12.
Default value: 2
Change effective: 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.
Possible values: Boolean
Default value: false
Change effective: Next Execution
ohi.claims.quote.financial
Property to configure whether financial transactions for claims of process type Q(uote) should be created or not.
Possible values: Boolean
Default value: false
Change effective: Next Execution
ohi.claims.reservation.financial
Property to configure whether financial transactions for claims of process type R(eservation) should be created or not.
Possible values: Boolean
Default value: true
Change effective: 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
Possible values: Boolean
Default value: true
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 500
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5
Change effective: Next Execution
ohi.max.headroom
The maximum number of tasks to load into the processing grid.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
ohi.max.headroom.<0>
The maximum number of tasks to load into the processing grid - per given activity type.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 0
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: Next Execution
ohi.processing.cache.claimeventrules.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.
Possible values: String
Default value: maximumSize=1000,softValues,recordStats
Change effective: Next Execution
ohi.processing.cache.dynamicfieldsetupcache.spec
Specification for a cache that caches DynamicFieldSetup. For more information, see CacheBuilderSpec’s javadoc:
https://guava.dev/releases/19.0/api/docs/com/google/common/cache/CacheBuilderSpec.html
Possible values: String
Default value: maximumSize=10000,softValues,recordStats,expireAfterAccess=3600s
Change effective: Next Execution
ohi.processing.cache.dynamicrecordsetupcache.spec
Specification for a cache that caches the DynamicRecordSetup. For more information, see CacheBuilderSpec’s javadoc:
https://guava.dev/releases/19.0/api/docs/com/google/common/cache/CacheBuilderSpec.html
Possible values: String
Default value: maximumSize=10000,softValues,recordStats,expireAfterAccess=3600s
Change effective: 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.
Possible values: String
Default value: maximumSize=1000,softValues,recordStats
Change effective: Next Execution
ohi.processing.cache.fielddetailsetupcache.spec
Specification for a cache that caches the FieldDetails. For more information, see CacheBuilderSpec’s javadoc:
https://guava.dev/releases/19.0/api/docs/com/google/common/cache/CacheBuilderSpec.html
Possible values: String
Default value: maximumSize=10000,softValues,recordStats,expireAfterAccess=3600s
Change effective: 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
Possible values: String
Default value: maximumSize=10000,softValues,recordStats,expireAfterAccess=3600s
Change effective: Next Execution
ohi.processing.cache.flexcodesetupcache.spec
Specification for a cache that caches the FlexCodeSetup. For more information, see CacheBuilderSpec’s javadoc:
https://guava.dev/releases/19.0/api/docs/com/google/common/cache/CacheBuilderSpec.html
Possible values: String
Default value: maximumSize=10000,softValues,recordStats,expireAfterAccess=3600s
Change effective: 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
Possible values: String
Default value: maximumSize=1000,softValues,recordStats,expireAfterAccess=3600s
Change effective: 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.
Possible values: String
Default value: maximumSize=1
Change effective: Next Execution
ohi.processing.cache.ingroup
This property allows for caching of the responses of the "InGroup" family of function calls.
Possible values: Boolean
Default value: false
Change effective: Next Execution
ohi.processing.cache.productbenefitspecifications.spec
A specification of Google Guava’s CacheBuilder configuration. It configures a cache for product benefit specifications. Defined
as a string which is a series of comma-separated keys or key-value pairs, each corresponding to a CacheBuilder method.The cache
has an entry for every combination of product, claim form, calendar year and benefit specification subtype
Possible values: String
Default value: maximumSize=5000,softValues,recordStats
Change effective: Next Execution
ohi.processing.concurrentparentactivities.throttle
System property that determines whether the parent level/root activities should be throttled.The parent activities spawned by the
system (i.e., activities with origin 'Spawned' but not initiated by the user) are not throttled by default. This behavior can be
overruled through the activity type specific property ohi.processing.concurrentparentactivities.throttle.<0>.<1>
Possible values: Boolean
Default value: true
Change effective: Next Execution
ohi.processing.concurrentparentactivities.throttle.<0>.<1>
System property that determines whether the parent level/root activities should be throttled per activity type per activity
level.The first placeholder is the activity type code and the second placeholder is the activity level
Possible values: Boolean
Default value:
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 3
Change effective: Next Execution
ohi.processing.enrollment.cacheexpiry
Number of minutes gathered enrollment data can be considered as 'up-to-date' (i.e. not expired).
Possible values: Integer ≥ 1
Default value: 5
Change effective: 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).
Possible values: Integer ≥ 0
Default value: 3
Change effective: 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).
Possible values: Integer ≥ 1
Default value: 1
Change effective: Next Execution
ohi.processing.finalize.attempts.constraint
Total maximum number of times to attempt finalization of a claim.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 400
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 500
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 500
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 100
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 100
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 500
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 400
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 1
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 1
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 3
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 3
Change effective: Next Execution
ohi.processing.max.concurrentparentactivities.size
System property that determines the number of parent activities that run in parallel by default, if throttling is enabled.The
parent activities spawned by the system (i.e., activities with origin 'Spawned' but not initiated by the user) are not considered
for size limit by default. This behavior can be overruled through the activity type specific property
ohi.processing.max.concurrentparentactivities.size.<0>.<1>
Possible values: Integer ≥ 0
Default value: 8
Change effective: Next Execution
ohi.processing.max.concurrentparentactivities.size.<0>.<1>
System property that determines the number of parent activities that run in parallel per activity type per activity level. The
first placeholder is the activity type code and the second placeholder is the activity level
Possible values: Integer ≥ 0
Default value:
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 3
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 3
Change effective: Next Execution
ohi.processing.maxErrorAttempts
Number of times a task can resolve as 'errored' before it stops a task flow.
Possible values: Integer ≥ 0
Default value: 3
Change effective: Next Execution
ohi.processing.maxIncompleteAttempts
Determines how many times a specific incomplete task will reschedule for processing, before marking it as 'errored'.
Possible values: Integer ≥ 0
Default value: 10000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: 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.
Possible values: 1≤ Integer ≤ value of ohi.processing.paymentstatuscomplete.timeout
Default value:
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 60
Change effective: Next Execution
ohi.processing.pricingfinalize.attempts.constraint
Total maximum number of times a claim can attempt to be finalized for pricing.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
ohi.processing.retryimmediate
Determines if a failed task retries immediately, or re-queues for another attempt after a delay.
Possible values: Boolean
Default value: true
Change effective: Immediate
ohi.processing.throttle.activities.task.dequeue.delay.<0>.<1>
Amount of delay in seconds (per activity type per activity level) when a task re-queues for another attempt. The first
placeholder is the activity type code and the second placeholder is the activity level
Possible values: Integer ≥ 0
Default value:
Change effective: Next Execution
ohi.processing.throttle.activities.task.priority.<0>.<1>
Priority of the task (per activity type per activity level) for execution. The first placeholder is the activity type code and
the second placeholder is the activity level
Possible values: Integer ≥ 0
Default value:
Change effective: Next Execution
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.
Possible values: Integer ≥ 1
Default value: 3
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 3
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 3
Change effective: 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.
Possible values: Boolean
Default value: true
Change effective: 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
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
Possible values: String
Default value: maximumSize=1000,softValues,recordStats
Change effective: Next Execution
ohi.processing.cache.ingroup.diagnosis.spec
Specification for the cache storing diagnosis group membership. Value must be a valid Google Guava specification. See the
CacheBuilderSpec’s javadoc: http://docs.guava-libraries.googlecode.com/
Possible values: String
Default value: maximumSize=100000,softValues,recordStats
Change effective: Next Execution
ohi.processing.cache.ingroup.flexcode.spec
Cache for Flex Codes in a Flex Code Group
Possible values: String
Default value: maximumSize=100000,softValues,recordStats
Change effective: 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.
Possible values: String
Default value: maximumSize=1000,softValues,recordStats
Change effective: Next Execution
ohi.processing.cache.ingroup.message.spec
Cache for messages in a message group.
Possible values: String
Default value: maximumSize=1000,softValues,recordStats
Change effective: Next Execution
ohi.processing.cache.ingroup.procedure.spec
Specification for the cache storing procedure group membership. Value must be a valid Google Guava specification. See the
CacheBuilderSpec’s javadoc: http://docs.guava-libraries.googlecode.com/
Possible values: String
Default value: maximumSize=100000,softValues,recordStats
Change effective: 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.
Possible values: String
Default value: maximumSize=10000,softValues,recordStats
Change effective: 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.
Possible values: String
Default value: maximumSize=10000,softValues,recordStats
Change effective: 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.
Possible values: String
Default value: maximumSize=1000,softValues,recordStats
Change effective: 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:
ohi.consumptionimport.filereader.chunk.size
The number of importable data units to collect as one processable group from a external insurable objects source file
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
ohi.diagnosisimport.filereader.chunk.size
A separate processing activity spawns for processing a chunk or batch of diagnoses of the specified size.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: Next Execution
ohi.insurableobjectimport.filereader.chunk.size
A separate processing activity spawns for processing a chunk or batch of insurable objects of the specified size.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: Next Execution
ohi.procedureimport.filereader.chunk.size
A separate processing activity spawns for processing a chunk or batch of procedures of the specified size.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: Next Execution
ohi.providerimport.filereader.chunk.size
A separate processing activity spawns for processing a chunk or batch of providers of the specified size.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: Next Execution
ohi.referencesheetimport.filereader.chunk.size
A separate processing activity spawns for processing a chunk or batch of reference sheets of the specified size.
Possible values: Integer ≥1
Default value: 5000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
Claims In Integration Point
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.
Possible values: Boolean
Default value: false
Change effective: 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.
Possible values: Boolean
Default value: false
Change effective: 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:
ohi.claims.change.url
MANDATORY
Reference to the UI page for change claims, to be contained by a Workflow event.
Possible values: String
Default value:
Change effective: Next Execution
ohi.claims.manualadjudication.url
MANDATORY
Reference to the UI page for manual adjudication, to be contained by a Workflow event.
Possible values: String
Default value:
Change effective: Next Execution
ohi.claims.manualbenefits.url
MANDATORY
Reference to the UI page for application of manual benefits, to be contained by a Workflow event.
Possible values: String
Default value:
Change effective: Next Execution
ohi.claims.manualpricing.url
MANDATORY
Reference to the UI page for manual pricing, to be contained by a Workflow event.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: Next Execution
ohi.<0>.application.baseurl
MANDATORY
This is the default URL for accessing the application. It is used to construct the links included in asynchronous responses and
notifications. It includes the machine or load balancer, the domain, and a port number. The placeholder <0> in this property name
must specify the application name. The various API requests that start an asynchronous process can take a custom header parameter
that overrides the value of this property. In this case, the base URL is derived from the request, instead of this property.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: After Restart
Callout Rules
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.
Possible values: String
Default value:
Change effective: 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'.
Possible values: String
Default value: application/json
Change effective: 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').
Possible values: Integer ≥ 1
Default value:
Change effective: 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.
Possible values: Integer > 1
Default value: 5
Change effective: 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.
Possible values: String
Default value: application/json
Change effective: Next Execution
Data Exchange
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.
Possible values: String
Default value:
Change effective: 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
Possible values: Integer ≥ 1
Default value: 2
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 3
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 100
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
Enrollment Client
ohi.enrollment.logtraffic
This property switches on or off HTTP traffic logging for Jersey/REST machine-to-machine enrollment communication. When it is
true - requires additional logback configuration
Possible values: Boolean
Default value: false
Change effective: Next Execution
ohi.enrollment.server.connect.timeout
This property specifies the number of milliseconds the system allows to establish a connection with the Enrollment Service.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
ohi.enrollment.server.read.timeout
This property specifies the number of milliseconds the system allows to get the result from the Enrollment Service.
Possible values: Integer ≥ 1
Default value: 1000
Change effective: Next Execution
ohi.enrollment.server.status.operation
This property specifies the request path to identify the Enrollment operation to invoke. Do not add a leading or trailing slash.
Possible values: String
Default value: api/enrollments
Change effective: Next Execution
ohi.enrollment.server.uri
This property specifies the scheme and authority part that hosts the Enrollment system. Example value: 'http://acme.net:7998'
(do not add a trailing slash).
Possible values: String
Default value:
Change effective: 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"/>
Persistence
ohi.persistence.cache.size.default
The size of Eclipselink’s shared cache (L2) when no specific size is defined. It defines the number of entities that is kept in
memory.Every cacheable entity has it’s own cache, so the number applies per entity type.
Possible values: Integer ≥ 0
Default value: 500
Change effective: After Restart
ohi.persistence.cache.<0>.size
The size of Eclipselink’s shared cache (L2) for a specific entity. It defines the number of entities that is kept in memory.If
not defined, the value of ohi.persistence.cache.size.default is used. The placeholder is the name of the entity like 'Procedure'.
Possible values: Integer ≥ 0
Default value:
Change effective: After Restart
ohi.persistence.read.maxrowstoretrieve
The maximum number of rows to be retrieved by a query in order to reduce memory consumption.
Possible values: Integer ≥ 0
Default value: 100
Change effective: Immediate
The limit set by ohi.persistence.read.maxrowstoretrieve is not enforced. Only a warning is written in the log when a query retrieves more rows than this threshold. |
User Interface
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.
Possible values: Boolean
Default value: false
Change effective: 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'.
Possible values: String
Default value: ohi
Change effective: 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
Possible values: Integer ≥ 1
Default value: 300
Change effective: Immediate
ohi.jsui.formatted.address.organization
This property is used to display the formatted address in context of a organization
Possible values: String
Default value:
Change effective: After Restart
ohi.jsui.formatted.address.person
This property is used to display the formatted address in context of a person
Possible values: String
Default value:
Change effective: After Restart
ohi.jsui.formatted.name.individualproviders
This property is used to display the formatted name in context of an individual provider
Possible values: String
Default value:
Change effective: After Restart
ohi.jsui.formatted.name.persons
This property is used to display the formatted name in context of a person
Possible values: String
Default value:
Change effective: After Restart
ohi.ui.accessToken.root.url
The webgate URL root (Required for CSP allowlist).
Possible values: String
Default value:
Change effective: After Restart
ohi.ui.accessToken.url
The webgate URL to access accessToken resource.
Possible values: String
Default value:
Change effective: 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).
Possible values: String
Default value: Oauth
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: Immediate
ohi.ui.logout.url
The URL used by Oracle JET to actively logout a user (session)
Possible values: String
Default value:
Change effective: After Restart
ohi.ui.maxrecordsofaccesshistory
Maximum number of access history records to be shown/stored for the UI page.
Possible values: Integer ≥ 1
Default value: 10
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 200
Change effective: 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')
Possible values: Integer ≥ 1
Default value:
Change effective: Next Execution
ohi.ui.pollinterval
This property controls the interval between automatic page refreshes for pages that support it. Value is in milliseconds.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 5000
Change effective: 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.
Possible values: Integer ≥ 0
Default value: 3600000
Change effective: 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.
Possible values: Integer ≥ 1
Default value: 1500
Change effective: After Restart
ohi.ui.webgate.logout.url
Logout from WebGate/SSO external provider
Possible values: String
Default value: /logout
Change effective: After Restart
ohi.ui.webgate.url
OAM URL (Required for CSP allowlist).
Possible values: String
Default value:
Change effective: After Restart
Specifically for OpenID Connect Support
The following table lists user interface related properties, specifically for OpenID Connect support:
ohi.oauth.idp.uri
You need to set a system property to the IDP (IDentity Provider) URL to acquire the OpenID Connect configuration. Set this
property when ohi.oauth.use.openidconnect
is set to 'true'.
Possible values: String
Default value:
Change effective: After Restart
ohi.oauth.use.openidconnect
When set to true, it indicates that Oracle JET UI leverages OpenID Connect authentication.
Possible values: Boolean
Default value: false
Change effective: After Restart
ohi.security.oauth.callback
Specifies the OpenID Connect callback URL to invoke after authentication of the user through OpenID Connect takes place, but
before an access token is obtained.
Possible values: String
Default value: oidc/callback
Change effective: After Restart
ohi.security.oauth.cookie.maxage
This property determines the time (in seconds) until the the OAUTH authentication cookie expires.
Possible values: Integer ≥ 1
Default value: 3600
Change effective: After Restart
ohi.security.oauth.cookie.name
This property specifies the name of the shared cookie, which stores the OpenID connect authentication information.
Possible values: String
Default value: OHI_SHARED_AUTH
Change effective: 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.
Possible values: String
Default value: /
Change effective: 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 the system makes a request with the 'https:' scheme.
Possible values: Boolean
Default value: false
Change effective: After Restart
Outbound Restful Service Invocation Specific to Notifications
ohi.eventing.ui.path
MANDATORY
This is the URI of the ADF UI application - the system uses this URI as the base for creation of ADF Deep links. A typical
example of this value is: 'http://acme.net:8090/auths'. Default equals the application name.
Possible values: String
Default value:
Change effective: 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:
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.
Possible values: String
Default value:
Change effective: Next Execution
ohi.datareplication.event.retrieval.diff.current.timestamp
System property to fetch events created before given number of seconds. The default value is 30s which means events which were
created upto 30s before current time will be replicated in target system.
Possible values: Integer ≥ 0
Default value: 30
Change effective: Next Execution
ohi.datareplication.event.retrieval.include.current.timestamp
Property when set to true fetches events created before current time, when false this restriction doesn’t apply.
Possible values: Boolean
Default value: true
Change effective: Next Execution
Extract
ohi.extract.datafilesize
This property controls how many items are gathered in a single Data File. We suggest a value between 1 and 1000.
Possible values: Integer ≥ 1
Default value: 500
Change effective: Next Execution
ohi.extract.datafilesize.<0>
This property controls how many items are gathered in a single Data File of a specific entity. We suggest a value between 1 and
1000. The wildcard should be replaced with the entity name.
Possible values: Integer ≥ 1
Default value:
Change effective: Next Execution
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.
Possible values: String
Default value:
Change effective: Next Execution
Monitoring and Metrics
ohi.healthcheck.url.mapping
Defines the mapping between the Healthcheck servlet and a URL pattern. Value is a URL Mapping (For example, /up).
Possible values: String
Default value:
Change effective: After Restart
ohi.instrumentation.common.application.tag
Set to true to tag each metric with the name of the application.
Possible values: Boolean
Default value: false
Change effective: After Restart
ohi.instrumentation.filter.ohi.nameprefix
Set to false to enable recording of non-OHI metrics.
Possible values: Boolean
Default value: true
Change effective: After Restart
ohi.instrumentation.gather.applicationmetrics
Set to true to enable recording of metrics.
Possible values: Boolean
Default value: false
Change effective: Immediate
ohi.instrumentation.gather.gc
Set to true to enable recording of garbage collection metrics.
Possible values: Boolean
Default value: false
Change effective: After Restart
ohi.instrumentation.gather.jvm
Set to true to enable recording of JVM metrics.
Possible values: Boolean
Default value: false
Change effective: After Restart
ohi.instrumentation.gather.system
Set to true to enable recording of system metrics.
Possible values: Boolean
Default value: false
Change effective: 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.
Possible values: Comma-separated string, e.g. api,oig-api,policies-ws
Default value:
Change effective: After Restart
ohi.instrumentation.<0>.histogram
Determines whether to publish histogram buckets for the timer you configure.
Possible values: Boolean
Default value: false
Change effective: After Restart
ohi.instrumentation.<0>.percentiles
Percentiles for the timer you configure.
Possible values: Comma-separated string, e.g. 0.5,0.75,0.95,0.99
Default value:
Change effective: 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.
Possible values: Regular expression
Default value:
Change effective: 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.
Possible values: String
Default value:
Change effective: After Restart