Property Definitions Integration Point
Background
All Oracle Health Insurance applications rely on system properties to enable different kinds of behavior. The Installation Guide contains an exhaustive list of the available system properties.
The purpose of the following HTTP IP is to make the definition of the system properties available on a running system.
System Property Definitions Integration Point
This integration point provides the ability to retrieve all system property definitions, including the relevant characteristics.
The operations are protected by the HTTP API access restriction 'property definitions IP'.
The endpoint is available at the following location:
http://<host>:<port>/<context-root>/propertydefinitions
GET (all)
This method returns all the system property definitions order by name.
Example of a response:
{
"items": [
{
"name" : "ohi.policies.calculate.commission",
"description" : "This property can be set to true if a license for commission calculation is present.",
"deprecated" : false,
"mandatory" : false,
"defaultValue" : "false",
"possibleValues" : "true or false",
"accessMode" : "Protected",
"changeEffective" : "AfterRestart"
}, {
"name" : "ohi.policies.calculate.leapyear.fiscalyear.startmonth",
"description" : "Can be set to let the fiscal year start at another month than January. Used for leap year detection. If for example set to 4, the period of 2019-04-01 to 2020-03-31 is now the leap year. \nIf this property is not specified, days in a year is considered as 365 for non-contracted policies.",
"deprecated" : false,
"mandatory" : false,
"defaultValue" : null,
"possibleValues" : "Positive integer, values between 1 and 12",
"accessMode" : "Public",
"changeEffective" : "NextExecution"
},
...
]
}
This operation returns a status as described in Response Messages, typically 200.
The following table lists the attributes of a system property definition:
Attribute | Description |
---|---|
name |
The unique name of the property. This name may include a placeholder like {0}. For example ohi.service.{0}.client.authentication |
description |
A description of the property’s purpose and what should be used as actual value for placeholders |
deprecated |
|
mandatory |
|
defaultValue |
The value used for this property when no explicit value is given. |
possibleValues |
A list of the available values for this property |
accessMode |
|
changeEffective |
Indicates when a changed value takes effect. The possible values are:
|
- Note
-
ChangeEffective value "Immediate" does not influence the polling delay for reading the properties file. It only defines when a change detected by the polling is effectuated in the application.
Get (subset)
This method is available at:
http://<host>:<port>/<context-root>/propertydefinitions?name=<prefix>
Only system property definitions whose name start with the given prefix are returned, ordered by name.
This operation returns a status as described in Response Messages, typically 200 if at least one matching property is found, or 204 if there is no match.
GET (one)
This operation is available on the same location, followed by "/<property>", where <property> is the exact name of the property:
http://<host>:<port>/<context-root>/currentproperties/<property>
This operation is similar to the GET (subset) operation, but only returns the property if it exactly matches the path parameter <property>.
This operation returns a status as described in Response Messages, typically 200 if a matching property is found or 404 if no property of that name is found.