WAD - adding menu entries with JavaScript - help please!

Question

Hiya,
I am completely new to JavaScript and I need some help with adding menu entries into my WAD template. Can anyone please help?
I want to add functionality into my WAD template to enable users adding results rows on a selected characteristic, at a single mouse click. Currently they need to go to the menu -> properties -> characteristic -> display results -> always -> ok. That's five clicks of a mouse (provided they know were to go).
I want to add this option to the basic menu so that they can click once only.
What I have managed to figure out so far using SAP help is the following. I have added a Script Item into my WAD Layout and added the following line of code in the Script Editing window:
sapbi_addToMenu("Add totals", "alternate_context_menu", "X","CHARACTERISTIC", "", "bottom", "", "")
It worked fine in that it added an extra item "Add totals" to my menu when I righclick on a characteristic. So far so good. However, I have no idea what function I should be using here, or how to code it. Surely WAD uses some function to perform this action, something that I could reuse? Is there a library somewhere of all the function used in WAD?
Can anyone please help with the code?
Many thanks,
Agata

Answer 1

Hiya again,
I have managed to partially solve this problem by using the following code. However it requires me to define on which characteristic the function is performed. In this case I have managed to get it working on 0PROJECT, but I want it to be ANY characteristic which has been right clicked?
Any ideas how I can pass the characteristic name as a VARIABLE, whose value would be read automatically when menu is triggered?
/* Add Contextmenu entries */
sapbi_addToMenu("Add totals", "JS_SET_RESULT_VISIBILITY_R", "X","CHARACTERISTIC", "", "bottom", "", "")
* Javascript functions that are to be integrated into a web template and that
* are to be used later in the web application ALWAYS have to have the same function
* signature, i.e. the parameters that will be passed.
* @param currentState - a list of parameters that describe the state the web item
* @param defaultCommandSequence - the initially used sequence of commands that
*       would have been used instead of the custom
*       script.
function JS_SET_RESULT_VISIBILITY_R( currentState, defaultCommandSequence ){
//Note: information can be extracted using the parameter 'currentState'
// and 'defaultCommandSequence'. In either case create your own object
// of type 'sapbi_CommandSequence' that will be sent to the server.
// To extract specific values of parameters refer to the following
// snippet:
//  var key = currentState.getParameter( PARAM_KEY ).getValue();
//  alert( "Selected key: " + key );
// ('PARAM_KEY' refers to any parameter's name)
//Create a new object of type sapbi_CommandSequence
var commandSequence = new sapbi_CommandSequence();
  * Create a new object of type sapbi_Command with the command named "SET_RESULT_VISIBILITY"
var commandSET_RESULT_VISIBILITY_1 = new sapbi_Command( "SET_RESULT_VISIBILITY" );
/* Create parameter TARGET_DATA_PROVIDER_REF_LIST */
var paramTARGET_DATA_PROVIDER_REF_LIST = new sapbi_Parameter( "TARGET_DATA_PROVIDER_REF_LIST", "" );
var paramListTARGET_DATA_PROVIDER_REF_LIST = new sapbi_ParameterList();
// Create parameter TARGET_DATA_PROVIDER_REF
var paramTARGET_DATA_PROVIDER_REF1 = new sapbi_Parameter( "TARGET_DATA_PROVIDER_REF", "DP_1" );
paramListTARGET_DATA_PROVIDER_REF_LIST.setParameter( paramTARGET_DATA_PROVIDER_REF1, 1 );
  // End parameter TARGET_DATA_PROVIDER_REF!
paramTARGET_DATA_PROVIDER_REF_LIST.setChildList( paramListTARGET_DATA_PROVIDER_REF_LIST );
commandSET_RESULT_VISIBILITY_1.addParameter( paramTARGET_DATA_PROVIDER_REF_LIST );
/* End parameter TARGET_DATA_PROVIDER_REF_LIST */
/* Create parameter CHARACTERISTIC */
var paramCHARACTERISTIC = new sapbi_Parameter( "CHARACTERISTIC", "0PROJECT" );
commandSET_RESULT_VISIBILITY_1.addParameter( paramCHARACTERISTIC );
/* End parameter CHARACTERISTIC */
/* Create parameter RESULT_VISIBILITY */
var paramRESULT_VISIBILITY = new sapbi_Parameter( "RESULT_VISIBILITY", "VISIBLE" );
commandSET_RESULT_VISIBILITY_1.addParameter( paramRESULT_VISIBILITY );
/* End parameter RESULT_VISIBILITY */
// Add the command to the command sequence
commandSequence.addCommand( commandSET_RESULT_VISIBILITY_1 );
  * End command commandSET_RESULT_VISIBILITY_1
//Send the command sequence to the server
    return sapbi_page.sendCommand( commandSequence );