Operation is used to compare one BRTilslutning connection of a manhole inspection against the KeyAqua duct the network holds for it - whether the pipes the inspection found at a manhole are the pipes the network claims.
The manhole is resolved from the inspection's confirmed link, then its position identifier (Broendnr), then the nearest manhole to its own coordinates. The duct is resolved from that manhole's connected ducts, narrowed by flow direction. A single candidate is used as is. Where several remain, a Tilloebspunkt naming a manhole the network holds selects the duct running between the two; otherwise dimension is the tiebreak, and a still ambiguous result returns the candidates for the caller to pick from.
A connection the network holds no duct for is a result rather than an error:
the response carries a null matched_snsewerduct_id.
Token issued for API consumer.
Optional manual pick - if provided, this duct is compared instead of the resolved one. Must be connected to the resolved manhole.
Optional manual pick - if provided, this snsewernode is used instead of the resolved one.
GUID of the BRTilslutning connection to compare
Maximum auto-match distance in meters when the manhole is resolved by proximity. Defaults to 0.2 (20 cm).
Comparison result
Ducts at the manhole this connection could refer to, returned when none resolved outright.
Whether the two values disagree. Null when no verdict can be reached - the inspector recorded nothing, or the comparison returns a placeholder - so "not comparable" is never rendered as agreement.
Field name being compared
Value from the inspection record. FK fields are shown as a nested {id, txt} object.
Value from the matched KeyAqua network object. The connection comparison returns the duct's own value here; the inspection and observation comparisons still return a placeholder null.
Id of the duct this connection refers to. Null when the network holds no duct for it, or when several candidates fit.
What a user decided about this connection, or null while nobody has
judged it. updated is set by /manhole-connection-duct-diff/ when a
write succeeds; the other two are recorded by
/manhole-connection-review/ and write nothing to the network.
Username of the user who judged the connection; null while unreviewed.
When the connection was judged; null while unreviewed.
Id of the manhole the inspection was resolved to.
There was an error in request. Usually field validation failed, or no manhole could be resolved for the inspection.
Fields which failed validation
List of validation errors for this fieldname
Authentication credentials are missing or invalid
{
"details": "Authentication credentials were not provided"
}Standard error response payload
Detailed description of error
Object was not found
{
"details": "Not found."
}Standard error response payload
Detailed description of error