Services JD Edwards (AIS)
Nomajde accède à JD Edwards par son serveur AIS, avec les services REST documentés par Oracle. Il est livré avec un catalogue de ces services, prêts à l'emploi : chacun a un nom, une description, des paramètres nommés qui précisent ce qu'ils attendent avec un exemple — et sa propre permission. Ce sont les briques de tout ce que Nomajde fait avec un JD Edwards en service : les écrans sur un formulaire JDE, les tests de non-régression, les tâches et les demandes adressées à l'assistant IA.
Vue d'ensemble
Le catalogue
Les services sont les points d'accès du connecteur ais_connection, dans Liberty Next → Données → Connecteurs.
Lire
| Service | Renvoie | Paramètres |
|---|---|---|
| AIS server configuration | La version d'AIS et son environnement par défaut. | — |
| Find a JDE object | Les applications, tables, vues, fonctions métier et états dont le nom ou la description contient un texte. | FILTER, TYPES |
| Query a table or a view | Les lignes d'une table ou d'une vue métier, ou leur nombre. | TABLE, TYPE, KIND, COLUMNS, MAX, MATCH, CONDITIONS |
| A data item's labels | Le titre et la description d'un élément du dictionnaire de données. | ITEM, SYSTEM |
| An application's processing options | Les valeurs des options de traitement d'une version d'application interactive. | APPLICATION, VERSION |
| A report's options and selection | La sélection, la séquence et les options d'une version d'état. | REPORT, VERSION |
| A report job's status | L'état d'un travail soumis. | JOB, SERVER |
| A business function's parameters | Les fonctions métier et leurs paramètres. | NAME, OBJECT ou TEMPLATE |
| Orchestrations, One orchestration | Les orchestrations proposées par AIS ; pour l'une d'elles, sa description, sa version, ses entrées et ses sorties. | NAME |
| Notifications, Scheduled jobs | Les notifications, le planificateur AIS et ses travaux. | — |
Modifier JD Edwards
| Service | Action | Paramètres |
|---|---|---|
| Run an orchestration | Lance une orchestration avec ses entrées, quelle que soit sa version. | NAME, VERSION, INPUTS |
| Run a business function | Lance une fonction métier. | NAME, PARAMS, OUTPUTS |
| Submit a report | Soumet une version d'état telle qu'elle est enregistrée. | REPORT, VERSION |
| Start a scheduled job, Stop a scheduled job | Démarre ou arrête la planification d'une orchestration ou d'une notification. | NAME |
Ces cinq services sont marqués comme modifiant des données. Trois paramètres dépendent de l'objet et s'écrivent en JSON, avec leur exemple : les conditions d'une requête, les valeurs d'une fonction métier, les entrées d'une orchestration. Pour éviter le JSON, créer un point d'accès dédié à un état, une table, une fonction ou une orchestration avec Créer à partir de… : chaque entrée devient alors un champ libellé.
Où un service s'utilise
| Depuis | Comment |
|---|---|
| L'onglet Test du connecteur | Renseigner les paramètres et exécuter : le moyen le plus rapide d'essayer un service. |
| Un écran | Comme action de la barre d'outils ou du menu de ligne — soumettre un état pour la ligne sélectionnée —, ou comme source des lignes de l'écran. |
| Une tâche | Comme étape : export nocturne, état soumis puis attendu, orchestration lancée. Voir Tâches. |
| Un test | Comme étape d'un cas de non-régression. |
| L'assistant IA | Il lit avec les services de lecture ; pour un service qui modifie JD Edwards, il présente d'abord une carte à valider. |
Ce que voit JD Edwards
Chaque appel s'exécute sous le compte JD Edwards du connecteur : la sécurité de JD Edwards s'applique à ce compte, l'audit l'enregistre, et les textes reviennent dans sa langue. Lui donner les droits nécessaires aux intégrations, pas davantage.
Ce que JD Edwards refuse est rapporté dans ses propres termes. Une erreur de fonction métier fait échouer l'appel avec son message ; un avertissement — Duplicate Address Book record exists — est signalé avec la réponse et l'appel reste valide.
Accès
Chaque service a sa permission, api:ais_connection:<service>, accordée dans les règles Au-delà des menus d'un rôle. Un rôle peut donc lire des tables sans pouvoir soumettre un état, ou lancer une orchestration et aucune autre.
- Accorder les services de lecture aux équipes qui construisent les écrans et les tests.
- Accorder avec parcimonie les cinq services qui modifient JD Edwards — ou, mieux, accorder les points d'accès dédiés créés avec Créer à partir de….
- Le connecteur contient aussi un service générique, AIS service (generic, used by nomajde.ais), réservé au code de Nomajde : il atteint tous les services AIS et n'est donc accordé à aucun rôle.
Pour l'assistant IA, un service qui modifie JD Edwards demande en plus que l'utilisateur soit autorisé à modifier des données par l'assistant, et n'est jamais appelé sans carte validée.
Conseils & bonnes pratiques
- Essayer un service dans l'onglet Test avant de le placer dans une tâche ou un écran.
- Query a table or a view avec
KIND=COUNTrépond à une question de volume sans lire les lignes. - Réserver un compte JD Edwards au connecteur : l'audit distingue alors ce que Nomajde a fait de ce qu'une personne a fait.
- Un même JSON saisi deux fois est le signe qu'il faut passer par Créer à partir de….
Voir aussi
- Créer à partir de… — points d'accès et écrans à partir de JD Edwards.
- Points d'accès d'API — l'éditeur de points d'accès de Liberty Next.
- Server Manager — la même approche pour la console Server Manager.