Outputs

Outputs are the end point for an executed action - once the Input triggers a script to run, it will have an effect on a chosen output. 

Just the same as your inputs, you will need to select an Output Type from the drop-down list and then click Add New

The output types to choose from are:

Just as with inputs, each of these output types will have some standard fields to fill out across all of them: 

  • Name: Title of the input, which will help identify what it's for.
  • Key: The identifier for the input used by the system. Input keys will begin with in-.
  • Script: The Mesa Script [link] that will execute when this input is triggered. Scripts are also created on the Mesa dashboard and will generally trigger an Output [link].

Each Output has a toggle to disable/enable it and a button to duplicate it. Only the Virtual Output will have a Test button to run an example payload. 

While there is a limit to the number of inputs you can have enabled, there is no limit to the number of outputs you can have on Mesa. 

Here are the details on the available Output types:

FTP

Save the output to a file on a FTP server.

  • See list of standard fields.
  • Method: Mesa supports FTP and SFTP connections.
  • Port: The FTP port to connect to. Often times 21 for FTP and 22 for SFTP.
  • Username: The FTP username.
  • Password: Create a Secret with your FTP password and select it in this dropdown.
  • Host: The FTP host to connect to.
  • File: The file path and name to read and pass to the Script. This field supports the following tokens:
    • {date:RELATIVE_STRING}: This token can be used to enter a relative date from today. Full syntax details. For example, out-{date:m_d_Y}.csv will read or save the file out-03_14_2019.csv.

Shopify API

Make a Shopify API call with the output.

  • See list of standard fields.
  • API: The Shopify API method you would like to call. Typically, this will be a POST, PUT, PATCH or DELETE method.
  • Schedule: How often this input should run. Uses crontab syntax.
  • Advanced Options: Connect to another Shopify site that Mesa is not installed on by connecting with Private App credentials.
    • Site Hostname: The admin hostname for the external site
    • API Key: The Private App API key
    • Password: The Private App password

Task

Run an arbitrary script with the output. Tasks can be used to make calls to third party APIs.

Virtual Output

Create a list that can be pushed to from an input.  On a schedule, these items will be sent to the script, 100 at a time, for processing.  For example, you could push all orders to a queue and then every hour post all of the new orders to a file on a FTP file.