On the Mappings page you can see a table containing all the mappings you have created. Beside every mapping there is a set of action buttons affecting the corresponding mapping:
- Stats – displays statistical graphs;
- Test – performs a test of the current mapping;
- Edit – displays a form allowing you to modify the current mapping;
- Delete – obviously deletes the current mapping, with confirmation.
Creating and Editing the Mappings
In the Mappings page, you can create a new mapping by using the Add New button in the table’s header. To edit an existing mapping click on the corresponding Edit button. In either case, a form will appear that allows the mapping to be edited.
The Edit Mapping form is used to configure any particular mapping. This form is structured in 3 sections:
- The common section includes just one field: name.
- The source section contains the fields that are specific to the selected source integration.
- The target section similarly contains the fields that are specific to the selected target integration.
Every type of integration has its own specific settings which are displayed according to the currently selected source or target. In other words, the form will change dynamically when you change the integrations to be used.
Below you can see an Edit Mapping form in action. All settings are visible at the same time in a flat view. I could opt for a wizard style user interface, but I eventually have used a flat and dynamically adaptive form because this way you have the whole picture at a glance, nothing being hidden. And the form doesn’t seem to become cluttered because the number of settings is reasonably low. But of course, this may change in the future.
Another feature of this form is that you can display a mini help for each form field. Just hover your mouse pointer over the question mark on the right of each field to show a callout with a short explanation.
For details regarding the integration specific mapping settings please refer to The Integrations chapter.
When you create a new mapping, a unique link is being associated to be used for receiving IPN notifications from the source. The link address can be copied by clicking on the link symbol on the left of each mapping. For details on using these links please consult Supercharge Your Links chapter.
The Error Indicators
Another cool feature is the error indicator. When one of the mappings doesn’t perform as expected due to various reasons, it is displayed in reddish colors and an exclamation sign icon is also showing to the left. If you click on this icon a pop-over appears containing details about the last few errors. For details please read Debugging Your Mappings chapter.
When you click on Stats button, a page with statistic information is displayed. Due to the philosophy behind data storage of this application of not using any database backend but only JSON files, only the last 30 days of historical statistical data is retained for each mapping, which should be enough to evaluate the mapping’s performance.