SharePoint 端口

Version 23.4.8843


SharePoint 端口


SharePoint 端口可以从云端存储服务上传或下载文件。

概述

每个 SharePoint 端口与一个特定的 SharePoint 账号连接。在远程的存储中,有独立的上传目标文件夹和下载目标文件夹。

在知行之桥工作流中的文件,如果与 SharePoint 端口连接,会被上传至上传目标文件夹,在下载目标文件夹下的文件会被下载并进入知行之桥工作流。该端口支持过滤功能,可以只发送或接收拥有特定名称和/或扩展名的文件。

端口配置

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

设置

授权

与 SharePonit 账号授权有关的设置

  • 端口 Id 端口的静态、唯一标识符。
  • 端口类型 显示端口类型及其用途的描述。
  • 端口描述 一个可选字段,用于提供端口及其在流中的角色的自由格式描述。
  • URL 与存储账号关联的 SharePoint URL,通过将以下内容附加到网站地址:“/sites/mySiteName”,必须将 SharePoint 站点的名称包含在 URL 的末尾。
  • 用户 与存储账号关联的用户凭证。
  • 密码 与存储账号关联的密码凭证。

发送

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

  • 远程文件夹 上传端口 Send 文件夹下的文件到特定的远程文件夹。
  • 覆盖远程文件 是否应该上传(覆盖)或跳过已存在于远程文件夹中的文件。

接收

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

  • 远程文件夹 此远程文件夹下的文件将会被下载。若有多个文件夹可以使用逗号分隔。
  • 文件掩码 全局匹配模式,确定在远程文件夹下应下载哪些文件,如果需要多种文件掩码,应使用高级设置选项中的接收过滤规则
  • 删除文件(接收后) 是否应该从远程存储中删除下载成功的文件。

自动化

自动化设置

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

  • 发送 到达端口的文件是否会被自动处理。
  • 重试间隔 上传失败后进行重试之前的时间间隔。
  • 最大重试次数 端口处理输入文件的最大次数。是否成功基于服务器相应和回执的验证(如需要回执)。如果设置为 0,那么端口将无限次尝试处理失败文件。
  • 下载 端口是否应自动轮询要下载文件的远程下载路径。
  • 下载间隔 自动下载之间的间隔。
  • 每次执行等待的分钟数。仅当执行间隔被设置为 Minute 时适用。
  • 第几分钟/小时 每小时计划的分钟偏移量。仅当执行间隔被设置为 Hourly 时适用。例如,如果将此值设置为 5,将在 1:05、2:05、3:05 自动执行脚本。
  • 在指定的某一天内进行消息处理的时间。仅当执行间隔被设置为 DailyWeeklyMonthly 时适用。
  • 进行消息处理的某一天。仅当执行间隔被设置为 WeeklyMonthly 时适用。
  • Cron 表达式 表示 cron 表达式的任意字符串,用于确定何时执行。仅当执行间隔被设置为 Advanced 时适用。

性能

与端口资源分配相关的设置。

  • 最大线程数 从线程池中消耗用于处理此端口上的文件的最大工作线程数。 如果设置,这将覆盖 设置 > 自动化 页面上的默认设置。
  • 最大文件数 分配给端口的每个线程发送的最大文件数。 如果设置,这将覆盖 设置 > 自动化 页面上的默认设置。

高级

其它设置

在之前目录中没有涉及的设置

  • 接收过滤规则 全局模式过滤规则,用来确定从远程存储下载哪些文件(例如 *.txt)。负模式用来决定 下载哪些文件(例如 -*.tmp)。当需要多个文件掩码模式,应使用该设置。多模式可以使用逗号分隔,除非文件名完全匹配,否则优先使用后面的过滤规则。
  • 日志调试信息 是否为该端口启用加强日志功能。在请求技术支持时,建议生成调试日志并将其与支持请求一起提供。
  • 递归子目录 是否下载远程目标路径子文件夹下的文件。
  • 日志子文件夹方案 指端口根据选定的时间间隔对日志文件夹中的文件进行分组。 例如,Weekly 选项表示端口每周创建一个新子文件夹并将该周的所有日志存储在该文件夹中。 空白设置告诉端口将所有日志直接保存在 Logs 文件夹中。 对于处理大量事务的端口,使用子文件夹有助于保持日志井井有条并提高性能。
  • 日志消息 已处理文件的日志条目是否包含文件本身的副本。
  • 保存至 Sent 文件夹 端口处理的文件是否应复制到端口的已发送文件夹。

特殊设置

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

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

建立连接

当与 SharePoint 端口建立连接时,需要如下信息:

  • URL
  • 用户
  • 密码

连接测试 按钮可以用来验证连接参数是否正确。

上传

上传文件,设置发送 -> 远程文件夹为上传文件的目标路径。每个 SharePoint 端口可上传文件到特定的文件夹下。

覆盖远程文件选项可以用来确定是否应该覆盖或跳过已存在于远程文件夹下的文件。

配置之后,所有被放在 输出文件夹下的文件将会被上传到远程存储。如果启用发送自动化,上传将会自动进行;否则,可以通过端口输入选项卡的设置发送单个文件。

下载

下载文件,设置接收 -> 远程文件夹为下载文件的路径。多个下载文件夹可以使用逗号来分隔。

文件掩码可以设置为全局模式过滤规则(例如: *.txt),只下载与过滤规则匹配的文件。要指定过滤规则,可以在高级页面配置接收过滤规则

覆盖本地文件选项可以确定是否应该覆盖或跳过已存在于本地文件系统中的文件。删除文件(接收后)选项决定了是否删除已从远程存储中成功下载的文件。

配置之后,文件将根据接收自动化设置来下载,或者在输出选项卡中通过点击接收按钮手动下载。