> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAP IDoc Receive

> 使用知行之桥SAP IDoc 端口配置从 SAP 接收 IDoc 文件。

## 端口配置

从 SAP 接收 IDoc 时，可以使用以下设置。

#### 接收设置

*关于接收 IDoc 文件的设置。*

| 设置 | 说明 |
| - | - |
| **IDoc 接收器** | 端口是否应从 SAP 检索 IDoc 文件。 |
| **程序 ID** | 一个用于向 SAP 系统标识知行之桥的唯一名称。 |
| **IDoc 格式** | 是否以原始 IDoc 或 IDoc XML 接收文件。 |

#### 高级设置

*不包含在上述类别中的设置。*

| 设置 | 说明 |
| - | - |
| **延迟处理** | 放置在 **交易**选项卡中的文件的处理将延迟的时间（秒）。这是旧版设置。最佳做法是[使用 File 端口](https://docs.kasoftware.com/26.4/self-hosted/zh/flows/designing-a-flow.md#与本地文件系统交互)管理本地文件系统，而不是使用此设置。 |
| **刷新模板** | 启用后，端口会在发生解析错误时尝试更新其用于解析的模板。端口会连接 SAP 系统并查询相应模板来执行更新。 |
| **本地文件名格式** | 用于为端口输出的消息分配文件名的方案。可以在文件名中动态使用宏来包含标识符和时间戳等信息。有关详细信息，请参阅[宏](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/sap-idoc/sap-idoc.md#宏)。 |
| **上传模板** | 用于上传模板并将其安装在端口的架构文件夹中。如果模板已存在，系统会询问是否要覆盖它。 |

#### 服务器状态

*服务器的状态。*

| 状态 | 描述 |
| - | - |
| **活动** | 服务器正在运行。点击**停止服务器**可将其停止。 |
| **非活动** | 服务器未运行。点击**启动服务器**可将其启动。 |

要查看服务器运行期间生成的日志，请参阅[日志选项卡](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/sap-idoc/sap-idoc.md#日志选项卡)。

#### 消息

> [!NOTE]
>
> **保存至 Sent 文件夹**和**Sent 文件夹方案**设置已弃用，默认处于隐藏状态。只有先前已启用这些设置或将其配置为非默认值的端口才会显示它们。若要保留成功处理的文件副本，请在工作流中右键单击该端口，选择**显示成功路径**，然后将成功路径连接到[File 端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/file.md)。

| 设置 | 描述 |
| - | - |
| **保存至 Sent 文件夹**（已弃用） | 将端口处理的文件复制到 Sent 文件夹。默认禁用。保存到 Sent 文件夹中的文件不受静态加密保护。 |
| **Sent 文件夹方案**（已弃用） | 按所选时间间隔对 Sent 文件夹中的文件进行分组。仅在启用**保存至 Sent 文件夹**时适用。 |

#### 日志

*控制日志创建和存储的设置。*

| 设置 | 说明 |
| - | - |
| **日志级别** | 端口生成日志的详细程度。请求支持时，请将其设置为 **Debug**。 |
| **日志子文件夹方案** | 指示端口根据所选时间间隔对 Logs 文件夹中的文件进行分组。**每周**（Weekly）选项（默认值）指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在其中。留空则指示端口将所有日志直接保存到 Logs 文件夹中。对于处理大量交易的端口，使用子文件夹有助于保持日志有序并提升性能。 |
| **日志消息** | 选中此项可让已处理文件的日志条目包含该文件本身的副本。如果禁用此项，可能无法从**交易**选项卡 下载文件副本。 |

#### 其他设置

*其他设置适用于特定用例。*

| 设置 | 说明 |
| - | - |
| **其他设置** | 允许以分号分隔的列表配置隐藏的端口设置（例如 `setting1=value1;setting2=value2`）。正常的端口用例和功能不需要使用这些设置。 |

## 从 SAP 接收 IDocs

配置 IDoc 端口以连接到 SAP 系统后，即可开始从 SAP 接收 IDoc 文件。IDoc 端口可以接收原始 IDoc 或 XML IDoc 格式的文件。

要从 SAP 接收文件，请为知行之桥创建一个 RFC 目标。然后，可以在设置选项卡 的[接收设置](#接收设置)部分勾选**启用 IDoc 接收器**，并输入你在 SAP 系统中为知行之桥注册的**程序 ID**。

### 测试从 SAP 接收 IDoc

此示例介绍如何配置 SAP 系统，以便向知行之桥发送 MATMAS IDoc。

1. *定义逻辑系统：* 首先，进入事务 SALE。然后导航到 基本设置 > 逻辑系统 > 定义逻辑系统。创建一个具有有效名称（例如 Arc）和描述的新条目。

2. *创建 RFC 目标：* 打开事务代码 SM59。单击创建按钮，并填写下述 RFC 目标字段。

   | 设置 | 说明 |
   | - | - |
   | **RFC 目标** | 新目标的唯一名称（例如 Arc\_DEST）。 |
   | **连接类型** | **T** 表示 TCP/IP。 |
   | **描述** | 目标的描述。 |
   | **程序 ID** | 将在知行之桥中设置的唯一名称，用于标识该目标。 |
   | **激活类型** | 选择**注册服务器程序**。 |

   ![SAP RFC 目标设置](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/sap-rec-dest.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=e90e2917efa72e8c5c05850a122ad9eb)

   保存设置后，测试连接以确保可以成功连接到知行之桥。

3. *创建处理端口：* 转到事务代码 WE21。创建一个新的事务性 RFC 端口，使用唯一名称以及你在步骤 2 中创建的同一目标。

   ![SAP 接收端口设置](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/sap-rec-connector.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=455a2e46c8f508bb70820105e2cfe458)

4. *创建合作伙伴配置文件：* 打开事务 WE20。为步骤 1 中添加的逻辑系统创建一个合作伙伴配置文件。接下来，为 MATMAS 文档添加一个出站参数。将**消息类型**设置为 **MATMAS**。在**出站选项**选项卡上，将**接收方端口**设置为步骤 3 中配置的端口值，将**输出模式**设置为 **Transfer IDoc Immed**，并将 IDoc **基本类型**设置为 **MATMAS05**。

   ![SAP 接收合作伙伴配置文件设置](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/sap-rec-param.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=382b44b60c0d2d58be6fe6297ebc3882)

5. *发送测试 IDoc：* 使用事务 BD10 向知行之桥发送指定物料编号的测试 IDoc。发送消息之前，需要配置**消息类型**和**逻辑系统**。使用事务 BD87 监控传出消息，并在必要时再次处理它们。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.