How to Map Source Data Fields to Luminous

When integrating your data (like Shopify orders) into Luminous, you'll need to define how fields from your source system map to fields in Luminous. You can do this through simple paths or JSONPath expressions.

Field mapping tells Luminous exactly which piece of data from your incoming source should go into a specific Luminous field.

There are two ways to map data:

Use simple paths for direct field mappings where the field is easily accessible.

Example:

Raw JSON Example:

This maps directly, pulling the order_number value (12345) from the source data into the orderNumber field in Luminous.

For more complex mappings, particularly involving arrays or nested data, JSONPath is powerful.

You can test and validate JSONPaths easily using online tools such as JSONPath Evaluator.

Example 1: Mapping Custom Properties

Raw JSON Example:

This expression tells Luminous to take all properties from each line_item and store them as a custom field called Customization Json for each corresponding line item in Luminous.

Example 2: Mapping Specific Property URL

Raw JSON Example:

This expression tells Luminous to extract the URL (https://cdn.filestackcontent.com/image1) from the _imageLayers property from each line item and store it as a custom field called PrintFileURL.

Here's how you'd map common fields from a Shopify order:

Order Level Fields:

Line Item Fields:

This guide will ensure you map fields correctly, making your data integration seamless and error-free!