/**
    Function to find an element by its ID.

    @argument objectId	String containing id of the element
    */
    function findDOM(objectId) {
        // general check for DOM support
        var DOMsupported = 0;
        var standardDOMsupported = 0;
        var ieDOMsupported = 0;
        var netscapeDOMsupported = 0;
        if (document.getElementById) {standardDOMsupported = 1; DOMsupported = 1;}
        else {
            if (document.all) {ieDOMsupported = 1; DOMsupported = 1;}
            else if ((navigator.appName.indexOf('Netscape') != -1) && (browserVersion ==4)) {netscapeDOMsupported = 1; DOMsupported = 1;}
        }
        if (standardDOMsupported) {return (document.getElementById(objectId));}
        if (ieDOMsupported) {return (document.all[objectId]);}
        if (netscapeDOMsupported) {return (document.layers[objectId]);}
    }


    /**
    Function to display a confirm DHTML popup containing 2 buttons with text.
    First buttonpress (Yes button) calls confirmationPressYes() function. Second buttonpress (No button) calls confirmationPressNo.
    These functions need to be implemented in the pages that call this function.

    @argument confirmationText	String containing the text of the confirmation.
    @argument yesButtonText	    String containing the text of the Yes button.
    @argument noButtonText	    String containing the text of the No button.
    */
    function confirmYesNo( confirmationText, yesButtonText, noButtonText ) {
        var div = findDOM("spiderConfirmation");
        if (!div) {
            // since this layer can overlap with form elements, namely select element we make sure they don't by specifying absolute position
            var nWidth = 100;
            var nHeight = 20;
            div = document.createElement("div");
            div.setAttribute("id","spiderConfirmation");

			var headerColourFilter="";
			if(document.all){
				headerColourFilter=" filter:progid:DXImageTransform.Microsoft.Gradient(GradientType=1, StartColorStr='#FF102468', EndColorStr='#FFa5cbf7');";
			}
			var cnt='\
				<span style="position:absolute;left:'+nWidth+'px; top:'+nHeight+'px;width:300px;color:#fff;border-top:2px solid #fff; border-left:2px solid #fff; border-right:2px solid #000; border-bottom:2px solid #000; background-color:ActiveBorder;text-align:center;">\
							<div style="height:12pt;font-size:8pt;font-weight: bold;text-align:left;background-color: #314d8c;'+headerColourFilter+'">&nbsp;Spider Confirm Alert</div>\
							<p style="font-size:8pt;color: #000;text-align:center;margin-left:10pt;margin-right:10pt;">' + confirmationText + '</p>\
					<span style="margin:10pt;">\
						<form>\
							<span style="position:relative;left:0px;top:0px;width:75px; height:30px;border 1 groove #000">\
								<input type="button" value="' + yesButtonText +'" style="width:74px;height:20px;font-size:8pt;border:1px outset #fff;" onclick="confirmationPressYes();" name="confirmationYes"  />\
							</span>\
							<span style="position:relative;left:10px;top:0px;width:75px;height:30px;border 1 groove #000">\
								<input type="button" value="' + noButtonText + '" style="width:74px;height:20px;font-size:8pt;border:1px outset #fff;" onclick="confirmationPressNo();" name="confirmationNo" />\
							</span>\
						</form>\
					</span>\
				</span> \
			';
			div.innerHTML=cnt;
            div.style.position = 'absolute';
            document.body.appendChild(div);
            div.style.left = nWidth+'px';
            div.style.top = nHeight+'px';
            return true;
        }
    }



/**
Function to create a centered popup window

@argument myUrl		String containing popup url
@argument myHeight	String containing url height
@argument myWidth	String containing url width
*/
function popUpWindow(myUrl, myHeight, myWidth) {
	popUpWindowPos(myUrl, myHeight, myWidth, "center");
}

/**
Function to create a popup window, with the additional capability to specify the position of the window.

@argument myUrl			String containing popup url
@argument myHeight		String containing url height
@argument myWidth		String containing url width
@argument myPosition	"center" - center of screen
						"left", "right" - fully left or right of screen, vertically centered
						"top" or "bottom" - fully top or bottom of screen, vertically centered
						"rightheight" - full right of screen, over entire height
*/
function popUpWindowPos(myUrl, myHeight, myWidth, myPosition) {
    var winName     = 'popUpSpider';
	var toolbar     = 0;
	var location    = 0;
	var directories = 0;
	var status      = 0;
	var menubar     = 0;
	var scrollbars  = 1;
	var resizable   = 1;
	var top;
	var left;
	if(myPosition=="center") {
		top         = (screen.height/2)-(myHeight/2);
		left        = (screen.width/2)-(myWidth/2);
	}
	else if(myPosition=="left") {
		top         = (screen.availHeight/2)-(myHeight/2);
		left        = 0;
	}
	else if(myPosition=="right") {
		top         = (screen.availHeight/2)-(myHeight/2);
		left        = screen.availWidth-myWidth-10;	// 10=guessed size of windowborder
	}
	else if(myPosition=="rightheight") {
		top         = 0;
		myHeight	= screen.availHeight - 30;	// 30=guessed size of windowborder
		left        = screen.availWidth-myWidth-10;	// 10=guessed size of windowborder
	}
	else if(myPosition=="top") {
		top         = 0;
		left        = (screen.width/2)-(myWidth/2);
	}
	else if(myPosition=="bottom") {
		top         = screen.availHeight-myHeight - 30;	// 30=guessed size of windowborder
		left        = (screen.width/2)-(myWidth/2);
	}
	else {
		top=0;
		left=0;
	}
	var param = "width=" + myWidth + ",height=" + myHeight + ",toolbar=" + toolbar + ",location=" + location + ",directories=" + directories + ",status=" + status + ",menubar=" + menubar + ",scrollbars=" + scrollbars + ",resizable=" + resizable + ",top=" + top + ",left=" + left;
	var popUp = window.open(myUrl, winName, param);
	popUp.focus();
}

/**
Function to create a popup window that passes form parameters from opener to popup window using append string
To be used as: popUpParams('url', 400, 600, 'formName', new Array('field1Name','field2Name',..), true)

@argument myUrl				String containing popup url
@argument myHeight			String containing url height
@argument myWidth			String containing url width
@argument formObject		Form object
@argument fieldObjectArray	Array containing strings of field names
@argument hasAppendString	Boolean, use true for hasAppendString if myUrl already has an append string, otherwise false
*/
function popUpParams(myUrl, myHeight, myWidth, formObject, fieldObjectArray, hasAppendString) {
    // build up append string
    var appendString = "";
    var appendStartToken = "?";
    var appendToken = "&";
    if (hasAppendString == true) { appendStartToken = "&"; }
    var loops = fieldObjectArray.length;
    var firstValue = true;
    for (var i = 0; i < loops; i++) {
        var obj = eval('document.' + formObject + '.' + fieldObjectArray[i]);
        var value = getGeneralSingleInputValue(obj, false);
        if (value) {
            // if it exists add name value pair
            if (firstValue == true) {
                appendString += appendStartToken + fieldObjectArray[i] + "=" + value;
                firstValue = false;
            } else {
                appendString += appendToken + fieldObjectArray[i] + "=" + value;
            }
        }
    }
    // call popup with the right url
    var myAppendedUrl = myUrl + appendString;
    popUpWindow(myAppendedUrl, myHeight, myWidth);
}

/**
Function to create a confirmation window

@argument yesUrl	String containing yes action url
@argument noUrl		String containing no action url
*/
function confirmAction(yesUrl, noUrl) {
    var conf = confirm(warningMessage);
    if (conf) {
        self.location = yesUrl;
    } else {
        self.location = noUrl;
    }
}

/**
Function to create a decision tree made of confirmation windows
Example call: confirmTree(new Array('message1','message2','message3'), 'redirect.html')
You progress through the tree by positive actions (yes button)
A negative actions (cancel button) stops the function

@argument messageArray	Array containing a string of messages
@argument yesUrl		String containing yes action url
@argument noUrl			String containing no action url
*/
function confirmTree(messageArray, yesUrl, noUrl) {
	var loops = messageArray.length;
	for (var i = 0; i < loops; i++) {
		var conf = confirm(messageArray[i]);
		if (conf) {
			if (i == (messageArray.length - 1)) {
				window.location.href = yesUrl;
				return;
			}
		} else { // negative action
			if (i == (messageArray.length - 1)) {
			  window.location.href = noUrl;
			  return;
			}
		}
	}
	return;
}

/**
Function to change the url of pop-up opener page, close pop-up window
In a link used as: <a href="javascript:changeUrlOpenerCloseSelf('newOpenerUrl')">

@argument newOpenerUrl	String containing url to be opened
*/
function changeUrlOpenerCloseSelf(newOpenerUrl) {
    window.opener.location.href = newOpenerUrl;
    self.close();
}

/**
Function to close window
*/
function exit() {
	window.close();
}

/**
Functions to pass values from a popup window to its opener and close the popup window

@argument formField		String
@argument codeField		String
@argument textField		String
@argument codeText		String
@argument nameText		String
*/
function selectAndExit(formField, codeField, textField, codeText, nameText) {
	opener.document.forms[formField].elements[textField].value = nameText;
	opener.document.forms[formField].elements[codeField].value = codeText;
	window.close();
}

/**
Functions to pass default values from a popup window to its opener and close the popup window

@argument formField		String
@argument textField		String
@argument codeField		String
@argument defaultText	String
*/
function clearAndExit(formField, textField, codeField, defaultText) {
	opener.document.forms[formField].elements[textField].value = defaultText;
	opener.document.forms[formField].elements[codeField].value = '';
	window.close();
}

/**
Functions sort form fields and submit form

@argument formField				String
@argument sortColumnField		String
@argument sortAscendingField	String
@argument columnName			String
*/
function sort(formField, sortColumnField, sortAscendingField, columnName) {
	if (document.forms[formField].elements[sortColumnField].value == columnName) {
		if (document.forms[formField].elements[sortAscendingField].value == 'true') {
			document.forms[formField].elements[sortAscendingField].value = 'false';
		}
		else {
			document.forms[formField].elements[sortAscendingField].value = 'true';
		}
	}
	else {
		document.forms[formField].elements[sortAscendingField].value = 'true';
	}
	document.forms[formField].elements[sortColumnField].value=columnName;
	document.forms[formField].submit();
}

/**
Function to clear all text, password, textarea, radio & checkbox element values of a form
Select (one & multiple) element values are set to first value available
Called by: onclick="clearForm('myFormName')"

@argument formName	String with name of form
*/
function clearForm(formName) {
	var formArrayLength = eval('window.document.' + formName + '.elements.length');
	var formTypes = new Array(formArrayLength);
	for (var i = 0; i < formArrayLength; i++) {
		formTypes[i] = eval('window.document.' + formName + '.elements['+ i +'].type');
		if ((formTypes[i] == 'text') || (formTypes[i] == 'password') || (formTypes[i] == 'textarea')) {
			eval('window.document.' + formName + '.elements['+ i +'].value = ""');
		} else if ((formTypes[i] == 'radio') || (formTypes[i] == 'checkbox')) {
			eval('window.document.' + formName + '.elements['+ i +'].checked = false');
		} else if ((formTypes[i] == 'select-one')) {
			eval('window.document.' + formName + '.elements['+ i +'].options[0].selected = true');
		} else if ((formTypes[i] == 'select-multiple')) {
                  var optionSize = eval('window.document.' + formName + '.elements['+ i +'].length');
                  for (j = 0; j < optionSize; j++) {
			eval('window.document.' + formName + '.elements['+ i +'].options[' + j + '].selected = false');
                  }
		 eval('window.document.' + formName + '.elements['+ i +'].options[0].selected = true');
		}
	}
}

/**
Function to expand/collapse the <ul> elements in a treemenu

@argument menuId	String containing menu id
*/
function toggleTreemenu(menuId) {
	var elem = (document.getElementById) ? document.getElementById(menuId) : ((document.all) ? document.all[menuId] : null);
	if (elem) {
		elem.parentNode.className = (elem.parentNode.className == "treemenuExpandedImage") ? "treemenuCollapsedImage" : "treemenuExpandedImage";
		if (elem.nextSibling.nextSibling.className) { // In case only text is shown
			elem.nextSibling.nextSibling.className = (elem.nextSibling.nextSibling.className == "treemenuExpanded") ? "treemenuCollapsed" : "treemenuExpanded";
		}
		else if (elem.nextSibling.nextSibling.nextSibling.className) { // In case a link is shown, so an extra node is generated
			elem.nextSibling.nextSibling.nextSibling.className = (elem.nextSibling.nextSibling.nextSibling.className == "treemenuExpanded") ? "treemenuCollapsed" : "treemenuExpanded";
		}
	}
}

/**
Function to expand/collapse <tr> sections

@argument headerId		String containing header id
@argument rowId			String containing row id
@argument imageColor	String containing image color for collapse/expand icon (see corresponding class in css)
*/
function toggleSection(headerId, rowId, imageColor) {
	var header = (document.getElementById) ?  document.getElementById(headerId) : ((document.all) ? document.all[headerId] : null);
	var row = (document.getElementById) ? document.getElementById(rowId) : ((document.all) ? document.all[rowId] : null);
	if (header && row) {
		var collapsedImg = "collapsedImg" + imageColor;
		var expandedImg = "expandedImg" + imageColor;
		header.className = (header.className == collapsedImg) ? expandedImg : collapsedImg;
		row.className = (row.className == "collapsed") ? "expanded" : "collapsed";
	}
}

/**
Function for paging to go to the previous set

@argument myForm	String containing form name
*/
function pagingPrevious(myForm){
document.forms[myForm].target = '_self';
document.forms[myForm].pagingAction.value='paging.previous';
document.forms[myForm].target = '_self';
document.forms[myForm].submit();
}

/**
Function for paging to go to the next set

@argument myForm	String containing form name
*/
function pagingNext(myForm){
document.forms[myForm].target = '_self';
document.forms[myForm].pagingAction.value='paging.next';
document.forms[myForm].target = '_self';
document.forms[myForm].submit();
}

/**
Function for paging to change the size of the set

@argument myForm	String containing form name
*/
function pagingStepSizeChange(myForm){
document.forms[myForm].target = '_self';
document.forms[myForm].pagingAction.value='paging.step';
document.forms[myForm].submit();
}

/**
Function to select all checkboxes with the same name from a specific form
Use: onclick="selectAll('myForm', 'myField')"

@argument formName		String containing form name
@argument fieldName		String containing field name
*/
function selectAll(formName, fieldName) {
	if(!document.forms[formName]){return;}
	var objRef =  document.forms[formName].elements[fieldName];
	if(!objRef){return;}
	var	objLength = objRef.length;
	if (objLength) {
		for (var i = 0; i < objLength; i++) {
			objRef[i].checked = true;
		}
	}
	else {
		objRef.checked = true;
	}
}

/**
Function to deselect all checkboxes with the same name from a specific form
Use: onclick="deselectAll('myForm', 'myField')"

@argument formName		String containing form name
@argument fieldName		String containing field name
*/
function deselectAll(formName, fieldName) {
	if(!document.forms[formName]){return;}
	var objRef =  document.forms[formName].elements[fieldName];
	if(!objRef){return;}
	var	objLength = objRef.length;
	if (objLength) {
		for (var i = 0; i < objLength; i++) {
			objRef[i].checked = false;
		}
	}
	else {
		objRef.checked = false;
	}
}

/**
Function to get the value of any form input field
Multiple-select fields are returned as comma-separated values (Doesn't support input types: button,file,reset,submit)

@argument obj	Object to be checked
@return			Form field value
*/
function getGeneralInputValue(obj) {
	var use_default=(arguments.length>1)?arguments[1]:false;
	if (isGeneralArray(obj) && (typeof(obj.type)=="undefined")) {
		var values=new Array();
		for(var i=0;i<obj.length;i++){
			var v=getGeneralSingleInputValue(obj[i],use_default);
			if(v!=null){values[values.length]=v;}
		}
		return commifyGeneralArray(values);
	}
	return getGeneralSingleInputValue(obj,use_default);
}

/**
Function to check if an object is an Array

@argument obj	Object to be checked
@return			True if object is an Array, false if not
*/
function isGeneralArray(obj){
    return(typeof(obj.length)=="undefined")?false:true;
}

/**
Function to get the single input value (hekper function)

@argument obj			Object to be checked
@argument use_default	Default value
@return					The single input value
*/
function getGeneralSingleInputValue(obj,use_default) {
	switch(obj.type){
	    case 'radio': case 'checkbox': return(((use_default)?obj.defaultChecked:obj.checked)?obj.value:null);
		case 'text': case 'password': case 'hidden': case 'textarea': return(use_default)?obj.defaultValue:obj.value;
		case 'select-one':
			if(use_default){
				var o=obj.options;
				for(var i=0;i<o.length;i++){if(o[i].defaultSelected){return o[i].value;}}
				return o[0].value;
				}
			if (obj.selectedIndex<0){return null;}
			return(obj.options.length>0)?obj.options[obj.selectedIndex].value:null;
		case 'select-multiple':
			var values=new Array();
			for(var i=0;i<obj.options.length;i++) {
				if((use_default&&obj.options[i].defaultSelected)||(!use_default&&obj.options[i].selected)) {
					values[values.length]=obj.options[i].value;
					}
				}
			return (values.length==0)?null:commifyGeneralArray(values);
		}
	return null;
}

/**
Function that takes an array of values and turns it into a comma-separated string

@argument array		Array to convert
@return				Comma separated string
*/
function commifyGeneralArray(obj){
	var s="";
	if(obj==null||obj.length<=0){return s;}
	for(var i=0;i<obj.length;i++){
		s=s+((s=="")?"":",")+obj[i].toString();
	}
	return s;
}
/**
Function to select or deselect a series of checkboxes with the same name
Use: <a href="javascript:checkAll('formName', 'checkboxName', true)">

@argument formName		String containing form name
@argument checkboxName	String containing checkbox name
@argument checkAll		Boolean true to select all, false to deselect all
*/
function checkAll(formName, checkboxName, selectAll) {
	n = document.forms[formName].elements.length;
	for (i = 0; i < n; i++) {
		if (document.forms[formName].elements[i].name.indexOf(checkboxName) !=-1) {
			document.forms[formName].elements[i].checked = selectAll;
		}
	}
}