"},{"ID":349442,"user_firstname":"Chris","user_lastname":"Dunn","nickname":"Chris","user_nicename":"cdunn","display_name":"Chris Dunn","user_email":"cdunn@esri.com","user_url":"","user_registered":"2023-11-28 19:54:05","user_description":"Chris Dunn is a Sr Product Engineer on the Field Maps team. He works closely with Product Managers, other Product Engineers, Designers, and Developers to ensure Field Maps continues to be a high quality mobile GIS application. He loves seeing the amazing ways users solve problems using Esri technology and he wishes Arcade existed back when he worked as an analyst using ArcMap 9.3.","user_avatar":"
"}],"short_description":"A quick look at how to get started using Arcade in ArcGIS Field Maps.","flexible_content":[{"acf_fc_layout":"content","content":"ArcGIS <\/span>Field Maps<\/span> <\/span><\/a>is <\/span>an all-in-one app that uses data-driven maps and mobile forms to help workers perform data capture and editing, find assets and information, and report their real-ti<\/span>m<\/span>e locations. ArcGIS <\/span>Arcade is <\/span>a portable, lightweight, secure<\/span>, and geospatial<\/span> expression language used to create custom content in ArcGIS <\/span>applications<\/span>.\u00a0<\/span>\u00a0<\/span><\/span>\u00a0<\/span><\/p>\n Arcade\u2019s portability allows it to be used across the ArcGIS system. For example, a popup created in ArcGIS Pro can be shared to ArcGIS Online and the functionality will remain consistent between the two applications. Arcade is lightweight in that it\u2019s not a full programming language<\/span>\u2014<\/span>it\u2019s closer to a spreadsheet cell calculation. It\u2019s easy to use, but it\u2019s also very powerful and runs quickly. Because it\u2019s not a full programming language, it\u2019s secure, and the security of your systems can\u2019t be compromised by Arcade. Arcade is geospatial, which means you can access GIS information and query items using spatial methods in your expressions. <\/span>\u00a0<\/span><\/p>\n What are some of the benefits of using Arcade in your GIS? First, it\u2019s easy to get started. We have extensive documentation online, and if you haven\u2019t visited the Arcade Resources<\/a><\/span>\u00a0page recently, you might want to take a look, as we have revamped the site so it\u2019s more intuitive, especially for those who may be new to Arcade. There are also lots of sample expressions on GitHub<\/a><\/span>\u00a0to help you get started. Getting started with Arcade can be as simple as writing a one-line expression, allowing you to start small.<\/span>\u00a0<\/span><\/p>\n Using Arcade means you can calculate outputs on the fly. This is especially helpful if you have data that changes <\/span>frequently<\/span><\/span>\u2014<\/span><\/span>you <\/span>don\u2019t<\/span> have to go into the table on the backend and run field calculations each time data is updated. This can be <\/span>useful <\/span>when creating<\/span> symbology and labels to draw attention to locations or assets that need to be addressed quickly. Th<\/span>is<\/span> also means you <\/span>don\u2019t<\/span> have to worry about changing your schema. For example, if you want to add information in your pop<\/span>–<\/span>ups <\/span>that<\/span>\u2019<\/span>s<\/span> a concatenation of two fields, <\/span>you<\/span>\u2019ll<\/span> need to go through the <\/span>whole process<\/span> of adding a new field and running the field calculator. With Arcade<\/span>,<\/span> you can create expressions that will give you the same results without having to do all the messy work on the backend. That also means you <\/span>don\u2019t<\/span> have to own the data <\/span>you<\/span>\u2019<\/span>re<\/span> working with. For example, if you add a demographic layer from ArcGIS Living Atlas of the World to your map<\/span>,<\/span> you can still use Arcade to help you symbolize that data to meet your needs a<\/span>nd<\/span> you can use calculations on fields in that layer for your pop<\/span>–<\/span>ups and labels.<\/span><\/span>\u00a0<\/span><\/p>\n Before we get into the details of where and how you can use Arcade, let\u2019s go over a few of the basics of the Arcade Editor<\/strong>. You can build, test, name, and reuse expressions, access variables and functions, and view suggestions and help for improving your expressions.<\/span>\u00a0<\/span><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":2193412,"id":2193412,"title":"Expression Window","filename":"Expression-Window.jpg","filesize":32297,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/field-maps\/field-mobility\/arcgis-field-maps-get-started-with-arcgis-arcade\/expression-window-2","alt":"Arcade Editor found in ArcGIS Online and ArcGIS Enterprise.","author":"285382","description":"Arcade Editor","caption":"","name":"expression-window-2","status":"inherit","uploaded_to":2193212,"date":"2023-12-12 15:09:17","modified":"2023-12-12 15:43:57","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":847,"height":643,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window.jpg","medium-width":344,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window.jpg","medium_large-width":768,"medium_large-height":583,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window.jpg","large-width":847,"large-height":643,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window.jpg","1536x1536-width":847,"1536x1536-height":643,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window.jpg","2048x2048-width":847,"2048x2048-height":643,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window-613x465.jpg","card_image-width":613,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Expression-Window.jpg","wide_image-width":847,"wide_image-height":643}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" The variables<\/span> in the <\/span><\/span>Arcade Editor<\/span> <\/span><\/strong>are helpful for pulling in information from the layers and tables in your map and even those that <\/span>aren\u2019t<\/span> in your map. <\/span><\/span>Variables<\/span><\/span><\/span> are <\/span>the<\/span> attributes that you want to u<\/span>se<\/span> with your Arcade expressions. <\/span><\/span>Functions<\/span><\/span><\/span> allow you to do something with those variables – for example, <\/span>change<\/span> all caps text to title case, meaning only the <\/span>first letter of each word is capitalized. Functions are listed by type<\/span>,<\/span> such as constants, date, geometry, <\/span>text<\/span>, and <\/span>more.<\/span> Functions are also searchable, so you <\/span>don\u2019t<\/span> need to scroll down <\/span>a long list<\/span> if you know what <\/span>you<\/span>\u2019re<\/span> looking for. <\/span><\/span>The <\/span><\/span>H<\/span>elp<\/span><\/span><\/strong> panel <\/span>open<\/span>s<\/span> the Arcade documentation site with more information<\/span> on how to work with Arcade<\/span>.<\/span> Looking back at the <\/span>e<\/span>xpression <\/span>w<\/span>indow for a moment, when writing your expressions, you can take advantage of the <\/span>I<\/span>ntellisense<\/span> feature<\/span><\/span>\u2014a<\/span><\/span><\/span>s you type<\/span>,<\/span> I<\/span>ntellisense<\/span> will make recommendations based on what you have <\/span>entered <\/span>in<\/span> the editor.\u00a0<\/span><\/span>\u00a0<\/span><\/p>\n Where can you use Arcade? The short answer is across the ArcGIS system, and most functionality is available even when you\u2019re working offline. You can use Arcade in ArcGIS mobile apps such as ArcGIS Field Maps, ArcGIS Workforce, and ArcGIS Navigator. You can use Arcade in web maps in ArcGIS Online and ArcGIS Enterprise as well as in mobile map packages (MMPKs), and Arcade is also available in ArcGIS Pro. <\/span>\u00a0<\/span><\/p>\n How can you use Arcade in ArcGIS Field Maps? You can use Arcade expressions to alter symbology, format labels, extend pop-ups, and improve smart forms. For example, you can use Arcade to do the following:<\/span>\u00a0<\/span><\/p>\n By using Arcade to modify symbology, we can create categories from a single field<\/span>\u2014such as<\/span>\u00a0in this example expression using a date calculation to show how recently an area with an invasive species of plants was treated:<\/span>\u00a0<\/span><\/p>\n"},{"acf_fc_layout":"sidebar","content":"","image_reference":false,"layout":"code_snippet","image_reference_figure":"","snippet":"\/\/Create variables for today and treatment date (Date)\r\nvar todayDate = today();\r\nvar treatmentDate = $feature.TreatmentDate;\r\n\r\n\/\/Create variable for last treatment - datediff, days\r\nvar lastTreatment = DateDiff(todayDate, treatmentDate, 'days');\r\n\r\n\/\/If statement Recently Treated less than 30 days, Needs Treatment 31-89 days, Treatment Overdue over 90 days\r\nIf(lastTreatment = 30 && lastTreatment < 90){\r\n return 'Needs Treatment'\r\n}else{\r\n return 'Treatment Overdue'\r\n}\r\n","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"image","image":{"ID":2193762,"id":2193762,"title":"Invasive Species Legend","filename":"Invasive-Species-Legend.jpg","filesize":13963,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/field-maps\/field-mobility\/arcgis-field-maps-get-started-with-arcgis-arcade\/invasive-species-legend","alt":"Resulting legend with symbology based on treatment status.","author":"285382","description":"Legend with symbology created by an Arcade expression.","caption":"","name":"invasive-species-legend","status":"inherit","uploaded_to":2193212,"date":"2023-12-12 15:39:58","modified":"2023-12-12 15:43:30","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":448,"height":277,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","medium-width":422,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","medium_large-width":448,"medium_large-height":277,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","large-width":448,"large-height":277,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","1536x1536-width":448,"1536x1536-height":277,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","2048x2048-width":448,"2048x2048-height":277,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","card_image-width":448,"card_image-height":277,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Invasive-Species-Legend.jpg","wide_image-width":448,"wide_image-height":277}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" You can also use Arcade to format rich text labels with simple calculations, such as converting miles per hour to kilometers per hour. Or you could classify your data into categories, such as in the treatment area example above. <\/span>\u00a0<\/span><\/p>\n Since we are looking specifically at Field Maps, here are a few tips about labels and mobile apps. It\u2019s important to keep your audience and their devices in mind when creating maps and map elements. Large labels can quickly overrun a small screen on a phone or tablet. With so much functionality at your fingertips with Arcade, it\u2019s sometimes tempting to do all the things. But since we are dealing with reduced screen real estate, you\u2019ll want to keep your labels short and to the point. Use your symbology in conjunction with your labels to show more information in a small space. If you have lots of information to share in your maps, consider using pop-ups to supplement your labels. <\/span>\u00a0<\/span><\/p>\n Pop-ups are a great place to take advantage of Arcade\u2019s functionality, either by using Arcade exclusively or in conjunction with other content such as text boxes, charts, images, or field lists. Here is an example of how you can use three Arcade expressions to add useful data-driven information to a pop-up. For the first expression (shown below), we measured the herbicide treatment area in square feet and rounded the result. In the second expression, we measured the distance from the centroid of the treatment area to the nearest trail. For the third expression, we calculated the name of the nearest trail to the treatment area. Then using a text box, all of this information was added to the pop-up in two short plain text sentences. <\/span>\u00a0<\/span><\/p>\n"},{"acf_fc_layout":"sidebar","content":"","image_reference":false,"layout":"code_snippet","image_reference_figure":"","snippet":"\/\/Round the area in square feet to 2 decimal points\r\nRound(Area($feature, 'square-feet'), 2);","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"sidebar","content":"","image_reference":false,"layout":"code_snippet","image_reference_figure":"","snippet":"\/\/Call the Trail Inspection layer as a feature set\r\nvar trails = FeatureSetByName($map, \"Trail Inspections - GreenwayTrails\");\r\n\r\n\/\/Create a variable for the nearest trail to the treatment area using a 500ft buffer\r\nvar nearestTrail = First(Intersects(trails, BufferGeodetic($feature, 500, \"feet\")));\r\n\r\n\/\/Find the centroid of the treatment area\r\nvar treatmentCentroid = Centroid($feature);\r\n\r\n\/\/Find the trail nearest to the treatment area using NearestVertex\r\nvar result = NearestVertex(nearestTrail, treatmentCentroid);\r\n\r\n\/\/Round the resulting distance to 2 decimals\r\nreturn Round(result.distance, 2);","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"sidebar","content":"","image_reference":false,"layout":"code_snippet","image_reference_figure":"","snippet":"\/\/Call the Trail Inspection layer as a feature set\r\nvar trails = FeatureSetByName($map, \"Trail Inspections - GreenwayTrails\");\r\n\r\n\/\/Create a variable for the nearest trail to the treatment area using a 500ft buffer\r\nvar nearestTrail = First(Intersects(trails, BufferGeodetic($feature, 500, \"feet\")));\r\n\r\n\/\/Return the name of the nearest trail\r\nreturn nearestTrail.Name;","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"image","image":{"ID":2194422,"id":2194422,"title":"Pop-up using Arcade elements","filename":"Pop-up-using-Arcade-elements.jpg","filesize":65152,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/field-maps\/field-mobility\/arcgis-field-maps-get-started-with-arcgis-arcade\/pop-up-using-arcade-elements","alt":"Pop-up using Arcade elements in ArcGIS Online","author":"285382","description":"Pop-up using Arcade elements in ArcGIS Online","caption":"","name":"pop-up-using-arcade-elements","status":"inherit","uploaded_to":2193212,"date":"2023-12-12 17:03:44","modified":"2023-12-12 17:04:17","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":936,"height":606,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements.jpg","medium-width":403,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements.jpg","medium_large-width":768,"medium_large-height":497,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements.jpg","large-width":936,"large-height":606,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements.jpg","1536x1536-width":936,"1536x1536-height":606,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements.jpg","2048x2048-width":936,"2048x2048-height":606,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements-718x465.jpg","card_image-width":718,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-using-Arcade-elements.jpg","wide_image-width":936,"wide_image-height":606}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" You can use Arcade to create conditional logic and calculations to make your forms more streamlined and user-friendly for those collecting data in the field. Examples include calculating a total dollar amount from a damage assessment or using conditional visibility to only collect the data that\u2019s needed. As of the February 2023 release, you can also set logic for conditional editing and conditional required. With conditional editing, you can set fields to be editable or read only. And conditional required allows you to set fields to be required, only when certain conditions are met.<\/span>\u00a0<\/span><\/p>\n Up until this point, we\u2019ve been focusing on how to set up map elements for use in Field Maps. We saw some pop-up examples and how to use Arcade to help streamline your data collection in the field. But what does it all look like when you are out in the field and viewing it on your mobile device? Looking at our trails and invasive species example again, here is what you can expect from a mobile view:<\/span>\u00a0<\/span><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":2194702,"id":2194702,"title":"Pop-up with Arcade Elements on mobile device","filename":"Pop-up-with-Arcade-Elements-on-mobile-device-e1702560829897.jpg","filesize":112266,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-e1702560829897.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/field-maps\/field-mobility\/arcgis-field-maps-get-started-with-arcgis-arcade\/pop-up-with-arcade-elements-on-mobile-device","alt":"Pop-up with Arcade Elements on mobile device","author":"285382","description":"Pop-up with Arcade Elements on mobile device","caption":"","name":"pop-up-with-arcade-elements-on-mobile-device","status":"inherit","uploaded_to":2193212,"date":"2023-12-12 17:23:47","modified":"2023-12-12 17:24:02","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":300,"height":633,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-e1702560829897.jpg","medium-width":124,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-e1702560829897.jpg","medium_large-width":300,"medium_large-height":633,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-e1702560829897.jpg","large-width":300,"large-height":633,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-728x1536.jpg","1536x1536-width":728,"1536x1536-height":1536,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-e1702560829897.jpg","2048x2048-width":300,"2048x2048-height":633,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-220x465.jpg","card_image-width":220,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/12\/Pop-up-with-Arcade-Elements-on-mobile-device-512x1080.jpg","wide_image-width":512,"wide_image-height":1080}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" As you\u2019ve seen, Arcade can be used to create powerful, dynamic, impactful maps that guide mobile workers, giving them additional context or simplifying and automating complex workflows. Using Arcade in ArcGIS Field Maps can be broken down into two broad categories \u2013 maps and smart forms. Now that we\u2019ve seen symbology and label examples, here are a few additional examples of how Arcade can be used to improve maps for mobile workers:<\/span>\u00a0<\/span><\/p>\nArcade Basics<\/span>\u00a0<\/span><\/h2>\n
Use Arcade with Field Maps<\/h2>\n
\n
Symbology and labels<\/h2>\n
Tips for mobile apps<\/h2>\n
Pop-ups<\/h3>\n
Smart forms<\/h3>\n