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 :
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 :
La figure 16 illustre la première boîte de dialogue de l'assistant de Business Object Designer, qui comprend six étapes.
Pour sélectionner l'ODA :
Vous pouvez également rechercher un agent par nom d'hôte et numéro de port.
Business Object Designer affiche votre sélection dans la zone Agent's name.
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.
Configurez les propriétés de PortalODA décrites dans le tableau 8.
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 |
Après avoir configuré toutes les propriétés d'initialisation de PortalODA, Business Object Designer affiche l'écran suivant.
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.
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.
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.
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.
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).
Cette fenêtre contient les options suivantes :
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.
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.
Dans la fenêtre BO Properties, entrez ou modifiez les informations suivantes :
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.
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 |
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.