Core Concepts
Techniques
Stub data
Stub data is hard-coded into a task, providing an unchanging source of data for previews. It is an important tool when generating dynamic preview actions. Stub data may be used for user-defined variables, but may also override environment variables as needed.
For controlling preview event data (i.e. the values in
event.data, and values found in event subject variables), use defined preview events to cleanly specify these values outside of the task code.Stubbing Liquid variables
Most tasks make decisions based on the Liquid variables automatically provided, making it a common practice to stub them during preview mode. Any and all Liquid variables may be replaced by stub data, including
event and any event subject variables.The stub data in the following examples include an ID for the order, so as to generate a realistic tagsAdd mutation during preview mode.
Realistic preview actions are important for users and developers, but there's a functional importance for tagsAdd mutations in particular: in preview mode, Mechanic looks at the
id argument in order to determine what kind of resource will be tagged, in order to determine what permissions this particular mutation requires. If you generate tagsAdd mutations during preview, make sure to use realistic ID values!1
{% if event.preview %}
2
{% assign order = hash %}
3
{% assign order["source_name"] = "web" %}
4
{% assign order["admin_graphql_api_id"] = "gid://shopify/Order/1234567890" %}
5
{% endif %}
6
7
{% if order.source_name == "web" %}
8
{% action "shopify" %}
9
mutation {
10
tagsAdd(id: {{ order.admin_graphql_api_id | json }}, tags: "web") {
11
userErrors { field, message }
12
}
13
}
14
{% endaction %}
15
{% endif %}
Copied!
1
{% if event.preview %}
2
{% capture order_json %}
3
{
4
"source_name": "web",
5
"admin_graphql_api_id": "gid://shopify/Order/1234567890"
6
}
7
{% endcapture %}
8
9
{% assign order = order_json | parse_json %}
10
{% endif %}
11
12
{% if order.source_name == "web" %}
13
{% action "shopify" %}
14
mutation {
15
tagsAdd(id: {{ order.admin_graphql_api_id | json }}, tags: "web") {
16
userErrors { field, message }
17
}
18
}
19
{% endaction %}
20
{% endif %}
Copied!
Stubbing GraphQL data
Mechanic makes GraphQL data available to tasks via the shopify filter. Mechanic observes the shopify filter in action during preview mode, using its inputs to inform Mechanic's knowledge of what permissions the task needs.
For this reason, it's important to allow the shopify filter to run normally, and construct stub data afterwards.
It can be useful to specify stub data using JSON, fed through the parse_json filter. Sample JSON is easy to generate using Shopify's GraphiQL app.
GraphQL with stub data
GraphQL pagination with stub data
1
{% capture query %}
2
query {
3
publications(first: 250) {
4
edges {
5
node {
6
id
7
name
8
}
9
}
10
}
11
}
12
{% endcapture %}
13
14
{% assign result = query | shopify %}
15
16
{% if event.preview %}
17
{% capture result_json %}
18
{
19
"data": {
20
"publications": {
21
"edges": [
22
{
23
"node": {
24
"id": "gid://shopify/Publication/69217648807",
25
"name": "Online Store"
26
}
27
}
28
]
29
}
30
}
31
}
32
{% endcapture %}
33
34
{% assign result = result_json | parse_json %}
35
{% endif %}
36
37
{% log available_publications: result.data.publications %}
Copied!
1
{% assign cursor = nil %}
2
{% assign total_inventory = 0 %}
3
4
{% for n in (0..100) %}
5
{% capture query %}
6
query {
7
orders(
8
first: 250
9
query: "status:open"
10
after: {{ cursor | json }}
11
) {
12
pageInfo { hasNextPage }
13
edges {
14
node { name, email }
15
}
16
}
17
}
18
{% endcapture %}
19
20
{% assign result = query | shopify %}
21
22
{% if event.preview %}
23
{% capture result_json %}
24
{
25
"data": {
26
"orders": {
27
"pageInfo": {
28
"hasNextPage": false
29
},
30
"edges": [
31
{
32
"node": {
33
"name": "#1135",
34
"email": "[email protected]"
35
}
36
}
37
]
38
}
39
}
40
}
41
{% endcapture %}
42
43
{% assign result = result_json | parse_json %}
44
{% endif %}
45
46
{% for order_edge in result.data.orders.edges %}
47
{% assign order_node = order_edge.node %}
48
49
{% if order_node.email == blank %}
50
{% continue %}
51
{% endif %}
52
53
{% action "email" %}
54
{
55
"to": {{ order_node.email | json }},
56
"subject": {{ "We're still working on " | append: order_node.name | json }},
57
"body": "Thanks for your patience!"
58
}
59
{% endaction %}
60
{% endfor %}
61
62
{% if result.data.orders.pageInfo.hasNextPage %}
63
{% assign cursor = result.data.orders.edges.last.cursor %}
64
{% else %}
65
{% break %}
66
{% endif %}
67
{% endfor %}
Copied!
Last modified 1mo ago
Copy link
Edit on GitHub