esri / field-maps-scripts

A set of scripts and notebooks to help administer maps and workflows for ArcGIS Field Maps.

Field Maps Scripts

A set of Python scripts and notebooks to help configure maps and manage data for ArcGIS Field Maps.

Features

Scripts

Functionality	Script
Copy Form Between Maps	copy_form_between_maps.py
Download Attachments from Feature Layer	download_attachments.py

Notebooks

• Add Field Maps App ID to ArcGIS Enterprise
• Bulk Update Maps for Use in Collector or Field Maps
• Field Apps Deployment Using Python
• Generate PDF Report
• Add GPS Metadata Fields (Pro)
• Add GPS Metadata Fields
• Configure Search
• Location Sharing Status
• Create Offline Areas from Feature Layer

Requirements

• Python 3.6+
• ArcGIS API for Python 1.8.4+
• ArcGIS Field Maps (web and mobile applications)
• ArcGIS Pro 2.5+ (Add GPS Metadata Fields (Pro) only)

Instructions

This repository requires the ArcGIS API for Python version 1.8.4 or greater to run. We recommend setting up your local environment via Anaconda.

1. Install Anaconda
2. Run conda env create --file environment.yml to create the virtual environment with the correct dependencies
3. Run conda activate field-maps-scripts to activate the environment
4. (Optional - dev only) Configure pre-commit to run flake8 linting on pushes
   • pre-commit install --hook-type pre-push

Resources

• ArcGIS Field Maps
• ArcGIS API for Python

Issues

Although we do our best to ensure these scripts and notebooks work as expected, they are provided as is and there is no official support.

If you find a bug, please let us know by submitting an issue.

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

Licensing

Copyright 2022 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's LICENSE file.

field-maps-scripts's Issues

Add GPS Metadata Capture Domains

Describe the bug
If I try to run the Add GPS Metadata capture for line and polygon layers on an existing line hosted feature layer that has a missing domain, the notebook fails to update with the error

To Reproduce

1. Create a new line hosted feature layer on ArcGIS Online with no GPS metadata fields.
2. Run the notebook to create the GPS metadata fields.
3. Through ArcGIS Online, click delete list in the field properties for Worst fix type.
4. Re-run the script.
5. Error pictured above is shown, domain is not updated.

Expected behavior
The missing domain for Worst fix type should be added back.

Virtual environment issue

Running conda env create --file environment.yml to create the virtual environment completes successfully (link to full terminal output), however when trying to run proswap field-maps-scripts I get the following error:

proswap: C:\Program Files\ArcGIS\Pro\bin\Python\envs\field-maps-scripts environment doesn't appear to contain ArcGIS Pro

In ArcGIS Pro when I go to Package Manager > Environment Manager I get the following error:
Broken Environment. Cannot be activated.

Additionally when activating the environment in the Python Command prompt I also get this message:

(arcgispro-py3) C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3>activate field-maps-scripts
Current directory is another environment, changing directory to active environment.

(field-maps-scripts) C:\Program Files\ArcGIS\Pro\bin\Python\envs\field-maps-scripts\etc\conda\activate.d>rem proj-data is installed because its license was copied over

Is there anything I'm missing? Any help will be appreciated.

To Reproduce
Steps to reproduce the behavior:

1. Install ArcGIS Pro 3.0
2. Run conda env create --file environment.yml to create the virtual environment with the correct dependencies
3. Run activate field-maps-scripts to activate the environment
4. Run proswap field-maps-scripts to activate the environment
5. See error
6. Open ArcGIS Pro, go to Package Manager > Environment Manager
7. See error

Expected behavior
A working virtual environment which can be activated in ArcGIS Pro.