Skip to main content
ShipStation 端口允许你通过向 ShipStation 推送数据或从 ShipStation 拉取数据,将 ShipStation 集成到数据流中。

核心功能

  • 集成运输和履约平台,用于电子商务订单管理
  • 基于 API 的连接,支持创建货运、物流轨迹查询、标签生成和订单管理
  • 支持标准数据库操作(Select、Lookup、Upsert 和存储过程)进行数据操作
请按照以下步骤将知行之桥连接到 ShipStation。

建立连接

要允许知行之桥使用 ShipStation 中的数据,你必须先建立与 ShipStation 的连接。可以通过两种方式建立此连接:
  • 将 ShipStation 端口添加到流程中。然后,在 设置 选项卡中,点击连接下拉列表旁边的 创建。
  • 打开知行之桥的 系统设置 页面,然后打开 连接 选项卡。点击 添加,选择 ShipStation,然后点击 下一步。
  • 只有首次创建连接时才需要登录过程。
  • ShipStation 连接可以在多个 ShipStation 端口之间重复使用。

输入连接设置

打开新的连接对话框后,按以下步骤操作:
  1. 提供所需信息:
    • 名称 — 连接的静态名称。
    • 类型 — 始终设置为 ShipStation。
    • API Key — ShipStation 账号的 API Key。
    • API Secret — ShipStation 账号的 API Secret。
  2. 可选:点击 高级 打开高级连接设置下拉菜单。大多数情况下不需要这些设置。
  3. 点击 测试连接,确保知行之桥可以使用提供的信息连接到 ShipStation。如果发生错误,请检查所有字段后重试。
  4. 点击 添加连接 完成连接。
  5. 在端口配置窗格的 连接 下拉列表中,选择新创建的连接。
  6. 点击 保存更改。
高级 选项卡上还提供数据源特定的身份验证和配置选项。本文档未描述所有选项,但你可以在我们网站的 在线帮助文件 页面找到数据源的详细信息。

选择操作

建立与 ShipStation 的连接后,你必须选择 ShipStation 端口要执行的操作。下表概述了每个操作及其在工作流程中的位置。

高级选项卡

高级 选项卡上的许多设置会从你正在使用的数据源动态加载,因此本文档未涵盖这些设置。你可以在我们网站的 在线帮助文件 页面找到数据源的详细信息。 以下选项适用于所有数据源。

消息

高级设置

高级设置 是依赖任意数据库驱动程序(例如 Database、CData 和 API 端口)来连接各种数据源的端口的通用设置。

其他

其他设置 用于特定使用场景。

自动化选项卡

自动化设置

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

性能

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

警报选项卡

与配置警报相关的设置。 在执行服务级别协议(SLA)之前,你需要设置电子邮件警报以发送通知。默认情况下,知行之桥使用 警报 选项卡上的全局设置。要对此端口使用其它设置,请开启 覆盖全局设置。 默认情况下,错误警报处于启用状态,这意味着每当发生错误时都会发送电子邮件。要关闭它们,请取消选中 启用 复选框。 输入 主题(必填),然后可选择输入以逗号分隔的 收件人 邮箱列表。

SLA 选项卡

与配置服务级别协议(SLA)相关的设置。 SLA 允许你配置流程中端口预计发送或接收的数量,并设置预计达到该数量的时间范围。当未满足 SLA 时,知行之桥会发送电子邮件警告用户,并将 SLA 标记为 At Risk,这意味着如果很快仍未满足 SLA,它将被标记为 Violated。这让用户有机会介入并确定 SLA 未满足的原因,并采取适当操作。如果在风险期结束时仍未满足 SLA,SLA 会被标记为 violated,并再次通知用户。 要定义 SLA,请开启 预期数量,然后点击 设置 选项卡。 空 SLA 配置
  • 如果端口具有单独的发送和接收操作,请使用单选按钮指定 SLA 适用的方向。
  • 在窗口的 预计至少 部分:
    • 设置你预计处理的最小事务数量(数量)
    • 使用 每 字段指定时间范围
    • 指明 SLA 应何时生效。如果选择 开始于,请填写日期和时间字段。
    • 选中希望 SLA 生效的星期几。必要时可使用下拉列表选择 每天。
  • 在窗口的 将状态设置为“At Risk” 部分,指定 SLA 应何时标记为有风险。
    • 默认情况下,在 SLA 违规之前不会发送通知。要更改此行为,请选中 发送“At Risk”通知。
以下示例显示了为一个端口配置的 SLA:该端口预计在周一至周五每天接收 1000 个文件。如果在时间段结束前 1 小时仍未收到 1000 个文件,则会发送风险通知。 SLA 配置示例
如有需要,你可以关闭 SLA 警报。这在维护窗口期间很有用。点击导航栏上的 设置,然后导航到 警报 > 常规警报。点击平板和铅笔图标进行编辑,并取消选中 SLA 警报 设置。

宏

在文件命名策略中使用宏可以提高组织效率,并增强对数据上下文的理解。通过在文件名中加入宏,你可以动态包含标识符、时间戳和标头信息等相关信息,为每个文件提供有价值的上下文。这有助于确保文件名反映对组织而言重要的详细信息。 知行之桥支持以下宏,它们都使用以下语法:%Macro%。

示例

某些宏(例如 %Ext% 和 %ShortDate%)不需要参数,但其它宏需要。所有接受参数的宏都使用以下语法:%Macro:argument% 以下是一些接受参数的宏示例:
  • %Header:headername%:其中 headername 是消息上的标头名称。
  • %Header:mycustomheader% 解析为输入消息上设置的 mycustomheader 标头的值。
  • %Header:ponum% 解析为输入消息上设置的 ponum 标头的值。
  • %RegexFilename:pattern%:其中 pattern 是正则表达式模式。例如,%RegexFilename:^([\w][A-Za-z]+)% 会匹配并解析为文件名中的第一个单词,且不区分大小写(test_file.xml 解析为 test)。
  • %Vault:vaultitem%:其中 vaultitem 是 vault 中项目的名称。例如,%Vault:companyname% 解析为 vault 中存储的 companyname 项的值。
  • %DateFormat:format%:其中 format 是接受的日期格式(详情请参阅 示例日期格式)。例如,%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% 解析为文件上的日期和时间戳。
你还可以创建更复杂的宏,如以下示例所示:
  • 在一个文件名中组合多个宏:%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
  • 在宏外包含文本:MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
  • 在宏内包含文本:%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%