Installation et utilisation

Cette section aborde les points suivants :

Installation d'ODA for Manugistics

Pour installer le composant ODA for Manugistics, utilisez le programme d'installation d'IBM WebSphere Business Integration Adapter for Manugistics. Suivez les instructions contenues dans le document System Installation Guide for UNIX ou for Windows. Une fois l'installation terminée, vous devez installer les fichiers suivants dans le répertoire où vous avez installé le produit sur votre système :

Remarque :
Sauf indication contraire, ce document utilise les barres obliques inverses (\) comme convention dans les chemins de répertoire. Pour les systèmes UNIX, remplacez les barres obliques inverses par des barres obliques (/). Tous les noms de chemin des produits sont associés au répertoire dans lequel le produit est installé sur votre système.

Avant d'utiliser ODA for Manugistics

Pour pouvoir exécuter ODA for Manugistics, vous devez effectuer les opérations suivantes :

  1. Installez le pilote JDBC correspondant. Suivez les instructions contenues dans le document System Installation Guide for UNIX ou for Windows.
    Important:
    ODA for Manugistics peut être connecté à n'importe quelle base de données utilisant un pilote JDBC qui prend en charge JDBC 2.0 ou suivant.
  2. Etant donné qu'ODA for Manugistics crée des noms d'objet métier et des noms d'attribut à partir des noms de tables de base de données et des colonnes correspondantes, et que ces noms doivent être au format ISO Latin-1, vérifiez que les noms des composants de la base de données sont au format Latin-1. Dans le cas contraire, vous avez le choix entre les opérations suivantes :
  3. Modifiez le shell UNIX ou le fichier de traitement par lots Windows et configurez les valeurs décrites dans le Tableau 12.

    Tableau 12. Variables de configuration du shell et du fichier de traitement par lots
    Variable Explication Exemple
    AGENTNAME
     
    Nom de l'ODA

    UNIX : AGENTNAME=ManugisticsODA

    Windows : set AGENTNAME=ManugisticsODA

    AGENT
     
    Nom du fichier jar de l'ODA

    UNIX : AGENT=$CROSSWORLDS/ODA/Manugistics/ BIA_ManugisticsODA.jar

    Windows : set AGENT= %CROSSWORLDS%\ODA\Manugistics\ BIA_ManugisticsODA.jar




    DRIVERPATH
     
    Chemin d'accès à la bibliothèque du pilote JDBC. ODA for Manugistics utilise les classes du pilote pour établir une connexion à une base de données spécifique

    UNIX : DRIVERPATH=$CROSSWORLDS/lib/ \ xwutil.jar:$CROSSWORLDS/lib/ \ xwbase.jar:$CROSSWORLDS/lib/ \ xwsqlserver.jar:$CROSSWORLDS/lib/ \ spy/lib/spy.jar

    Windows : set DRIVERPATH=%CROSSWORLDS%\ / lib\xwutil.jar;%CROSSWORLDS%\lib\ / xwbase.jar;%CROSSWORLDS%\lib\ / xwsqlserver.jar;%CROSSWORLDS%\lib\ / spy\lib\spy.jar

    DRIVERLIB
     
    Chemin d'accès aux bibliothèques natives utilisées par le pilote JDBC

    UNIX : DRIVERLIB=$CROSSWORLDS/lib/db2jdbc.so

    Windows : DRIVERLIB=%CROSSWORLDS%\bin\db2jdbc.dll

Une fois que vous avez installé le pilote JDBC et défini les valeurs de configuration dans le shell ou le fichier de traitement par lots, vous devez procéder comme suit pour créer les objets métier :

  1. Lancez l'ODA.
  2. Lancez Business Object Designer.
  3. Suivez un processus à six étapes dans Business Object Designer pour configurer et exécuter l'ODA.

Les sections suivantes décrivent chaque étape en détail.

Lancement d'ODA for Manugistics

Vous pouvez lancer ODA for Manugistics à l'aide du script de démarrage correspondant au système d'exploitation.

UNIX :

start_ManugisticsODA.sh
 

Windows :

start_ManugisticsODA.bat
 

Configurez et exécutez ODA for Manugistics à l'aide de l'outil Business Object Designer. Business Object Designer recherche chaque ODA par le nom indiqué dans la variable AGENTNAME de chaque script ou fichier de traitement par lots. Le nom par défaut de l'ODA défini pour ce connecteur est ManugisticsODA.

Exécution d'instances multiples d'ODA for Manugistics

Il est recommandé de changer le nom de l'ODA lorsque vous exécutez plusieurs instances de ce composant. Pour créer d'autres instances d'ODA for Manugistics portant chacune un nom unique :

Il est recommandé d'indiquer un préfixe à chaque nom de machine hôte lorsque vous exécutez des instances ODA sur différentes machines.

La Figure 6 illustre la fenêtre dans Business Object Designer à partir de laquelle vous sélectionnez l'ODA à exécuter.

Utilisation des fichiers de messages d'erreur et de trace

Les fichiers de messages d'erreur et de trace (la valeur par défaut est BIA_ManugisticsODAAgent.txt) résident dans le répertoire \ODA\messages\, situé sous le répertoire produit. Ces fichiers utilisent la convention d'appellation suivante :

AgentNameAgent.txt
 

Si vous créez plusieurs instances du script ou du fichier de traitement par lots de l'ODA et que vous indiquez un nom unique pour chaque ODA représenté, vous pouvez avoir un fichier de messages pour chaque instance d'ODA. Des noms différents d'ODA peuvent également utiliser le même fichier de messages. Il existe deux manières d'indiquer un fichier de messages correct :

Important:
Si vous n'indiquez pas de nom pour le fichier de messages lorsque vous configurez l'ODA, ce dernier s'exécute sans messages. Pour plus d'informations sur l'indication du nom du fichier de messages, voir "Configuration des propriétés d'initialisation".

Au cours du processus de configuration, indiquez les éléments suivants :

Le Tableau 13 décrit ces valeurs.

Tableau 13. Niveaux de suivi
Niveau de trace Description
0 Consigne toutes les erreurs
1 Effectue un suivi de tous les messages d'entrée et de sortie pour la méthode
2 Effectue un suivi des propriétés de l'ODA et de leurs valeurs
3 Trace le nom de tous les objets métier
4 Trace le détail des unités d'exécution générées
5 * Indique les valeurs d'initialisation de l'ODA pour toutes ses propriétés
* Trace un état détaillé de chaque unité d'exécution générée par ODA for Manugistics
* Trace le cliché de la définition de l'objet métier

Pour plus d'informations sur l'emplacement dans lequel vous voulez configurer ces valeurs, voir "Configuration des propriétés d'initialisation".

Copyright IBM Corp. 1997, 2004