Skip to main content
Jump to: navigation, search

Global Functions - Useful JavaScript Functions (BIRT)

Revision as of 18:13, 26 February 2009 by (Talk | contribs) (Comments)

< To: Report Developer Examples (BIRT)

Global Functions - Useful JavaScript Functions (BIRT) This example does not have a Bugzilla ID all code entered on the page.


Basic JavaScript is a good language but there are significant bits of function that are not supported. This page contains examples of useful JavaScript functions that can assist with report development.

BIRT Version Compatibility

This example was built using version 2.2 M5.

Example Files

Rather than enter these examples as functions. Each example is just pasted here in the code.

Creating Global Functions

In order for these functions to be globally accessible the function needs to be added as a global. The recommended procedure here is to use the reportContext.setPersistentGlobalVariable(name, value) function. So lets imagine that we want to create a global logging function. We would want to add the following code to any Script handler that has access to the reportContext.

function log ( str ){
reportContext.setPersistentGlobalVariable("log", log);

From that point forward, any other expression or script can access logging by just calling log("message");

The most logical place to add the creation of your global functions is the initialize method of the Report component (the top component in the outline view). Alternately, you may want to add the function to a template.

The following is the collection of useful global functions.


UCFirst (upper case first letter)

Sometimes you want to be able to have just the first letter of word capitalized, at the start of a sentence for example. This function does that for you.

function UCFirst(str){
   // split string
   firstChar = str.substring(0,1);
   remainChar = str.substring(1);

   // convert case
   firstChar = firstChar.toUpperCase(); 
   remainChar = remainChar.toLowerCase();

   return firstChar + remainChar
} // Make function globally available reportContext.setPersistentGlobalVariable("UCFirst", UCFirst); USAGE
UCFisrt("ALLCAPS"); = gives => Allcaps
UCFirst("alllower"); = gives => Alllower
UCFirst("MiXeDuP"); = gives => Mixedup

UCWords (upper case the first character of each word in a string)

function UCWords(str) {
   // split string on spaces
   arrStr = str.split(" ");

   var strOut = ;

   for (i=0;i<arrStr.length;i++)
       // split string
       firstChar = arrStr[i].substring(0,1);
       remainChar = arrStr[i].substring(1);

       // convert case
       firstChar = firstChar.toUpperCase(); 
       remainChar = remainChar.toLowerCase();

       strOut += firstChar + remainChar + ' ';

   // return string, but drop the last space
   return strOut.substring(0, strOut.length - 1);

   // Make function globally available
   reportContext.setPersistentGlobalVariable("UCWords", UCWords);

UCWords("HELLO WORLD"); = gives => Hello World
UCWords("hello world"); = gives => Hello World
UCWords("hElLo WoRlD"); = gives => Hello World


Please enter comments below by selecting the edit icon to the right. You will need a Bugzilla account to add comments.

Actually, I had issues with the for loop in function UCWords. It caused my eclipse environment to either run out of memory or to only return the first cell of a multiple cell table.

Instead, I re-coded to use:

function UCWords(str){
  var arrStr = str.split(" ");
  var strOut = "";
  var i = 0;
  while (i < arrStr.length) {
     firstChar  = arrStr[i].substring(0,1);
     remainChar = arrStr[i].substring(1);
     firstChar  = firstChar.toUpperCase(); 
     remainChar = remainChar.toLowerCase();
     strOut += firstChar + remainChar + ' ';
  return strOut.substr(0,strOut.length - 1);
} 19:49, 4 October 2007 (EDT)

Here's a modified version of the function UCWords that takes a set of word delimiters instead of just spaces:

function UCWords(str) {
	var doneStr = '';
	var len = str.length;
	var wordIdx = 0;
	var char;
	for (var i = 0;i < len;i++) {
		char = str.substring(i,i + 1);
		if (' -/#$&'.indexOf(char) > -1) {
			wordIdx = -1;
		if (wordIdx == 0) {
			char = char.toUpperCase();
		} else if (wordIdx > 0) {
			char = char.toLowerCase();
		doneStr += char;
	return doneStr;

-- niik

Back to the top