ArcGIS Field Maps

Duplicate maps and forms for use in Field Maps

There are times when you may find yourself creating similar maps and forms for use in ArcGIS Field Maps. Maybe you’re transitioning into a new field season or perhaps you’re using the same editable feature layer across multiple maps. Rather than create each map and form from scratch, you can duplicate them to save time and ensure consistency in your operations. You can duplicate maps using the Field Maps web app, and you can copy forms between maps using ArcGIS API for Python or ArcGIS Online Assistant.

Duplicate a map

Duplicating a map is a simple way to create a new map based on an existing workflow or purpose. In the Field Maps web app (shown below), I have a map that was used for collecting information about crops in the spring.

Harvested Crops - Spring map card

With summer approaching, I want to create a new map with the same settings and form. To do this, I can duplicate the spring map. On the map card, I’ll click the Duplicate button. In the window that appears, I’ll title the duplicated map Harvested Crops – Summer and click Yes, duplicate.

Duplicate map window

The duplicate map is created and contains the same summary, feature templates, forms, and offline settings as the original map. Map areas and sharing settings are not preserved when duplicating a map.

Harvested Crops - Summer map card

Now I can open the summer map and make any slight adjustments needed for the new season. Once I share the map, it’s ready to go. For more information, see Duplicate a map.

Copy a form

Sometimes you may only need to copy the form from one map to another. For example, if the Harvested Crops – Summer map required different settings and additional reference layers, I could create a map from scratch and then copy the form for the editable layer from the spring map. Forms can be copied from one map to another using the copy_form_between_maps.py Python script or AGO Assistant.

Copy a form with a Python script

First, you’ll need to install ArcGIS API for Python if you haven’t done so already. Field Maps scripts require ArcGIS API for Python 1.8.4 or later. For installation instructions, see Install and set up ArcGIS API for Python.

Next, clone or download the Field Maps scripts GitHub repository to your machine. This is where the sample Python scripts and notebooks are hosted for Field Maps. In the terminal or command prompt, set the file path to the location of the repository folder:


cd C:\Users\<user_name>\Desktop\field-maps-scripts

Run the following command to create the virtual environment with the correct dependencies needed to run the script:


conda env create --file environment.yml

Next, activate the environment:


conda activate field-maps-scripts

Once you’ve activated the environment, you are ready to run the script.

The copy_form_between_maps.py script allows you to copy the form from one map to another. For the script to work, the source map and destination map must have the same feature service. You can run the script to copy the form for all editable layers in the map, or you can select specific layers. If there is an existing form in the destination map, it will be overwritten.

Before running the script, direct the file path to the scripts folder within Field Maps scripts:


cd C:\Users\<user_name>\Desktop\field-maps-scripts\scripts

The copy_form_between_maps.py script is as follows:


python copy_form_between_maps.py -org https//arcgis.com -u username -p password -source-map-id <source-map-id> -dest-map-id <dest-map-id> -layer-name <layer-name> --overwrite

Copy the script into a text editor, such as Notepad++, and edit the following parameters to match your own information:

Once you’ve edited the parameters, run the script in the terminal or command prompt. The form is copied to the destination map. For more information, see the copy form between maps readme.

Copy a form with AGO Assistant

Not familiar with Python? Don’t worry, you can also use AGO Assistant to copy the form. AGO Assistant is a tool developed to provide easy access to the underlying map and item .json files. AGO Assistant is meant for advanced users, so proceed with caution before editing the item .json file.

Browse to https://ago-assistant.esri.com/ and sign in to your account. Under I want to, select View an Item’s JSON.

View and Item's JSON

Search for the map you want to copy the form or forms from and select the map.

Search for source map

You’ll see two JSON editors, one for the item metadata (top) and one for the map definition (bottom). In the map definition, search for the layer containing the form and copy the formInfo JSON object.

Copy the formInfo JSON element

Now search for the map to which you’ll copy the form. Select that map and click Edit JSON. In the map definition, find the layer you want to apply the form to and paste the copied formInfo object.

Paste the formInfo JSON element

Save your changes. If you open the map in the Field Maps web app, you’ll see the copied form.

Additional information

These are three ways to save time by duplicating maps and copying forms. For more information about configuring maps for use in Field Maps, see Configure the map and Configure the form.

About the authors

Josh is a Product Writer with a background in geography and comparative literature. Originally from Georgia, Josh now works and lives in Portland, Maine. When he isn't writing for the field apps team, he enjoys reading and playing his bass clarinet.

Connect:

I am an Engineer on the Field Apps Team primarily focused on Workforce and Tracker. In my free time, you can often find me hiking, camping, or kayaking throughout Maine and New Hampshire.

Connect:

2
Leave a Reply

Please Login to comment
newest oldest
Anonymous
Anonymous

Thank you! We looked for this last week and couldn’t find it (because the blog wasn’t available yet). We were going nuts. Templates are due tomorrow for multiple services and this saved us.

Next Article

Customize your profile item gallery

Read this article