Manhole + Pipe Snapping
Overview
Manhole and pipe snapping lets a linear feature (e.g. a pipe) snap its start and end nodes to point features (e.g. manholes). Attribute values from the snapped points automatically flow into the linear feature for calculations like cover level differences and pipe falls.
How It Works
When you create a linear feature with snapping configured, it grabs attribute values from the manhole features at its start and end. If the manhole position or attributes change later, the pipe's geometry and calculations update automatically.
Setting Up the Point Feature Type (e.g. Manhole)
In the web portal, edit the point feature type used for manholes:
- Add a short-text attribute named
_recalc_snaps. - Set its attribute settings value to
!MODIFIER-HIDEso it doesn't appear in the form.
This tells the app to recompute any snapped linear features when this manhole's geometry or attributes change.
Setting Up the Linear Feature Type (e.g. Pipe)
Add attributes to pull values from the snapped point features:
- Use
!SNAPPEDSTART(attributeName)in the default value to pull a value from the manhole snapped to the start of the pipe. - Use
!SNAPPEDEND(attributeName)for the manhole at the end.
Example — cover level fall calculation:
- Manhole feature type has a
COVER_LEVattribute (cover level in metres). - Pipe feature type adds two attributes:
UpstreamCoverLevelwith default!SNAPPEDSTART(COVER_LEV), andDownstreamCoverLevelwith default!SNAPPEDEND(COVER_LEV). - Pipe adds a third attribute
Fallwith default!CALC $UpstreamCoverLevel - $DownstreamCoverLevel.
$ prefix makes the calculation reactive — whenever
UpstreamCoverLevel or
DownstreamCoverLevel changes,
Fall recalculates automatically.
Captured Workflow
- Capture the two manhole point features first, filling in their
COVER_LEVvalues. - Start a new pipe (linear) feature and let it snap its start node to the first manhole and end node to the second.
- The pipe's
UpstreamCoverLevel,DownstreamCoverLevel, andFallpopulate automatically. - If you later edit either manhole, the pipe's geometry and calculations recompute on save.