> ## 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 Translate

> 使用知行之桥SAP IDoc 端口配置 IDoc 到 XML 以及 XML 到 IDoc 的转换。

## 端口配置

将 IDoc 转换为 XML 或将 XML 转换为 IDoc 时，可以使用以下设置。

#### 控制记录信息选项

当将 IDoc 文件转换为 XML，或将 XML 文件转换为 IDoc 时，你可能希望在不更改 IDoc 文件数据的情况下更改控制记录信息。有关详细信息，请参阅[向 SAP 发送 IDocs](./sap-idoc-send#sending-idocs-to-sap)。

要覆盖 IDoc 文件的控制头，请选中**覆盖**，然后更改以下选项。

| 设置                     | 说明                    |
| ---------------------- | --------------------- |
| **SAP 版本 (DOCREL)**    | IDOC 的 SAP 版本。        |
| **测试标志 (TEST)**        | 指示 IDoc 是否应处于测试模式的标志。 |
| **发送方端口 (SNDPOR)**     | 发送方端口（SAP 系统或外部子系统）。  |
| **发送方合作伙伴编号 (SNDPRN)** | 发送方的合作伙伴编号。           |
| **发送方合作伙伴类型 (SNDPRT)** | 发送方的合作伙伴类型。           |
| **发送方合作伙伴功能 (SNDPFC)** | 发送方的合作伙伴功能。           |
| **发送方地址 (SNDSAD)**     | 发送方的地址。               |
| **逻辑地址 (SNDLAD)**      | 发送方的逻辑地址。             |
| **接收方端口 (RCVPOR)**     | 接收方端口。                |
| **接收方合作伙伴编号 (RCVPRN)** | 接收方的合作伙伴编号。           |
| **接收方合作伙伴类型 (RCFPRT)** | 接收方的合作伙伴类型。           |
| **接收方合作伙伴功能 (RCVPFC)** | 接收方的合作伙伴功能。           |
| **接收方地址 (RVCSAD)**     | 接收方的地址。               |
| **接收方逻辑地址 (RCVLAD)**   | 接收方的逻辑地址。             |
| **使用系统日期/时间**          | 是否在控制记录信息中包含系统日期/时间。  |

#### 高级设置

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

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

#### 消息

*消息设置* 决定端口如何查找消息并在处理后管理消息。可以将消息保存到**已发送**文件夹，也可以按照如下所述，根据**已发送**文件夹方案对消息分组。

| 设置               | 说明                                                                                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **保存至 Sent 文件夹** | 选中此项可将端口处理的文件复制到该端口的 Sent 文件夹。                                                                                                                               |
| **已发送文件夹方案**     | 指示端口根据所选时间间隔对 **Sent** 文件夹中的文件进行分组。例如，**每周**（Weekly）选项指示端口每周创建一个新的子文件夹，并将该周发送的所有文件存储在该文件夹中。留空则指示端口将所有文件直接保存到 **Sent** 文件夹中。对于处理大量交易的端口，使用子文件夹有助于保持文件有序并提升性能。 |

#### 日志

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

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

#### 其他设置

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

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

## 无需连接到 SAP 即可进行转换

可以通过使用[高级设置](#高级设置)中的**上传模板**选项，将附加文档模板上传到端口，在没有直接连接 SAP 的情况下将 IDoc 转换为 XML，反之亦然。该模板包含基础模板的所有元素。

要从 SAP 下载模板：

* 在 SAP 中，找到 TCODE 为 `WE60` 的文档事务。
* 如果你的 IDoc 类型是基本类型，请选择**基本类型**单选按钮。否则，选择**增强**。
* 单击**文档**菜单并选择 **XML 模式**。
* 从 **XML** 菜单中，选择**下载**。
* 将下载的文件另存为 `${IDocType}.xsd`（例如 `SHPMNT05.xsd`）。
* 使用**上传模板**将该文件上传到端口。