Understanding the AIS Server Discovery Service

The discovery service is a service on the AIS Server that enables any AIS client or consumer of orchestrations, including the Oracle Internet of Things (IoT) Cloud Service, to discover orchestrations available on the AIS Server. The service enables consumers of orchestrations to view the available orchestrations as well as the format and inputs of each orchestration.

Note: For more information on how to use the IoT Cloud Service, see:https://cloud.oracle.com/iot

The URI for the discovery service is:

http://<ais_server>:<port>/jderest/discover

You can invoke the service using a GET HTTP method.

The discovery service is secured. You must include basic authentication credentials in the GET request to secure it.

The response is returned in an array, which lists each orchestration separately. The array includes the following details about each orchestration:

  • Name. The name of the orchestration.

  • Description. A description that should describe the task performed by the orchestration and include additional details about other components the orchestration uses such as a white list, rule, or cross reference.

  • Input format. JDE Standard, Generic, or Cloud IoT.

  • Input. The input value.

  • Input type. String, numeric, or date.

Note: Orchestration descriptions are available starting with EnterpriseOne Tools release 9.2.0.3.

Example: Orchestration Details in the JSON Response from the Discovery Serviceprovides an example of the orchestration details in a JSON response.