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.
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.
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.
Vous devez d'abord sélectionner l'agent ODA.
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.
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.
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. |
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.
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.
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.
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.
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.