Mapping

Mapping

Summary: Learn how to create, import, edit, and export mappings in a BrynQ interface.

Use mapping in an interface

With mapping, you connect fields from your source system to fields in your target system so BrynQ can transfer data correctly.

Open the Mapping tab

  • Open the interface you want to work on.
  • Select the correct draft or editable version.
  • Go to Mapping in the interface menu.
  • Check the page header to confirm you are mapping the correct source and target systems.

Create a new mapping manually

  • In the empty state, click New Mapping.
  • If you already have mappings, click New Mapping in the left sidebar.
  • Enter a clear name for the mapping so you can find it later.
  • Use Add column on the source or target side to add the fields you need.
  • Fill in the table rows to show which source values should go to which target values.

Import a mapping from a file

  • Click Import mapping.
  • Upload a .csv or .xlsx file.
  • If you upload an Excel file, select the correct sheet.
  • If you upload a CSV file, choose the correct delimiter.
  • Enter a Mapping name.
  • Select the input columns and output columns you want to use.
  • Turn on First row column name if the first row contains your column names.
  • Check the preview and click Apply and import.

Edit an existing mapping

  • Select a mapping from the list on the left.
  • Click the mapping name at the top if you want to rename it.
  • Add or remove columns when needed.
  • Update the rows in the table to match your latest data rules.
  • Use Set unmapped values if missing values should fall back to one default value.

Export or remove a mapping

  • Open the mapping you want to use.
  • Click the export icon in the top bar to download the current mapping as a CSV file.
  • To delete a mapping, select it in the sidebar and click the trash icon.

Important things to know

These details help you avoid confusion while editing.

Saving and edit access

  • Mapping changes are saved automatically while you work in an editable draft.
  • You can only edit mapping when the interface version is editable.
  • If the interface is read-only or deactivated, you can view the mapping but not change it.
  • If a mapping is locked, BrynQ shows a warning and the mapping cannot be edited.

Tips for a clean mapping

  • Use short and clear mapping names.
  • Check that your source columns and target columns match the correct fields.
  • Review imported files before saving, especially when you select the delimiter or the first row option.
  • Remove old mappings that are no longer used so the interface stays easy to manage.

Additional information: - A mapping can contain multiple rows and multiple input and output columns. - Exported files are useful when you want to review a mapping outside BrynQ or reuse it later.

    • Related Articles

    • Map Fields Between Source and Target

      Summary: Map source values to target values so BrynQ can send the right data to the target app when the two apps use different field values. Requirements: - You need access to the interface you want to configure. - The interface must include a ...
    • Set Up Scenarios in a Template Interface

      Summary: Set up Scenarios in an interface template so BrynQ knows which data flow each template step supports, which fields are required, and which mappings users must complete. Requirements: - You need access to Admin portal and permission to manage ...
    • Complete Template Configuration

      Summary: Complete the setup of a BrynQ template interface by filling in the required tabs, checking the draft, and publishing it when it is ready. Requirements: - You need access to Interfaces. - You need permission to edit and publish the interface. ...
    • Interface Concepts and Lifecycle

      Summary: Learn what a BrynQ interface is, which states it can have, and how it moves from setup to live use. Requirements: - You need access to Interfaces to view interfaces. - You need the correct permissions to create, edit, publish, or run an ...
    • Create an Interface from a Template

      Summary: Create a new BrynQ interface by selecting a ready-made template and, when needed, activating the apps used by that template. Requirements: - You need the Create interfaces permission. - Your plan must have space for another interface. - If ...