Editing offline data

Offline data downloaded from a feature service and feature data in an offline map can be edited locally without a network connection. These local edits can later be synchronized with the source feature service when a network connection becomes available.

You can edit offline data from a feature service in the following ways:

• Add, update, and delete features, non-spatial data, and related data.
• Add and remove attachments.

The source feature service must have editing enabled.

When editing offline data downloaded from a feature service, the workflow is very similar to editing online data in the feature service over a network connection:

• Offline data: edits are stored on device storage and you must synchronize the edits with the feature service. See Synchronizing edits for more information.
• Online data: edits are stored in-memory and you must apply the edits to the feature service.

Add a feature

To add a new feature:

1. Create an in-memory Feature by calling CreateFeature() on a Geodatabase Feature Table.

   ArcGIS Maps SDK for .NETArcGIS Maps SDK for .NETArcGIS Maps SDK for SwiftArcGIS Maps SDK for KotlinArcGIS Maps SDK for JavaArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   var newFeature = geodatabaseFeatureTable.CreateFeature();
   

   Go to sample
   More info

   New features can also be created by providing a geometry and attributes, or from a Feature Template, a Feature Type, or a Feature Subtype. Feature Templates can be defined in ArcGIS Pro or in the Map Viewer. Feature Types and Feature Subtypes can be defined in ArcGIS Pro.

2. Optionally modify the Feature's geometry and/or attributes.

   ArcGIS Maps SDK for .NETArcGIS Maps SDK for .NETArcGIS Maps SDK for SwiftArcGIS Maps SDK for KotlinArcGIS Maps SDK for JavaArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   newFeature.Geometry = new MapPoint(x: -0.1722, y: 51.5298, spatialReference: SpatialReferences.Wgs84);
   newFeature.SetAttributeValue("Name", "Lord's");
   

   Go to sample

3. Add the Feature to the offline data by calling AddFeature() on the Geodatabase Feature Table.

   ArcGIS Maps SDK for .NETArcGIS Maps SDK for .NETArcGIS Maps SDK for SwiftArcGIS Maps SDK for KotlinArcGIS Maps SDK for JavaArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   try
   {
       await geodatabaseFeatureTable.AddFeatureAsync(newFeature);
   }
   catch(Exception ex)
   {
       // Report the error
   }
   

   Go to sample

Update a feature

To update an existing feature:

1. Modify the geometry and/or attributes of the Feature.

   ArcGIS Maps SDK for .NETArcGIS Maps SDK for .NETArcGIS Maps SDK for SwiftArcGIS Maps SDK for KotlinArcGIS Maps SDK for JavaArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   existingFeature.Geometry = new MapPoint(x: -1.9025, y: 52.4559, spatialReference: SpatialReferences.Wgs84);
   existingFeature.SetAttributeValue("Name", "Edgbaston");
   

   Go to sample

2. Pass the modified feature to UpdateFeature() on the feature's Geodatabase Feature Table.

   ArcGIS Maps SDK for .NETArcGIS Maps SDK for .NETArcGIS Maps SDK for SwiftArcGIS Maps SDK for KotlinArcGIS Maps SDK for JavaArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)

   Use dark colors for code blocksCopy

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   if (existingFeature.FeatureTable is FeatureTable featureTable)
   {
       try
       {
           await featureTable.UpdateFeatureAsync(existingFeature);
       }
       catch (Exception ex)
       {
           // Report the error
       }
   }
   

   Go to sample

Delete a feature

Pass the Feature to DeleteFeature() on the feature's Geodatabase Feature Table.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
if (existingFeature.FeatureTable is FeatureTable featureTable)
{
    try
    {
        await featureTable.DeleteFeatureAsync(existingFeature);
    }
    catch (Exception ex)
    {
        // Report the error
    }
}

Editing capabilities

The owner of a feature service can configure how data can be edited. This configuration also affects offline data.

An offline application can read the configuration settings from the Geodatabase Feature Table to tailor the user experience. These are the properties that can be read, and the API object to read them from:

Transactions

A transaction allows you to group together multiple edits to feature layers, tables, and attachments in the same geodatabase. This supports offline applications that allow a number of related edits before the user decides whether to keep them or not.

Synchronizing edits

To update a feature service with offline edits, you can synchronize the offline data with the source feature service. This can also update the offline data with edits in the feature service. To learn more, see Offline data: Synchronize and Offline maps: Synchronize.

Code examples

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
try
{
    geodatabase.BeginTransaction();
}
catch (Exception ex)
{
    // Handle error - BeginTransaction will throw if another transaction is active
}

try
{
    await geodatabaseFeatureTable.DeleteFeatureAsync(existingFeature);
}
catch(Exception ex)
{
    // Handle error
}

var newFeature = geodatabaseFeatureTable.CreateFeature();

newFeature.Geometry = new MapPoint(x: 0.2638, y: 52.3987, spatialReference: SpatialReferences.Wgs84);
newFeature.SetAttributeValue("Name", "Ely cathedral");

try
{
    await geodatabaseFeatureTable.AddFeatureAsync(newFeature);
}
catch(Exception ex)
{
    // Handle error
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
try
{
    geodatabase.RollbackTransaction();
}
catch(Exception ex)
{
    // Handle error - RollbackTransaction will throw if there is no active transaction
}

Tutorials

Create an offline map area

Use ArcGIS Online to create an offline map area that can be downloaded by any number of users.

ArcGIS Online 

Create a mobile map package

Use ArcGIS Pro to create a mobile map package.

ArcGIS Online  ArcGIS Pro 

Display an offline map on demand

Download and display an offline map for a custom area of a web map stored in ArcGIS.

.NET  Qt 

Display a map from a mobile map package

Access and display a map from a mobile map package for offline use.

.NETJava Qt 

API support