Skip to main content

JD Edwards services (AIS)

Nomajde reaches JD Edwards through its AIS server, with Oracle's documented REST services. It ships a catalogue of these services, ready to use: each one has a name, a description, named parameters that say what they expect with an example — and its own permission. They are the building blocks of everything Nomajde does with a live JD Edwards: screens on a JDE form, non-regression tests, jobs, and the requests made to the AI assistant.


At a glance​

The AIS catalogueA screenA jobA testThe AI assistantREADQuery a table or a viewPOSTFind a JDE objectGETA report's options and selectionPOSTA business function's parametersPOSTOne orchestrationGETA data item's labelsPOSTCHANGE JD EDWARDSRun an orchestrationchanges dataRun a business functionchanges dataSubmit a reportchanges dataAIS serverJD Edwardsunder the connector'sJDE accountUsed everywherewithout a line of codeA card to approvebefore a change of JDENamed parameterswith help and an exampleOne permission eachapi:ais_connection:<service>Marked apartgranted sparingly

The catalogue​

The services are the endpoints of the ais_connection connector, in Liberty Next → Data → Connectors.

Read​

ServiceReturnsParameters
AIS server configurationThe AIS release and its default environment.—
Find a JDE objectThe applications, tables, views, business functions and reports whose name or description holds a text.FILTER, TYPES
Query a table or a viewRows of a table or a business view, or their count.TABLE, TYPE, KIND, COLUMNS, MAX, MATCH, CONDITIONS
A data item's labelsThe title and description of a data dictionary item.ITEM, SYSTEM
An application's processing optionsThe processing option values of an interactive application version.APPLICATION, VERSION
A report's options and selectionThe selection, the sequence and the options of a report version.REPORT, VERSION
A report job's statusThe state of a submitted report.JOB, SERVER
A business function's parametersBusiness functions and their parameters.NAME, OBJECT or TEMPLATE
Orchestrations, One orchestrationThe orchestrations AIS offers; for one, its description, its version, its inputs and outputs.NAME
Notifications, Scheduled jobsThe notifications, the AIS scheduler and its jobs.—

Change JD Edwards​

ServiceDoesParameters
Run an orchestrationRuns an orchestration with its inputs, whatever its version.NAME, VERSION, INPUTS
Run a business functionRuns a business function.NAME, PARAMS, OUTPUTS
Submit a reportSubmits a report version as it is saved.REPORT, VERSION
Start a scheduled job, Stop a scheduled jobStarts or stops the schedule of an orchestration or a notification.NAME

These five are marked as changing data. Three parameters depend on the object and are written as JSON, with their example: the conditions of a query, the values of a business function, the inputs of an orchestration. To avoid the JSON, make an endpoint of its own for one report, one table, one function or one orchestration with Create from…: each input then becomes a labelled field.


Where a service is used​

FromHow
The connector's Test tabFill the parameters and run it: the quickest way to try a service.
A screenAs an action in the toolbar or the row menu — submit a report for the selected row — or as the source of the screen's rows.
A jobAs a step: nightly export, a report submitted and waited for, an orchestration run. See Jobs.
A testAs a step of a non-regression case.
The AI assistantIt reads with the reading services; for one that changes JD Edwards it shows a card to approve first.

What JD Edwards sees​

Every call runs under the JD Edwards account of the connector: JD Edwards security applies to that account, the audit records it, and texts come back in its language. Give it the rights the integrations need, no more.

What JD Edwards refuses is reported in its own words. A business function's error fails the call with its message; a warning — Duplicate Address Book record exists — is reported with the answer and the call stands.


Access​

Each service has its permission, api:ais_connection:<service>, granted in a role's Beyond the menus rules. A role can therefore read tables without being able to submit a report, or run one orchestration and no other.

  • Grant the reading services to the teams that build screens and tests.
  • Grant the five services that change JD Edwards sparingly — or better, grant the specific endpoints made with Create from….
  • The connector also holds a generic service, AIS service (generic, used by nomajde.ais), kept for Nomajde's own code: it reaches every AIS service, so it is granted to no role.

For the AI assistant, a service that changes JD Edwards also requires the user to be allowed to change data through the assistant, and is never called without an approved card.


Tips & best practices​

  • Try a service in the Test tab before putting it in a job or a screen.
  • Query a table or a view with KIND = COUNT answers a volume question without reading the rows.
  • Use a dedicated JD Edwards account for the connector, so that the audit separates what Nomajde did from what a person did.
  • When the same JSON is typed twice, it is time for Create from….