Text page
Welcome to the sixth and final unit of the “Setting up my first scenario” course.
In this unit you are going to start bringing everything together and explore mapping items.
The aim of this unit is to map items from one module to another.
As in previous modules, ensure that you have your Make Foundation Use Case open. You will be adding more to it in this session!
If you have not created this yet, you should access the previous units and build out the scenario.
Text page w/landscape image
To keep this question relevant to what you have built in your scenario so far, mapping involves generating items of information from one module, and telling Make where you want the information to appear in the next module(s).
For example:
- In the Weather app you want to take the description of the weather
- You would like this item of information to appear within the first row on your spreadsheet
In order to do this, you need to map the data from the first module (source) into the second one (destination).
This is the equivalent of a map that plots a journey, with a destination at the end of it.
CAROUSEL - 6- IMAGE - PORTRAIT
We’re going to split this task into two halves. Make sure that you follow this task at your own pace. The first part is identifying the items that you can map.
Generating a bundle / consume a credit
On the Weather app, right-click and click Run this module only. As this is your source module, it will generate a bundle of information for you.
Generating a bundle and performing an operation
When you have clicked Run this module once, there are two things to review here:
A thought bubble will appear next to Weather containing a 1. This means that:
- You have performed an operation and consumed a credit
- You have generated at least one bundle
Click the + and you will be able to see the bundle, and the items it contains.
What’s in the bundle?
There are two sets of information here.
- Number 1 - your input bundle might look familiar - it shows the configurations you entered into the Weather module, such as the city name.
- Number 2 - this shows your output bundle. Every item here can be mapped in the next module(s).
Note: Some items contain a
+, this is known as a collection/array, and it means that there are multiple items that can be mapped here. You will learn more about collections and arrays later on.
Click the + next to Coordinates / Wind to see what other items you are able to map.
This concludes the first task.
CAROUSEL - 6- IMAGE - PORTRAIT
This forms the second part of the exercise. Please work through each option.
Where to map your items
You now know from the previous page which items you can map from the Weather module. Now let’s look at where you are going to map them to in your target module.
NOTE: it would be useful if you opened the Make Foundation scenario Google Sheet that you created earlier for this exercise. Ensure that you have selected your Make Foundation Use Case from the Google Sheets module.
Within Make, open the module Google Sheets → Add a Row. This will load the configuration page.
Scroll down on the configuration panel to Values - you will see several fields that say A, B, C, etc. These correspond with the columns in your Google Sheet.
Click the plus icon in the field labeled A - you will be greeted with the fields that you can map. Does this look familiar? It should; these are the items from your bundle. This is real data that you have generated.
You can select one or many of the items here and it will process that information into row A on your Google Sheet.
When you select any of these items, they will be mapped to the chosen field. You can select an item by either clicking on it, or dragging and dropping it.
Mapping items
To complete this exercise, you are going to map four different items to your Google Sheet.
- For Column A, select Sunrise
- For Column B, select Temperature
- For Column C, select Status
- For Column D, select Description
Click OK and then save your scenario.
Text page w/landscape image
TIP: Viewing the Source of Your Items
Before you continue, a quick note on the source of your items – reopen the configuration for the module Google Sheets → Add a Row, and hover over any of the items in your bundle on row A.
Do you see what is happening with the Weather app? It will start to pulsate.
This is an incredibly useful visual reminder for when you start to build other modules later. It shows where the source of your mapped item is coming from, which will be especially useful when you start to build more complex scenarios with more modules, and different sources of data.
Text page w/landscape image
The next course will cover running your scenario in more depth. However, you’re ready to run your first automation now.
It would be beneficial to have your Google Sheet open in another tab / screen, to see what happens.
Click the Run once button, and look at your Google Sheet, you will see that it now has content.
This is what you have mapped from the Weather app.
Congratulations - you have just run your first scenario!
Text page
This concludes unit six. You can now map items within your scenario.
By now you should have an understanding of:
- What an item is
- How to generate a bundle
- How to map items
- How our mapped items appear in our destination
Great work! You should take all this newly learned information into the last unit of this course: Check your learning.