Utilisation d'ODA for Manugistics dans Business Object Designer

Cette section explique comment utiliser ODA for Manugistics dans Business Object Designer pour créer des définitions d'objet métier. Pour plus d'informations sur l'exécution de Business Object Designer, voir le document Business Object Development Guide. Vous pouvez télécharger ce document sur l'InfoCenter d'IBM WebSphere Business Integration Adapters : http://www.ibm.com/websphere/integration/wbiadapters/infocenter

Une fois que vous avez lancé un ODA, vous devez démarrer Business Object Designer afin de le configurer et l'exécuter. Dans Business Object Designer, la création 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 6 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. "Développement des noeuds et sélection des objets de la base de données"
  4. "Confirmation des sélections d'objets de base de données"
  5. "Création des définitions" et, le cas échéant, "Informations supplémentaires"
  6. "Enregistrement des définitions"

Sélection de l'ODA

La Figure 6 représente la première boîte de dialogue de l'assistant de Business Object Designer qui comprend six étapes. Dans cette fenêtre, sélectionnez l'ODA à exécuter.

Figure 6. 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.
    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.

  3. Cliquez sur Next.

Configuration des propriétés d'initialisation

La première fois que Business Object Designer communique avec ODA for Manugistics, il vous invite à entrer les propriétés d'initialisation, comme l'illustre la Figure 7. Vous pouvez enregistrer ces propriétés dans un profil nommé de sorte que vous n'ayez plus besoin de les entrer chaque fois que vous utilisez ODA for Manugistics. Pour plus d'informations sur l'indication d'un profil ODA, voir le document Business Object Development Guide.

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


Configurez les propriétés d'ODA for Manugistics, décrites dans le Tableau 14.

Tableau 14. Propriétés d'ODA for Manugistics
Numéro de ligne Nom de la propriété Type de propriété Description
1
UserName
 
String Nom de l'utilisateur qui dispose des autorisations pour se connecter à la base de données.
2
Password
 
String Mot de passe de l'utilisateur qui dispose des autorisations pour se connecter à la base de données.
3
DatabaseUrl
 
String URL qui permet de se connecter à la base de données. Par exemple : jdbc:oracle:thin:@MACHINENAME:1521:SIDNAME
4
DatabaseDriver
 
String Nom du pilote utilisé pour établir la connexion. Par exemple : oracle.jdbc.driver.OracleDriver
5
DefaultBOPrefix
 
String Texte préajouté au 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 "Informations supplémentaires".
6
TraceFileName
 
String Nom du fichier dans lequel le composant ODA for Manugistics enregistre les informations de trace. Si le fichier n'existe pas, ODA for Manugistics le crée dans le répertoire \ODA\Manugistics. Si le fichier existe déjà, ODA for Manugistics y ajoute le nom du fichier. ODA for Manugistics nomme le fichier conformément à la convention d'appellation. Par exemple, si l'agent est nommé ManugisticsODA, il crée un fichier trace nommé ManugisticsODAtrace.txt. Utilisez cette propriété pour indiquer un autre nom pour ce fichier.
7
TraceLevel
 
Integer Niveau de suivi défini pour ODA for Manugistics. Voir Tableau 13.
8
MessageFile
 
String Nom du fichier de messages et d'erreurs. ODA for Manugistics affiche le nom du fichier conformément à la convention d'appellation. Par exemple, si l'agent s'appelle ManugisticsODA, la valeur de la propriété du fichier de messages se présente sous la forme ManugisticsODAAgent.txt. Important : Le fichier de messages et d'erreurs doit résider dans le répertoire \ODA\messages. Utilisez cette propriété pour vérifier ou indiquer un fichier existant.
Important

Corrigez le nom du fichier de messages si la valeur par défaut affichée dans Business Object Designer correspond à un fichier qui n'existe pas. Si le nom est incorrect lorsque vous passez à la fenêtre suivante, Business Object Designer affiche un message d'erreur dans la fenêtre dans laquelle l'ODA a été lancé. Le message n'apparaît pas dans Business Object Designer. Si vous n'indiquez pas un fichier de messages correct, l'ODA s'exécute sans message.

Développement des noeuds et sélection des objets de la base de données

Une fois les propriétés d'initialisation configurées pour ODA for Manugistics, Business Object Designer se connecte à la base de données spécifiée et affiche une arborescence contenant tous les noms de schéma existant dans la base de données. Ces noms, représentés par des noeuds dans l'arborescence, peuvent être développés. Cliquez sur l'un deux pour afficher toutes les tables, les vues, les procédures stockées et les synonymes/alias contenus dans chaque schéma. La Figure 8 représente cette boîte de dialogue avec certains schémas développés.

Figure 8. Arborescence des schémas avec les noeuds développés


Pour identifier tous les objets de base de données qui stockent les données de la définition de l'objet métier créée, sélectionnez l'ensemble des tables, vues, procédures stockées et synonymes/alias, puis cliquez sur Next. Pour plus d'informations sur le filtrage des objets renvoyés, voir le document Business Object Development Guide.

Le nom de schéma ALL SCHEMAS est utilisé pour faciliter l'extraction des objets comme les tables et les vues des bases de données qui n'ont pas de schéma associé aux objets. Si vous développez ALL SCHEMAS, une arborescence contenant les tables, vues, procédures stockées et les synonymes/alias s'affiche. Lorsque tous les noeuds sont développés, tous les objets correspondants de la base de données s'affichent, quel que soit le schéma auquel l'objet appartient.

Figure 9. Développement du noeud ALL SCHEMAS pour extraire les objets

B

Confirmation des sélections d'objets de base de données

Après avoir identifié tous les objets de base de données à associer à la définition de l'objet métier créée, Business Object Designer affiche la boîte de dialogue qui contient uniquement les tables, les vues, les procédures stockées et les synonymes/alias. La Figure 10 représente cette boîte de dialogue.

Figure 10. Confirmation de la sélection des objets de base de données


Cette fenêtre contient les options suivantes :

Création des définitions

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

Informations supplémentaires

Si le composant ODA for Manugistics a besoin d'informations supplémentaires, Business Object Designer affiche la fenêtre BO Properties, qui vous permet d'entrer ces informations.

Figure 11. Informations supplémentaires sur les objets de base de données


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

Figure 12. Sélection des attributs de procédure stockée


Remarque :
Si une zone dans la boîte de dialogue BO Properties contient plusieurs valeurs, la zone apparaît vide lorsque la boîte de dialogue s'affiche pour la première fois. Cliquez dans la zone pour afficher une liste déroulante contenant ses valeurs.

Les attributs de la procédure stockée à ajouter à l'objet métier peuvent être associés à l'une des procédures stockées dans la base de données de ce schéma. Vous pouvez choisir une procédure stockée dans une liste déroulante contenant toutes les procédures stockées de la base de données de ce schéma, en fonction de chaque attribut de procédure stockée. Ces informations créeront les informations spécifiques à l'application relatives à cet attribut.

Figure 13. Association des procédures stockées aux attributs de procédure stockée


Les informations spécifiques à l'application relatives à l'objet se présenteront sous la forme TN=tableName.

Au niveau de l'attribut, les informations spécifiques à l'application se présenteront sous la forme CN=ColumnName.

Si un objet métier est créé à partir d'une procédure stockée, et que les attributs de procédure stockée d'ODA for Manugistics Adapter (comme SPForCreate) y sont associés, l'agent ODA fournit la liste de tous les noms de procédure stockée de ce schéma en fonction des attributs de procédure stockée. Cet ODA permet d'associer la procédure stockée requise à l'objet métier. Cela permet de créer les informations spécifiques à l'application pour l'attribut de la procédure stockée du composant ODA for Manugistics Adapter, comme suit :

SPN=stored procedure Name; IN=a1:a2; OUT=b1:b2; IO=c1:c2

où IN signifie que le paramètre de la procédure stockée est de type INPUT, OUT signifie que le paramètre est de type OUTPUT et IO de type INPUT/OUTPUT. L'ODA n'affecte pas la valeur "true" ou "false" au paramètre RS dans les informations spécifiques à l'application. Par conséquent, vous devez le faire manuellement.

Les instructions ajoutées à l'objet métier sont les instructions standard, telles que Retrieve, RetrieveByContent, Create, Update et Delete.

Si le paramètre de retour de la procédure stockée est de type ResultSet, l'agent ODA analyse le jeu de résultats et crée un objet métier, faisant ainsi des colonnes du jeu de résultats les attributs de l'objet métier. Les informations spécifiques à l'application pour les colonnes de la procédure stockée auront la valeur CN=StoredProcedureColumnName. L'ODA définit les attributs de clé basés sur les métadonnées JDBC renvoyées par le pilote. Si aucune valeur n'est renvoyée, l'ODA n'identifie pas les attributs par défaut comme des clés. Tous les autres attributs, comme les attributs de longueur et de type, sont définis comme pour les attributs créés à partir des tables.

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.

Copyright IBM Corp. 1997, 2004