Génération de définitions d'objets métier

Cette section explique comment utiliser iSeries ODA dans Business Object Designer pour créer des définitions d'objet métier. Pour plus d'informations sur le lancement et l'utilisation de Business Object Designer, voir IBM WebSphere Business Integration Adapters Business Object Development Guide.

Démarrage de l'ODA iSeries

Vous pouvez démarrer l'ODA iSeries à l'aide d'un des scripts suivants :

Utilisez Business Object Designer pour sélectionner, configurer et exécuter l'ODA iSeries. Business Object Designer recherche chaque ODA par le nom indiqué dans la variable AGENTNAME de chaque script ou fichier de traitement par lots.

Exécution de Business Object Designer

Business Object Designer dispose d'un assistant pour vous guider à travers les étapes nécessaires pour générer une définition d'objet métier en utilisant l'ODA.

Sélection de l'agent

Vous devez d'abord sélectionner l'agent ODA.

  1. Ouvrez Business Object Designer.
  2. Cliquez sur File > New Using ODA. La fenêtre Business Object Wizard - Step 1 of 6 - Select Agent s'ouvre.
  3. Sélectionnez l'ODA/AGENTNAME (du script start_iSeriesODA) dans la liste Located agents et cliquez sur Next. (Vous devrez peut-être cliquer sur Find Agents si l'agent souhaité n'est pas répertorié.)
Figure 14. Fenêtre Select Agent
Fenêtre Select Agent

Configuration de l'agent

Une fois que vous avez cliqué sur Next dans la fenêtre Select Agent, la fenêtre Business Object Wizard - Step 2 of 6 - Configure Agent s'ouvre.

Figure 15. Fenêtre Configure Agent

Les propriétés définies dans cet écran sont décrites dans le Tableau 5. Vous pouvez enregistrer dans un profil toutes les valeurs entrées dans cet écran. Au lieu de saisir de nouveau les données de la propriété la prochaine fois que vous exécuterez l'ODA, vous sélectionnerez le profil voulu dans le menu déroulant et ré-utilisez les valeurs enregistrées. Vous pouvez enregistrer plusieurs profils, chacun avec un ensemble de valeurs différent.

Tableau 7. Propriétés de configuration de l'agent
Nom de propriété Valeur par défaut Type Description
iSeriesHostName String (obligatoire) Nom de la machine hôte iSeries.
iSeriesUserName String (obligatoire) Nom d'utilisateur requis pour se connecter à la machine iSeries
iSeriesPassword String (obligatoire) Mot de passe utilisé pour se connecter à la machine iSeries
iSeriesFilePath /QSYS.LIB/ String Chemin IFS absolu vers la source de sélection.
iSeriesODAOption String Type de ressource utilisé par le iSeries. Actuellement, il y a trois options : RPGMBR, RPGLEMBR et DTAQ.
Si RPGMBR est sélectionné, les IFSFiles entrés sont considérés comme des programmes sources au format RPG. Si RPGLE est entré, les IFSFiles sélectionnés sont considérés comme des programmes sources au format RPGLE.
DTAQ implique que le fichier IFS sélectionné est un DataQueue, qui peut être séquentiel ou indexé.
En fonction de cette sélection, l'accès aux fichiers sources permet de créer les définitions d'objet métier correspondantes.

Remarque :
Des programmes sources RPG et RPGLE de différentes longueurs d'enregistrement sont pris en charge, en fonction des définitions de format du langage.

Utilisez les boutons New et Save de la zone de groupe Profiles dès que vous voulez que l'ODA crée un nouveau profil. Lorsque vous utiliserez de nouveau l'ODA, vous pouvez sélectionner un profil existant. Saisissez la valeur de chaque propriété, telle que définie dans le tableau 7.

Lorsqu'une zone obligatoire est laissée vide ou en cas d'erreur (par exemple si un nom d'utilisateur est incorrect), le message d'erreur correspondant s'affiche en incrustation.

Remarque :
Si vous utilisez un profil, les valeurs de la propriété sont remplies automatiquement, mais vous pouvez les modifier si nécessaire. Vous pouvez également enregistrer de nouvelles valeurs.

Sélection d'un objet métier

La fenêtre Business Object Wizard - Step 3 of 6 - Select Source s'ouvre, comme illustré sur la Figure 17.

Cet écran dresse la liste des fichiers sources *.MBRs pour RPG ou RPGLE ou des fichiers *.DTAQ pour files d'attente de données, pour que l'utilisateur sélectionne les noms de ces fichiers. Le type de fichier est déterminé par la propriété iSeriesODAOption Agent. Les répertoires IFS sont représentés en tant que noeuds d'arborescence développables, tandis que les noms de sources (MBR ou DTAQ) sont présentés en tant que noeuds feuille. Vous pouvez sélectionner plusieurs sources (noeuds feuille uniquement) du même répertoire IFS ou de différents répertoires IFS. Utilisez cet écran pour sélectionner n'importe le nombre voulu de fichiers sources pour lesquels l'ODA générera des définitions d'objet métier.

Figure 16. Fenêtre Select Source
Fenêtre Select Source

  1. Si nécessaire, développez un noeud pour consulter la liste des noeuds secondaires.
  2. Sélectionnez les fichiers sources à utiliser. Cliquez sur Next.
  3. Pour sélectionner plusieurs noeuds, voir Business Object Development Guide pour plus d'informations sur les structures d'arborescences.

Confirmation de la sélection d'objet

La fenêtre Business Object Wizard - Step 4 of 6 - Confirm source nodes for business object definitions s'ouvre. Elle affiche les objets sélectionnés.

Figure 17. Fenêtre Confirm source node
Fenêtre Confirm source node

Cliquez sur Back pour procéder à des modifications ou sur Next pour confirmer que la liste est correcte. La fenêtre Business Object Wizard - Step 5 of 6 - Generating business objects... s'ouvre avec un message indiquant que l'assistant est en train de générer les objets métier.

Génération d'objets métier

Une fois que vous avez confirmé vos sources de noeud, l'ODA iSeries génère les objets métier. La fenêtre Business Object Wizard - Step 6 of 6 - Saving business object definitions... s'ouvre.

  1. Cochez soit Save a copy of the business object definitions to a separate file, soit Open the new business object definitions in separate windows. Ce dernier choix lance Business Object Designer et ouvre les objets métier dans cette application.
  2. Si vous avez terminé et souhaitez fermer l'ODA, cochez Shutdown ODA et cliquez sur Finish.

Figure 18. Fenêtre Save business objects
Fenêtre Save business objects

Copyright IBM Corp. 2003, 2005