跳转到主要内容
Shopify 端口允许你通过向 Shopify 推送数据或从中拉取数据,将 Shopify 集成到数据流中。

核心功能

  • 集成电子商务平台,支持 OAuth 和访问令牌(Access Token)身份验证
  • 基于店铺 URL 的连接性,支持访问产品、订单、客户和库存数据
  • 支持标准数据库操作(Select、Lookup、Upsert 和存储过程)进行数据操作
请按照以下步骤将知行之桥连接到 Shopify。

建立连接

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

输入连接设置

打开新的连接对话框后,请按照以下步骤操作:
  1. 提供所需信息:
    • Name — 连接的静态名称。
    • Type — 始终设置为 Shopify。
    • Auth Scheme — 从列表中选择身份验证方案。选项为 OAuthAccess Token
    • Shop URL — Shopify 商店的完整 URL。
    • OAuth Client Id — 账户的客户端 ID(仅 OAuth 身份验证)。
    • OAuth Client Secret — 账户的客户端密钥(仅 OAuth 身份验证)。
    • Access Token — 用于建立连接的访问令牌(仅 Access Token 身份验证)。
  2. 可选:单击高级打开高级连接设置下拉菜单。大多数情况下不需要这些设置。
  3. 单击测试连接,确保知行之桥可以使用所提供的信息连接到 Shopify。如果发生错误,请检查所有字段并重试。
  4. 单击添加连接以完成连接。
  5. 在端口配置窗格的连接下拉列表中,选择新创建的连接。
  6. 单击保存更改
高级选项卡上还包含特定于数据源的身份验证和配置选项。本文档未全部介绍这些选项,但你可以在我们网站的在线帮助文件页面找到数据源的详细信息。

选择操作

建立到 Shopify 的连接后,必须选择 Shopify 端口要执行的操作。下表概述了每个操作及其在知行之桥工作流中的位置。

高级选项卡

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

消息

高级设置

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

其他设置

其他设置 适用于特定用例。

自动化选项卡

自动化设置

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

性能

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

告警选项卡

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

SLA 选项卡

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

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