Search

RSS 端口

Version 26.2.9636

RSS 端口

RSS 端口支持下载远程 RSS 和 Atom feeds。

核心功能

  • RSS 和 Atom 摘要摄取，支持自动轮询及多种认证方案
  • 支持增量更新，利用 If-Modified-Since 标头和基于 ETag 的重复检测机制
  • 可配置的响应标头提升（Promotion），用于提取元数据

概述

RSS 端口暴露出一个简单的接口，可以自动轮询特定的 RSS 或 Atom feed 中的可下载内容。端口可配置为只处理新的或更新的内容，并且可以对远程服务进行 HTTP 和 TLS 认证。

端口设置

设置

配置

与端口核心配置有关的设置。

  • 端口 Id 端口的静态、唯一标识符。
  • 端口类型 显示端口类型及其用途的描述。
  • 端口描述 一个可选字段，用于提供端口及其在流中的角色的自由格式描述。
  • Feed URL 下载 RSS 内容的 HTTP 或 HTTPS 接口。
  • Feed 类型 远程 URL 是 RSS 还是 Atom feed。
  • Use If-Modified-Since 启用时，端口将会在发出的请求中包含一个 “If-Modified-Since” 头部，该头部等于上一次下载尝试的最新时间。这使得服务器根据新的或最近被修改过的内容来过滤响应。
  • Process New Items 启用时，端口将储存上次下载的修改日期，并且将滤除自该日期以来不是新的或修改过的结果。该结果与 Use If-Modified-Since 相同，但是过滤是在客户端完成的，而不是向服务器发送过滤条件。

认证

与 RSS 服务认证有关的设置。

  • 认证类型 RSS 服务使用的认证类型。更多详情请查阅认证方式部分。

TLS 服务器认证

与验证 TLS 服务器身份有关的设置。

  • TLS 服务器证书 用作验证 TLS／SSL 身份的公钥证书。此设置可以留空，以允许底层 OS/JVM 执行证书验证，也可以设置为 “Any Certificate”，以无条件信任目标服务器的身份。

高级设置

高级设置

在先前目录中未包含的设置。

  • 延迟处理 放置在输入文件夹中的文件的处理延迟的时间量（以秒为单位）。 这是一个遗留设置。 最佳实践是使用 File 端口 来管理本地文件系统，而不是此设置。
  • 跳过已处理的项目 当启用时，端口会维护每个项目下载的校验和，且将不会再次下载相同的内容
  • 超时时间 在抛出超时错误之前等待 RSS 服务器响应的持续时间（以秒为单位）
  • 启用 ETag 服务器可能包含 RSS 内容的校验和作为 ETag（实体标签）；如果启用此设置，则端口将在上一个请求中包含上一个响应中的 ETag 作为 “If-None-Match” 头部
  • 启用 TLS 协议 当建立出站连接时支持的 TLS／SSL 协议列表。强烈推荐仅使用 TLS 协议。某些老旧的操作系统不支持 TLS 1.2。

代理配置

端口使用代理时的配置。

  • 使用“系统设置” 表示端口切换使用在知行之桥的“系统设置”选项卡下配置的代理设置。
  • 代理类型 要使用的代理类型。 选择无则不使用代理。 否则，选择Tunnel、SOCKS4、SOCKS5 或 HTTP。
  • 代理主机 代理服务器。 格式取决于所选的代理类型。
  • 代理端口 连接到代理时使用的端口。
  • 代理用户 连接到代理时使用的用户名。
  • 代理密码 关联用户名的密码。
  • 认证方式 连接到代理时使用的协议。 选项包括Basic、Digest、Proprietary 和 NTLM。

消息

消息设置 确定端口如何搜索消息并在处理后管理它们。 可以将消息保存到你的 已发送 文件夹，或者可以根据 已发送 文件夹方案将它们保存，如下所述。

  • 保存至 Sent 文件夹 选中此选项可将端口处理的文件复制到端口的已发送文件夹中。
  • 已发送文件夹方案 端口根据选定的时间间隔对已发送文件夹中的文件进行分组。例如，选项每周（Weekly）指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在“Sent”文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

日志

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

特殊设置

特殊设置 适用于特定用例。

  • 其他设置 允许在以分号分隔的列表中配置隐藏的端口设置，例如setting1=value1;setting2=value2。 正常的端口用例和功能不需要使用这些设置。

自动化

自动化设置

与端口自动处理文件有关的设置。

  • 接收 端口是否根据特定的间隔发送 RSS 下载请求。
  • 间隔 自动请求的时间间隔。
  • 分 每次执行等待的分钟数。仅当执行间隔被设置为 Minute 时适用。
  • 第几分钟/小时 每小时计划的分钟偏移量。仅当执行间隔被设置为 Hourly 时适用。例如，如果将此值设置为 5，将在 1:05、2:05、3:05 自动执行脚本。
  • 时 在指定的某一天内进行消息处理的时间。仅当执行间隔被设置为 Daily 或 Weekly 或 Monthly 时适用。
  • 天 进行消息处理的某一天。仅当执行间隔被设置为 Weekly 或 Monthly 时适用。
  • Cron 表达式 表示 cron 表达式的任意字符串，用于确定何时执行。仅当执行间隔被设置为 Advanced 时适用。

通知选项卡

与配置通知相关的设置。

在执行服务级别协议 (SLA) 之前，需要设置电子邮件通知以接收通知。默认情况下，知行之桥使用 通知 选项卡上的全局设置。要为此端口使用其他设置，请启用覆盖全局设置。

默认情况下，错误通知处于启用状态，这意味着每当出现错误时都会发送电子邮件。要关闭错误通知，请取消选中启用复选框。

输入主题（必填），然后（可选）输入以逗号分隔的收件人电子邮件列表。

SLA 选项卡

与配置服务级别协议 (SLA) 相关的设置。

SLA 允许配置预期流程中端口发送或接收的数据量，并设置预期达到该数据量的时间范围。当 SLA 未达到时，知行之桥会发送电子邮件警告用户，并将 SLA 标记为_存在风险_，这意味着如果 SLA 未能尽快达到，则会被标记为_已违反_。这让用户有机会介入并确定 SLA 未达到的原因，并采取适当的措施。如果在风险时间段结束时仍未达到 SLA，则会将 SLA 标记为_已违反_，并再次通知用户。

要定义 SLA，请启用预期数据量，然后点击设置选项卡。

  • 如果端口具有单独的发送和接收操作，请使用单选按钮指定 SLA 适用的方向。
  • 在窗口的预计至少部分中：
    • 设置预计处理的最小事务数量（交易量）
    • 使用每个字段指定时间范围
    • 指示 SLA 生效的时间。如果选择开始于，请填写日期和时间字段。
    • 勾选希望 SLA 生效的星期几对应的复选框。如有必要，请使用下拉菜单选择每天。
  • 在窗口的将状态设置为“有风险”部分中，指定应将 SLA 标记为有风险的时间。
    • 默认情况下，只有在违反 SLA 的情况下才会发送通知。要更改此设置，请勾选发送“有风险”通知。

以下示例显示了为端口配置的 SLA，该端口预计在周一至周五每天接收 1000 个文件。如果尚未收到 1000 个文件，则会在时间段结束前 1 小时发送风险通知。

注意：如果有必要，可以关闭 SLA 通知。这在维护窗口期间非常有用。点击导航栏上的设置，然后跳转到通知 > 通用通知。点击平板和铅笔图标进行编辑，并取消勾选 SLA 通知设置。

建立连接

与任何 RSS 服务建立连接都需要有效的目标 Feed URL。某些服务可能还需要身份验证或一组自定义头部才能使用该服务。

端口无提示地支持 HTTP 和 HTTPS 目标 URL 。如果目标 URL 以 HTTPS 开头，则端口将自动协商安全的 TLS 连接。在这种情况下，应将服务器 TLS 证书设置为标识服务器的公钥证书，并且可以将此字段设置为 “Any Certificate” 以隐式信任目标接口。

认证方式

RSS 端口支持以下格式的 HTTP 认证：

  • Basic（纯文本）
  • Digest（加密）
  • NTLM
  • Negotiate
  • Proprietary

端口会向远程 RSS 服务的每个请求提供用户和密码中指定的凭据。

自动缓存清理

知行之桥会自动清理资源缓存。此过程在每次接收周期的后台运行，删除远程服务器上已不存在的文件对应的过期缓存条目。这使得缓存大小始终保持在可管理范围内，无需任何手动操作。

默认情况下，文件保留 30 天，但您可以在高级选项卡的其他设置字段中使用 ResourceCacheRetentionDays 设置来调整保留时间以适应您的环境。例如，ResourceCacheRetentionDays=15 表示文件保留 15 天后将被删除。