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

# SAP 工作负载集成
<a name="sap-integrations"></a>

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

## 您能做什么
<a name="sap-integrations-capabilities"></a>

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

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

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

## 开始前的准备工作
<a name="sap-integrations-prerequisites"></a>

在设置 SAP 工作负载集成之前，请确保具备以下条件：
+ 安装并配置了相应模块的 SAP 系统。
+ 具有必要权限和授权的 SAP 用户帐户。
+ Amazon 快速作者或更高版本。
+ Amazon Quick 和你的 SAP 系统之间的网络连接。

## 准备 SAP 系统配置和身份验证
<a name="sap-system-preparation"></a>

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

### 身份验证方法
<a name="sap-authentication-methods"></a>

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 系统配置要求
<a name="sap-system-configuration"></a>

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

#### OAuth 2.0 安装程序
<a name="sap-oauth-setup"></a>

对于 OAuth 2.0 身份验证：
+ 使用适当的作用域配置 OAuth 授权服务器
+ 使用交易代码验证 OAuth 服务已启用 `/IWFND/MAINT_SERVICE`
+ 有关详细的 OAuth 2.0 配置，请参阅 SAP 文档：[OAuth 2.0 配置指南](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html)

#### SAP API 激活
<a name="sap-api-activation"></a>

确保所需的 SAP API 服务处于活动状态：
+ 为您选择的 SAP 连接器激活特定的 API 服务
+ 在你的 SAP 系统中验证 API 服务状态
+ 有关 API 激活的信息，请参阅 SAP 文档：[SAP API 服务激活指南](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm)

### 可用的 SAP 工作负载集成类型
<a name="sap-integration-types"></a>

选择符合您业务需求的 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 工作负载身份验证设置
<a name="sap-authentication-setup"></a>

准备 SAP 用户身份验证凭证并确保适当的系统访问权限。
+ **SAP 系统 URL**-获取 SAP 系统的基本 URL 或服务器地址。
+ **用户凭证**-创建或标识具有适当权限的 SAP 用户帐户。
+ **系统权限**-确保用户帐户具有您计划集成的特定 SAP 模块所必需的 SAP 授权和交易代码。
+ **网络访问**-验证您的 SAP 系统是否可通过外部连接进行访问，以及防火墙规则是否允许集成。

## 设置 SAP 集成
<a name="sap-integrations-setup"></a>

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

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

1. 选择一个可用的 SAP 连接器：
   + **SAP 物料清单**
   + **SAP 业务合作伙伴**
   + **SAP 材料库存**
   + **SAP 实地盘点文档**
   + **SAP 产品大师**

1. 单击 “**添加**”（加上 “\$1” 按钮）。

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

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

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

   1. <a name="sap-oauth-configuration"></a>**OAuth 2.0 配置**

      对于 OAuth 2.0 身份验证，请提供：
      + **客户端 ID**-您的 SAP OAuth 客户端 ID
      + **客户密钥**-你的 SAP OAuth 客户端密钥
      + **令牌网址**- OAuth 令牌端点网址
      + **域网址**-SAP 系统 API 端点网址

   1. <a name="sap-basic-auth-configuration"></a>**基本身份验证配置**

      对于基本身份验证，请提供：
      + **用户名**-您的 SAP 系统用户名
      + **密码**-您的 SAP 系统密码
      + **域网址**-SAP 系统 API 端点网址

1. 选择**创建并继续**。

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

1. 单击**下一步**。

### 预期结果
<a name="sap-integrations-setup-results"></a>

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

## 按连接器类型划分的可用操作
<a name="sap-available-operations"></a>

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

### SAP 物料清单运营
<a name="sap-bom-operations"></a>

管理物料清单数据的可用操作：
+ **获取物料 BOM 物**料-检索指定物料的物料清单详细信息

  **操作 ID：**`getMaterialBOMItem`

  **端点：**`GET /MaterialBOMItem`

### SAP 业务合作伙伴的运营
<a name="sap-bp-operations"></a>

管理业务伙伴数据的可用操作：
+ **获取业务合作伙伴**-检索业务合作伙伴的一般数据

  **操作 ID：**`getBusinessPartner`
+ **获取业务合作伙伴地址**-检索业务合作伙伴地址数据

  **操作 ID：**`getBusinessPartnerAddress`
+ **获取业务合作伙伴角色**-检索业务合作伙伴角色数据

  **操作 ID：**`getBusinessPartnerRole`
+ **通过 ID 获取业务合作伙伴-按**业务伙伴编号检索业务伙伴数据

  **操作 ID：**`getBusinessPartnerByID`

  **必填参数：**`BusinessPartner`（字符串，最多 10 个字符）
+ 按 **ID 获取业务合作伙伴角色**-使用关键字段检索业务合作伙伴角色数据

  **操作 ID：**`getBusinessPartnerRoleByID`

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

### SAP 材料库存业务
<a name="sap-ms-operations"></a>

用于管理物料库存数据的可用操作：
+ **在账户中获取材料库存**-检索账户模型中发布的材料库存信息

  **操作 ID：**`getMaterialStockInAccount`

### SAP 实地盘点记录操作
<a name="sap-pi-operations"></a>

用于管理实地盘点文档的可用操作：
+ **获取 PhysInventory 文档项目**-读取实地盘点项目信息

  **操作 ID：**`getPhysInventoryDocItem`

### SAP 产品大师操作
<a name="sap-pm-operations"></a>

用于管理产品主数据的可用操作：
+ **获取产品主项目**-返回产品主记录

  **操作 ID：**`getProductMaster`
+ **按物料获取工厂数据**-返回产品主记录的工厂数据

  **操作 ID：**`getPlantDataByMaterial`

  **必填参数：**`Product`（字符串，最多 40 个字符）
+ **按物料获取供应计划数据-按**产品编号和工厂返回供应计划数据

  **操作 ID：**`getSupplyPlanningDataByMaterial`

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

## 查询参数
<a name="sap-odata-parameters"></a>

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


**支持的查询参数**  

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

## 管理 SAP 工作负载集成
<a name="sap-integrations-management"></a>

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

### 编辑集成设置
<a name="sap-integrations-editing"></a>

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

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

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

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

1. 修改集成设置：
   + 更新身份验证凭证（用户名和密码）。
   + 更改 SAP 系统 URL 或连接设置。
   + 修改集成名称或描述。

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

### 共享集成
<a name="sap-integrations-sharing"></a>

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

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

1. 配置共享选项：
   + **与特定用户共享**-输入用户名或电子邮件地址。
   + **与组织共享**-向组织中的所有用户开放。

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

1. 选择 “**共享集成**” 以应用共享设置。

### 删除集成
<a name="sap-integrations-deletion"></a>

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

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

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

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

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

## 排除 SAP 工作负载集成故障
<a name="sap-integrations-troubleshooting"></a>

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

### 身份验证问题
<a name="sap-authentication-issues"></a>

OAuth 2.0 身份验证失败  
**症状：**令牌生成失败、客户端凭据无效或 OAuth 范围错误。  
**解决方法：**  
+ 验证 OAuth 客户端 ID 和客户端密钥是否正确
+ 使用事务检查是否在 SAP 中正确配置 OAuth `/IWFND/MAINT_SERVICE`
+ 确保为您的 SAP 工作负载连接器类型正确配置了所需的范围
+ 验证令牌 URL 格式是否与您的 SAP 系统配置相匹配

基本身份验证失败  
**症状：**登录失败、凭据无效或访问被拒绝错误。  
**解决方法：**  
+ 验证 SAP 用户名和密码是否正确
+ 检查用户帐户是否具有必要的 SAP 授权
+ 确保用户帐户未被锁定或过期
+ 验证域名 URL 是否可访问且格式正确

### SAP 系统配置问题
<a name="sap-system-configuration-issues"></a>

API 服务未激活  
**症状：**服务不可用错误、找不到 API 端点或 HTTP 404 响应。  
**解决方法：**  
+ 验证您的系统中是否激活了所需的 SAP API 服务
+ 使用 SAP 事务代码检查 API 服务状态
+ 确保 API 服务与您选择的 SAP 连接器类型相对应
+ 请联系您的 SAP 管理员以激活缺失的 API 服务

连接超时  
**症状：**请求超时、网络连接错误或响应时间过长。  
**解决方法：**  
+ 检查你的 SAP 系统 URL 是否正确且可访问
+ 验证网络连接是否允许连接到 SAP 系统
+ 确保防火墙规则允许集成流量
+ 检查 SAP 系统性能和可用性

### 权限和授权错误
<a name="sap-permission-errors"></a>

SAP 授权不足  
**症状：**访问被拒绝错误、缺少授权消息或受限操作失败。  
**解决方法：**  
+ 确保经过身份验证的用户需要获得特定模块的 SAP 授权
+ 验证用户是否有权访问必要的交易代码
+ 检查用户账户是否有适当的角色分配
+ 请联系您的 SAP 管理员以授予缺少的权限

范围权限错误  
**症状：** OAuth 范围错误、API 操作权限不足或访问受限消息。  
**解决方法：**  
+ 验证 OAuth 配置是否包含您的连接器类型所需的范围
+ 检查 SAP 系统中是否正确授予了范围权限
+ 确保已向 OAuth 客户端授予必要的 API 访问权限

### 数据格式和参数错误
<a name="sap-data-format-errors"></a>

参数格式无效  
**症状：**数据验证错误、字段长度消息无效或参数格式异常。  
**解决方法：**  
+ 查看操作参数并确保它们与预期的 SAP 数据格式相匹配
+ 检查字段长度是否符合 SAP 系统要求（例如， BusinessPartner 最多 10 个字符）
+ 验证特定 SAP 模块的数据类型是否正确
+ 确保为操作提供了所有必填字段

查询参数错误  
**症状：**查询语法错误、不支持的参数消息或格式错误的请求错误。  
**解决方法：**  
+ 验证参数使用正确的语法（例如`$filter`、`$top`、`$skip`）
+ 检查参数值的格式是否正确
+ 确保 SAP API 支持正在使用的特定参数
+ 有关支持的查询选项，请参阅 SAP API 文档

### SAP 系统可用性问题
<a name="sap-system-availability"></a>

SAP 系统不可用  
**症状：**连接被拒绝错误、系统无响应或服务不可用消息。  
**解决方法：**  
+ 向 SAP 管理员查询 SAP 系统状态和可用性
+ 验证是否存在影响系统的定期维护时段
+ 检查是否有任何 SAP 系统警报或已知问题
+ 确认系统可用性后重试该操作