Running Custom JavaScript™ Files

Custom JavaScript™ can also be loaded from attached JavaScript™ files. Any .js file that is added to the application in the Settings > Files section is automatically loaded into your running application. An associated JavaScript™ file is evaluated once when the browser first loads the running application, and is not called in response to any events.

Table 1. JavaScript™ objects available in attached JavaScript™ files
Variable Full name Description Example Type
app Application object Contains functions for accessing global general information
  • app.getCurrentUser();
  • A common use case for external .js files is utility methods to be executed later in events by custom JavaScript™. One example is a function to sum up all Number values in a section: 
    app.getSharedData().sumNumbers = function(section)
{
	var total = 0;
	var children = section.getChildren();
	for(var i=0; i<children.getLength(); i++)
	{
		var child = children.get(i);
		if(child.getType() === 'number')
			total += child.getBOAttr().getValue();
	}
	return total;
};
    Then from an event where you want to sum all numbers in a section: 
    var sub = app.getSharedData().sumNumbers(page.F_Expense);
 GUI
Note:

When JavaScript™ security is enabled: For added security, external JavaScript™ files that are referenced by URL do not load into the running application. Uploaded JavaScript™ files are evaluated in a safe sandbox and all content must adhere to the restrictions of the sandbox. See JavaScript Security for more details. For example, functions must be defined by using the following format: app.getSharedData().blat = function (...) { ... }

When JavaScript™ security is disabled: External JavaScript™ files that are referenced by URL are loaded by using a <script> tag and does not have access to the app variable. These scripts must use window.NitroApplication to access the Domino Volt API functions. JavaScript™ files that are uploaded to the application are evaluated by using the eval() function.