1. Introduction
QuickCapture Esri Labs is graduating into a fully supported ArcGIS product. ArcGIS QuickCapture is planned to be released on June 25, 2019 and its Esri Labs version will be retired a that time.
If you are new to ArcGIS QuickCapture and are looking for information into how to configure the app, we strongly recommend you start with the official ArcGIS QuickCapture app in our Esri Early Adopter Program at: https://earlyadopter.esri.com/key/ArcGISQuickCapture
If you are already using ArcGIS QuickCapture Esri Labs, you will also find detailed information in the Early Adopter Site about how to migrate your existing projects from ArcGIS QuickCapture Esri Labs to ArcGIS QuickCapture.
This mobile app is designed to help rapid data capture. It allows you to capture the location of assets or incidents as described in a predefined list of GIS feature types. You can use this app, for example, to capture the location of assets along a road while traveling in the passenger seat.
Project setup workflow: https://www.youtube.com/watch?v=yEHrZhbzGMA
- Tap on a button to add a point with the feature template associated with your button
- New points are kept locally in the device. The number of points captured is represented in the top-right corner.
- Tap on the upload button (top-right corner) to upload to your service (only available if connected)
- Tap and hold over the coordinates at the bottom to open a small map centered at your location (works only while online)
- The Delete Last Point... deletes the last point captured
- The mobile app beeps when you add or delete a point
The QuickCapture app makes use of the information contained within a feature service's editing templates (i.e. feature templates), with each feature template in the service being shown in QuickCapture as a new button. Template style and attribute properties determine how the button displays and behaves. For more information on feature templates see: (About feature templates and how to update them).
Start with a feature layer in your portal (Online or Enterprise) with at least one point, polyline or polygon layer in it. This is the layer on which the QuickCapture app will store your data. Multiple layers are also supported, they may be of the same or different geometry types.
It is strongly recommended (but not mandatory) you create a hosted feature layer view so you can have more flexibility in configuring symbology. When creating a view, ensure that you enable editing in the item settings.
For your layer/view to be listed in the QuickCapture gallery after you login, you must tag it with QuickCapture. To do this you need to navigate to the AGOL/Portal layer/view item and update the tag accordingly.
Tip: Make sure you have a thumbnail configured for the feature service item. This will appear in the project view of the app.
Once the service item is tagged with QuickCapture you can sign into the app and do a refresh of projects (pull/drag down in the project list). The service item should appear as a project in the table of contents:
After tapping on the project to download it to the device - the project will open up and automatically create groups and buttons based on the templates configured within the feature service or view. A button is created for each feature template in the layer and the following will occur:
- If templates are grouped as types, then a group separator is automatically added for each feature type with more than one feature template.
- Templates will be shown in the same order in which templates are organized in the service.
- If there is more than one layer, a separate layer group will appear on the data capture page.
Note that the default button behaviors and appearances can be customized using parameters and variables. Please see the appropriate sections below.
Tapping on a button will result in different behavior depending on whether the source layer is a point, line or polygon. Please note the following:
- Line and polygon capture differs slightly from points, where points are captured when a respective point feature button is pressed, line and polygon capture is togged on/off.
- Points may be captured at any time, even if there is line or polygon capture in progress.
- When a line or polygon capture is in progress, the respective button flashes to indicate it is active.
- The red circle inside a line or polygon capture button blinks each time a point is captured for the respective feature.
- Multiple line and polygons may be captured simultaneously.
- The default behavior is for line or polygon buttons within a group to operate mutually exclusively. That is when a new feature is started, the previous feature is automatically completed.
- Mutual exclusivity within a group may be turned off on a per button basis using the exclusive and groups can be defined using group property. Both properties are described in the Configuration parameters section below.