Utilisation de PortalODA dans Business Object Designer

Cette section explique comment utiliser PortalODA dans Business Object Designer pour convertir les définitions d'objets métier existantes et pour en générer de nouvelles. Pour ce faire, consultez les informations disponibles directement sur Portal Infranet. Pour plus d'informations sur le démarrage de Business Object Designer, voir le manuel Business Object Development Guide.

Après avoir démarré un agent ODA, vous devez démarrer Business Object Designer afin de le configurer et de l'exécuter. Dans Business Object Designer, la génération ou la conversion d'une définition d'objet métier à l'aide d'un ODA comprend six étapes. Business Object Designer propose un assistant pour vous guider à travers ces étapes.

Après avoir démarré l'ODA, procédez comme suit pour démarrer l'assistant :

  1. Ouvrez Business Object Designer.
  2. Dans le menu File, sélectionnez le sous-menu New Using ODA....

    Business Object Designer affiche la première fenêtre de l'assistant, Select Agent. La figure 16 représente cette fenêtre.

Pour sélectionner, configurer et exécuter l'ODA, procédez comme suit :

  1. Sélection de l'ODA
  2. Configuration des propriétés d'initialisation
  3. Génération de définitions et, le cas échéant, Ajout d'informations complémentaires
  4. Enregistrement des définitions

Sélection de l'ODA

La figure 16 illustre la première boîte de dialogue de l'assistant de Business Object Designer, qui comprend six étapes.

Figure 16. Sélection de l'ODA
Sélection de l'ODA

Pour sélectionner l'ODA :

  1. Cliquez sur le bouton Find Agents pour afficher tous les ODA enregistrés ou en cours d'exécution dans la zone Located agents.

    Vous pouvez également rechercher un agent par nom d'hôte et numéro de port.

    Remarque :
    Si Business Object Designer ne localise pas l'ODA souhaité, vérifiez la configuration de l'ODA.
  2. Sélectionnez l'ODA dans la liste affichée.

    Business Object Designer affiche votre sélection dans la zone Agent's name.

Configuration des propriétés d'initialisation

La première fois que Business Object Designer communique avec PortalODA, il vous invite à entrer un ensemble de propriétés d'initialisation, comme illustré par la figure 17. Vous pouvez enregistrer ces propriétés dans un profil nommé, ainsi vous n'aurez plus besoin des les entrer chaque fois que vous utiliserez PortalODA. Pour plus d'informations sur l'indication d'un profil ODA, voir le document Business Object Development Guide.

Figure 17. Configuration des propriétés d'initialisation de l'agent
Configuration des propriétés d'initialisation de l'agent

Configurez les propriétés de PortalODA décrites dans le tableau 8.

Important :
Toutes les propriétés de PortalODA citées dans le tableau 8 doivent obligatoirement être définies.

Tableau 8. Propriétés de PortalODA
Numéro de ligne Nom de propriété Type de propriété Description
1 UserName String Nom de connexion à l'application Portal Infranet
2 Password String Mot de passe de l'application Portal Infranet
3 CMPortNo String Numéro du port sur lequel le gestionnaire de connexions s'exécute
4 CMHostName String Nom ou adresse IP de la machine sur laquelle le gestionnaire de connexions s'exécute
5 Database String Numéro de la base de données à laquelle le gestionnaire de connexions est connecté
6 Type String Type de connexion de Portal Infranet : 1 correspond à la validation des propriétés UserName et Password, 0 signifie qu'il n'y a pas de validation
7 Version String Version de Portal Infranet
8 LanguageVersion String Exemple : ENU pour l'anglais
9 DefaultBOPrefix String Exemple : Portal_BO
10 FileLocation String Chemin d'accès absolu contenant les fichiers des versions antérieures de définitions d'objets métier. Par exemple, sous Windows, si le chemin d'accès est C:\PortalBos, vous devez entrer la valeur C:\\Portal\\. Sous UNIX, si le chemin d'accès est /home/PortalBOs, vous devez entrer la valeur /home/PortalBos/.
11 TraceFileName String Nom du fichier de trace
12 TraceLevel Integer Texte ajouté avant le nom de l'objet métier pour le rendre unique. Vous pouvez modifier le nom par la suite, lorsque Business Object Designer vous demande d'entrer les propriétés de l'objet métier. Pour plus d'informations, voir Ajout d'informations complémentaires
13 MessageFile String Chemin d'accès au fichier de messages

Développement de noeuds, sélection de fichiers référentiels et de classes stockables

Après avoir configuré toutes les propriétés d'initialisation de PortalODA, Business Object Designer affiche l'écran suivant.

Figure 18. Arborescence offrant deux options de conversion et de génération d'objets métier
Arborescence offrant deux options de conversion et de génération d'objets métier

Cet écran présente deux options pouvant être développées, Convert et Generate. Si vous devez convertir les anciennes définitions d'objets métier en de nouvelles définitions, développez le noeud Convert. Les fichiers référentiels contenant les définitions d'objets métier à convertir s'affichent.

Conversion d'anciennes définitions d'objets métier

Les anciennes définitions d'objets métier possèdent des informations spécifiques à chaque application présentées sous forme de valeurs séparées par des virgules, tandis que les nouvelles définitions d'objets métier possèdent des informations spécifiques à chaque application présentées sous forme de paires nom-valeur séparées par des virgules. De plus, les anciennes définitions d'objets métier utilisent des méta-objets métier pour transformer la structure d'un objet métier associé à un code opération particulier alors que, dans les nouvelles définitions d'objets métier, cette fonction est remplacée par la paire nom-valeur d'informations spécifiques à chaque application au niveau de l'attribut de l'objet métier.

Sélectionnez les fichiers à convertir, puis cliquez sur Next.

Remarque :
Lorsque vous sélectionnez un fichier, toutes les définitions d'objets métier qu'il contient sont converties. Aucune méthode n'est préconisée pour sélectionner un sous-ensemble de définitions d'objets métier à convertir. Toutefois, si vous voulez convertir uniquement un sous-ensemble de définitions d'objets métier, vous pouvez créer un fichier contenant le sous-ensemble souhaité puis le convertir.

Génération de nouveaux objets métier

Si vous devez générer de nouvelles définitions d'objets métier à l'aide d'informations obtenues dans Portal Infranet, développez le noeud Generate. Cette option vous permet d'obtenir tous les noms de classes stockables depuis Portal Infranet et affiche une arborescence.

Ces noms de classes stockables, représentés par des noeuds dans l'arborescence, peuvent être développés (voir figure 19). Les objets métier générés ont des propriétés devant être définies individuellement pour qu'ils puissent être utilisés par le connecteur. Les zones de clé d'un objet métier doivent être marquées en tant que zones de clé dans l'objet métier du système WebSphere Business Integration. En fonction du code opération utilisé pour les différentes instructions, les informations spécifiques à chaque application au niveau des attributs doivent être définies. Ainsi, si un attribut fait partie du code opération de l'instruction Create, la valeur de la propriété "Create" doit être définie en fonction du nom de la zone parent. Reportez-vous à la section Informations spécifiques à l'application de niveau attribut pour obtenir des détails sur les diverses propriétés contenues dans les informations spécifiques aux applications d'un attribut.

Figure 19. Ecran présentant les classes stockables
Ecran présentant les classes stockables

Cet écran vous permet de sélectionner une classe stockable à générer dans la liste proposée. Le signe "+" placé avant un nom de classe signifie que la classe possède des objets enfants. Il est possible de sélectionner plusieurs classes à générer.

Remarque :
Lorsque vous sélectionnez une classe à générer qui possède des objets enfants, par défaut ces derniers ne sont pas sélectionnés. Vous devez sélectionner de façon explicite les objets enfants si vous souhaitez également les générer. Pour ce faire, maintenez la touche Maj enfoncée tout en sélectionnant les objets enfants.

Confirmation de la sélection des fichiers référentiels et des classes stockables

Après avoir identifié tous les fichiers référentiels ou toutes les classes stockables à associer à la définition d'objets métier générée, Business Object Designer affiche l'écran de confirmation suivant (voir figure 20).

Figure 20. Confirmation de votre sélection
Confirmation de votre sélection

Cette fenêtre contient les options suivantes :

Génération de définitions

Après avoir confirmé la sélection des objets de la base de données, la boîte de dialogue suivante vous informe que Business Object Designer procède à la création des définitions.

La figure 21 représente cette boîte de dialogue.

Figure 21. Génération de définitions
Génération de définitions

Ajout d'informations complémentaires

Si PortalODA requiert des informations complémentaires, Business Object Designer affiche la fenêtre BO Properties, qui vous invite à saisir ces informations. Cela ne se produit qu'en cas de génération d'objets métier. La figure 22 représente cette fenêtre.

Figure 22. Propriétés des classes stockables spécifiques aux applications
Propriétés des classes stockables spécifiques aux applications

Dans la fenêtre BO Properties, entrez ou modifiez les informations suivantes :

Figure 23. Informations spécifiques aux applications concernant les instructions
Informations spécifiques aux applications concernant les instructions

Le format des informations spécifiques aux applications au niveau de l'instruction est :

OpCode=;Flag=;TFlag=;IF=;IFP=;IFM=;OF=OFP= describes

Le tableau 9 décrit chaque nom cité dans les informations spécifiques aux applications au niveau de l'instruction.

Tableau 9. Informations spécifiques aux applications concernant les instructions
Nom Description
Opcode Nom du code opération devant être exécuté pour cette instruction
Flag Valeur de l'indicateur à utiliser avec le code opération
TFlag TFlag peut avoir la valeur true ou false, selon que le code opération gère ses propres transactions ou non.
IF IF (Input Flist) est le nom de l'objet métier utilisé pour préparer une flist d'entrée pour le code opération
IFP IFP (Input Flist Parameter) est le nom du paramètre facultatif pouvant être utilisé pour préparer la flist d'entrée.
IFM IFM (Input Flist Mode) est la valeur qui définit le type de conversion de flist effectuée
OF OF (Output Flist) est le paramètre qui régit la façon dont la flist renvoyée lors de l'exécution du code opération doit être convertie en objet métier
OFP OFM (Output Flist Mode) est la valeur qui définit le type de mise à jour des objets métier effectuée à partir de la flist de sortie du code opération

Enregistrement des définitions

Après avoir fourni toutes les informations requises dans la boîte de dialogue BO Properties et cliqué sur OK, Business Object Designer affiche la boîte de dialogue finale de l'assistant. Dans cette fenêtre, vous pouvez enregistrer la définition sur le serveur ou dans un fichier ou encore ouvrir la définition en vue de la modifier dans Business Object Designer. Pour plus d'informations, voir le document Business Object Development Guide.

La figure 24 représente cette boîte de dialogue.

Figure 24. Enregistrement d'une définition d'objet métier
Enregistrement d'une définition d'objet métier

Copyright IBM Corp. 2003, 2005