Automated email notification in ArcGIS Field Maps Designer

Field Maps Designer is a mobile solution integrated with ArcGIS Online, which allows users to capture the data on-site. On top of that, Field Maps Designer enables users to create notes, perform some inspections, and, most importantly, share all the information instantly with the office. In this article, I would like to pay attention to the automated email notifications, which can be done in Field Maps Designer. I was impressed by the video below, which shows nicely how to make it simple. However, sometimes, the situation requires a more advanced approach. One of them discussed in this short text is data filtration based on various inputs from a questionnaire. First, we can follow up on the video below and create the standard connection, to which other sample features will be added later.
1. After setting up your Make account or logging in, hit the Create New Scenario button, as shown in the image below (Pic. 1).

Integromat Make creating new scenario
Pic. 1 Creating a new scenario with Make (former Integromat) platform.

 

2. When the list of various apps appears, there is a search box at the bottom. Once you start typing the Field Maps Designer (1), it should appear at the top with all the built-in features. We must choose Watch Features (2), as the tool will now monitor all the site workers’ changes.

Make Integromat Field Maps Designer watch features
Pic. 2 shows the Field Maps Designer built-in options in the Make (former Integromat) automation platform, where 1 is the search box, and 2 is the proper feature selection.

 

     3. The Watch Features option requires establishing the correct Webhook (Pic. 3). You might have an existing one, but it might not necessarily work for your current situation. In this case, It would be advisable to Add a new connection (1). Here, you need to provide the correct URL of your ArcGIS Online platform. Each ArcGIS Online account has its separate URL address like your_account_name.maps.arcgis.com(2). Your ArcGIS Online web address should be recognized shortly by the Make platform and saved to the list. Since the Make platform recognized and approved your connection, you should be able to see all the feature-hosted layers created at your ArcGIS Online account (3). Select the one that you would like to sync with your email box. When the Create a Webhook box opens, look at the three options beneath. They apply a separate situation on which your notification will be based. I could trigger it only when my features are created or modified. You can use it in all situations if you want. Click Save when you are happy with everything (5).

Creating connection with Field Maps Designer - Make
Pic. 3 Setting up the Field Maps Designer connection, where: 1 – Existing connections; 2 – Adding new connection; 3 – List of feature layers assigned to the connection; 4 – List of triggered events; 5 – Saving new webhook.

 

    4. Once your Field Maps Designer webhook is ready, you need the Iterator to trigger the requested action. The Iterator can be added from the Flow Control icon in the bottom bar (Pic. 4). It will come out randomly near the Field Maps Designer icon, and you can drag it everywhere. The number next to the icon indicates that the Iterator cannot end your automation process.

Integromat Make adding iterator
Pic. 4 Adding Iterator in Make (former Integromat) automating platform.

 

The opened-end wrench icon is worth attention because it allows us to adjust the circumstances of the Iterator process. Before we do it, our Iterator must be configured (Pic. 5). In other words, the item must know which specific data to focus on. By clicking it, the Array box opens (1), where all the fields assigned to the linked layer should appear.

Integromat make setting up the iterator
Pic. 5 Configuring the Iterator mode in Make (former Integromat) automation platform, where: 1 -Defining the Array; 2 – The field selection; 3 – Saving the configuration

 

This is the second level of specification, where we must determine the field on which the automatic email notification will be based within the given layer (2). When the configuration is completed (3), you can see that the work targets features and their attributes. When any change is provided, the Iterator reflects it in action. Because our field is already specified, we can use the aforementioned open-ended wrench icon to provide relevant filters.
The video below doesn’t cover the filtering option but only applies to the situation when we want the action triggered by a particular value. The preparation of filtering is shown well in the image below (Pic. 6).

Integromat Make setting up the iteration filter
Pic. 6 Setting up the filter in Iteration, where: 1 -Setting up the filter; 2 – Finding the proper field (question); 3 – Dragging selected question to the Conditions section; 4 – Defining the value for the Condition; 5 – Applied changes (Filter icon).

 

Once the opened-end wrench icon is clicked, you should see the dropdown in which the Filter option can be found (1). The Filter option can be set up from all the questions (fields) in the selected layer (2). Whilst one of them is dragged to the Set up a Filter box (3), we should determine the exact Condition. Initially, your Text operators are Equal to, although you can define other circumstances. Indeed, I left it untouched and provided the field value to which the text operator must fit correctly. When everything is done, the icon between the Field Maps Designer and Iterator signs changes to the filter-looking shape (5).

     5.  Find the Email (or Outlook) module and add it to the scenario (Pic. 7). You can see the plus appearing just right of the Iterator sign (1). Use it to populate the list of applications the Make collaborates with and find the Outlook application like you did before with Field Maps Designer. Next, choose Create and Send a Message mode (2).

Adding outlook element to Field Maps Designer scenario
Pic. 7 Adding the Microsoft Outlook element to the Field Maps Designer scenario, where: 1 – Add another module; 2 – Choose the Create and Send a Message option.
Integromat Make configure Outlook element
Pic. 8 Configuring Outlook element in Make (former Integromat) automation platform, where: 1 – 6 Selection of fields (questions) for Body Content.

 

You can see the box with Outlook email configuration details by opening Create and Send a Message. These details cover the Body Content, where you can build up the HTML-based content plotted with the variables. These variables are fields (questions) included in the selected layer. Using the Watch Features section, we can drag and drop the given fields where we want.

Integromat Outlook configuration details
Pic. 9 The details of Outlook configuration in Make (former Integromat) automation platform, where: 1 – The Subject name; 2Body Content; 3 – The importance level; 4 – The email options; 5 – The Attachments option.

 

The notification will be flagged with a red interjection when the importance is high. The attachments option, which is discussed later in this text, is also enjoyable. We are done with the basic scenario by saving the Outlook settings. It’s enough to run automatic notifications. However, there are some ways in which this scenario can be expanded.
6. We can equip it with relevant attachments. I will discuss the most common one, the .pdf file, including some basic data about an object. The image below (Pic. 10) shows how to do it.

Integromat Make PDF attachment
Pic. 10 Creating the PDF module in Make (former Integromat) automation platform.

 

You can always see the opened-end wrench icon halfway between one module and another, which, after expanding, gives you some options (1). This time, we can add a module instead of applying a filter. Next, the finding and selection of existing apps are the same as usual (2). If too many are in the application scope, an analog search can be done for modules (3). Let’s consider the PDF.co app for creating the .pdf files for us. Continuing the HTML-based thread, we can use the Convert HTML to PDF module, which must be configured on the same basis as the Outlook app (Pic. 11).

Integromat PDF attachment configuration
Pic. 11 The PDF attachment module configuration in Make (former Integromat) automating platform, where: 1Convert options (HTML to PDF selected); 1B – Input HTML Code; 2 – Output File Name; 2B – Output File Name code; 3 – Print & Page options; 4 – Export Type.

 

The interface is analog; the Convert Type comes as the first (1), and we use HTML to PDF, although there are other options where the URL to PDF can be interesting. The same applies to Outlook configuration; the Input HTML Code is required and works similarly (1B). The Output File Name (2) can also be fetched with field variables (2B). Other options refer to the paper properties (3). Finally, our file can be downloaded or converted into JSON format (4).

Make scenario ready
Pic. 12 The Make (formerly Integromat) scenario is ready to use! We need to save it and select the preferable option for data collection.

 

Finally, our scenario becomes completed (Pic. 12). It must be saved before use (1). Finally, we need to specify the method of obtaining the data. The process can be Run Once (2), although it is advisable to turn on the Immediately as data arrives option (3). Other options exist, like At Regular Intervals, Once, Every Day, and so forth.

7. We can now run our Make scenario and add or edit data in the ArcGIS Field Maps Designer Mobile App (Pic. 13-15).

Make Integromat running module
Pic. 13 Running module in Make (former Integromat) automated platform.

 

Adding new features to Field Maps Designer
Pic. 14 Adding new features to Field Maps Designer.

 

Integromat Make final email notification
Pic. 15 Final email notification about the specific value occurrence in Field Maps Designer.

 

As you can see, the email with your changes comes almost instantly. Sometimes, you must wait a few minutes until the Waiting for data process is completed. If more than one occurrence is found throughout this time, you might see more separate emails accordingly. The emails are kept simple. You will always be the email’s author because it’s being sent from your Make account. As per earlier discussion, the leading receiver can change (Pic. 8). On the left-hand side (Pic. 15), you have a sort of confirmation that the attachment has been generated correctly.
This is only an example of expanded automated notification features, which every user can create on his own when using the Make automation builder. The Make (former Integromat) offers many more options, and more robust scenarios can be produced. On top of that, the product is still being developed. Currently, fetching ArcGIS Online layers with image attachments is impossible, but I hope it will change soon.  The example above describes the simple scenario that can be used to make successful automated bits for your work with the ArcGIS Online Field Maps Designer app. You don’t need to pay anything, as the Make (former Integromat) lets you produce two scenarios for free. I will come back and demonstrate another Make scenario in the future.

Mariusz Krukar

 

Links:

  1. https://www.esri.com/arcgis-blog/products/field-maps/field-mobility/from-desk-to-field-in-5-easy-steps-with-field-maps-designer/
  2. Make.com – The Main (former Integromat) page

 

Forums:

  1. https://community.make.com/t/failed-to-verify-connection/2816

Youtube:

 

Leave a Comment