com.apama.position
Event PositionConfigSchema


The Position Configuration Schema event is provided by a Position Tracker implementation upon registration.

This event object describes the configuration parameters that can (or must) be set when subscribing to the Position Tracker. The schema may also contain reference information about a specific Position Tracker implementation (such as a version number) if required.
Action Summary
 voidaddItem(string name, string type, string defaultValue, sequence<string > allowableValues, string description, boolean required, boolean referenceOnly)

This function adds a new configuration parameter to the list with the full set of information.
 voidaddItemMinimal(string name, string type, string defaultValue, string description)

This function adds a new configuration parameter to the list with the full set of information.
 sequence<string >getParamAllowableValues(string paramName)

This function gets a sequence of allowable values for the specified parameter. This can be used by the Position Tracker implementation to inform the user of an enumerated parameter value.
 stringgetParamDefaultValue(string paramName)

This function gets the default value for the specified parameter (as a string).
 stringgetParamDescription(string paramName)

This function gets the description of the specified parameter.
 stringgetParamType(string paramName)

This function returns the type of the configuration parameter as a string (e.g. "string", "boolean", "integer", "float", etc).
 booleanhasParam(string paramName)

This function allows the user to check whether the Position Tracker implementation supports the specified parameter name.
 booleanisParamReferenceOnly(string paramName)

This function returns whether the parameter is for reference purposes only or whether the parameter is configurable by the client on subscription.
 booleanisParamRequired(string paramName)

This function returns whether the parameter is required to be passed back to the Position Tracker implementation on subscription, or whether the parameter is optional.
 
Action Detail

addItem

void addItem(string name, string type, string defaultValue, sequence<string > allowableValues, string description, boolean required, boolean referenceOnly)
This function adds a new configuration parameter to the list with the full set of information.
Parameters:
name - The name of the parameter
type - The type of the parameter (e.g. "string", "boolean", "integer", "float", "sequence<string>", etc)
defaultValue - The default value of this parameter (blank if not required)
allowableValues - A sequence containing the allowable values for this configuration parameter (empty if not required)
description - A short description of what the parameter is for
required - A boolean flag indicating if the configuration parameter must be provided or is optional
referenceOnly - A boolean flag indicating if the configuration parameter is purely informational (IE not settable)
See Also:
com.apama.position.PositionConfigSchema#addItemMinimal() - This action allows the user to add a configuration item with a minimal set of values

addItemMinimal

void addItemMinimal(string name, string type, string defaultValue, string description)
This function adds a new configuration parameter to the list with the full set of information.
Parameters:
name - The name of the parameter
type - The type of the parameter (e.g. "string", "boolean", "integer", "float", "sequence<string>", etc)
defaultValue - The default value of this parameter (blank if not required)
description - A short description of what the parameter is for
See Also:
com.apama.position.PositionConfigSchema#addItem() - This action allows the user to add a configuration item with more information (such as the allowable values, etc)

getParamAllowableValues

sequence<string > getParamAllowableValues(string paramName)
This function gets a sequence of allowable values for the specified parameter. This can be used by the Position Tracker implementation to inform the user of an enumerated parameter value.
Parameters:
paramName - The name of the parameter to get the sequence of allowable values for
Returns:
A sequence of allowable values (as strings) of the parameter specified, or an empty string if the parameter is not supported or is not restricted to a set of values

getParamDefaultValue

string getParamDefaultValue(string paramName)
This function gets the default value for the specified parameter (as a string).
Parameters:
paramName - The name of the parameter to get the default value for
Returns:
The default value of the parameter specified as a string, or an empty string if the parameter is not supported or no default value is provided by the Position Tracker implementation

getParamDescription

string getParamDescription(string paramName)
This function gets the description of the specified parameter.
Parameters:
paramName - The name of the parameter to get the description for
Returns:
The description of the parameter requested, or an empty string if the requested parameter is not supported.

getParamType

string getParamType(string paramName)
This function returns the type of the configuration parameter as a string (e.g. "string", "boolean", "integer", "float", etc).
Parameters:
paramName - The name of the parameter to get the type of
Returns:
The type of the parameter specified as a string, or an empty string if the parameter is not supported.

hasParam

boolean hasParam(string paramName)
This function allows the user to check whether the Position Tracker implementation supports the specified parameter name.
Parameters:
paramName - The name of the parameter to check is supported
Returns:
true if supported, false otherwise

isParamReferenceOnly

boolean isParamReferenceOnly(string paramName)
This function returns whether the parameter is for reference purposes only or whether the parameter is configurable by the client on subscription.
Parameters:
paramName - The name of the parameter to check if it is for reference purposes only
Returns:
true if the parameter is for reference purposes only false if it is configurable by the client on subscription

isParamRequired

boolean isParamRequired(string paramName)
This function returns whether the parameter is required to be passed back to the Position Tracker implementation on subscription, or whether the parameter is optional.
Parameters:
paramName - The name of the parameter to check if it is required
Returns:
true if the parameter is required to be passed on subscription, false if it can be set optionally