Class actuate.parameter.ParameterData
Description
The ParameterData class is a high-level wrapper for an actuate.parameter.ParameterDefinition object.
Constructor
Syntax
string actuate.parameter.ParameterData(string reportName, actuate.parameter.ParameterDefinition pd)
Constructs a new ParameterData object.
Parameters
reportName
String. The name of the report where the parameter definition originates.
pd
actuate.parameter.ParameterDefinition object. The parameter definition set for this ParameterData object.
Function summary
Table 44‑23 lists the actuate.parameter.ParameterData functions.
Table 44‑23 actuateparameter.ParameterData functions
Function
Description
Returns the cascading parent value
Returns the child ParameterData object
Returns the controlType UI value
Returns the current UI value set by the UI control
Returns the default value for this ParameterData object
Returns the help text for this ParameterData object
Returns the list of name-value pairs for this ParameterData object
Returns the parameter name for this ParameterData object
Returns the parent ParameterData object
Returns the pick list for the child ParameterData object
Returns the prompt text for this ParameterData object
Returns the filter-based suggestion list for this ParameterData object
Returns true when this parameter is ad hoc
Returns true when this parameter is a cascading parameter
Returns true when this parameter is a dynamic filter
Returns true when this parameter is a multi-list
Returns true when this parameter is required
Indicates that the parameter data contains a child
Sets the UI value of the UI control
Indicates that the parameter data contains a parent
Defines a web service to send SOAP messages
getCascadingParentValues
Syntax
actuate.parameter.ParameterValue[ ] ParameterData.getCascadingParentValues( actuate.parameter.ParameterValue[ ] parentValues)
Returns the cascading parent value.
Parameter
parentValues
An array of actuate.parameter.ParameterValue objects. This array is the one to be populated.
Returns
An array of actuate.parameter.ParameterValue objects. This is the input array populated with the cascading parent values.
Example
This sample code returns a storage array of actuate.parameter.ParameterValue objects representing the cascading parent values:
var parentValues = new Array( );
parentValues = myParamData.getCascadingParentValues(parentValues);
getChildData
Syntax
actuate.parameter.ParameterData ParameterData.getChildData( )
Returns the child ParameterData object.
Returns
actuate.parameter.ParameterData object.
Example
This example assigns the child ParameterData object to a myChildData variable:
var myChildData = myParameterData.getChildData( );
getControlType
Syntax
string ParameterData.getControlType( )
Returns the controlType UI value for this ParameterData object.
Returns
String. The controlType UI value. Legal controlType UI values are:
*null
*AutoSuggest
*ControlRadioButton
*ControlList
*ControlListAllowNew
*ControlCheckBox
Example
This sample code displays the controlType UI value for the myParamData object in an alert box:
alert(myParamData.getControlType( ));
getCurrentValue
Syntax
actuate.parameter.ParameterValue ParameterData.getCurrentValue( )
Returns the current UI value set by the UI control.
Returns
actuate.parameter.ParameterValue. Returns null when the UI control has not set a value.
Example
This sample code assigns the current UI value to the myCurrVal variable:
var myCurrVal = myParameterData.getCurrentValue( );
getDefaultValue
Syntax
string ParameterData.getDefaultValue( )
Returns the default value for this ParameterData object.
Returns
String. The default value. Returns null when the default value is null.
Example
This sample code displays the default value for myParamData in an alert box:
alert(myParamData.getDefaultValue( ));
getHelpText
Syntax
string ParameterData.getHelpText( )
Returns the help text for this ParameterData object.
Returns
String. The help text.
Example
This example displays the help text for the myParamData object in an alert box:
alert(myParamData.getHelpText( ));
getNameValueList
Syntax
actuate.parameter.NameValuePair[ ] ParameterData.getNameValueList( )
Returns the list of name-value pairs for this ParameterData object.
Returns
Array of actuate.parameter.NameValuePair objects.
Example
This example stores the array of NameValuePair objects for the myParamValues object in a variable called myNVList:
var myNVList = new Array( );
myNVList = myParamValues.getNameValueList( );
getParameterName
Syntax
string ParameterData.getParameterName( )
Returns the parameter name for this ParameterData object.
Returns
String. The parameter name.
Example
This sample code displays the parameter name for the myParamData object in an alert box:
alert(myParamData.getParameterName( ));
getParentData
Syntax
actuate.parameter.ParameterData ParameterData.getParentData( )
Returns the parent ParameterData object.
Returns
actuate.parameter.ParameterData object.
Example
This sample code assigns this ParameterData object’s parent ParameterData object to the myParentData variable:
var myParentData = myParameterData.getParentData( );
getPickList
Syntax
actuate.parameter.ParameterValue[ ] ParameterData.getPickList(function callback)
Gets the pick list for the child of this parameter data.
Parameter
callback
Function. An optional function to call when this function completes. This function receives the following parameters:
*An array of actuate.parameter.NameValuePair objects
*An integer that represents the pick list’s total leftover count
Returns
An array of actuate.parameter.ParameterValue objects.
Example
This sample code uses the callback function runNext( ) to display the pick list’s total leftover count in an alert box and assigns the array of NameValuePair objects to the pickListNVPairs variable:
paramObj.getPickList(runNext);
function runNext(pairs, leftover){
alert(leftover);
var pickListNVPairs = new Array( );
pickListNVPairs = pairs;
}
getPromptText
Syntax
string ParameterData.getPromptText( )
Returns the prompt text for this ParameterData object.
Returns
String. The prompt text.
Example
This sample code displays the prompt text for the myParamData object in an alert box:
alert(myParamData.getPromptText( ));
getSuggestionList
Syntax
string[ ] ParameterData.getSuggestionList(function callback, string filter)
Returns the filter-based suggestion list for this ParameterData object.
Parameters
callback
Function. An optional function to call when this function completes. This function receives an array of actuate.parameter.NameValuePair objects as a parameter.
filter
String. The filter for the suggestion list.
Example
This sample code uses the string "Trucks" to call back function runNext( ) to filter the suggestion list and assigns the filtered NameValuePair objects to the mySuggestions variable:
paramObj.getSuggestionList(runNext, "Trucks");
function runNext(suggested){
var mySuggestions = new Array( );
mySuggestions = suggested;
}
isAdhoc
Syntax
boolean ParameterData.isAdhoc( )
Returns true when this parameter is a dynamic filter parameter.
Returns
Boolean. True when this parameter is a dynamic filter.
Example
This example displays the dynamic filter status of a parameter in an alert box:
alert(paramData.isAdhoc( ));
isCascadingParameter
Syntax
boolean ParameterData.isCascadingParameter( )
Returns true when this parameter is a cascading parameter.
Returns
Boolean. True when this parameter is a cascading parameter.
Example
This example displays the cascading parameter status of a parameter in an alert box:
alert(paramData.isCascadingParameter( ));
isDynamicFilter
Syntax
boolean ParameterData.isDynamicFilter( )
Returns true when this parameter is a dynamic filter.
Returns
Boolean. True when this parameter is a dynamic filter.
Example
This example displays the dynamic filter status of a parameter in an alert box:
alert(paramData.isDynamicFilter( ));
isMultiList
Syntax
boolean ParameterData.isMultiList( )
Returns true when this parameter is shown as a multi-list UI element.
Returns
Boolean. True when this parameter is shown as a multi-list UI element.
Example
This example displays the multi-list UI element status of a parameter in an alert box:
alert(paramData.isMultiList( ));
isRequired
Syntax
boolean ParameterData.isRequired( )
Returns true when this parameter is required.
Returns
Boolean. True when this parameter is required.
Example
This example displays the required status of a parameter in an alert box:
alert(paramData.isRequired( ));
setChildData
Syntax
void ParameterData.setChildData(actuate.parameter.ParameterData childData)
Adds a child parameter to this parameter.
Parameter
childData
An actuate.parameter.ParameterData object that contains the child for this ParameterData object.
Example
This sample code sets the ParameterData object myChildData as the child of the ParameterData object myParamData:
myParamData.setChildData(myChildData);
setCurrentValue
Syntax
void ParameterData.setCurrentValue(actuate.parameter.ParameterValue value)
Sets the UI value of the UI control. When a UI value changes, UIControl calls this method to update the ParameterData object.
Parameter
value
An actuate.parameter.ParameterValue object set by the UI.
Example
This sample code sets the ParameterValue object myValue as the value of the ParameterData object myParamData:
myParamData.setCurrentValue(myValue);
setParentData
Syntax
void ParameterData.setParentData(actuate.parameter.ParameterData parentData)
Sets a parent ParameterData object, making this ParameterData object its child.
Parameter
parentData
An actuate.parameter.ParameterData object that contains the parent for this ParameterData object.
Example
This sample code sets the ParameterData object myParentData as the parent of the ParameterData object myParamData:
myParamData.setParentData(myParentData);
setWebService
Syntax
void ParameterData.setWebService(object webService)
Defines a web service to use to send SOAP messages.
Parameter
webService
Object. A web service to send SOAP messages.