SAP 工作负载集成 - Amazon Quick Suite
您能做什么开始前的准备工作准备 SAP 系统配置和身份验证设置 SAP 集成按连接器类型划分的可用操作查询参数管理 SAP 工作负载集成排除 SAP 工作负载集成故障

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

SAP 工作负载集成

借助 SAP 工作负载集成，您可以在各种 SAP 系统中执行操作。管理业务数据、库存、物料和业务流程。这些集成仅支持操作执行，并且需要 Amazon Quick Suite 专业版或更高级别的级别。

您能做什么

SAP 工作负载集成提供企业级连接，帮助您使用 SAP 系统。

动作连接器

在 SAP 系统内执行操作。通过 SAP 创建、更新和管理业务数据、库存记录、物料信息和其他企业运营 APIs。

多个 SAP 模块

Support 支持五种不同的集成类型：物料清单、业务合作伙伴、物料库存、实物盘点文档和主产品。

开始前的准备工作

在设置 SAP 工作负载集成之前，请确保具备以下条件：

  • 安装并配置了相应模块的 SAP 系统。

  • 具有必要权限和授权的 SAP 用户帐户。

  • 亚马逊 Quick Suite 作者或更高版本。

  • Amazon Quick Suite 和你的 SAP 系统之间的网络连接。

准备 SAP 系统配置和身份验证

在 Amazon Quick Suite 中设置集成之前，请准备好您的 SAP 系统配置和用户身份验证。SAP 工作负载集成支持多种身份验证方法，并且需要适当的系统设置。

身份验证方法

SAP 工作负载集成支持两种身份验证方法：

OAuth 2.0（推荐使用）

自动化工作流程的安全身份验证方法。需要在 SAP 系统中进行 OAuth 配置。

必填参数：

  • 客户端 ID-SAP OAuth 客户端 ID

  • 客户密钥-SAP OAuth 客户端密钥

  • 令牌 URL- OAuth 令牌端点（例如https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100）

  • 域名网址-SAP 系统 API 端点（例如https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER）

基本身份验证

用于直接访问 SAP 系统的用户名和密码认证。

必填参数：

  • 用户名-SAP 系统用户名

  • 密码-SAP 系统密码

  • 域名网址-SAP 系统 API 端点

SAP 系统配置要求

在使用 SAP 工作负载集成之前，请确保正确配置您的 SAP 系统：

OAuth 2.0 安装程序

对于 OAuth 2.0 身份验证：

  • 使用适当的作用域配置 OAuth 授权服务器

  • 使用交易代码验证 OAuth 服务已启用 /IWFND/MAINT_SERVICE

  • 有关详细的 OAuth 2.0 配置，请参阅 SAP 文档：OAuth 2.0 配置指南

SAP API 激活

确保所需的 SAP API 服务处于活动状态：

  • 为您选择的 SAP 连接器激活特定的 API 服务

  • 在你的 SAP 系统中验证 API 服务状态

  • 有关 API 激活的信息，请参阅 SAP 文档：SAP API 服务激活指南

可用的 SAP 工作负载集成类型

选择符合您业务需求的 SAP 集成类型，并确保相应的 SAP 模块在您的系统中可用。

SAP 物料清单

管理物料清单数据，包括组件清单、数量和制造规格。

所需范围：ZAPI_BILL_OF_MATERIAL_SRV_0002

SAP 业务合作伙伴

处理业务合作伙伴信息，包括客户和供应商数据、联系方式和关系管理。

所需范围：ZAPI_BUSINESS_PARTNER_0001

SAP 材料库存

访问和管理物料库存水平、库存流动和仓库信息。

所需范围：ZAPI_MATERIAL_STOCK_SRV_0001

SAP 实地盘点文档

创建和管理实地库存文档、库存盘点和库存对账流程。

所需范围：ZAPI_MATERIAL_STOCK_SRV_0001

SAP 产品大师

维护产品主数据，包括材料规格、分类和产品层次结构。

所需范围：ZAPI_PRODUCT_SRV_0001

SAP 工作负载身份验证设置

准备 SAP 用户身份验证凭证并确保适当的系统访问权限。

  • SAP 系统 URL-获取 SAP 系统的基本 URL 或服务器地址。

  • 用户凭证-创建或标识具有适当权限的 SAP 用户帐户。

  • 系统权限-确保用户帐户具有您计划集成的特定 SAP 模块所必需的 SAP 授权和交易代码。

  • 网络访问-验证您的 SAP 系统是否可通过外部连接进行访问，以及防火墙规则是否允许集成。

设置 SAP 集成

准备好 SAP 系统配置和身份验证凭证后，所有 SAP 集成类型的设置过程都类似。根据您的安全要求在 OAuth 2.0 或基本身份验证之间进行选择。

  1. 在 Amazon Quick Suite 控制台中，选择集成。

  2. 选择一个可用的 SAP 连接器：

    • SAP 物料清单

    • SAP 业务合作伙伴

    • SAP 材料库存

    • SAP 实地盘点文档

    • SAP 产品大师

  3. 单击 “添加”（加上 “+” 按钮）。

  4. 填写 SAP 集成的名称和描述。

  5. 选择集成的连接类型。

  6. 使用支持的方法之一配置身份验证：

    1. OAuth 2.0 配置

      对于 OAuth 2.0 身份验证，请提供：

      • 客户端 ID-您的 SAP OAuth 客户端 ID

      • 客户密钥-你的 SAP OAuth 客户端密钥

      • 令牌网址- OAuth 令牌端点网址

      • 域名网址-SAP 系统 API 端点网址

    2. 基本身份验证配置

      对于基本身份验证，请提供：

      • 用户名-您的 SAP 系统用户名

      • 密码-您的 SAP 系统密码

      • 域名网址-SAP 系统 API 端点网址

  7. 选择创建并继续。

  8. 选择要与之共享集成的用户。

  9. 单击下一步。

预期结果

成功设置后，您的 SAP 工作负载集成将显示在集成列表中，可供在 Amazon Quick Suite 工作流程、自动化和 AI 代理中使用。您可以使用配置的身份验证凭证直接从 Amazon Quick Suite 执行特定于 SAP 的操作。

按连接器类型划分的可用操作

每个 SAP 工作负载连接器都提供针对其业务领域量身定制的特定操作。查看所选连接器类型的可用操作。

SAP 物料清单运营

管理物料清单数据的可用操作：

  • 获取物料 BOM 物料-检索指定物料的物料清单详细信息

    操作 ID：getMaterialBOMItem

    终端节点：GET /MaterialBOMItem

SAP 业务合作伙伴的运营

用于管理业务合作伙伴数据的可用操作：

  • 获取业务合作伙伴-检索业务合作伙伴的一般数据

    操作 ID：getBusinessPartner

  • 获取业务合作伙伴地址-检索业务合作伙伴地址数据

    操作 ID：getBusinessPartnerAddress

  • 获取业务合作伙伴角色-检索业务合作伙伴角色数据

    操作 ID：getBusinessPartnerRole

  • 通过 ID 获取业务合作伙伴-按业务伙伴编号检索业务伙伴数据

    操作 ID：getBusinessPartnerByID

    必填参数：BusinessPartner（字符串，最多 10 个字符）

  • 按 ID 获取业务合作伙伴角色-使用关键字段检索业务合作伙伴角色数据

    操作 ID：getBusinessPartnerRoleByID

    必填参数：BusinessPartner（字符串，最多 10 个字符）、BusinessPartnerRole（字符串，最多 6 个字符）

SAP 材料库存业务

用于管理物料库存数据的可用操作：

  • 在账户中获取材料库存-检索账户模型中发布的材料库存信息

    操作 ID：getMaterialStockInAccount

SAP 实地盘点记录操作

用于管理实地盘点文档的可用操作：

  • 获取 PhysInventory 文档项目-读取实地盘点项目信息

    操作 ID：getPhysInventoryDocItem

SAP 产品大师操作

用于管理产品主数据的可用操作：

  • 获取产品主项目-返回产品主记录

    操作 ID：getProductMaster

  • 按物料获取工厂数据-返回产品主记录的工厂数据

    操作 ID：getPlantDataByMaterial

    必填参数：Product（字符串，最多 40 个字符）

  • 按物料获取供应计划数据-按产品编号和工厂返回供应计划数据

    操作 ID：getSupplyPlanningDataByMaterial

    必填参数：Product（字符串，最多 40 个字符）、Plant（字符串，最多 4 个字符）

查询参数

SAP 连接器支持用于筛选、排序和格式化 API 响应的标准查询参数。使用这些参数来优化数据检索和处理。

支持的查询参数
# 参数 描述 Type
1 $top 限制退货商品的数量 整数
2 $skip 跳过指定数量的项目 整数
3 $filter 根据指定条件筛选结果 字符串
4 $orderby 按指定字段对结果进行排序 array
5 $select 选择要返回的特定属性 array
6 $expand 展开相关实体 array
7 $inlinecount 包括响应中的商品数量 字符串

管理 SAP 工作负载集成

创建 SAP 工作负载集成后，您可以通过多个选项对其进行管理。

编辑集成设置

按照以下步骤修改您的 SAP 工作负载集成设置。

  1. 在 Amazon Quick Suite 控制台中，选择集成。

  2. 从集成网格中选择你的 SAP 工作负载集成类型。

  3. 从列表中选择您的集成，然后选择编辑。

  4. 修改集成设置：

    • 更新身份验证凭证（用户名和密码）。

    • 更改 SAP 系统 URL 或连接设置。

    • 修改集成名称或描述。

  5. 选择 “保存更改” 以应用您的修改。

共享集成

您可以与组织中的其他用户共享 SAP 工作负载操作连接器。

  1. 从 SAP 集成详细信息页面中，选择共享。

  2. 配置共享选项：

    • 与特定用户共享-输入用户名或电子邮件地址。

    • 与组织共享-向组织中的所有用户开放。

  3. 设置共享访问权限级别。

  4. 选择共享集成以应用共享设置。

删除集成

请按照以下步骤永久移除您的 SAP 集成。

  1. 从 SAP 工作负载集成详细信息页面中，选择删除。

  2. 查看删除的影响，包括使用此集成的所有工作流程或自动化。

  3. 键入集成名称以确认删除。

  4. 选择 “删除集成” 可将其永久删除。

排除 SAP 工作负载集成故障

使用这些故障排除技巧来解决常见的 SAP 工作负载集成问题。

身份验证问题

OAuth 2.0 身份验证失败

症状：令牌生成失败、客户端凭据无效或 OAuth 范围错误。

解决方案：

  • 验证 OAuth 客户端 ID 和客户端密钥是否正确

  • 使用事务检查是否在 SAP 中正确配置 OAuth /IWFND/MAINT_SERVICE

  • 确保为您的 SAP 工作负载连接器类型正确配置了所需的范围

  • 验证令牌 URL 格式是否与您的 SAP 系统配置相匹配

基本身份验证失败

症状：登录失败、凭据无效或访问被拒绝错误。

解决方案：

  • 验证 SAP 用户名和密码是否正确

  • 检查用户帐户是否具有必要的 SAP 授权

  • 确保用户帐户未被锁定或过期

  • 验证域名 URL 是否可访问且格式正确

SAP 系统配置问题

API 服务未激活

症状：服务不可用错误、找不到 API 端点或 HTTP 404 响应。

解决方案：

  • 验证您的系统中是否激活了所需的 SAP API 服务

  • 使用 SAP 事务代码检查 API 服务状态

  • 确保 API 服务与您选择的 SAP 连接器类型相对应

  • 请联系您的 SAP 管理员以激活缺失的 API 服务

连接超时

症状：请求超时、网络连接错误或响应时间慢。

解决方案：

  • 检查你的 SAP 系统 URL 是否正确且可访问

  • 验证网络连接是否允许连接到 SAP 系统

  • 确保防火墙规则允许集成流量

  • 检查 SAP 系统性能和可用性

权限和授权错误

SAP 授权不足

症状：访问被拒绝错误、缺少授权消息或受限操作失败。

解决方案：

  • 确保经过身份验证的用户需要获得特定模块的 SAP 授权

  • 验证用户是否有权访问必要的交易代码

  • 检查用户账户是否有适当的角色分配

  • 请联系您的 SAP 管理员以授予缺少的权限

范围权限错误

症状： OAuth 范围错误、API 操作权限不足或访问受限消息。

解决方案：

  • 验证 OAuth 配置是否包含您的连接器类型所需的范围

  • 检查 SAP 系统中是否正确授予了范围权限

  • 确保已向 OAuth 客户端授予必要的 API 访问权限

数据格式和参数错误

参数格式无效

症状：数据验证错误、字段长度消息无效或参数格式异常。

解决方案：

  • 查看操作参数并确保它们与预期的 SAP 数据格式相匹配

  • 检查字段长度是否符合 SAP 系统要求（例如， BusinessPartner 最多 10 个字符）

  • 验证特定 SAP 模块的数据类型是否正确

  • 确保为操作提供了所有必填字段

查询参数错误

症状：查询语法错误、不支持的参数消息或格式错误的请求错误。

解决方案：

  • 验证参数使用正确的语法（例如$filter、$top、$skip）

  • 检查参数值的格式是否正确

  • 确保 SAP API 支持正在使用的特定参数

  • 有关支持的查询选项，请参阅 SAP API 文档

SAP 系统可用性问题

SAP 系统不可用

症状：连接被拒绝错误、系统无响应或服务不可用消息。

解决方案：

  • 向 SAP 管理员查询 SAP 系统状态和可用性

  • 验证是否存在影响系统的定期维护时段

  • 检查是否有任何 SAP 系统警报或已知问题

  • 确认系统可用性后重试该操作