Installation et utilisation

Cette section aborde les points suivants :

Installation de PortalODA

Pour installer PortalODA, utilisez le programme d'installation de WebSphere Business Integration Adapter (WBIA). 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 WBIA sont associés au répertoire dans lequel le produit est installé sur votre système.

Avant d'utiliser PortalODA

Pour pouvoir exécuter PortalODA, vous devez copier les fichiers .jar requis de l'application Portal Infranet dans le répertoire %ProductDir%/connectors/Portal/dependencies. Les fichiers suivants doivent être copiés dans ce répertoire :

pcm.jar
 pcmext.jar

Les fichiers ci-dessus se trouvent dans le dossier %INFRANET%\jars.

Une fois le composant PortalODA installé, vous devez effectuer les opérations suivantes pour générer ou convertir des objets métier :

  1. Lancez l'agent ODA.
  2. Démarrez 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.

Démarrage de PortalODA

Vous pouvez démarrer PortalODA à l'aide d'un des scripts suivantes :

UNIX :

start_PortalODA.sh

Windows :

start_PortalODA.bat

Configurez et exécutez PortalODA à 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'agent ODA défini pour ce connecteur est PortalODA.

Exécution de PortalODA sur plusieurs machines

Vous pouvez exécuter plusieurs instances de l'agent ODA, soit sur l'hôte local, soit sur un hôte distant du réseau. Si plusieurs instances s'exécutent sur une même machine, chacune d'elle doit utiliser un port unique.

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

Changement du nom du fichier de messages et d'erreurs

Le fichier de messages d'erreur et de trace (PortalODAAgent.txt) se trouve dans le répertoire \ODA\messages\, sous le répertoire produit. Ce fichier utilise la convention de dénomination suivante :

AgentNameAgent.txt

Si vous renommez un agent ODA dans la variable AGENTNAME d'un fichier de script ou de traitement par lots, utilisez cette convention pour renommer le fichier de messages d'erreur et de trace associé.

Si vous créez plusieurs instances du fichier de script ou de traitement par lots et indiquez un nom unique pour chaque agent ODA représenté, créez une copie du fichier de messages d'erreur et de trace pour chacun de ces agents. Attribuez un nom à chaque fichier conformément à cette convention. Par exemple, si la variable AGENTNAME indique PortalODA1, nommez le fichier de messages associé : PortalODA1Agent.txt.

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

Le tableau 7 décrit les valeurs du niveau de traçage.

Tableau 7. Niveaux de traçage
Niveau de trace Description
0 Consigne toutes les erreurs
1 Effectue un traçage de tous les messages d'entrée et de sortie pour la méthode
2 Effectue un traçage des propriétés de l'ODA et de leurs valeurs
3 Effectue un traçage des noms de tous les objets métier
4 Effectue un traçage du 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 * Effectue un traçage de l'état détaillé de chaque unité d'exécution générée par PortalODA * Exécute le traçage du vidage des définitions d'objets métier

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

Copyright IBM Corp. 2003, 2005