How to Link and Map Fields Between Tools in Unito

To enable 2-way sync in Unito, users set up a field mapping table that links pairs of fields between connected tools. This determines how real-time updates occur.

What does this article cover?

What is a field mapping in Unito?

Fields represent the details of your work items (e.g., tasks, tickets, issues, contacts etc.) such as a title, description, attachment, label, status, etc. Users connect fields in different tools in the field mapping table of their flow. Each field mapping, or pair of fields, represents a connection created by Unito that allows information to update in either direction or both. This is what we mean by 2-way sync.

 For example, you can decide that labels and tags with different values actually represent the same information (e.g., a "prod" label in one tool and a "production" tag in another).

What are fields in Unito? Fields represent the details of each item in sync in your connected tools: title, description, assignee, attachment, etc. 

The field mapping table is found in the fourth step of the flow builder:

Group 1088499

Here's an example of a table of field mappings in Unito:

ServiceNow Jira fields-1

In this example, any field mappings with 2-way sync (represented by arrows moving in both directions) allow changes in either tool to update the other automatically.

What do the arrows mean? The directional arrows indicate if and how manual changes to one field will automatically update the paired field in your other tool.

Field mappings with an arrow pointing in only one direction represent a 1-way sync, so that manual changes in the source (e.g., the above ServiceNow Caller field to the Jira Reporter field) automatically update in the destination field, but not vice versa. So if the user were to modify the Reporter field in Jira, the ServiceNow Caller field would be unaffected.

Many fields are similar enough — such as comments or due dates — that you can tell Unito to map them automatically before selecting your fields manually. Once you reach the screen pictured above though, you'll have to choose individual field mappings. 

How to create a new field mapping

When editing your fields in Unito, click + Add mapping to create a new pair of linked fields.

Note: You can only have one pair of unassigned fields open at a time.

Select field mappings

Next, click Select a field for each tool and choose an option from the drop-down menu that matches the field type you want to link between items.

Select field mappings

Pick your first field, and Unito will automatically narrow down the possible choices in your other tool. Once you've chosen two fields, you can change the sync direction for that pair of fields.

Restrictions

  • Certain fields — like the description footer — can be mapped to multiple fields, while others can only be mapped once.
  • Other fields can only be mapped in a single direction depending on the tool or the tool's API. For example, in most cases attachments must always be synced to the description footer of the other tool and not to another attachment field.

How do I delete a field mapping in Unito?

To delete a field mapping in Unito, simply move your cursor over the mapping you want to remove and select the trash can icon on the right. 

Note: Deleting a field mapping will not delete any of the associated data.

Ex.: Deleting a field mapping for a board name synced to the description footer (pictured above) won't delete any board names or details already synced to description footers. It will simply prevent your flow from syncing those fields in the future.

How to change field sync direction

Each field has its own sync direction controls, much like flow direction. This controls the flow of information in synced pairs of work items.

  • With 1-way sync direction in all of your field mappings, data will only update automatically from one tool to the other as changes are made in the source tool.
  • With 2-way mappings, changes made in either tool will automatically update the other.

modnay servicenow fields

In this case, changes to any of these fields in either tool will update in the other tool, except for Number to Incident Number, and Link to Item which will only appear in the Description footer of the other tool but no changes to that description will affect the link. 

Understanding Sync Direction Limitations

When setting up sync direction for your field mappings, you may find some options greyed out. This is because they can only sync one way, due to technical limitations in the tools themselves or a lack of a corresponding field in the destination tool. In those cases, a workaround is to sync those fields to the description footer.

Here are a few examples of field mappings that can only be one-way:

  • Any mappings including a description footer

  • Mappings that include the name of a board, project, or repository

  • A mapping including an issue number

The exact mappings affected by this will depend on the tool pairing you're syncing. To test this out, try to add a new mapping.

How to edit a mapping

You can change one of the synced fields in your mappings by clicking on a field name and seeing if there are alternative fields to replace it with. Once you save your flow, Unito will then update your flow according to the rules you've set.

changing existing fieldsIn this example, we could imagine someone originally synced Priority to Importance, but then later decided that Importance matched better with the Labels field.

Adjusting field values (the gear symbol)

You can customize field mappings with labels, tags, or other types of statuses and drop-down fields with more precision.

Click on the cog (or gear) icon beside the fields with a drop-down list associated to them. You'll then see additional options or values within that field mapping. This is where you can decide how the different values of a drop-down field (usually statuses, states, or custom fields) in one tool correspond to a drop-down field in another. 

In the example above, I've built a flow between two Trello boards and told Unito that my red label in one board should match with the red label in another.

Here's another example with a custom field that includes a drop-down menu:

marketing content production to global marketing activation 1

There are a few things you can do here to customize this kind of mapping further:

  • Add a new pair: When you click on + Add more labels & labels you can add a new pair of mappings, and choose labels from both drop-downs, just like when you add a regular mapping.

  • Delete a pair: When you hover over a pair of mappings, a trash can will appear on the right, similar to main field mappings. Click on it to delete a mapping.

  • Build a group pairing: Did you know you can map multiple labels from one board to a single label on another? All you need to do is click on the plus sign on either side and add the label you want to map under the right group.

Why can't I map users?

To map users between tools, they must exist in both tools already with the same email address. If you've done this and users, assignees, or members still aren't syncing, you may need to take a few additional steps to map users and assignees.