VTL include properties - Settings tab

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.

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 a 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 directly from the web using URL parameters. If necessary, permission verification must therefore be performed in the code of the VM files, so that unauthorized access to sensitive information is prevented.

Examples Verify access 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.