View a markdown version of this page

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

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

SAP 工作负载集成

借助 SAP 工作负载集成，您可以在各种 SAP 系统中执行操作。管理业务数据、库存、物料和业务流程。有关 Amazon Quick 订阅要求，请参阅在控制台中设置集成。

您能做什么

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

动作连接器

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

多个 SAP 模块

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

开始前的准备工作

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

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

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

  • 亚马逊 Quick Author 或更高版本

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

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

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

身份验证方法

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

OAuth 2.0（推荐）

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

必填参数：

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

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

  • 令牌网址-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 文档：OAut h 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 控制台中，选择连接器。

  2. 选择 “为你的团队创建” 选项卡。

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

    • SAP 物料清单

    • SAP 业务合作伙伴

    • SAP 材料库存

    • SAP 实地盘点文档

    • SAP 产品大师

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

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

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

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

    1. OAuth 2.0 配置

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

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

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

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

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

    2. 基本身份验证配置

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

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

      • 密码-您的 SAP 系统密码

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

  8. 选择创建并继续。

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

  10. 单击下一步。

预期结果

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

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

每个 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 控制台中，选择连接器。

  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 系统警报或已知问题

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