KeyedAppState

const val MAX_DATA_LENGTH = 1000: Int

const val MAX_KEY_LENGTH = 100: Int

const val MAX_MESSAGE_LENGTH = 1000: Int

const val SEVERITY_ERROR = 2: Int

const val SEVERITY_INFO = 1: Int

java-static fun builder(): KeyedAppState.KeyedAppStateBuilder

Create a KeyedAppStateBuilder.

abstract fun getData(): String?

Optionally, a machine-readable value to be read by the EMM. For example, setting values that the admin can choose to query against in the EMM console (e.g. “notify me if the battery_warning data <10”).

abstract fun getKey(): String

The key for the app state. Acts as a point of reference for what the app is providing state for. For example, when providing managed configuration feedback, this key could be the managed configuration key to allow EMMs to take advantage of the connection in their UI.

java-static fun getMaxDataLength(): Int

Get the maximum length of getData.

java-static fun getMaxKeyLength(): Int

Get the maximum length of getKey.

java-static fun getMaxMessageLength(): Int

Get the maximum length of getMessage.

abstract fun getMessage(): String?

Optionally, a free-form message string to explain the app state. If the state was triggered by a particular value (e.g. a managed configuration value), it should be included in the message.

abstract fun getSeverity(): Int

The severity of the app state. This allows EMMs to choose to notify admins of errors. This should only be set to SEVERITY_ERROR for genuine error conditions that a management organization needs to take action to fix.

When sending an app state containing errors, it is critical that follow-up app states are sent when the errors have been resolved, using the same key and this value set to SEVERITY_INFO.