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

# 当前版本

> 当前版本的知行之桥发行说明。

## 概览

观看此视频，了解本版本新功能的摘要：

[//player.bilibili.com/player.html?isOutside=true\&aid=117517922143631\&bvid=BV1AxxE6bE1F\&cid=43124261561\&p=1](//player.bilibili.com/player.html?isOutside=true\&aid=117517922143631\&bvid=BV1AxxE6bE1F\&cid=43124261561\&p=1)

## 主要特性

### 新增

* 扩展 [远程 MCP 服务器](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/remote-mcp-server.md)，新增用于触发端口、重新排队消息、清理文件和查找服务日志的工具，并增强了 `diagnose_message` 工具。
* 在交易详细信息视图中新增“诊断错误”按钮，可使用已配置的 [AI 提供商](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/ai-settings.md) 对失败的交易进行 AI 分析。
* 在 [性能设置](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/performance-settings.md) 中新增“分析工作池”工具，可在选定的时间窗口内捕获工作池日志，并使用已配置的 AI 提供商给出调整建议。
* 在 [配置库](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/global-settings-vault.md) 中新增对外部密钥提供程序的支持，除本地配置库外，配置库项目还可以来自环境变量和 [Azure Key Vault](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/global-settings-vault.md#添加-azure-key-vault-提供程序)（企业版）。
* 在全局“设置”页面的 [清理选项](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/cleanup-settings.md) 和 [其他设置](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/additional-settings.md) 部分中新增对配置库引用的支持。
* 为 [版本控制](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/git-version-control.md) 新增按工作区划分的 Git 仓库支持，包括版本控制页脚中的仓库列表以及提交历史记录中的仓库筛选。
* 新增更详细的审计日志条目，在知行之桥更多的配置（端口、工作区、用户、角色等）中记录更改了哪项设置及其旧值和新值。
* 在 [管理 API](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-actions.md) 中新增 `moveConnectors` 操作，可将一组端口移动到另一个工作区，同时保留它们之间的连接。
* 在管理 API 中新增 `users` [资源](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-resources.md) 和 `refreshAPICredential` [操作](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-actions.md)，用于管理用户以及重新生成身份验证令牌和客户端密钥。
* 新增 [消息目录](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/installation/arc-properties-configuration.md#cdata-app-messagedirectory) 设置（Java 中为 `cdata.app.messageDirectory`，.NET 中为 `MessageDirectory`），用于将消息数据与应用程序目录分开存储。
* 在 [活动](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md) 页面新增 [自动化日志](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#自动化日志)，用于记录计划的轮询尝试，包括未返回数据的轮询和被跳过的计划。此外，还在“自动化”选项卡中新增“自动化状态”和“上次处理结果”显示，用于显示端口当前处于运行、空闲还是暂停状态，以及其上次运行的结果。
* 在端口设置的共享连接选择器中新增连接状态指示器（已连接、警告、失败和未测试）。
* 在 [概览页面](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/dashboard.md) 中新增一张卡片，显示当前处于退避状态的端口数量，并提供在端口列表中查看这些端口的链接。
* 为主 [概览页面](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/dashboard.md) 新增可配置的自动刷新间隔，默认每 60 秒刷新一次。
* 当应用程序数据库接近所配置数据库类型的既定记录阈值时，在 UI 中显示警告。
* 当端口的 SLA 转变为“存在风险”或“已违反”状态时，新增相应的应用程序日志条目，使监控工具无需依赖电子邮件即可获取 SLA 事件。
* 在消息日志的消息详细信息视图中新增“下载消息”按钮，并将消息流中的端口名称改为可打开该端口设置的链接。
* 为 [base64encode](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/encoding-decoding-string-formatters.md#base64encode-inputencoding) 和 [hexencode](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/encoding-decoding-string-formatters.md#hexencode-uppercase-inputencoding) 格式化程序新增可选的输入编码参数，为 [base64decode](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/encoding-decoding-string-formatters.md#base64decode-outputencoding) 和 [hexdecode](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/encoding-decoding-string-formatters.md#hexdecode-outputencoding) 格式化程序新增可选的输出编码参数，从而支持诸如使用 `[guid(false) | base64encode('hex')]` 生成 Base64 GUID 之类的操作。

### 变更

* 所有使用 CData 驱动程序的端口已更新为使用 v26 驱动程序，不再使用 v25。
* 所有 [版本控制](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/git-version-control.md) 操作（包括查看版本控制日志）现在仅限管理员使用。非管理员用户在 UI 中将不再看到版本控制选项。
* 现在可以直接在 UI 中切换配置类型，从而更轻松地将 [版本控制](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/git-version-control.md) 仓库从本地转换为远程。
* [版本控制](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/git-version-control.md) 差异视图现在包含“查看所有设置”选项，可在显示更改的同时显示未更改的设置。
* 将端口“交易”页面一次可上传的最大文件数从 99 增加到 256。超出限制的上传现在会被阻止，并显示说明最大数量的消息。
* 移除之前已弃用的经典活动页面、经典工作流设计器和经典报告 UI。
* 为 [XML Map](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/xml-map/xml-map.md)、Branch、Validate 和 [Email Send](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/email-send.md) 端口中的 XML 处理新增内存保护；当输入过大而无法安全加载到内存中时，这些端口现在会记录警告或拒绝该消息。
* 明确了在 .NET 上迁移应用程序数据库后显示的后续步骤，包括需要添加到 `Web.config` 的 `AppDb` 连接字符串条目。
* 使用 `@json` 响应格式时，[管理 API](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-resources.md) `connectors` 资源的 `$select` 参数现在会返回端口特有的属性，例如 `as2identifier`。

### 修复

* 修复 [Form](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/form.md) 和 [TCP Server](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/tcp-server.md) 端口默认“受信任 IP”设置的问题。
* 修复工作区设置中无法使用配置库引用的问题。
* 修复从 .arc 文件导入配置库项目时会为其分配新 ID，导致通过 [版本控制](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/git-version-control.md) 拉取的设置丢失配置库引用的问题。
* 修复为 Java 安装生成 `arc.xml` 文件时部分配置未被保留的问题。
* 修复 [管理 API](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-filtering.md) 中 `$filter` 表达式里未加括号的 `not` 会作用于表达式其余部分，从而导致结果错误的问题。
* 修复 [管理 API](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-resources.md) `reports` 资源在 `$count` 请求中忽略 `$filter` 的问题。
* 修复 [管理 API](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-resources.md) `connectors` 资源忽略 `$orderby` 参数的问题。
* 修复导入端口覆盖现有端口时，未清除导入文件中为空的设置的问题。
* 修复在区分大小写的文件系统上，名称仅大小写不同的证书无法全部显示在端口证书选择器中的问题。
* 修复当 `arc.properties` 中的 `cdata.app.directory` 值包含空格、引号或转义反斜杠时，Java 安装程序和升级脚本无法读取该值的问题。
* 修复在 [版本控制](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/git-version-control.md) 中执行“提交并推送”时，推送失败可能导致工作区中的本地更改被移除的问题。

## 端口

### 新增

* 新增基于 CData Microsoft 365 驱动程序构建的 [Microsoft 365 Email](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/ms365email/ms365email.md) 端口，可通过 Microsoft Graph API 发送和接收电子邮件，并支持使用仅限应用程序的身份验证访问共享邮箱。
* 新增 [Partner Mailbox](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/partner-mailbox.md) 端口，为交易伙伴提供自助式 Web 门户，用于下载为其暂存的文件以及上传要发送的文件。
* 新增 [Finalize](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/finalize.md) 端口，并在 [File](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/file.md) 端口中新增延迟完成处理功能，可将删除或移动源文件等后处理操作推迟到下游处理成功之后再执行。
* 为 [SOAP](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/soap.md) 端口新增“输出行为”设置和“响应事件”。
* 在 [SFTP Server](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/sftp-server.md) 端口的个人配置中新增“加密算法”设置，用于指定允许的加密算法。
* 在 [XML Map](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/xml-map/xml-map.md) 端口的条件编辑器中新增将值与另一个 XPath、消息头或变量进行比较的功能。
* 在 [Database](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/database/database.md) 及其他数据类端口的 Lookup 动作中新增对 XML lookahead 语法的支持。
* 为 [Excel](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/excel.md) 端口新增“根元素名称”设置，用于覆盖作为输出根元素的工作表名称。
* 在 [Excel](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/excel.md) 端口的“高级设置”中新增“工作表名称”设置（在表模式下可用），用于指定工作簿中哪些工作表生成输出。将该设置留空时会输出所有工作表。
* 将上传的 blob 的远程路径作为输入提供给 [Azure Blob](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/azure-blob.md) 端口的 AfterSend 事件。
* 在 [Box](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/box.md) 端口的 AfterSend 事件中新增 FileId 输入。
* 为 [AS2](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/as2.md) 端口新增“记录 MDN”设置，无论日志级别如何，都会保留每个 MDN 回执的副本。该设置默认启用，也可以关闭。
* 为 [Webhook](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/webhook.md) 端口新增“请求头”设置，用于将指定的传入 HTTP 头提升为消息头。
* 新增为使用 AI 辅助映射的 [Database](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/database/database.md) 端口和数据类端口自定义 AI 提示词的功能。
* 在 [File](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/file.md) 和 [S3](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/s3.md) 端口中新增对 BatchGroups 作为输入的支持，并新增用于处理 BatchGroups 的 [ArcScript](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/arcscript.md) 操作。
* 在 [XSD](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/xsd.md) 端口中，当上传的文件将覆盖现有 XSD 文件时会显示确认提示。

### 变更

* [File](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/file.md) 端口现在按最后修改时间的升序接收文件。
* 当入站消息由“延期私钥证书”解密时，[AS2](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/as2.md) 端口现在会使用该证书对 MDN 签名，因此在证书轮换期间无需在每个端口上配置“备用本地个人配置”。
* 应用程序端口和数据库端口中的证书设置（例如 SSL 客户端证书）现在可以使用在知行之桥中管理的证书。现有的证书设置将继续有效。
* 通过缓存文件夹 ID 来减少知行之桥对 Box 的 API 调用次数，从而提升 [Box](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/box.md) 端口的上传性能，尤其是上传到嵌套文件夹时。
* 针对 v26 驱动程序更新了 [Shopify](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/shopify/shopify.md) 端口，该驱动程序已移除 REST 架构。使用不受支持架构的连接现在会报错失败，直到切换到受支持的架构为止。
* [Databricks](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/databricks/databricks.md) 连接现在必须设置 Catalog。升级后，没有 Catalog 值的现有连接必须设置该值。
* [Odoo](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/odoo/odoo.md) 连接现在要求在 API Token 设置中填写 API 密钥。v26 Odoo 驱动程序不再接受在该字段中填写密码，因此使用密码的现有连接必须改为使用 API 密钥。
* 当添加 997 或 999 传入文档时，[TPMC](https://docs.kasoftware.com/26.4/self-hosted/zh/tpmc/tpmc.md) 现在会自动在交易伙伴的 EDI 端口上启用“返回入站功能确认”，并在移除时将其禁用，从而将收到的确认路由到“传入文档”的目标位置。
* 将 [Apache Kafka](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/apachekafka.md) 端口使用的 OpenSSL 库更新到 3.6.4 版本，以修复安全漏洞。

### 修复

* 修复 [ZUGFeRD](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/zugferd.md) 端口在使用逗号作为小数分隔符的 .NET 服务器上报错 "Unsupported version: 2.1" 而失败的问题。
* 修复连接到使用随机填充的服务器时，[SFTP](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/sftp.md) 下载间歇性失败并报错 "1098 - Invalid SSH packet length" 的问题。
* 修复导出 [AS4](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/as4.md) 端口时，未包含该端口所用连接中配置的证书的问题。
* 修复 [SAP IDoc](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/sap-idoc/sap-idoc.md) 端口重试失败的发送时，会重新发送文件中已发布到 SAP 的 IDoc 的问题。现在重试会从最后一个成功发送的 IDoc 之后继续。


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