设置“SAP 连接”样本

“SAP 连接”样本开发用于具有各种 SAP 对象的指定定义的 SAP 级别。如果您在运行样本时遇到任何问题，请针对您要向其运行样本的本地 SAP 系统重新生成这些对象来确保定义正确。您可以通过从“集成开发”透视图运行“适配器连接”向导来执行此操作：单击“文件 > 新建 > 适配器连接”，然后选择“Sample_SAPAdapter_Tx”。

以下部分描述了运行演示 SAPInput 和 SAPRequest 节点的样本所需的配置设置。

• 启用“适配器连接”项目以查找 SAP JCo 库和 JAR 文件
• 为“SAP 入站”样本配置 SAP 系统
• 使用 SAP JCo 库配置 Integration 节点运行时
• 为 SAP 入站适配器配置连接详细信息
• 配置 SAP 出站适配器

启用适配器连接项目，以找到 SAP JCo 库以及 JAR 文件和 SAP IDoc JAR 文件

1. 要使 SAP 样本在导入后成功构建，您必须使 SAP Java 连接器 (SAP JCo) 接口库以及 JAR 文件和 SAP IDoc JAR 文件可供“适配器连接项目”使用：
   • 在 Windows 上：
     1. 将 sapjco3.dll 依赖关系库复制到本地子目录 C:\SAP_JARS。
     2. 将 sapjco3.jar JAR 文件复制到同一本地子目录 C:\SAP_JARS（样本引用该子目录）。
     3. 将 sapidoc3.jar JAR 文件复制到同一本地子目录 C:\SAP_JARS（样本引用该子目录）。
   • 在 Linux 上：
     1. 将 libsapjco3.so 依赖关系库复制到本地子目录 /opt/SAP_JARS。
     2. 将 sapjco3.jar 复制到同一本地子目录 /opt/SAP_JARS。
     3. 将 sapidoc3.jar 复制到同一本地子目录 /opt/SAP_JARS。
     4. 修改文件属性，使您具有所有文件的读访问权和执行权。
2. 可选：更新 SAP JCo 和 IDoc JAR 位置：
   1. 导入样本。
   2. 右键单击“适配器连接”项目 CWYAP_SAPAdapter_Tx，选择“属性 > Java 构建路径 > 库选项卡”，并指定相应平台的 sapjco3.jar 和 sapidoc3.jar 的正确位置。

为“SAP 入站”样本配置 SAP 系统

当您使用 Integration 节点入站消息传递时，必须配置 SAP 系统，以使其可将 Integration 节点唯一识别为目标。SAP 将创建多个组件（RFC 目标、端口、逻辑系统、分发模型和合作伙伴概要文件）来配置此连接。

1. 创建从 SAP 系统到 Integration 节点的 RFC 连接：
   1. 登录到 SAP 系统。
   2. 转至 SM59 事务：RFC 连接的配置。
   3. 单击“TCP/IP 连接”，单击“创建”。
   4. 检查连接类型是否设置为 T。
   5. 将“RFC 目标名称”设置为相应值；例如，SAMPRFC。确保 RFC 目标的名称不超过 8 个字符，并使用同一名称替换此样本中的任何地方使用的 SAMPRFC。要对以下步骤使用不同的名称，请查阅您的 SAP 系统文档以了解如何使用不同的名称。 但是，请对此样本的所有已创建对象使用相同名称。
   6. 在“技术设置”选项卡上，选择“注册服务器程序”。
   7. 将“程序标识”设置为与 Integration 节点适配器中指定的程序标识相匹配；例如，SAMPRFC。
   8. 单击“保存”保存设置。
   9. 在“描述 1”字段中输入描述；例如，样本的 RFC。
   10. 在“描述 2”字段中输入描述；例如，您的名称。
   11. 单击“MDMP & Unicode”。
   12. 选择“Unicode”。
   13. 在显示的窗口中，单击绿色记号。
   14. 单击“保存”。
2. 创建逻辑系统：
   1. 转至 BD54 事务：更改/查看逻辑系统。
   2. 在显示的窗口中，单击绿色记号，该记号警告您此表是跨客户机的。
   3. 单击新建条目。
   4. 在第一个字段中输入逻辑系统的名称；例如，SAMPRFC。
   5. 在第二个字段中输入逻辑系统的描述；例如，样本的逻辑系统。
   6. 单击“保存”。
   7. 显示窗口：
      • 如果显示工作台请求编号，请单击绿色记号。
      • 如果不显示任何编号：
        1. 单击“新建请求”，并在“创建请求”窗口中输入描述。
        2. 要生成请求编号，请单击“保存”。
        3. 单击绿色记号以继续。
   8. 转至事务 SCC4：显示/查看客户机概述。
   9. 双击要使用的客户机；例如，001。
   10. 在下一页上，记录“逻辑系统”字段中的条目；例如，CLNT001。
3. 创建分发模型：
   1. 转至事务 BD64：维护分发模型。
   2. 按 F9 键切换至“编辑”方式。
   3. 单击“创建模型视图”。
   4. 输入“简短文本”描述，例如，样本的模型。
   5. 输入“技术名称”；例如，SAMPRFC。
   6. 单击绿色记号。
   7. 选择创建的条目，单击“添加消息类型”。
   8. 在窗口中，选择“发送方”字段，单击“发送方”字段旁的图标。
   9. 此时显示一个具有“逻辑系统”选择的窗口，选择您在步骤 2j 中的 SCC4 事务中记录的客户机名称；例如，CLNT001。
   10. 单击绿色记号。
   11. 选择“接收方”字段，单击“接收方”字段旁的图标。
   12. 选择创建的“逻辑系统”；例如，SAMPRFC。单击绿色记号。
   13. 在“消息类型”中，输入 MATMAS（您在样本中使用的 IDoc 的类型），单击绿色记号。
   14. 在“分发模型”窗口中，单击“保存”。
   15. 展开创建用于查看模型、发送方、接收方和消息类型的“模型”。
   16. 选择消息类型 MATMAS。
   17. 单击“环境 > 生成合作伙伴概要文件”。
   18. 在“生成合作伙伴概要文件”中，单击“执行”以生成结果屏幕。
   19. 复审生成的项目。
   20. 转至事务 WE21：IDoc 处理中的端口。
   21. 展开“端口/事务 RFC”。 此时在列表底部显示新端口。 该端口具有类似于 A0000000xx 的名称格式。
   22. 单击端口并输入描述。
   23. 单击“保存”。
4. 复审合作伙伴概要文件：
   1. 转至事务 WE20：合作伙伴概要文件。
   2. 展开“合作伙伴概要文件/合作伙伴类型 LS”，单击创建的合作伙伴；例如，SAMPRFC。
   3. 在“出站”参数表中，双击消息类型 MATMAS。 此时显示包含生成的端口名称（例如，A0000000xx）的窗口；且基本类型为 MATMAS05。

使用 SAP JCo 库配置 Integration 节点运行时

要部署含有 SAP 节点的消息流，必须使用必备的 SAP JCo 库来配置 Integration 节点运行时。这些库由底层 SAP 适配器组件用于建立与 SAP 系统的连接。

您必须从命令环境运行以下 mqsichangeproperties 命令，以设置包含 SAP JCo 库的目录的位置。

1. 运行以下命令，将 SAP 客户机目录更改为匹配您的平台和所选位置：

   mqsichangeproperties  IB9NODE -c EISProviders -o SAP -n jarsURL -v C:\SAP_JARS

   mqsichangeproperties IB9NODE -c EISProviders -o SAP -n nativeLibs -v C:\SAP_JARS

2. 要验证属性是否正确设置，请运行以下命令：

   mqsireportproperties IB9NODE -c EISProviders -o SAP -r

3. 使用以下命令停止并重新启动 Integration 节点：

   mqsistop IB9NODE

   mqsistart IB9NODE

为 SAP 入站适配器配置连接详细信息

1. 将 SAP 样本导入您的工作空间。
2. 展开 SapInboundMatMasSampleMSet 消息集项目。
3. 单击“适配器 > 入站 > SAP”。
4. 要打开编辑器以用于指定访问您的 SAP 系统所需的连接参数，请双击 SapMatMasInbound.inadapter。
5. 在编辑器中输入以下设置：
   1. 网关主机名称或 IP 地址。
   2. 网关服务；例如，sapgw00。 要查找“网关服务”，请使用“远程 TP 名称”列中的事务代码 SMGW（网关监视器）。
   3. RFC 程序标识；例如，SAMPRFC。
   4. SAP 客户机标识（来自 SAP txn SCC4）。
   5. 用户名。SAP 系统的用户名。
   6. 密码。对应用户名的密码。
   7. 语言代码。如果语言为非英语时的语言代码。
   8. 主机名或 IP 地址。SAP 应用程序服务器的主机名或 IP 地址。
   9. SAP 系统编号。
6. 保存更新的适配器。
7. 展开 Integration 项目 SapInboundMatMasSampleMFlow。
8. 要打开代理归档编辑器，双击 SapInboundMatMasSample.bar。
9. 单击“准备”选项卡。
10. 单击“构建代理归档”。
11. 保存代理归档。
12. 将 SapInboundMatMasSample.bar BAR 文件部署到 SapSample 集成服务器：右键单击该 BAR 文件并选择“部署”，或者将该 BAR 文件拖动到集成服务器。

配置 SAP 出站适配器

1. 将 SAP 样本导入您的工作空间。
2. 展开 SapOutboundCustomerMSet 消息集项目。
3. 单击“适配器 > 出站 > SAP”。
4. 要打开编辑器以用于指定访问您的 SAP 系统所需的连接参数，请双击 SapCustomerOutbound.outadapter。
5. 在编辑器中输入以下设置：
   1. SAP 系统的用户名。
   2. 密码。对应用户名的密码。
   3. SAP 客户机标识。
   4. 语言代码。如果语言为非英语时的语言代码。
   5. 主机名或 IP 地址。SAP 应用程序服务器的主机名或 IP 地址。
   6. SAP 系统编号。
6. 保存更新的适配器。
7. 展开 Integration 项目 SapOutboundCustomerSampleMFlow。
8. 要打开代理归档编辑器，双击 SapOutboundCustomerSample.bar。
9. 单击“准备”选项卡。
10. 单击“构建代理归档”。
11. 保存代理归档。
12. 将 SapOutboundCustomerSample.bar BAR 文件部署到 SapSample 集成服务器：右键单击该 BAR 文件并选择“部署”，或者将该 BAR 文件拖动到集成服务器。

返回到样本主页