Difference between revisions of "Passing Values Using Parameters"

Revision as of 11:16, 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 parameter 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

Portal

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

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

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

Application

• Create a Custom Field of the type Read Only - System Variables with one of the following.

Display as button

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

Display as hyperlink

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

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.

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.