Aller au contenu principal

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 AISUn écranUne tâcheUn testL'assistant IALIREQuery a table or a viewPOSTFind a JDE objectGETA report's options and selectionPOSTA business function's parametersPOSTOne orchestrationGETA data item's labelsPOSTMODIFIER JD EDWARDSRun an orchestrationmodifie des donnéesRun a business functionmodifie des donnéesSubmit a reportmodifie des donnéesServeur AISJD Edwardssous le compte JDEdu connecteurUtilisé partoutsans une ligne de codeUne carte à valideravant de modifier JDEParamètres nommésavec aide et exempleUne permission chacunapi:ais_connection:<service>Marqués à partaccordés avec parcimonie

Le catalogue​

Les services sont les points d'accès du connecteur ais_connection, dans Liberty Next → Données → Connecteurs.

Lire​

ServiceRenvoieParamètres
AIS server configurationLa version d'AIS et son environnement par défaut.—
Find a JDE objectLes applications, tables, vues, fonctions métier et états dont le nom ou la description contient un texte.FILTER, TYPES
Query a table or a viewLes lignes d'une table ou d'une vue métier, ou leur nombre.TABLE, TYPE, KIND, COLUMNS, MAX, MATCH, CONDITIONS
A data item's labelsLe titre et la description d'un élément du dictionnaire de données.ITEM, SYSTEM
An application's processing optionsLes valeurs des options de traitement d'une version d'application interactive.APPLICATION, VERSION
A report's options and selectionLa sélection, la séquence et les options d'une version d'état.REPORT, VERSION
A report job's statusL'état d'un travail soumis.JOB, SERVER
A business function's parametersLes fonctions métier et leurs paramètres.NAME, OBJECT ou TEMPLATE
Orchestrations, One orchestrationLes orchestrations proposées par AIS ; pour l'une d'elles, sa description, sa version, ses entrées et ses sorties.NAME
Notifications, Scheduled jobsLes notifications, le planificateur AIS et ses travaux.—

Modifier JD Edwards​

ServiceActionParamètres
Run an orchestrationLance une orchestration avec ses entrées, quelle que soit sa version.NAME, VERSION, INPUTS
Run a business functionLance une fonction métier.NAME, PARAMS, OUTPUTS
Submit a reportSoumet une version d'état telle qu'elle est enregistrée.REPORT, VERSION
Start a scheduled job, Stop a scheduled jobDé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​

DepuisComment
L'onglet Test du connecteurRenseigner les paramètres et exécuter : le moyen le plus rapide d'essayer un service.
Un écranComme 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âcheComme étape : export nocturne, état soumis puis attendu, orchestration lancée. Voir Tâches.
Un testComme étape d'un cas de non-régression.
L'assistant IAIl 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 = COUNT ré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​