Readonly Features by Attribute or Feature Type

Overview

Soarvo Mobile can make features read-only so users can view them but cannot edit or delete them in the mobile app.

Read-only behaviour can be applied in two ways:

1. At feature type level, so every feature of that type is read-only.
2. At individual feature level, so only specific features are read-only.

Making an Entire Feature Type Read-Only

Edit the target feature type in the web portal:

1. Add an attribute named _IS_READONLY.
2. Save/sync the feature type.
3. Refresh the location in Soarvo Mobile.

Any feature using this feature type will be treated as read-only in the mobile app.

Effect in mobile:

• The feature can still be viewed.
• Edit actions are hidden/disabled.
• Delete actions are hidden/disabled.
• Snapping/edit workflows ignore read-only features where editing would be required.

Example feature type attribute:

_IS_READONLY

The value does not need to be set on each feature. The presence of the _IS_READONLY attribute on the feature type is enough.

Making a Single Feature Read-Only

Set the feature attribute _isReadonly on the feature itself.

Supported read-only values:

Example feature attribute:

_isReadonly = yes

This makes only that feature read-only, assuming the feature type itself does not already force read-only behaviour.

Precedence Rules

Feature type read-only takes priority.

If the feature type contains _IS_READONLY, then all features of that type are read-only, even if an individual feature has:

_isReadonly = false

In other words:

1. _IS_READONLY on the feature type always wins.
2. If the feature type is not read-only, Soarvo Mobile checks the feature's _isReadonly value.
3. If _isReadonly is not present, the feature remains editable.

Examples

Make every feature of a type read-only:

_IS_READONLY

Make one feature read-only:

_isReadonly = yes

Explicitly keep one feature editable:

_isReadonly = false

This only works if the feature type does not have _IS_READONLY.

Notes

• _IS_READONLY and _isReadonly are case-sensitive.
• Use _IS_READONLY for feature type attributes.
• Use _isReadonly for individual feature attributes.