Mobile App Data Entry Shortcuts (Default Codes)
Overview
Soarvo Mobile supports default codes (formerly called default values in K-Capture) — special strings you place in a feature type's attribute settings to auto-populate field values, control attribute visibility, or run calculations. They turn a manual data-entry form into a smart form that fills itself.
How Default Codes Work
In the web portal, when you set up a feature type's attributes, the Attribute Settings field accepts default codes. The mobile app reads these codes when a feature is created, saved, opened, or its geometry changes, and runs the corresponding action.
Feature Type Metadata Settings
Attributes with names prefixed by _ act as feature-type settings rather than user-fillable fields. The most common:
_AUTO_ACCEPT— point features auto-save once all default codes resolve. Useful for rapid capture._ON_SAVE_ACTIONS— comma-separated actions to run after a feature is saved (e.g.successJingle,vibrate)._COPY_PARENT_GEOM— child point features copy the parent's geometry on creation.
Feature Created — Position & Identity Codes
These codes resolve when a feature is created.
!TS— full timestamp (e.g.01-Jan-2025 14:30:00)!D— date only;!TIME— time only!LAT,!LNG,!ALT— current user position (degrees / metres)!X,!Y,!Z— current position in the project's coordinate system!ACC,!SATS,!HDOP— accuracy, satellite count, HDOP!USER— user creating the feature!QA— accuracy + unit (e.g.1.3m)!AUTOINCor!AUTOINC(5)— increment the number attribute by 1 (or by 5)!LOCATIONNAME,!PROJECTNAME— context names
Cache Codes
Cache codes read and write values scoped to the user, project, or location. Useful for carrying values between features.
!READGLOBALCACHE(key)/!WRITEGLOBALCACHE(key, value)— global to the user!READPROJECTCACHE(key)/!WRITEPROJECTCACHE(key)— project-scoped!READLOCATIONCACHE(key)/!WRITELOCATIONCACHE(key)— location-scoped!RESTORE/!STORE— shorthand for location-cache read/write keyed by the attribute id
Geometry-Based Codes
Resolved whenever the feature's geometry changes.
!LEN— 2D length (metres);!LEN3D— 3D length!AREA— 2D area (square metres)!FEATUREX,!FEATUREY,!FEATUREZ— feature coordinates (point only)!FEATURELAT,!FEATURELNG,!FEATUREALT— feature lat/lng/alt (point only)!SNAPPEDSTART(attrName),!SNAPPEDEND(attrName)— pull attribute values from snapped point features (see Manhole + Pipe Snapping)!CHN,!CHNOFFSET,!CHNMIN,!CHNMAX— chainage along the map alignment (see Alignment and Chainage)
!CALC Expressions
Use !CALC for Excel-like calculations. Reference attributes by name; prefix with $ to make the calculation reactive (re-runs when the source attribute changes).
!CALC 2 + 2!CALC $field1 * $field2!CALC $status == 'active' ? 'Yes' : 'No'
Utility functions inside expressions: join(parts, separator), number(value), numberOrNull(value).
Modifier Codes (Show / Hide / Read-only)
!MODIFIER-HIDE— always hide the attribute!MODIFIER-SHOWWHEN $field == 'value'— show conditionally!MODIFIER-HIDEWHEN $field == 'value'— hide conditionally!MODIFIER-READONLY— read-only attribute!MODIFIER-FORCEPHOTOCAPTURE $cond— make a photo-upload mandatory under a condition!MODIFIER-SHOWTHUMBNAIL— display photos/sketches as thumbnails in the feature list
Sketch Attribute Codes
!LOADIMAGE(filename)— load a PNG into the sketch canvas (file uploaded asfilename.png.system)!LOADIMAGE([attributename])— dynamic image lookup based on another attribute's value
Specialised Codes
!RD8K/!RD8K(n)— pull RD8K cable-locator readings into an attribute (see RD8000+ Integration)!CALCRPR— auto-calculate Root Protection Radius for arboricultural surveys (see Tree Inspection Secondary Features)!CALCW3WNOW— get the user's current What3Words address