Version 1 and Version 2 AIS Services (Endpoints)

The AIS Server exposes endpoints that:

  • Enable access to EnterpriseOne data and applications.

  • Produce JSON responses.

Each endpoint provides a particular service, referred to as an AIS service, that AIS clients can use to interact with EnterpriseOne applications.

Table 1 describes version 1 AIS services available on the AIS Server. These services are accessed using the following URL path:

https://<AIS_Server>:<Port>/jderest/<endpoint>

With EnterpriseOne Tools release 9.2.1.2 comes the availability of version 2 AIS services. All version 1 AIS services are included in version 2 AIS services. Table 2 describes additional AIS services available in version 2. All paths to version 2 AIS services include /v2 in the URL path, for example:

https://<AIS_Server>:<Port>/jderest/v2/<endpoint>

For a detailed description of the methods, operations, and parameters in each AIS service, see the JD Edwards EnterpriseOne Tools REST API for the Application Interface Services Server Guide reference documentation.

Endpoint URIs for Version 1 AIS Services

Endpoint URI

HTTP Method

Description of Service

/defaultconfig

GET

The response will include information about the AIS Server including the release level, EnterpriseOne HTML Server configuration, and capabilities list. The capabilities that are available on the AIS Server depend on the EnterpriseOne Tools release applied to the AIS Server. If you are using the latest AIS Client Java API with up-to-date capabilities to develop AIS client applications, you need to make sure the AIS Server is on the latest EnterpriseOne Tools release. See AIS Server Capabilities for a list of capabilities available by EnterpriseOne Tools release.

/tokenrequest

POST

Based on the input, the response will contain login information including a login token and user details.

/tokenrequest/logout

POST

Based on the input (AIS token), the response will be a code of 200 if successful and 500 if the logout fails.

/formservice

POST

Based on the input, the response will contain a JSON representation of the form requested.

/batchformservice

POST

Based on the input, the response will contain a JSON representation of all of the forms requested.

/file/gettext

POST

Based on the input, the response will contain the text for the first text media object.

/file/updatetext

POST

Base on the input, the response will contain the status of the text update.

/file/list

POST

Based on the input, the response will contain the list of media objects for the structure and key requested.

/file/upload

POST (Multi-Part Form)

The response will contain the details of the uploaded file, including the media object sequence number.

/file/download

POST

This response will contain a multi-part form including the data for the attachment.

/file/addurl

POST

The response will contain the details of the URL media object, including the URL text and the sequence number.

/file/delete

POST

The response indicates the success or failure to delete the media object for the sequence number passed in.

/appstack

POST

Based on the input, the response will contain the current form open on the stack and any stack related information.

/poservice

POST

Based on the input, the response will contain the processing option values for the requested application and version.

/log

POST

Base on the input, the AIS Server will write a log entry with the information passed to the log service.

/jargonservice*

POST

Based on the input and the logged in users language, the correct item description will be returned for each data item provided.

/dataservice

POST

Based on the input, the response will contain either a count or a list of records matching a query of a table or view.

/orchestrator/<Name>*

POST

Based on the input and the URI, the requested orchestration will run. See "Configuring an Orchestration" in the JD Edwards EnterpriseOne Tools Orchestrator Guide for more information about creating orchestrations that use service requests to invoke EnterpriseOne applications.

/preference (Release 9.2.0.2)

POST

Allows management of preference records in the User Overrides Table (F98950).

/discover (Release 9.2.1)*

POST

Request a list of available orchestrations for that user.

/admin (Release 9.2.1)*

POST

Perform administrative operations such as clearing caches. The user must be configured in the Admin List in Server Manager to use this service.

/udomanager/<operation> (Release 9.2.1)*

POST

Request details about UDO objects. Valid operations are WATCHLIST and QUERY.

/watchlist (Release 9.2.1)*

POST

Execute an EnterpriseOne watchlist.

*These endpoints are NOT supported in the JDE Mobile Framework API for developing EnterpriseOne mobile enterprise applications.

Endpoint URIs for Version 2 AIS Services

Endpoint URI

HTTP Method(s)

Description of Service

/appstack/next

GET

POST

Executes stateful calls to get the next set of records in a grid.

/dataservice/next

GET

POST

Executes stateful calls to get the next set of records in a grid.

/dataservice/table/<tableName>

GET

Executes simple queries over EnterpriseOne tables.

/dataservice/view/<viewName>

GET

Executes simple queries over EnterpriseOne business views.

/formservice/<application>/<form>

GET

Executes simple queries in EnterpriseOne forms.

/formservice/<application>/<form>/<version>

GET

Executes a simple query in a form in a particular EnterpriseOne application version.

/message

POST

Sends an Enterpriseone message (PPAT) to external email systems or the EnterpriseOne Work Center email system