Retransforming Data and Mapper Replay

Table of Contents

1. What is a Mapper Replay?
2. When to Execute a Mapper Replay
3. How to Execute a Mapper Replay

What is a Mapper Replay?

Mapper Replay is a process by which mapping configurations are reapplied to source data and the retransformed data is exported to the connected data destination. It allows Reactor users to retransform all source data collected and indexed by Reactor according to the latest version of a mapping configuration, future-proofing their data.

When to Execute a Mapper Replay

A Mapper Replay should be executed whenever a new mapping configuration is deployed so that the mappings deployed will be applied retroactively to data collected and mapped before the new configuration was deployed. There are many reasons why a mapping configuration could be updated, including: 

1. Updates to support new data use cases
2. Updates to resolve mapping errors reported in Reactor
3. Updates to differentiate data from different sources that lands in the same destination

How to Execute a Mapper Replay

1. In Reactor, navigate to the Mappings page using the Mappings link on the left sidebar.
   
   ℹ️ If you do not see a Mapping link on the sidebar, select the REACTOR → link at the top-right of the SoundCommerce user interface.
2. Find the tile on the mapping graph for the data source whose data you would like to retransform
   ℹ️ If you need help finding the source you are looking for, use the search box at the top right of the mapping graph.
3. Each source tile has a circular arrow icon in the top-right corner (see below, in the red square); select this icon to kick off a mapper replay for this source.