VTL include properties - Settings tab

Applications module VTL Include Properties

Refer to a Velocity file in the application

The path and name of the referenced Velocity file are shown. All Velocity files from the application package are stored in the portal directory internal/application/store/<AppGuid>/resources.

Select Velocity file
Opens the Velocity file manager. An existing Velocity file from the application package can be referenced or a new file can be created.

Edit Velocity file
Opens the Velocity editor.

All Velocity files from the application package are saved to the portal directory \internal\application\store\<AppGuid>\resources.

Refer to a Velocity file on the server

An existing Velocity file available on the server can be referenced here.

Copy Velocity file from the server to the application
Opens the Velocity file manager where the Velocity file can be selected.

Security notice
Files with the extensions .vm and .vmi that contain Velocity scripting code are Velocity files. Velocity files can only be executed if they are stored within certain subdirectories of the portal's directory. These subdirectories are:
  • internal/system/vm/
  • internal/layout/vm/
  • internal/application/vm/
  • internal/application/resource/
  • internal/workflow/<GUID>/velocity/
Velocity files that end in .vm can be called up diretly from the web using URL parameters. If necessary, permission verfications must therefore be performed in the code of the VM files, so that unauthorized access to sensitive information is prevented.

Examples
Verify read permissions for a data group:
$AccessController.hasDatagroupPermissionFromPage($ProcessingContext, $appGuid, $dataGroupGuid, "read")
Verify access permissions for a page:
$AccessController.hasPagePermission($appGuid, $pageGuid, "access")
The file extension .vmi stands for Velocity files. As opposed to Velocity files with the extension .vm, VMI files cannot be called up directly from the web. For this reason, security checks, which have already been performed in the calling Velocity files, do not have to be performed again in VMI files. To use this element, you need to have experience with scripting languages and ideally also in Java development. United Planet does not provide any support for the use of VTL in Intrexx.