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

# SharePoint Configuration

> 配置 SharePoint 端口，用于在知行之桥中发送和接收文件。

export const SlasTab = ({siteName = "知行之桥"}) => <>
    <p><em>与配置服务级别协议 (SLA) 相关的设置。</em></p>
    <p>
      SLA 允许配置预期流程中端口发送或接收的数据量，并设置预期达到该数据量的时间范围。当 SLA 未达到时，{siteName} 会发送电子邮件警告用户，并将 SLA 标记为 <em>存在风险</em>，这意味着如果 SLA 未能尽快达到，则会被标记为 <em>已违反</em>。这让用户有机会介入并确定 SLA 未达到的原因，并采取适当的措施。如果在风险时间段结束时仍未达到 SLA，则会将 SLA 标记为已违反，并再次通知用户。
    </p>
    <p>
      要定义 SLA，请启用 <strong>预期数据量</strong>，然后点击 <strong>设置</strong> 选项卡。
    </p>
    <img src="/public/images/sla_empty.png" alt="SLA Empty" />
    <ul>
      <li>如果端口具有单独的发送和接收操作，请使用单选按钮指定 SLA 适用的方向。</li>
      <li>在窗口的 <strong>预计至少</strong> 部分中：
        <ul>
          <li>设置预计处理的最小事务数量（交易量）</li>
          <li>使用 <strong>每个</strong> 字段指定时间范围</li>
          <li>指示 SLA 生效的时间。如果选择 <strong>开始于</strong>，请填写日期和时间字段。</li>
          <li>勾选希望 SLA 生效的星期几对应的复选框。如有必要，请使用下拉菜单选择 <strong>每天</strong>。</li>
        </ul>
      </li>
      <li>在窗口的 <strong>将状态设置为“有风险”</strong> 部分中，指定应将 SLA 标记为有风险的时间。
        <ul>
          <li>默认情况下，只有在违反 SLA 的情况下才会发送通知。要更改此设置，请勾选 <strong>发送“有风险”通知</strong>。</li>
        </ul>
      </li>
    </ul>
    <p>
      以下示例显示了为端口配置的 SLA，该端口预计在周一至周五每天接收 1000 个文件。如果尚未收到 1000 个文件，则会在时间段结束前 1 小时发送风险通知。
    </p>
    <img src="/public/images/sla_defined.png" alt="SLA Configuration Example" />
    <Note>
      如果有必要，可以关闭 SLA 通知。这在维护窗口期间非常有用。点击导航栏上的 <strong>设置</strong>，然后跳转到 <strong>通知 &gt; 通用通知</strong>。点击平板和铅笔图标进行编辑，并取消勾选 <strong>SLA 通知</strong> 设置。
    </Note>
  </>;

export const AlertsTab = ({siteNameShort = "知行之桥"}) => <>
    <p><em>与配置通知相关的设置。</em></p>
    <p>
      在执行服务级别协议 (SLA) 之前，需要设置电子邮件通知以接收通知。默认情况下，{siteNameShort} 使用 <a href="/26.2/self-hosted/zh/getting-started/administration/settings/alerts">通知</a> 选项卡上的全局设置。要为此端口使用其他设置，请启用 <strong>覆盖全局设置</strong>。
    </p>
    <p>
      默认情况下，错误通知处于启用状态，这意味着每当出现错误时都会发送电子邮件。要关闭错误通知，请取消选中 <strong>启用</strong> 复选框。
    </p>
    <p>
      输入 <strong>主题</strong>（必填），然后（可选）输入以逗号分隔的 <strong>收件人</strong> 电子邮件列表。
    </p>
  </>;

export const CommonCacheCleanup = () => <>
    <p>知行之桥会自动清理资源缓存。此过程在每次接收周期的后台运行，删除远程服务器上已不存在的文件对应的过期缓存条目。这使得缓存大小始终保持在可管理范围内，无需任何手动操作。</p>
    <p>默认情况下，文件保留 30 天，但您可以在<strong>高级</strong>选项卡的<strong>其他设置</strong>字段中使用 <code>ResourceCacheRetentionDays</code> 设置来调整保留时间以适应您的环境。例如，<code>ResourceCacheRetentionDays=15</code> 表示文件保留 15 天后将被删除。</p>
  </>;

export const siteNameShort = "知行之桥";

创建与 SharePoint 的连接后，以下部分将帮助你配置端口，以便发送和接收文件。

## 端口配置

本节包含所有可配置的端口属性。

### 设置选项卡

#### 配置

有关如何创建 SharePoint 连接的详细说明，请参阅 [SharePoint 连接设置](./sharepoint)。

#### 发送配置

与上传到远程存储相关的设置。

| 设置    | 描述                                   |
| ----- | ------------------------------------ |
| 远程文件夹 | 端口处理的文件会上传到此文件夹。将鼠标悬停在该字段上可显示支持的宏列表。 |
| 覆盖    | 是否覆盖或跳过现有文件。                         |

#### 接收配置

与从远程存储下载相关的设置。

| 设置    | 描述                                           |
| ----- | -------------------------------------------- |
| 远程文件夹 | 从中下载文件的远程文件夹。使用逗号分隔的列表指定多个路径。                |
| 文件掩码  | 用于确定应下载 **远程路径** 中哪些文件的 glob 模式（例如，`*.txt`）。 |
| 删除    | 选中此项可从远程存储中删除成功下载的文件。                        |

#### 缓存

与多次下载之间缓存和比较文件相关的设置。

| 设置     | 描述                                                  |
| ------ | --------------------------------------------------- |
| 文件大小比较 | 选中此项可记录已下载文件的名称和大小。除非文件大小与上次下载不同，否则会跳过之前下载过的文件。     |
| 时间戳比较  | 选中此项可记录已下载文件的名称和上次修改时间戳。除非时间戳与上次下载不同，否则会跳过之前下载过的文件。 |

<Note>
  <CommonCacheCleanup />

  <p>启用缓存时，文件名不区分大小写。例如，端口无法区分 <code>TEST.TXT</code> 和 <code>test.txt</code>。</p>
</Note>

### 高级选项卡

#### 高级设置

未包含在前述类别中的设置。

| 设置      | 描述                                                                                                                 |
| ------- | ------------------------------------------------------------------------------------------------------------------ |
| 递归远程子目录 | 是否下载目标远程路径子文件夹中的文件。                                                                                                |
| 分块上传配置  | 是否使用 SharePoint 上传会话以分块方式上传大文件（大于 250MB 的文件需要此功能）。                                                                 |
| 分块大小    | 上传大文件时的分块大小（以 MB 为单位）。最小值为 1MB，默认值为 10MB。                                                                          |
| 接收过滤器   | 用于确定应下载哪些文件的 glob 模式过滤器。你可以使用负模式来指示不应下载的文件（例如，`-*.tmp`）。当需要多个 **文件掩码** 模式时，请使用此设置。多个模式可以用逗号分隔；除非找到完全匹配，否则后面的过滤器优先。 |
| 本地文件方案  | 指示端口根据所选间隔在本地文件夹中对文件进行分组。                                                                                          |
| 处理延迟    | 端口处理文件之前等待的时间（以秒为单位）。                                                                                              |

#### 其他

| 设置 | 描述                              |
| -- | ------------------------------- |
| 超时 | 服务器在抛出超时错误之前等待连接响应的时间长度（以秒为单位）。 |

#### 消息

| 设置        | 描述                             |
| --------- | ------------------------------ |
| 保存到已发送文件夹 | 选中此项可将端口处理的文件复制到该端口的 Sent 文件夹。 |
| 已发送文件夹方案  | 指示端口根据所选间隔在 Sent 文件夹中对消息进行分组。  |

#### 日志

| 设置       | 描述                                                           |
| -------- | ------------------------------------------------------------ |
| 日志级别     | 端口生成日志的详细程度。请求支持时，请将其设置为 **Debug**。                          |
| 日志子文件夹方案 | 指示端口根据所选间隔在 Logs 文件夹中对文件进行分组。**Weekly** 选项会指示端口每周创建一个新的子文件夹。 |
| 记录消息     | 选中此项可使已处理文件的日志条目包含文件本身的副本。                                   |

#### 其它设置

| 设置   | 描述                                                                                  |
| ---- | ----------------------------------------------------------------------------------- |
| 其它设置 | 允许你使用分号分隔的列表配置隐藏的端口设置（例如，`setting1=value1;setting2=value2`）。正常的端口使用场景和功能不应需要使用这些设置。 |

### 自动化选项卡

#### 自动化设置

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

| 设置       | 描述                                                                  |
| -------- | ------------------------------------------------------------------- |
| 发送       | 到达端口的文件是否自动上传。                                                      |
| 重试间隔     | 重试失败上传之前的时间量。                                                       |
| 最大尝试次数   | 端口处理输入文件的最大次数。如果设置为 0，则会无限期重试。                                      |
| 接收       | 端口是否应自动轮询远程下载路径以查找要下载的文件。                                           |
| 间隔       | 自动下载尝试之间的时间间隔。                                                      |
| 整点后的分钟数  | 小时计划的分钟偏移量。仅当间隔为“每小时”时适用。例如，如果此值设置为 5，自动化服务会在 1:05、2:05、3:05 等时间下载。 |
| 时间       | 尝试执行的具体时间。仅当间隔为“每天”、“每周”或“每月”时适用。                                   |
| 日期       | 尝试执行的日期。仅当间隔为“每周”或“每月”时适用。                                          |
| 分钟       | 等待的分钟数。仅当间隔为“分钟”时适用。                                                |
| Cron 表达式 | 五段式 cron 表达式。仅当间隔为“高级”时适用。                                          |

#### 性能

| 设置      | 描述               |
| ------- | ---------------- |
| 最大工作线程数 | 从线程池中消耗的最大工作线程数。 |
| 最大文件数   | 每个线程发送的最大文件数。    |

### 警报选项卡

<AlertsTab />

### SLA 选项卡

<SlasTab />

## 发送和接收

### 发送文件到 SharePoint

要发送文件，请将 **系统设置** 页面中 [发送配置](#发送配置) 部分的 **远程文件夹** 设置为文件应上传到的文件夹。每个 SharePoint 端口都会上传到单个文件夹位置。

使用 **覆盖远程文件** 选项指定是否应覆盖或跳过容器中已存在的文件。

配置完成后，放置在端口 **事务** 选项卡中的文件会上传到远程存储。如果启用了 **发送自动化**，上传会自动进行；否则，你可以从“事务”选项卡发送单个文件。

### 从 SharePoint 接收文件

要接收文件，请将 **系统设置** 页面中 [接收配置](#接收配置) 部分的 **远程文件夹** 设置为应下载文件的文件夹。使用逗号分隔的列表指定多个文件夹。

使用 **文件掩码** 设置 glob 过滤器（例如 `*.txt`），将下载限制为与过滤器匹配的文件。要指定多个过滤器，请使用 [高级选项卡](#高级选项卡) 上的 **接收过滤器** 选项。

使用 **删除** 指定是否应从远程存储中移除成功下载的文件。

## 宏

| 宏             | 描述                      |
| ------------- | ----------------------- |
| ConnectorID   | 端口的端口 ID。               |
| Ext           | 文件的扩展名（例如，`xml`、`csv`）。 |
| Filename      | 消息的原始文件名。               |
| FilenameNoExt | 消息的原始文件名，不包含文件扩展名。      |
| MessageId     | 分配给消息的唯一标识符。            |
| RegexFilename | 基于原始文件名上的正则表达式派生出的文件名。  |
| Header        | 按名称引用的消息标头中的值。          |
| LongDate      | 长格式的当前日期/时间。            |
| ShortDate     | 短格式的当前日期/时间。            |
| DateFormat    | 自定义格式的当前日期/时间。          |
| Vault         | 按名称引用的 vault 条目中的值。     |