Overview
Data mapping in Tines is about connecting the data you receive to the places where it’s needed in your workflow. This is done using reference paths, which allow you to pinpoint exactly where the data you want is located within the incoming event data.
When Tines receives data (often in JSON format) from another system, you need to map the incoming fields to the correct spots in your workflow. This is done using reference paths; like giving Tines directions to find the data in the JSON response.
Tines references
Before getting started, we recommend familiarizing yourself with the surrounding functionality this article covers:
Make it happen
Scenario
Reference employee data from a previous action.
Copy (
CMD + c) the JSON block provided below and paste (CMD + v) it onto the storyboard (these are action tiles and will auto-populate!).Click the “Employee” action tile.
Review the JSON structure of this action via the Payload Builder in the right config panel to familiarize yourself with the data it will pass.
Click the “Referencing Data” action tile.
Review the Payload Builder of this action as well. Notice how the Value pills are referencing the upstream “Employee” action tile’s JSON paths.
Click back to the “Employee” action tile.
Click Run.
Once the flow has finished, compare the Events of both actions and see how the upstream data is being referenced in the “Referencing Data” action.
Actions
{"standardLibVersion":"82","actionRuntimeVersion":"32","agents":[{"disabled":false,"name":"Employee","description":null,"options":"{\"mode\":\"message_only\",\"loop\":false,\"payload\":{\"user\":{\"name\":\"Angie\",\"email\":\"angie@tines.io\",\"profile\":{\"city\":\"Boston\"}}}}","position":{"x":165,"y":285},"type":"eventTransformation","timeSavedUnit":"minutes","timeSavedValue":0,"monitorAllEvents":false,"monitorFailures":false,"monitorNoEventsEmitted":null,"caseConfiguration":{"subStatus":null,"tags":[]},"recordType":null,"recordWriters":[],"form":null,"createdFromTemplateGuid":null,"createdFromTemplateVersion":null,"templateTags":[],"originStoryIdentifier":"cloud:0a13dfc5dbb71212cab0ad314b7fe531:f0064f807ac02bf877a6ff31d9b76916"},{"disabled":false,"name":"Referencing Data","description":null,"options":"{\"mode\":\"message_only\",\"loop\":false,\"payload\":\"The user's name is <<employee.user.name>>. Their email address is <<employee.user.email>>. They work at the <<employee.user.profile.city>> office.\"}","position":{"x":165,"y":375},"type":"eventTransformation","timeSavedUnit":"minutes","timeSavedValue":0,"monitorAllEvents":false,"monitorFailures":false,"monitorNoEventsEmitted":null,"caseConfiguration":{"subStatus":null,"tags":[]},"recordType":null,"recordWriters":[],"form":null,"createdFromTemplateGuid":null,"createdFromTemplateVersion":null,"templateTags":[],"originStoryIdentifier":"cloud:0a13dfc5dbb71212cab0ad314b7fe531:f0064f807ac02bf877a6ff31d9b76916"}],"links":[{"sourceIdentifier":"0","receiverIdentifier":"1"}],"diagramNotes":[]}