LongJump Support Wiki

JavaScript Functions and Variables

From LongJump Support Wiki

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.

JavaScript Functions

These functions are available anywhere that JavaScript is running on the platform.


Notepad.png

Note: Examples on this page have newlines added for readability.

showTab

Display an object list view (list of object records) as a tab in the GUI.

Syntax
showTab(key, tabTitle, url);
Parameters
  • key - Unique key that identifies the tab. Object ID is recommended.
  • tabTitle - The tab label.
  • url - The URL used to render the view, in the form: Service?t=499&object_id={id}
Optionally, add &show_layout={viewId} to specify a particular view.

Learn more:

Sample Usage

Here is the basic usage pattern: 

<a href="javascript:top.showTab('{objectId}','{Tab title}',
'Service?t=499&object_id={objectId}');">{Link title}</a>

Show the default view of the Orders Object (ID=bd5b766236dd487c8cce3648bd5ffe64) 

<a href="javascript:top.showTab('bd5b766236dd487c8cce3648bd5ffe64','Orders',
'Service?t=499&object_id=bd5b766236dd487c8cce3648bd5ffe64');">View Orders</a>

Show a specific view with ID de5dnnn8798, instead of the default view: 

<a href="javascript:top.showTab('bd5b766236dd487c8cce3648bd5ffe64','Orders',
'Service?t=499&object_id=bd5b766236dd487c8cce3648bd5ffe6464
&show_layout=de5dnnn8798');">Orders</a>

showTabInIFrame

Display a record form as a tab in the GUI, using the form either to add a record to an object or to display record details.

Syntax
showTabInIframe(key, tabTitle, url, preserveTabTitle);
Parameters
  • key - Unique key that identifies the tab. {objectId}-1 is recommended.
  • When a new record is displayed using that key, the tab is reused. Adding a dash and a one differentiates the record tab from a view tab.
  • Using the record ID for that purpose isn't recommended, because records in different objects could conceivably have the same record ID.
  • To make every record open in a different tab, you could use {objectId}-{recordId}
  • tabTitle - The tab label.
  • When displaying a record, the label is overwritten with the Object name and the Record Identifier
  • Standard practice in that case is to use it as a temporary label. For example: 'Loading...'
  • url - The URL used to display the record: Service?t=498&object_id={id}
  • Add &id=-1&a=add to add a new record
  • Add &id={recordId}&a=view&policyaction=view to display an existing record
(In each case, the Form used to display the record (or gather data for it) is determined by the user's Role and the action being performed.)
  • displayTitle - Boolean value that determines whether or not the specified title is used.
  • If true, the specified title is used for the tab label. (Must be true for a temporary label to be displayed, as well.)
  • If false, the Object name is used, instead.

Learn more:

Sample Usage

Here is the basic usage pattern: 

<a href="javascript:top.showTabInIframe('{objectId}-1','{Tab title}',
'Service?t=498&id=-1&a={action}&object_id={objectId}', true);">{Link Title}</a>

This example opens a tab to add a record to the Orders Object (ID=bd5b766236dd487c8cce3648bd5ffe64): 

<a href="javascript:top.showTabInIframe('bd5b766236dd487c8cce3648bd5ffe64-1',
'New Order','Service?t=498&id=-1&a=add&object_id=bd5b766236dd487c8cce3648bd5ffe64');">
Add Order</a>

This example opens a tab to display a record, where:

  • objectID = 088d7ac50c4349b5b08d06cc8fa4e732
  • recordID = 255796565
     
<a href="javascript:top.showTabInIframe('088d7ac50c4349b5b08d06cc8fa4e732-1', 
'Loading...','Service?t=498&id=255796565&object_id=088d7ac50c4349b5b08d06cc8fa4e732
&a=view&policyaction=view', true);">Details</a>
Learn more: HowTo:Use a SQL Query to List Records in a Custom Page

lj_closeDialog

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

Syntax
lj_refreshCurrentTab();
Sample Usage
function closeDialog()
{
    if ( $.browser.msie ) 
    { 
        top.lj_closeDialog()
        top.lj_refreshCurrentTab();
    }
    else
    {
        top.getActiveTabWindow().lj_refreshTab();
        top.lj_closeDialog();
    }
}

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.)

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_print_layout form (default) - use a Print Form
template - use a Print Template
show_print_layout yes (default) - allows user to specify which kind of layout to use
default_print_document The name of the form or template to pre-select in the list of possible choices.
show_print_document yes - allows user to change the default choice
print_immediately no (default) - The print dialog is shown. The user can then change any options that are displayed. Printing occurs when the user clicks the Print button).
yes - printing occurs immediately and the results are displayed in a new window. (It only works if both default_print_layout and default_print_document are specified.)
default_page_orientation portrait (default) or landscape
show_page_orientation yes - allows user to change page orientation
default_pdf yes - otherwise, an HTML page is generated
show_pdf yes - allows user to choose HTML or PDF
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 to 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 the code 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


lj_refreshCurrentTab

Refresh the current tab. Typically used in conjunction with lj_closeDialog

Syntax
lj_refreshCurrentTab();
Sample Usage
function closeDialog()
{
    if ( $.browser.msie ) 
    { 
        top.lj_closeDialog()
        top.lj_refreshCurrentTab();
    }
    else
    {
        top.getActiveTabWindow().lj_refreshTab();
        top.lj_closeDialog();
    }
}

lj_refreshTab

Refresh a specific tab. Typically used in conjunction with lj_closeDialog

Syntax
{window}.lj_refreshTab();
Sample Usage
function closeDialog()
{
    if ( $.browser.msie ) 
    { 
        top.lj_closeDialog()
        top.lj_refreshCurrentTab();
    }
    else
    {
        top.getActiveTabWindow().lj_refreshTab();
        top.lj_closeDialog();
    }
}

lj_showDialog

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

Syntax
lj_showDialog(url, height, width, "dialog style", "title");
Parameters
Parameter Description
url A string that gives the URL of a JSP/HTML Page in the platform, in the form /networking/pages/SomePage.jsp with optional query parameters to pass data: ?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.
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");


Global JavaScript Variables

The following JavaScript variables are global. They are available in all JavaScript code running on the platform.

Considerations
  • Variable names are case-sensitive
  • In a Site, no one is logged in, and the page is not running on the platform, so the variables have no meaning in that context.

User Variables

LJUserName
Name of the (logged in) User
LJPrimaryTeamName
Name of the Primary Team (user is a member of this team)
LJPrimaryTeamRoleName
Role of the User in the Primary Team

Page Variables

lj_window_src
Contains the URL of the current page. (Needs to be URL encoded when used.)
Sample Usage
encodeURIComponent(lj_window_src)
Retrieved from "https://agileappscloud.info/ljwiki-src/index.php?title=JavaScript_Functions_and_Variables&oldid=10590"