Blank Input

Blank Input task is triggered manually by the user. Before it runs, it will ask you to upload a file. Later this file is available in hook editor. This means you can easily access rows of your file and perform certain operations.

Looping over file rows is really simple and looks like that:

{% for row in file  %}
    {{ row["Your Column Name"] | log }}
{% endof %}

Above snippet will output to task logs each row value for column named Your Column Name .

Any hook placed in this task will have file object preloaded. This object is nothing else as an array with JSON objects. Each JSON object has properties named exactly as columns in your source file. Let's have a look how you can use this task to create customers in Shopify.

{% unless file %} 
  {% capture file %} 
  [{
    "email": "[email protected]"
  }]
  {% endcapture %}
{% endunless %} 
​
{% capture mutation %}
    mutation tagsAdd($input: CustomerInput!) {
      customerCreate(input: $input) {
        customer {
          id
        }
        userErrors {
          field
          message
        }
      }
    }
{% endcapture %}
​
{% capture variables %}
    {
      "input": {
        "email": ""
      }
    }
{% endcapture %}
​
{% assign variables = variables | parse %}
​
{% for row in file %}
  {% assign variables.input.email = row['email'] %}
  {% assign result = mutation | graphql: variables %}
​
  {% if result.customerCreate.userErrors != empty %}
    {{ result.customerCreate.userErrors[0] | log }}
  {% else %}
    {{ "Created new customer with id: " | append: result.customerCreate.customer.id | log }}
  {% endif %}
​
{% endfor %}

Lines 1-7 create dummy file object for validation purposes (when validating user code, no predefined objects are created). Next, in lines 9-21 we capture GraphQL mutation for creating a customer. Lines 23-29 capture variables required for GraphQL mutation. Next we use forloop to go through the file rows and for each row assign email to variables.input.email.

Having mutation input ready we execute GraphQL query and voila our customer is created.