Flow 自动化：通过执行器批量查询手动分类
您可以在【Flow 自动化】中使用【批量查询手动分类】执行器，一次性获取店铺内多个手动分类的信息。手动分类是指由您手动添加商品的分类。您可以按分类 ID、标题等条件筛选查询范围，并在同一工作流的后续步骤中使用返回的分类信息，例如在分类设置发生变化时更新商品标签、上架商品或发送邮件通知团队。
本文将说明该执行器的适用情况、字段定义、适用工作流、如何进行测试，并提供一个实用示例及使用限制。
何时使用批量查询手动分类执行器
适用于以下情况：
- 有分类被创建或删除时，您希望查询分类信息，以便及时更新相关商品的标签或所属分类。
- 有商品被添加至分类时，您希望获取该分类的信息，用于更新商品信息、上架商品或向团队发送提醒。
| 注意：该执行器仅用于查询分类信息，不会修改分类，也不会在分类中添加或移除商品。如需对查询结果进行处理，请在工作流中接续其他执行器。 |
字段说明
【批量查询手动分类】执行器允许您设置查询条件以及查询结果的排序方式。
| 字段 | 说明 |
| 【查询条件】 |
用于筛选需要查询的手动分类。点击【+ 添加条件】，勾选所需条件并填写对应的值，然后点击【确定】。如未添加任何条件，该执行器将查询店铺内的全部手动分类，每次最多返回 50 个。 可添加的条件包括：
|
| 【查询结果的排序方式（选填）】 |
设置查询结果的排列顺序。排序将影响本次查询最终保留的数据范围，以及查询结果作为变量时的展示效果。可选项如下：
|
适用工作流触发器
【批量查询手动分类】执行器主要用于由以下触发器启动的工作流：
- 分类创建
- 分类删除
- 商品加入手动分类
测试工作流
若要测试工作流是否成功查询手动分类，请按照以下步骤操作：
- 在【Flow 自动化】中，使用【分类创建】触发器和【批量查询手动分类】执行器设置一个工作流，然后点击【发布】。
-
在 SHOPLINE 后台，前往【商品】>【分类】，点击【创建分类】。
-
选择【手动分类】类型，填写分类信息后点击【创建】。
注意： 有关创建分类的详细信息，请参阅《创建与设置商品分类》。 -
保存分类后，前往【Flow 自动化】查看执行结果。
注意： 有关如何监控工作流执行情况的更多信息，请参阅《Flow 自动化应用介绍》中的《如何查看 Flow 运行结果》章节。 - 打开该工作流的运行详情，确认【批量查询手动分类】执行器已返回您所创建分类的信息。
使用场景
以下是使用【批量查询手动分类】执行器自动完成新促销分类准备工作的实用示例。
场景：运营人员创建新的促销分类时，自动查询该分类信息，为分类下的商品批量添加“活动预热”标签，并发送邮件通知团队核对。
- 触发器：分类创建
-
执行器：批量查询手动分类
- ids：[分类 ID]（触发该工作流的分类 ID）
- limit：10
- 执行器：Count 函数（统计查询到的分类数量）
- 条件：数量大于 0。
-
执行器：添加商品标签
- 目标商品：查询到的分类内包含的商品
- 标签名称：活动预热
-
执行器：发送邮件
- 邮件标题：新分类已创建：[分类名称]
- 邮件内容：新分类 [分类名称] 已成功创建并完成商品自动添加标签，请及时核对在线商店的展示效果。
- 收件人：运营团队邮箱
- 结果：每当有新分类创建，系统都会自动为分类内的商品添加标签并通知团队，避免遗漏分类配置。
| 注意： 如需插入方括号中显示的信息（例如 [分类 ID] 和 [分类名称]），请点击【+ 添加变量】并选择对应的参数。 |
使用限制与注意事项
- 仅查询不修改：该执行器仅查询分类信息，不会修改分类或分类内的商品。如需对查询结果进行处理，请接续其他执行器。
- 已删除的分类：当工作流由【分类删除】触发器启动时，该分类已被删除，查询可能不会返回结果。建议在后续执行器前添加条件，判断是否有查询结果。
- 单次查询数量：每次查询最多返回 250 个分类（默认 50 个）。如需获取更多结果，请使用 【page_info】 或 【since_id】 条件。