Shopify流程中的变量
变量是占位符,在工作流运行时被值替换。这些变量描述了工作流中涉及的客户、订单和产品的属性。例如,有订单号、订单价格、客户名称等变量。
Flow使用不同于Shopify主题的Liquid版本,并且可以通过GraphQL管理API.
大多数变量的名称是自描述的。例如,显示产品名称的变量为{{产品。标题}}
.当消息发送时,这个变量被替换为订购产品的名称:大咖啡杯
.
向动作添加变量
属性的任何文本字段都可以添加变量添加变量链接。单击添加变量链接到相关字段下面,然后从列表中选择一个变量。
的变量添加变量列表进行筛选,以便您只能看到应用于所选触发器的变量。从列表中选择变量后,它将被正确格式化并添加到文本框中。
Flow几乎支持所有GraphQL管理API字段。
液态变量
如果您是具有编写Liquid代码经验的开发人员,则可以使用Liquid编写变量或编辑使用添加变量链接。要了解更多,请参阅GraphQL管理API参考.
条件标签和迭代标签
您可以手动添加Liquid变量标签到您的工作流消息。您可以使用这些标记在邮件中包含更多信息。
例如,你可以使用afor循环
对象来遍历对象列表,例如订单的行项目。使用这些标记,您可以创建包含详细信息的消息,例如产品名称、SKU、价格和订单中每个行项目的数量,并使收件人不必在Shopify管理中查找这些信息。
Flow支持以下Liquid条件(或控制流)标签:
Flow还支持以下Liquid迭代标签:
过滤器
流量支持以下液体过滤器:
过滤器的名字 | 过滤器类型 |
---|---|
腹肌 | 数学 |
附加 | 字符串 |
at_least | 数学 |
at_most | 数学 |
利用 | 字符串 |
装天花板 | 数学 |
concat | 数组 |
日期 | 额外的 |
默认的 | 额外的 |
divided_by | 数学 |
downcase | 字符串 |
逃避 | 字符串 |
第一个 | 数组 |
地板上 | 数学 |
加入 | 数组 |
最后的 | 数组 |
lstrip | 字符串 |
地图 | 数组 |
- | 数学 |
模 | 数学 |
newline_to_br | 字符串 |
+ | 数学 |
预谋 | 字符串 |
删除 | 字符串 |
remove_first | 字符串 |
取代 | 字符串 |
replace_first | 字符串 |
反向 | 数组 |
轮 | 数学 |
rstrip | 字符串 |
大小 | 数组 |
片 | 字符串 |
排序 | 数组 |
分裂 | 字符串 |
带 | 字符串 |
strip_html | 字符串 |
strip_newlines | 字符串 |
次 | 数学 |
截断 | 字符串 |
truncatewords | 字符串 |
uniq | 数组 |
upcase | 字符串 |
url_encode | 字符串 |
在哪里 | 数组 |
变量的例子
例如,您希望创建一个工作流,以便在客户在订单上花费超过500美元时向员工发送电子邮件。方法创建工作流订单创建触发器,设置一个条件,如果订单总额超过$500则为真,然后使用发送内部邮件行动。在消息部份发送内部邮件操作,使用以下变量。
输入 | 输出 |
---|---|
请向{{order.customer. firstname}} {{order.customer. lastname}}({{order.customer.email}})发送个人感谢信,感谢您为$ {{order. totalpriceset . shopmoney .amount}}下订单。 | 请向Jeanne Dupont (jeanne@example.com)发送个人感谢信,感谢她下了763.42美元的订单。 |
当产品库存越来越低,需要订购更多库存时,您决定通知工作人员。创建的工作流以OB欧宝娱乐APP库存数量变更触发,并设置一个条件,如果之前的库存数量小于或等于10则为真。在消息部份发送内部邮件操作,使用以下变量。
输入 | 输出 |
---|---|
请重新订购{{产品。标题}}。给owner@store.com发邮件确认他们已经收到了采购订单。 | 请重新订购高腰紧身裤-黑色。给owner@example.com发邮件确认他们已经收到了采购订单。 |
您希望取消具有较高风险级别的订单,但希望由您的员工手动取消订单。创建的工作流以OB欧宝娱乐APP订单创建触发,并设置一个条件,如果订单的风险级别等于高,则该条件为真。在消息部份发送内部邮件操作,使用以下变量。
输入 | 输出 |
---|---|
我们的Shopify商店收到了一个欺诈风险很高的订单。我们想马上取消这个订单,在它被送到生产之前: {{order.name}} {{order.billingAddress.lastName}}, {{order.billingAddress.firstName}} {{秩序。电子邮件}} 请确认新的订单状态谢谢! |
我们的Shopify商店收到了一个欺诈风险很高的订单。我们想马上取消这个订单,在它被送到生产之前: # 1001 杜邦,珍妮 jeanne@example.com 请确认新的订单状态谢谢! |
For循环的例子
当收到订单时,发送包含所订购产品的消息是很有用的。您可以通过使用for循环
,重复执行一个代码块。支持变量的文本字段也支持For循环和forloop对象.
例如,您希望创建一个工作流,该工作流按顺序返回所有sku和数量的列表。在消息部份发送内部邮件操作,使用以下变量。
输入 | 输出 |
---|---|
订单汇总: {%为a的顺序。lineitem %} SKU: {{a.sku}}( {{a.quantity}} ), {% endfor %} |
订单汇总: 8987097979 (50) 8877778887 (3) 888998898 b (1) |
您决定向电子邮件添加更多信息,包括产品名称、sku、每件商品的价格和客户的运输信息。在消息部份发送内部邮件操作,使用以下变量。
输入 | 输出 |
---|---|
订单汇总: {%为a的顺序。lineitem %} 产品:{{a.title}} SKU: {{a.sku}} 价格(每单位):$ {{a.originalUnitPriceSet.shopMoney.amount}} 数量:{{a.quantity}} {% endfor %} |
订单汇总: 产品:高腰紧身裤-黑色 SKU: 8987097979 单价:8.49美元 数量:5 产品:运动袜-蓝色 SKU: 888998898 b 价格(每件):5.61美元 数量:2 |
您需要跟踪由特定供应商提供的销售项目。在消息部份发送内部邮件操作时,使用以下变量并包含如果
在你的for循环
.
输入 | 输出 |
---|---|
Acme产品销售: {%为x。lineitem %} {% if x.vendor == 'acme-vendor' %} 产品名称:{{x.title}} SKU: {{x.sku}} {% endif %} {% endfor %} |
Acme产品销售: 产品名称:高腰紧身裤-黑色 SKU: 8987097979 |
Shopify Flow中的复杂数据对象
Shopify Flow不支持输出数组和对象,原因如下:
- GraphQL API不推荐输出不需要的数据,它可能会创建较大的查询大小,导致工作流失败。
- 当引入新特性时,会添加新的API字段,这可能会破坏您的工作流程。
如果自动发送的数据太多,工作流就会失败。不是直接调用数组和对象,而是遍历数组并只包含所需的字段。
例如,不打电话{{秩序。李neItems }}
直接使用以下格式调用特定字段。这些示例包括了通过直接调用数组或对象将包含的所有字段。复制并粘贴所需的字段。
{%为李在order.lineItems%}{%评论%}李。合同-省略{%endcomment%}{%为ca在li.customAttributes%}{{ca.关键}}{{ca.价值}}{%endfor%}{%为达在li.discountAllocations%}{{达.allocatedAmountSet.presentmentMoney.量}}{{达.allocatedAmountSet.presentmentMoney.currencyCode}}{{达.allocatedAmountSet.shopMoney.量}}{{达.allocatedAmountSet.shopMoney.currencyCode}}{%endfor%}{{李.discountedTotalSet.presentmentMoney.量}}{{李.discountedTotalSet.presentmentMoney.currencyCode}}{{李.discountedTotalSet.shopMoney.量}}{{李.discountedTotalSet.shopMoney.currencyCode}}{{李.discountedUnitPriceSet.presentmentMoney.量}}{{李.discountedUnitPriceSet.presentmentMoney.currencyCode}}{{李.discountedUnitPriceSet.shopMoney.量}}{{李.discountedUnitPriceSet.shopMoney.currencyCode}}{%评论%}li.duties- omitted{%endcomment%}{{李.fulfillableQuantity}}{{李.fulfillmentService.callbackUrl}}{{李.fulfillmentService.fulfillmentOrdersOptIn}}{{李.fulfillmentService.处理}}{{李.fulfillmentService.id}}{{李.fulfillmentService.inventoryManagement}}{%评论%}其余位置省略{%endcomment%}{{李.fulfillmentService.位置.的名字}}{{李.fulfillmentService.productBased}}{{李.fulfillmentService.名}}{%为sm在li.fulfillmentService.shippingMethods%}{{sm.代码}}{{sm.标签}}{%endfor%}{{李.fulfillmentService.类型}}{{李.fulfillmentStatus}}{{李.id}}{{李.图像.altText}}{{李.图像.高度}}{{李.图像.id}}{%评论%}li.image.metafield省略{%endcomment%}{%评论%}li.image.privateMetafield省略{%endcomment%}{{李.图像.宽度}}{{李.merchantEditable}}{{李.的名字}}{{李.nonFulfillableQuantity}}{{李.originalTotalSet.presentmentMoney.量}}{{李.originalTotalSet.presentmentMoney.currencyCode}}{{李.originalTotalSet.shopMoney.量}}{{李.originalTotalSet.shopMoney.currencyCode}}{{李.originalUnitPriceSet.presentmentMoney.量}}{{李.originalUnitPriceSet.presentmentMoney.currencyCode}}{{李.originalUnitPriceSet.shopMoney.量}}{{李.originalUnitPriceSet.shopMoney.currencyCode}}{%评论%}其余产品省略{%endcomment%}{{李.产品.标题}}{{李.数量}}{{李.refundableQuantity}}{{李.requiresShipping}}{{李.restockable}}{{李.sellingPlan.的名字}}{{李.sku}}{%为tl在li.taxLines%}{{tl.priceSet.presentmentMoney.量|json}}{{tl.priceSet.presentmentMoney.currencyCode|json}}{{tl.priceSet.shopMoney.量|json}}{{tl.priceSet.shopMoney.currencyCode|json}}{{tl.率|json}}{{tl.ratePercentage|json}}{{tl.标题|json}}{%endfor%}{{李.应纳税的}}{{李.标题}}{{李.totalDiscountSet.presentmentMoney.量}}{{李.totalDiscountSet.presentmentMoney.currencyCode}}{{李.totalDiscountSet.shopMoney.量}}{{李.totalDiscountSet.shopMoney.currencyCode}}{{李.unfulfilledDiscountedTotalSet.presentmentMoney.量}}{{李.unfulfilledDiscountedTotalSet.presentmentMoney.currencyCode}}{{李.unfulfilledDiscountedTotalSet.shopMoney.量}}{{李.unfulfilledDiscountedTotalSet.shopMoney.currencyCode}}{{李.unfulfilledOriginalTotalSet.presentmentMoney.量}}{{李.unfulfilledOriginalTotalSet.presentmentMoney.currencyCode}}{{李.unfulfilledOriginalTotalSet.shopMoney.量}}{{李.unfulfilledOriginalTotalSet.shopMoney.currencyCode}}{{李.unfulfilledQuantity}}{%评论%}其余变量省略{%endcomment%}{{李.变体.标题}}{{李.variantTitle}}{{李.供应商}}{%endfor%}
{"lineItems": [{%为李在order.lineItems%}{%如果forloop.first! =真正的%},{%endif%}{"合同":{{%评论%}合同其余部分略{%endcomment%}“id”:{{李.合同.id|json}}}, "customAttributes": [{%为ca在li.customAttributes%}{%如果forloop.first! =真正的%},{%endif%}{“关键”:{{ca.关键|json}}“价值”:{{ca.价值|json}}}{%endfor%}], "discountAllocations": [{%为达在li.discountAllocations%}{%如果forloop.first! =真正的%},{%endif%}"allocatedAmountSet": {"presentmentMoney": {"amount":{{达.allocatedAmountSet.presentmentMoney.量|json}}“currencyCode”:{{达.allocatedAmountSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{达.allocatedAmountSet.shopMoney.量|json}}“currencyCode”:{{达.allocatedAmountSet.shopMoney.currencyCode|json}}}}{%endfor%}], "discountedTotalSet": {"presentmentMoney": {"amount":{{李.discountedTotalSet.presentmentMoney.量|json}}“currencyCode”:{{李.discountedTotalSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{李.discountedTotalSet.shopMoney.量|json}}“currencyCode”:{{李.discountedTotalSet.shopMoney.currencyCode|json}}}}, "discountedUnitPriceSet": {"presentmentMoney": {"amount":{{李.discountedUnitPriceSet.presentmentMoney.量|json}}“currencyCode”:{{李.discountedUnitPriceSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{李.discountedUnitPriceSet.shopMoney.量|json}}“currencyCode”:{{李.discountedUnitPriceSet.shopMoney.currencyCode|json}}}}, "职责":[{%为责任li.duties%}{%如果forloop.first! =真正的%},{%endif%}{{%评论%}其他职责略{%endcomment%}“id”:{{责任.id|json}}}{%endfor%}),“fulfillableQuantity”:{{李.fulfillableQuantity|json}}, "fulfillmentService": {"callbackUrl":{{李.fulfillmentService.callbackUrl|json}}“fulfillmentOrdersOptIn”:{{李.fulfillmentService.fulfillmentOrdersOptIn|json}}“处理”:{{李.fulfillmentService.处理|json}}“id”:{{李.fulfillmentService.id|json}}“inventoryManagement”:{{李.fulfillmentService.inventoryManagement|json}},{%评论%}fulfillmentService。在ventoryManagement - omitted{%endcomment%}“productBased”:{{李.fulfillmentService.productBased|json}}“名”:{{李.fulfillmentService.名|json}}, "shippingMethods": [{%为sm在li.fulfillmentService.shippingMethods%}{%如果forloop.first! =真正的%},{%endif%}{“代码”:{{sm.代码|json}}“标签”:{{sm.标签|json}}}{%endfor%}》,“类型”:{{李.fulfillmentService.类型|json}}}, " fulfillmentStatus”:{{李.fulfillmentStatus|json}}“id”:{{李.id|json}}, "image": {"altText":{{李.图像.altText|json}}“高度”:{{李.图像.高度|json}}“id”:{{李.图像.id|json}},{%评论%}li.image.metafield省略{%endcomment%}{%评论%}li.image.privateMetafield省略{%endcomment%}“宽度”:{{李.图像.宽度|json}}}, " merchantEditable”:{{李.merchantEditable|json}}“名称”:{{李.的名字|json}}“nonFulfillableQuantity”:{{李.nonFulfillableQuantity|json}}, "originalTotalSet": {"presentmentMoney": {"amount":{{李.originalTotalSet.presentmentMoney.量|json}}“currencyCode”:{{李.originalTotalSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{李.originalTotalSet.shopMoney.量|json}}“currencyCode”:{{李.originalTotalSet.shopMoney.currencyCode|json}}}}, "originalUnitPriceSet": {"presentmentMoney": {"amount":{{李.originalUnitPriceSet.presentmentMoney.量|json}}“currencyCode”:{{李.originalUnitPriceSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{李.originalUnitPriceSet.shopMoney.量|json}}“currencyCode”:{{李.originalUnitPriceSet.shopMoney.currencyCode|json}}}}, "product": {{%评论%}其余产品省略{%endcomment%}“标题”:{{李.产品.标题|json}}},“数量”:{{李.数量|json}}“refundableQuantity”:{{李.refundableQuantity|json}}“requiresShipping”:{{李.requiresShipping|json}}“restockable”:{{李.restockable|json}}, "sellingPlan": {"name":{{李.sellingPlan.的名字|json}}}, " sku”:{{李.sku|json}}, "taxLines": [{%为tl在li.taxLines%}{%如果forloop.first! =真正的%},{%endif%}{"priceSet": {"presentmentMoney": {"amount":{{tl.priceSet.presentmentMoney.量|json}}“currencyCode”:{{tl.priceSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{tl.priceSet.shopMoney.量|json}}“currencyCode”:{{tl.priceSet.shopMoney.currencyCode|json}}}}, "rate":{{tl.率|json}}“ratePercentage”:{{tl.ratePercentage|json}}“标题”:{{tl.标题|json}}}{%endfor%}),“纳税”:{{李.应纳税的|json}}“标题”:{{李.标题|json}}, "totalDiscountSet": {"presentmentMoney": {"amount":{{李.totalDiscountSet.presentmentMoney.量|json}}“currencyCode”:{{李.totalDiscountSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{李.totalDiscountSet.shopMoney.量|json}}“currencyCode”:{{李.totalDiscountSet.shopMoney.currencyCode|json}}}}, " unfulfillleddiscountedtotalset ": {"presentmentMoney": {"amount":{{李.unfulfilledDiscountedTotalSet.presentmentMoney.量|json}}“currencyCode”:{{李.unfulfilledDiscountedTotalSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{李.unfulfilledDiscountedTotalSet.shopMoney.量|json}}“currencyCode”:{{李.unfulfilledDiscountedTotalSet.shopMoney.currencyCode|json}}}}, " unfulfillment originaltotalset ": {"presentmentMoney": {"amount":{{李.unfulfilledOriginalTotalSet.presentmentMoney.量|json}}“currencyCode”:{{李.unfulfilledOriginalTotalSet.presentmentMoney.currencyCode|json}}}, "shopMoney": {"amount":{{李.unfulfilledOriginalTotalSet.shopMoney.量|json}}“currencyCode”:{{李.unfulfilledOriginalTotalSet.shopMoney.currencyCode|json}}}}, " unfulfillment quantity ":{{李.unfulfilledQuantity|json}}, "variant": {{%评论%}其余变量省略{%endcomment%}“标题”:{{李.变体.标题|json}}}, " variantTitle”:{{李.variantTitle|json}},“供应商”:{{李.供应商|json}}}{%endfor%}]}