Skip to content

IMan System Connector Setup

The System Connector holds the store's ID and the Client ID and Secret of the app you created in Shopify Setup. Create one System Connector for each store.

  1. In the Designer, open Setup > System Connectors.
  2. Press Add and fill in the form as below.
  3. Save the System Connector.

The Add New Record form for a System Connector. ID is SHOPIFY, Description is Shopify Store and System Type is Shopify. Version is empty. Connection String holds AUTH=2;TRACE=True;. Username holds your-client-id, Password holds a masked value and Company ID holds your-shopify-store

ID

Any value that no other System Connector uses, such as SHOPIFY. A transform names its System Connector by this ID.

Description

A description of the store. The System Connector list on each Shopify reader and writer shows it.

System Type

Select Shopify. If Shopify is not in the list, see Installation.

Version

Leave it empty.

Connection String

A list of key=value settings, each ending in a semicolon, such as AUTH=2;TRACE=False;. A Dev Dashboard app needs AUTH=2. The other settings are optional.

Key Values Effect
AUTH 2 IMan gets its access token with the app's Client ID and Secret.
TRACE True or False True writes every request and response to WSTRACE-ShopifyCo-<ID>.log in the IMan Debug folder, where <ID> is the System Connector's ID. The trace holds the store's order and customer data. Turn it on only to investigate a problem. The default is False.
MaxConcurrentRequests 1 to 8 How many metafield requests a push sends to Shopify at once. It speeds up the Metafields, Product MetaFields and Customer MetaFields pushes, and the metafields on the Products, Customers and Orders pushes. Those three still write their records one at a time. Every request shares the store's rate limit, and when Shopify throttles a request, IMan waits and sends it again. The default is 1. Designer runs always send one request at a time.
MaxBulkOperations 1 to 5 How many Shopify bulk operations a push runs at once when its Use Bulk Operations field is True. Shopify allows an app five at a time on each store, across all its jobs. The default is 1.

Username

The app's Client ID.

Password

The app's Secret.

Company ID

The store's ID: the part of the store's address before .myshopify.com. For realisable-test.myshopify.com, enter realisable-test.

A browser address bar showing https://realisable-test.myshopify.com/admin, with realisable-test outlined

Existing Connections

A System Connector set up for a legacy custom app has AUTH=1 in its connection string, an empty Username, and the app's Admin API access token in Password. It keeps working and needs no change.

To move it to a Dev Dashboard app, create the app as in Shopify Setup. Then change AUTH=1 to AUTH=2, enter the Client ID in Username and the Secret in Password, and save the System Connector.