Difference between revisions of "Passing Values Using Parameters"

Revision as of 16:46, 8 October 2009

Using several techniques you can pass values from one page to another in order to pre-populate form fields or display on an HTML page.

Sending Page

Values can be sent from the initial (sending) page by creating a link to the destination page that includes parameters linking the variables to be passed.

Syntax:

/urltopage?parameter1=@variable1@&parameter2=@variable2@

Where:

• urltopage is the relative URL to the destination page.
• variable1, variable2 etc. are the variable names (eg. @firtsname@).
• parameter1, parameter2 corresponding names for the variables

Examples:

Portal

• Create a Portal shortcut and associate the link with that shortcut.

/urltopage?parameter1=@variable1@&parameter2=@variable2@

Button

• Create a Read Only - System Variables Custom Field with:

 <input type="button" class=Button value="Button Label" 
 onClick='parent.location.href="/urltopage?parameter1=@variable1@&parameter2=@variable2@"'/>

Hyperlink

• Create a Read Only - System Variables Custom Field with:

<a href="/urltopage?parameter1=@variable1@&parameter2=@variable2@">Click Here</a>

Note: User and Company variables can be used to pass the current logged in user details and their company details.

Receiving Page

On the receiving page the parameters can pre-populate a form or an HTML element which resides on that page. In order to achieve this the following JavaScript functions can be used.

Place the following first function in the head of the HTML.

function getParams() {
var idx = document.URL.indexOf('?');
var params = new Array();
if (idx != -1) {
var pairs = document.URL.substring(idx+1, document.URL.length).split('&');
for (var i=0; i<pairs.length; i++) {
nameVal = pairs[i].split('=');
params[nameVal[0]] = nameVal[1];
   }
}
return params;
}
params = getParams();

Place one of the following second functions in the body at the end just before the closing body tag </body>.

Form Field Population

<script>

var para1=document.getElementById('field1');
var para2=document.getElementById('field2');

para1.value = unescape(params["parameter1"]);
para2.value = unescape(params["parameter2"]);


</script> 

HTML Element Population (eg. <div>, <span>)

<script>

var para1=document.getElementById('element1');
var para2=document.getElementById('element2');

para1.value = unescape(params["parameter1"]);
para2.value = unescape(params["parameter2"]);

</script> 

Replace "field1" or "element1" etc. with the actual form or element id name and "parameter1" with the parameter name.

eg.

var para1=document.getElementById('firstname');

<input type="text" value="" id="firstname">

or

var para1=document.getElementById('firstname');

<div id="firstname"></div>

SmartSimple will replace the variable references (@lastname@ etc) with values derived from the current user session.