JavaScript Functions and Variables

These Javascript functions and variables are available for use in a JSP/HTML Page in the platform. They can also be used in Javascript defined for Action buttons.

Functions

lj_closeDialog

Close the current dialog. Typically used in conjunction with lj_refreshCurrentTab.

Sample Usage

Javascript closeDialog Sample

Syntax

lj_refreshCurrentTab();

lj_printRecord

This function displays a customized print dialog for a record. Use it to set defaults, to limit the available choices, and to choose the Print Template which is used. (It is only available for Custom Objects.)

Sample Usage

This code adds a [Custom Print] button to a Form, when placed in an On Load Form Script. In this case, the goal is restrict a user who has access to that form to a specific template. (The standard Print operation makes all templates available. A standard Action button, meanwhile, is present in every form. This code puts the button in a specific form, to restrict template access for users whose role causes it to be displayed.)

$("print_button").remove(); 
$("#edit_button").parent().append(
"<input type='button' id='customPrint' value='Custom Print' class='lj-button fg-button ui-state-default ui-corner-all' onClick=\"javascript:lj_printRecord('default_print_layout=template&show_print_layout=no&default_print_document=jsp&default_page_orientation=landscape&default_pdf=yes&show_pdf=no&print_immediately=yes');\">"
);

How it Works

$("print_button").remove()

Remove the standard print button

$("#edit_button").parent().append

Finds the location of the edit button (present in every form), gets it's parent (the toolbar), and adds the new button to it.

class='lj-button fg-button ui-state-default ui-corner-all'

The standard CSS style elements for platform buttons.

<input type='button' ...

Define the button. (The entire string is one uninterrupted line.)

onClick=\"javascript:lj_printRecord(...

Specify the button's action

Syntax

lj_printRecord('{option1}={value}&{option2}={value}&...');

Parameters

Each option has two parameters: One to specify a default value, the other to determine whether it should be displayed so it can be overridden by the user.

By default, an option is always shown, unless explicitly hidden.

Parameter	Description (default value in bold)
default_print_document	Object form or JSP/HTML [Page]
show_print_document	yes
default_print_layout	The form layout or template page to use.
show_print_layout	yes
default_page_orientation	portrait or landscape
show_page_orientation	yes
default_pdf	yes (otherwise, an HTML page is generated)
show_pdf	yes
print_immediately	no (queued, instead)
show_print_immediately	yes

lj_refreshCurrentTab

Refresh the current tab. Typically used in conjunction with lj_closeDialog

Sample Usage

Javascript closeDialog Sample

Syntax

lj_refreshCurrentTab();

lj_refreshTab

Refresh a specific tab. Typically used in conjunction with lj_closeDialog

Sample Usage

Javascript closeDialog Sample

Syntax

{window}.lj_refreshTab();

lj_showDialog

This function displays a JSP/HTML Page as a dialog.

Sample Usage

This sample displays a page at the specified URL in a popup dialog that has a close button.

var url = "/networking/pages/MyPage.jsp?recordId="+someValue
        + "&returnUrl="+encodeURIComponent(lj_window_src);

top.lj_showDialog(url,300,350,"popupdialogWithCloser","My Page Title");

Syntax

lj_showDialog(url, height, width, "dialog style", "title");

Parameters

All parameters are coded as strings.

Parameter	Description
url	The URL of a JSP/HTML Page in the platform, in the form /networking/pages/SomePage.jsp with optional query parameters to pass data, in the form ?param1=abc&param2=xyz&...
height	The height of the dialog window, in pixels.
width	The width of the dialog window, in pixels.
dialog style	A string that specifies the display style popupdialogWithCloser - Displays the dialog with a close button. popupdialog - Displays the dialog without a close button. Note: There is also no close icon in the corner, with this option. When using it, add your own controls to close the dialog.
title	Displayed in the banner of the dialog.

Variables

lj_window_src

Contains the URL of the current page. (Needs to be URL encoded when used.)

Sample Usage

encodeURIComponent(lj_window_src)