Get Configuration v2
get
/v2/defaultconfig
Get AIS Server configuration information and available capabilities.
Request
Query Parameters
-
all: string
Return all capibilities for all versions, not just since this version
-
bypassJASTest: string
Do not validate connection to JAS server
-
requiredCapabilities: string
Specify the AIS capabilities your client requires. These capabilities must be available on the AIS Server.
-
settings: string
Return the instance settings excluding the capibilities
Response
Supported Media Types
- application/json
200 Response
Successful Execution
Root Schema : DefaultConfig
Type:
object
Response Object for Default Config Service.
Show Source
-
aisVersion:
string
The version (release level) of this AIS Server.
-
capabilityList:
array capabilityList
The list of capabilities of this AIS Server.
-
defaultCachingOn:
boolean
When the value is true this AIS Server is currently configured to always cache read requests for FormService and DataService calls.
-
defaultEnvironment:
string
The default EnterpriseOne environment configured for this AIS Server.
-
defaultJasServer:
string
The default EnterpriseOne HTML (JAS) Server configured for this AIS Server.
-
defaultRole:
string
The default EnterpriseOne role configured for this AIS Server.
-
disconnectedTimeout:
string
Primarily for mobile, the value configured for disconnected timeout for this AIS Server.
-
displayEnvironment:
boolean
Primarily used for mobile, indicates if environment should be displayed on client login screen.
-
displayJasServer:
boolean
Primarily used for mobile, indicates if HTML (JAS) Server should be displayed on client login screen.
-
displayRole:
boolean
Primarily used for mobile, indicates if role should be displayed on client login screen.
-
enableMonitoring:
boolean
When the value is true this AIS Server is currently configured to enable monitoring of requests.
-
enableStudioSingleSignOn:
boolean
Indicates if Single Sign-On is enabled for Orchestrator Studio.
-
externalJASURL:
string
External HTML Server url if different from the JAS url configured for AIS communications.
-
groovyAvailable:
boolean
Indicates if Groovy properly configured with libraries available and engine initialized.
-
idcsSSOSignOffURL:
string
The IDCS SSO Sign Off URL.
-
internalUseEnabled:
boolean
Indicates if internal use is enabled.
-
isRunningInWLS:
boolean
Will be true if the AIS Server is deployed to Oracle WebLogic Server.
-
jasHost:
string
The default EnterpriseOne HTML (JAS) Server host configured for this AIS Server.
-
jasPort:
string
The default EnterpriseOne HTML (JAS) Server port configured for this AIS Server.
-
jasProtocol:
string
The default EnterpriseOne HTML (JAS) Server protocol configured for this AIS Server.
-
jrubyAvailable:
boolean
Indicates if JRuby properly configured with libraries available and engine initialized.
-
jythonAvailable:
boolean
Indicates if Jython properly configured with libraries available and engine initialized.
-
keepJasSessionOpen:
boolean
The value configured for Keep HTML (JAS) Server Sessions open for this AIS Server.
-
readCachTTL:
integer(int64)
Time in milliseconds, configured for read cache entries to live. Value of zero means read cachine is off.
-
requiredCapabilityMissing:
boolean
If you included a required capability list in your request this indicates if that capability is available on this AIS Server.
-
schedulerServer:
boolean
When the value is true this AIS Server is currently configured to be a scheduler server, the Quartz Scheduler is automatically started.
-
sessionTimeout:
string
The value configured for session timeout for this AIS Server.
-
ssoAllowed:
boolean
Primarily used for mobile, indicates if mobile apps allow SSO.
-
timeToLive:
string
The value configured for session time to live for this AIS Server.
Nested Schema : capabilityList
Type:
array
The list of capabilities of this AIS Server.
Show Source
-
Array of:
object Capability
Information about an individual capability.
Nested Schema : Capability
Type:
object
Information about an individual capability.
Show Source
-
asOfRelease:
string
The release in which the capability was first made available.
-
longDescription:
string
A long description of the capability
-
name:
string
The name of the capability.
-
shortDescription:
string
A short description of the capability.
-
sinceVersion:
string
The Service Version in which the capability was first made available.
415 Response
Invalid Content-Type Header - Must use application/json
500 Response
Server Failed to Process Request
Root Schema : ServiceErrorResponse
Type:
object
Error Response
Show Source
-
errorText:
string
-
exception:
string
The class of the exception if an exception was thrown.
-
exceptionId:
string
ExceptionId, only if an exception record was written to the F980060
-
message:
string
Details about the error.
-
status:
string
Allowed Values:
[ "ERROR", "WARNING" ]
Status determined by exception handling -
timeStamp:
string
The timestamp indicating the time the error message was returned.
-
type:
string
Optional type of error
-
userDefinedErrorText:
string
Optional error text added to an orchestration step.
Examples
Example Request
The following shows an example of a default config request. The default configurations currently on the AIS Server are returned in the response.
curl -i -X GET -H "Content-Type:application/json" http://ais_server_url/jderest/v2/defaultconfig/
Example Response
The following example shows the contents of the response body.
{ "jasHost": "aishot", "jasPort": "7552", "jasProtocol": "http", "defaultEnvironment": "JDV920", "defaultRole": "*ALL", "displayEnvironment": true, "displayRole": true, "displayJasServer": true, "defaultJasServer": "http://jashost:7552", "ssoAllowed": true, "sessionTimeout": "20", "timeToLive": "720", "aisVersion": "EnterpriseOne 9.2.2.4", "capabilityList": [ { "name": "version2services", "shortDescription": "Version 2 Service URL", "longDescription": "New capabilities available with V2 Services", "asOfRelease": "9.2.1.2", "sinceVersion": "v2" }, { "name": "nextPage", "shortDescription": "Next Page for App Stack and Data Request", "longDescription": "Ability to request next data set for Application Stack and Data Request", "asOfRelease": "9.2.1.2", "sinceVersion": "v2" }, { "name": "simpleGetServices", "shortDescription": "Simple GET Data Requests", "longDescription": "Ability to perform Data Requests with GET operation", "asOfRelease": "9.2.1.2", "sinceVersion": "v2" }, { "name": "formServiceOrderBy", "shortDescription": "Order By in Form Service", "longDescription": "Ability to order by columns in a grid with form service", "asOfRelease": "9.2.1.2", "sinceVersion": "v2" }, { "name": "messageService", "shortDescription": "Send Message Service", "longDescription": "Ability to send E-mail or Work Center messages", "asOfRelease": "9.2.1.2", "sinceVersion": "v2" }, { "name": "reportService", "shortDescription": "Report Service", "longDescription": "Ability to launch an determine the status of an EntepriseOne Report", "asOfRelease": "9.2.2.4", "sinceVersion": "v2" } ], "requiredCapabilityMissing": false, "keepJasSessionOpen": true, "disconnectedTimeout": "12", "isRunningInWLS": true, "readCachTTL": 60000, "defaultCachingOn": true }