KSLCore/ksl.controls/ControlImportResult

ControlImportResult

data class ControlImportResult(val successCount: Int, val failures: List<ControlUpdateException>, val missingKeys: List<String> = emptyList())(source)

Summary result returned by Controls.importAll and Controls.importAllFromJson.

The import continues past individual errors, accumulating them here. failures holds one ControlUpdateException per control whose value was rejected (string allowedValues violation or JSON deserialization failure). missingKeys holds the key name of every control present in the export snapshot but absent from the live model — these are logged at WARN level and left unchanged.

Parameters

successCount

number of controls successfully updated across all families

failures

validation exceptions in encounter order; empty on clean import

missingKeys

keys present in the export but not found in this model; empty when every exported key resolved to a live control

Constructors

ControlImportResult

constructor(successCount: Int, failures: List<ControlUpdateException>, missingKeys: List<String> = emptyList())

Properties

val failureCount: Int

Number of controls that could not be updated due to validation errors.

val failures: List<ControlUpdateException>

val hasFailures: Boolean

true if at least one control update failed validation.

val hasMissingKeys: Boolean

true if at least one exported key was not found in this model.

missingKeyCount

val missingKeyCount: Int

Number of export keys that had no matching control in this model.

val missingKeys: List<String>

val successCount: Int