Skip to main content

 

 

 

 
Language:
 
Applies only to Web Apps
 
 
OutSystems

IncludeJavascript API

API for including scripts in Web Screens for all web apps running in the environment.

To use this API reference the IncludeJavascript_API extension using the References Window in Service Studio.

Summary

Action Description
Application_AddExclusionRule Creates exclusion rules for a script. The specified script is not included in the specified application.
Application_RemoveExclusionRule Removes a script exclusion rule. The specified script is to be included in the specified application.
Espace_AddExclusionRule Creates exclusion rules for a script. The specified script is not included in the specified eSpace.
Espace_RemoveExclusionRule Removes a script exclusion rule. The specified script is to be included in the specified application.
Script_CreateOrUpdate Creates or updates a javascript. The script is inserted in the HTML of all Web Screens of all eSpace modules.
If the script name already exists, the script is updated, otherwise a new script is created.
Script_Delete Deletes a script: the script is no longer included in Web Screens.
Script_Get Returns the information of a script.
Script_List Returns a list of scripts to be included in Web Screens.
Script_SetActive Activates a certain script to be included in Web Screens.
Script_SetInactive Deactivates a certain script. The script is not included in Web Screens.
Structure Description
ExcludedApplications Represents an exclusion rule for a specific application. Exclusion rules specify applications in which scripts are not to be inserted.
ExcludedEspaces Represents an exclusion rule for a specific eSpace. Exclusion rules specify eSpaces in which scripts are not to be inserted.
JavaScript Represents a script to be included in the HTML of Web Screens.

Actions

Application_AddExclusionRule

Creates exclusion rules for a script. The specified script is not included in the specified application.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.
ApplicationKey
Type: Text. Mandatory.
The application unique key.

Application_RemoveExclusionRule

Removes a script exclusion rule. The specified script is to be included in the specified application.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.
ApplicationKey
Type: Text. Mandatory.
The application unique key.

Espace_AddExclusionRule

Creates exclusion rules for a script. The specified script is not included in the specified eSpace.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.
EspaceKey
Type: Text. Mandatory.
The eSpace unique key.

Espace_RemoveExclusionRule

Removes a script exclusion rule. The specified script is to be included in the specified application.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script to be included.
EspaceKey
Type: Text. Mandatory.
The eSpace unique key.

Script_CreateOrUpdate

Creates or updates a javascript. The script is inserted in the HTML of all Web Screens of all eSpace modules.
If the script name already exists, the script is updated, otherwise a new script is created.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.
ScriptOrURL
Type: Text. Mandatory.
The inline script or a URL specifying where the script is located. This parameter needs to comply with the isUrl parameter.
IncludeAt
Type: Text. Mandatory.
The location in the HTML where the script is to be included. Valid locations are ‘HeadTop’, ‘HeadBottom’, ‘BodyTop’, ‘BodyBottom’.
Order
Type: Integer.
Specifies the order in which the script is to be included in the Web Screen or Web Block.
Description
Type: Text.
The documentation of the script.

Script_Delete

Deletes a script: the script is no longer included in Web Screens.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.

Script_Get

Returns the information of a script.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.

Outputs

JavaScript
Type: Record of JavaScript.
The script to be included in Web Screens.

Script_List

Returns a list of scripts to be included in Web Screens.

Inputs

ShowInactive
Type: Boolean. Mandatory.
If true returns all scripts, including scripts marked as inactive.

Outputs

JavaScriptList
Type: RecordList of JavaScript.
List of scripts.

Script_SetActive

Activates a certain script to be included in Web Screens.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.

Script_SetInactive

Deactivates a certain script. The script is not included in Web Screens.

Inputs

ScriptName
Type: Text. Mandatory.
The name of the script.

Structures

ExcludedApplications

Represents an exclusion rule for a specific application. Exclusion rules specify applications in which scripts are not to be inserted.

Attributes

ApplicationKey
Type: Text (50). Mandatory.
The unique key of the application.
ApplicationName
Type: Text (50). Mandatory.
The name of the application.

ExcludedEspaces

Represents an exclusion rule for a specific eSpace. Exclusion rules specify eSpaces in which scripts are not to be inserted.

Attributes

EspaceKey
Type: Text (50). Mandatory.
The unique key of the eSpace.
EspaceName
Type: Text (50). Mandatory.
The name of the eSpace.

JavaScript

Represents a script to be included in the HTML of Web Screens.

Attributes

Name
Type: Text (50). Mandatory.
The name of the script.
ScriptOrURL
Type: Text (4096). Mandatory.
The inline script or an absolute URL specifying where the script is located.
IncludeAt
Type: Text (50). Mandatory.
The location in the HTML where the script is to be included. Valid locations are ‘HeadTop’, ‘HeadBottom’, ‘BodyTop’, ‘BodyBottom’.
Order
Type: Integer.
Specifies the order in which the script is to be included in the Web Screen or Web Block.
Description
Type: Text (50).
The documentation of the script.
IsActive
Type: Boolean. Mandatory.
Describes whether the script is globally enabled or disabled.
ExcludedApplications
Type: RecordList of ExcludedApplications. Mandatory.
The script is not inserted in the Web Screens of these applications.
ExcludedEspaces
Type: RecordList of ExcludedEspaces. Mandatory.
The script is not inserted in the Web Screens of these eSpaces.
  • Was this article helpful?