Skip to content

Source mapping: the screen

The Mapping step of a source tells Feedink which element of your file fills which field of your items. The screen shows the structure of your file, a live preview of one product and a bar that saves what you change.

The mapping of the Google RSS source: the Combine data card, the file schema with its fields, and the product preview

  • From the Sources list: the Mapping shortcut on the source’s row.
  • From the source’s panel: the Mapping step after Settings (Source settings).
  • From the setup guide: the step Map the fields has the button Open mapping. It opens the first source that has nothing mapped yet, or the first source when all have something.
  • Right after you create a source: Mapping in the panel (Add a source).

The mapping opens full screen, in the same head as the source’s other steps: the arrow goes back to Settings, the Rules button goes on to the source’s rules, and the close button returns to the list. For a source whose last update failed or was interrupted and that has nothing mapped yet, the Mapping and Rules shortcuts in the list are switched off (Sources list).

When you open the mapping of a source that has nothing mapped and no saved mapping linked to it, Feedink looks at the saved mappings it holds for sources of the same format. If one of them maps at least one field of your file (for an XML file it must also mark the element that wraps each product), Feedink picks a saved mapping that fits your file, applies it and saves it. It does not ask and shows no message: the tree simply opens with fields filled in. The example values of your file stay.

This happens once: after that something is mapped, so opening the mapping again changes nothing. Check the result against the Summary and fix what is wrong; every change you make after the automatic one is an edit like any other.

Owners and collaborators can change the mapping. A viewer can open the screen and read it, but has no way to keep a change: the buttons Add element, Add attribute and Add column are not shown, and the bar that appears after an edit has no Save, no Discard changes and no Undo or Redo, so a change a viewer makes on screen is not kept.

You can open and edit the mapping while the source or the inkspace is updating, and Save is not switched off on screen. If Feedink cannot take the change just then, a toast says so; try again when the update has finished (Update status, Save, undo and leave).