Aller au contenu principal

Créer à partir de… — points d'accès et écrans à partir de JD Edwards

Créer à partir de… écrit, d'après ce que JD Edwards décrit lui-même, un point d'accès dédié à un objet — une version d'état, une table, un formulaire, une fonction métier, une orchestration — ou un écran complet sur une application JD Edwards. Personne ne saisit de chemin ni de corps JSON : l'objet se cherche par son nom, quelques questions suffisent, et chaque entrée devient un champ libellé, avec son aide et sa valeur par défaut.

C'est le chemin le plus court pour afficher un formulaire JD Edwards dans une grille de Nomajde, avec des enregistrements qui passent par le formulaire — donc avec les règles, les valeurs par défaut, la sécurité et les messages de JD Edwards.

Accès : Liberty Next → Données → Connecteurs, connecteur ais_connection, onglet Points d'accès, bouton Créer à partir de….


Vue d'ensemble​

Créer un point d'accès à partir du serveurA JDE application (its list and its record) ▾RECHERCHERaddress bookChercher3 trouvés — choisissez-en unP01012Address BookP0101Address Book RevisionsP01111Address Book - Who's WhoP01012 — Address Book.Its list is W01012B (Work With Addresses, 9 columns);a record is edited in W01012A (Address Book Revision).WHAT TO CREATEThe endpoints and a screen on them ▾WHAT IDENTIFIES A RECORDAN8ALPHAT1THE FIELDS A RECORD IS EDITED WITHALPHAT1TAXMLNMADD1CTY1ADDZPH1VERSION OF THE APPLICATIONZJDE0001AnnulerCréer l'écranEnsuite : application, identifiant de l'écran,titre, ajout au menu — créés en une passe.Point de départapplication, formulaire, table, état…1 · Rechercherpar nom ou descriptionCe qui a été trouvéla liste et le formulaire2 · Répondrece qu'un opérateur connaîtLa cléretrouvée avant toute modification3 · Créerpoints d'accès et écran ensemble

Les trois étapes​

  1. Rechercher — choisir le point de départ, saisir un nom ou une partie de description, puis sélectionner l'objet dans les résultats.
  2. Répondre — les questions dépendent de l'objet : les colonnes à renvoyer, les champs à remplir, le bouton actionné. AIS décrit l'objet sans l'exécuter sur des données.
  3. Créer — le point d'accès est ajouté au connecteur, non enregistré et ouvert pour relecture : le renommer, ajuster un libellé, puis enregistrer le connecteur. Pour un écran, une seconde fenêtre demande l'application, l'identifiant de l'écran, son titre et s'il faut l'ajouter au menu ; tout est alors créé et enregistré en une fois.

Chaque point d'accès créé a sa propre permission et se range sous le titre de son application JD Edwards (P01012 — Address Book).


Ce qui peut être créé​

Point de départTexte à rechercherRésultat
A JDE application (its list and its record)Une application (P01012) ou une partie de sa description (address).Les points d'accès qui lisent, ajoutent, modifient et suppriment un enregistrement — et un écran qui les utilise.
A report versionLe début du nom d'un état (R0010…).Un point d'accès qui soumet cette version.
A table or a business viewUne partie du nom ou de la description.Un point d'accès qui la lit.
A JDE formUne application, un formulaire (W01012B) ou une partie de la description d'un formulaire.Un point d'accès qui utilise ce formulaire — ou un écran.
A business functionUn nom de fonction, un objet source (B0000130) ou une partie de description.Un point d'accès qui la lance.
An orchestrationUne partie du nom, de la description ou de la catégorie.Un point d'accès qui la lance.

A JDE application — le chemin simple​

C'est par là qu'il faut commencer. Les questions portent sur ce qu'un opérateur connaît ; le reste est trouvé automatiquement : la liste de l'application (son formulaire de recherche) et le formulaire dans lequel un enregistrement se modifie.

QuestionSignification
What to createThe endpoints and a screen on them (par défaut), ou The endpoints only (read, add, change, delete).
What identifies a recordLa ou les colonnes de la liste qui permettent de retrouver un enregistrement avant de le modifier ou de le supprimer. La première colonne est proposée.
The fields a record is edited withProposés : les champs affichés par la liste. Cocher les autres champs à remplir — chacun devient un champ de l'ajout et de la modification.
The list's own fields when it looks for a recordUniquement si la liste ne retrouve pas un enregistrement par sa seule clé : une valeur fixe par champ, par alias (AT1=* — tous les types de recherche). Vide le plus souvent.
Version of the applicationZJDE0001 par défaut.

La fenêtre indique ce qu'elle a trouvé — la liste, son nombre de colonnes, le formulaire de modification — et prévient si la liste n'affiche rien sans filtre sur le JD Edwards utilisé : l'écran en demandera alors un.

L'écran créé lit la liste dans une grille et ouvre une ligne dans une fiche : les mêmes colonnes, la clé verrouillée une fois l'enregistrement créé, une colonne qu'aucun enregistrement ne transmet affichée mais non saisissable.


A report version​

QuestionSignification
Processing options to fillChacune devient un champ, avec la valeur actuelle de la version par défaut. Les autres gardent la valeur de la version.
Columns to select onChacune devient un champ obligatoire, comparé par égal et ajouté à la sélection enregistrée de la version, qui est conservée.

Le point d'accès — Submit R0010P / XJDE0001 — est marqué comme modifiant des données.


A table or a business view​

QuestionSignification
Columns to returnAucune colonne choisie = toutes les colonnes.
Columns to filter onChacune devient un champ obligatoire : les lignes dont la colonne est égale à la valeur.
Maximum rows100 par défaut.

Le point d'accès indique où se trouvent ses lignes : un écran peut s'en servir comme source, les colonnes portant leur alias JD Edwards pour que le dictionnaire fournisse leurs libellés.


A JDE form​

Le générateur complet, pour un formulaire que le chemin simple ne couvre pas. AIS décrit le formulaire — ses champs, les colonnes de sa grille, ses boutons.

QuestionSignification
What to createOne endpoint (as set below), ou A screen on this form: its rows in a Liberty grid, and the endpoints it needs.
A screen: the columns that identify a row (its key)Nécessaire pour que l'écran enregistre. Aucune colonne choisie = un écran en lecture seule.
Values passed by the calling formPour un formulaire ouvert depuis un autre avec des champs grisés : le numéro de ces valeurs et un nom pour chacune — 1=Product_Code, 2=UDC_Type. Sans elles, un tel formulaire enregistre des données fausses.
Fields and grid filters to fillChacun devient un champ. Un filtre de grille laissé vide ne filtre pas ; il accepte A*, >…
What is done to a row of the gridAdd a row, Change the row the grid filters find, Delete the row the grid filters find.
Find the row with a leading *Pour les codes cadrés à droite, comme un code UDC : 002 se retrouve avec *002.
A record is edited inThis form's grid, ou un autre formulaire de l'application — Work With Addresses liste, Address Book Revision modifie.
Edited in another form: when JDE warnsSave all the same (OK is pressed again) and report the warning, ou Save nothing: the warning is the error.
Button pressedFind lit. Tout autre bouton fait ce que fait le formulaire — OK enregistre, Delete supprime — et le point d'accès est marqué comme modifiant des données.
Fields and columns to returnAucun choix = tous.

Les garanties d'un enregistrement​

Une modification ou une suppression par un formulaire, ce sont plusieurs actions dans une seule session JD Edwards : retrouver la ligne, contrôler ce qui a été trouvé, agir, valider par OK.

  • Rien n'est fait tant qu'une seule ligne n'est pas trouvée — aucune, pour un ajout.
  • Un enregistrement modifié dans un autre formulaire suit le parcours de l'utilisateur : retrouvé dans la liste, bouton de la liste actionné (Select, Add, Delete), autre formulaire rempli puis validé par OK.
  • Un avertissement arrête le premier OK comme pour un utilisateur ; il est accepté ou refusé selon le choix ci-dessus, et signalé avec l'enregistrement.
  • Après une suppression, l'enregistrement est recherché de nouveau : un formulaire qui n'a rien supprimé est une erreur.
  • Un champ que l'écran n'envoie pas n'est pas saisi dans le formulaire ; un champ vidé par l'utilisateur l'est.
  • Quand le formulaire refuse — champ obligatoire vide, valeur non acceptée —, l'enregistrement échoue avec le message du formulaire.
  • Les formulaires et la session sont toujours fermés, même en cas d'erreur : aucune session JD Edwards ni aucun verrou d'enregistrement ne subsiste.

A business function, An orchestration​

Point de départQuestionsRésultat
A business functionParameters to pass (chacun devient un champ ; les autres sont laissés à la fonction) et Parameters to return.Run <fonction> — une erreur fait échouer l'appel avec son message, un avertissement est signalé et l'appel reste valide.
An orchestrationAucune : la fenêtre liste ses entrées.Run <orchestration> — un champ par entrée, à l'adresse de sa version ; une entrée qui est une liste de lignes reste un seul champ JSON, avec la forme des lignes en exemple.

Un écran SQL enregistré par les formulaires​

Un écran qui lit une table JD Edwards en SQL — rapide, toutes les colonnes, pagination — peut garder sa lecture et enregistrer par les formulaires : dans le concepteur d'écran, Enregistre par désigne le connecteur AIS, et la mise à jour, l'insertion et la suppression sont les points d'accès d'enregistrement créés ci-dessus. Un champ du point d'accès prend la valeur de la colonne qui porte le même élément de données (ALPH à partir de ABALPH) : aucune correspondance à écrire. Voir Un écran sur un point d'accès d'API.


Garder les points d'accès à jour​

Un point d'accès garde la trace de son origine. Quand l'état, la table, le formulaire ou l'orchestration change dans JD Edwards — après une mise à jour, par exemple :

  • Actualiser depuis le serveur, sur le point d'accès, le reconstruit et montre ce qui change avant de l'appliquer ; le nom, le libellé et ce qui a été écrit sur ses champs sont conservés.
  • Vérifier N générés, au-dessus de la liste, interroge JD Edwards pour chaque point d'accès généré et liste ceux qui ne correspondent plus.

Conseils & bonnes pratiques​

  • Commencer par A JDE application ; réserver A JDE form à un formulaire en-tête et détail, à un formulaire ouvert avec des valeurs grisées ou à un bouton particulier.
  • Essayer le point d'accès de lecture dans l'onglet Test avant de créer l'écran : une liste vide à cet endroit sera un écran vide.
  • Pour un formulaire de type UDC, nommer les valeurs transmises par le formulaire appelant : saisies dans les champs à la place, le formulaire enregistre un code vide.
  • Accorder les points d'accès qui modifient JD Edwards aux rôles qui peuvent faire la même chose dans JD Edwards — pas davantage.
  • Ajouter un cas de non-régression sur chaque point d'accès généré dont dépend le métier.
  • L'assistant IA connaît la procédure : lui demander de créer un écran Liberty sur un formulaire JDE.

Voir aussi​