安装和使用

下节描述了 SAPODA 的安装和使用。

安装 SAPODA

要安装 SAPODA,使用 IBM WebSphere Business Integration Adapters 的安装程序。遵循 Implementation Guide for WebSphere InterChange Server、Implementation Guide for WebSphere Message Brokers、Adapter for WebSphere MQ Integrator Broker、《系统安装指南 Windows 版》《系统安装指南 Unix 版》中的指示信息。当完成安装时,在系统上的产品目录中安装了以下文件:

注:
在本文档中,反斜杠(\)用作目录路径的约定。对于 UNIX 安装,用斜杠(/)替代反斜杠。所有产品路径名都是相对于该产品在系统上的安装目录。

在使用 SAPODA 之前

本节包含以下各节:

在运行 SAPODA 之前

您必须执行以下操作后才能运行 SAPODA:

在使用 SAPODA 为 ALE 或 ABAP 扩展模块创建定义之前

您可以使用 SAPODA 来基于 IDoc(中间文件)生成 ABAP 扩展模块和 ALE 模块的业务对象定义:

重要提示:
在使用 SAPODA 来根据 SAP IDoc 定义文件生成业务对象定义之前,您必须为您想支持的每种 IDoc 类型创建 IDoc 定义文件。仅当使用解压缩的 IDoc 定义文件作为业务对象定义的模板时才需要此步骤。有关更多信息,请参阅"创建 IDoc 定义文件"

如何使用 SAPODA

在安装 SAPODA 之后,您必须执行以下操作来生成业务对象:

  1. 启动 ODA。
  2. 启动业务对象设计器。
  3. 遵循业务对象设计器中一个有 6 个步骤的过程来配置和运行 ODA。

以下各节详细地描述了这些步骤。

启动 SAPODA

您可以通过运行适当的文件来启动 SAPODA:
UNIX

start_SAPODA.sh

Windows

start_SAPODA.bat

使用业务对象设计器配置并运行 SAPODA。业务对象设计器使用代理程序的主机和端口来查找 ODA。在每个脚本或批处理文件的 AGENTNAME 变量中指定了代理程序的名称。此连接器的缺省 ODA 名称是 SAPODA。有关 ODA 和业务对象定义以及如何配置、启动和使用 ODA 的更多信息,请参阅 IBM WebSphere Business Object Development Guide

使用错误消息文件和跟踪消息文件

错误消息文件和跟踪消息文件(缺省值为 SAPODAAgent.txt)位于产品目录下的 \ODA\messages\。这些文件特定于语言和国家或地区,并且使用以下命名约定:

AgentNameAgent_ll_TT.txt
 

其中 _ll 是语言,_TT 是国家或地区。

例如,在中国大陆,该文件名将为:
SAPODAAgent_zh_CN.txt

而在台湾,该文件名将为:
SAPODAAgent_zh_TW.txt

业务对象设计器在选择消息文件时使用此信息。缺省搜索顺序是首先查找特定于语言环境的文件,该文件与业务对象设计器运行时所在的语言环境匹配。如果未找到该文件,则业务对象设计器缺省为美国英语(en_US )版本。最后,业务对象设计器查找不带任何语言环境信息或语言信息的文件名。

如果您创建 ODA 脚本或批处理文件的多个实例并为每个提供的 ODA 提供一个唯一名称,尽管没有要求这样做,您也可以为每个 ODA 实例都提供一个消息文件。或者,您可以将使用同一消息文件的 ODA 命名为不同名称。

有两种方式来指定有效的消息文件:

如果您使用存在于 ODA 根目录中的部署描述符 odk_dd.xml 文件, MessageFile 属性不会显示在“业务对象设计器”的“配置代理程序属性”窗口中。

注:
如果需要非英语语言环境,则相同的命名约定仍然适用;例如,SAPODA1Agent_zh_TW.txt

重要提示:
当您配置 ODA 时,未能正确指定消息文件的名称会导致它在不带消息的情况下运行。有关指定消息文件名的更多信息,请参阅配置初始化属性

在配置过程期间,您应指定:

表 4 描述跟踪级别值。

表 4. 跟踪级别
跟踪级别 描述
0 将所有错误写入日志
1 跟踪方法的所有进入和退出消息
2 跟踪 ODA 的属性及其值
3 跟踪所有业务对象的名称
4 跟踪所有衍生的线程的详细信息
5
  • 指示 ODA 的所有属性的初始值
  • 跟踪 SAPODA 衍生的每个线程的详细状态
  • 跟踪业务对象定义转储

有关在何处配置这些值的信息,请参阅配置初始化属性

Copyright IBM Corp. 1997, 2004