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

# 端口

> 端口是用于创建自动化数据处理流程的模块化构建块。

端口是用于通过 知行之桥 创建数据处理流程的构建块。每个端口可执行以下任务之一：

* 使用标准网络协议（AS2、AS4、FTP、SFTP、OFTP 等）与外部目标之间传输文件
* 与数据库或云应用程序等后端系统集成
* 使用或公开 RESTful Web API
* 将数据从一种格式转换为另一种格式
* 压缩/解压缩或加密/解密数据
* 修改文件内容或消息头
* 使用条件逻辑路由文件，以创建复杂的数据流

端口连接在一起可创建自动化数据处理流程。每个端口执行其特定任务后，所有接收或处理的文件都会传递到流程中的下一个端口。

这种模块化方法使 知行之桥 能够处理各种复杂度的业务任务。下图显示了一组 知行之桥 端口如何使用从后端数据源检索到的 XML 数据生成出站 EDI 文档：

![端口](https://mintcdn.com/qiao/4hcVjuRd69QHuQ3V/26.4/images/connectors.png?fit=max\&auto=format\&n=4hcVjuRd69QHuQ3V\&q=85\&s=77b587a89e6a58b19a0bca9568be04e3)

### 配置

每个端口都有一系列选项卡，可用于配置端口执行任务所需的设置。这些选项卡包括：

* **设置**，用于管理连接和身份验证参数
* **高级**，用于其他端口特定设置以及消息和日志信息
* **自动化**，用于指定端口应如何自动处理文件、轮询要下载的文件、重试失败消息等
* **通知**，用于在需要时覆盖全局[通知设置](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/alerts.md)
* **SLA**，用于配置期望流程中的端口发送或接收的数量，并设置期望达成该数量的时间范围
* **交易**，用于管理端口与本地文件系统的接口
* **事件**脚本，用于在端口处理期间的特定时间点执行自定义逻辑

某些端口（如 AS2 和 AS4）还要求配置本地个人设置以接收入站连接。

### 日志

端口发送、接收或处理文件时，会将此操作记录为交易。可以在端口的**交易**选项卡中查看特定端口的交易，也可以在活动页面的**交易**选项卡上查看\_所有\_端口的交易。

有关每个交易条目会捕获哪些信息的详细信息，请参阅活动文档。

> [!NOTE]
>
> 日期/时间条目始终根据浏览器的本地时区和日期格式设置进行本地化显示，因此即使浏览托管在不同时区的服务器，显示的时间戳也会反映本地时间。

### 消息

端口处理文件时，可以选择向文件添加元数据。此信息会作为消息捕获，并以特殊的 <var>.eml</var> 文件扩展名存储在应用程序数据库中。有关每条消息会捕获哪些信息的详细信息，请参阅[消息选项卡](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#消息日志)文档。

### 端口类型

端口分为基础（Core）、可控文件传输（MFT）、电子数据交换（EDI）、数据库（Database）和其他（Other）类别。每个端口都属于这些类别之一。

* [基础（Core）端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/core-connectors.md)提供构建数据工作流的基础功能。
* [可控文件传输（MFT）端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/mft-connectors.md)扩展了 知行之桥 使用安全文件传输协议发送和接收文件的能力。
* [电子数据交换（EDI）端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/edi-connectors.md)支持转换和操作 EDI 文档，以将这些文档与后端系统或 知行之桥 流程的其他方面集成。
* [数据库（Database）端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/database-connectors.md)提供连接各种数据库的能力。
* [其他（Other）端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/other-connectors.md)包括不属于其他类别的各种端口。它们与应用程序的其余部分分开授权。

除了上述类别之外，流程中的每个端口还会分配以下三种行为类别之一：触发、转换和终结。端口操作的配置及其在流程中的位置决定了其类别。

* 触发端口通过**接收自动化**拉取或创建文件来启动流程；对于支持被动接收的端口，则在端口从外部客户端接收到文件时启动流程。示例包括 [AS2](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/as2.md)、[Email Receive](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/email-receive.md) 或 [SFTP](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/sftp.md)。
* 转换端口位于流程中间，负责对消息执行处理（以某种方式修改消息）。示例包括 [X12](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/x12.md)、[XML Map](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/xml-map/xml-map.md) 或 [CSV](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/csv.md)。
* 终结端口是流程的末端，知行之桥 在此将消息传递到底层磁盘，或者端口在发送操作期间消耗消息且不生成任何输出。示例包括 [File](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/file.md)、[MySQL](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/mysql/mysql.md) 或任何配置为 Upsert 的数据库端口。

> [!NOTE]
>
> * 许多端口，例如 [File](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/file.md)、[FTP](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/ftp.md) 和 [SOAP](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/soap.md)，可以用作触发端口或终结端口，具体取决于配置的[操作](https://docs.kasoftware.com/26.4/self-hosted/zh/flows/designing-a-flow.md#指定操作)以及它们在流程中出现的位置。
> * [Script](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/script.md)、[REST](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/rest.md) 和任何 [Database](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/database-connectors.md) 端口都可以充当这三类端口中的任何一种，同样取决于配置的操作以及它们在流程中出现的位置。

### 批量编辑端口

点击导航栏上的**工作流 (Flows)**，然后选择右上角的**端口视图 (Connector View)** 即可访问该视图。它会显示应用程序中所有端口的列表，使用户能够在大规模场景下高效定位和管理端口。如果您拥有端口管理权限，可以使用此视图对端口执行批量编辑。详情请参阅[端口视图与批量编辑端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/bulk-edit-connectors.md)。

### 端口退避

当端口反复发送文件失败时，知行之桥 会自动进入退避状态，暂时暂停自动化，以防止资源耗尽和产生过多日志。处于退避状态时，端口会显示状态指示器，其中包含退避原因以及计划恢复自动化的时间。有关详细信息，请参阅[端口退避](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/connector-backoff.md)。


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