Setting Custom Property Data
The RUISDK.SetCustomProperty method is used to set the value of a custom property.
RUIResult SetCustomProperty (UInt32 customPropertyID, String customValue)
Parameters
The RUISDK.SetCustomProperty function has the following parameters.
|
Parameter |
Description |
|
customPropertyId (UInt32) |
This is a numeric index between 1 and 20. On the Usage Intelligence dashboard, custom values are given an ID ranging from C01 to C20. This ID is used to identify which of the 20 possible custom value is being set. |
|
customValue (String) |
The custom property value to use in Server reports; empty value clears the value. |
Returns
The RUISDK.SetCustomProperty function returns a RUIResult enum value with the following possible values.
|
Return |
Description |
|
ok |
Function successful. |
|
sdkInternalErrorFatal |
Irrecoverable internal fatal error. No further API calls should be made. |
|
sdkAborted |
A required New Registration has failed, and hence the SDK is aborted. RUISDK.StopSDK and RUISDK destructor are possible. |
|
sdkSuspended |
The Server has instructed a temporary back-off. |
|
sdkPermantelyDisabled |
The Server has instructed a permanent disable. |
|
sdkOptedOut |
Instance has been instructed by the application to opt-out. |
|
configNotCreated |
Configuration has not been successfully created. |
|
sdkAlreadyStopped |
SDK has already been successfully stopped. |
|
invalidCustomPropertyID |
The customPropertyID violates its allowable range. |