<require>

Name

Required

Description

type

yes

The type of file to load:

html = an HTML page or fragment for this app.

css = a CSS stylesheet that has not been configured in Presto for automatic dependency loading.

script = a JavaScript library that has not been configured in Presto for automatic dependency loading.

library = a JavaScript library that is configured in Presto for automatic dependency loading. Configured libraries, also known as named libraries, can contain any number of JavaScript or CSS files and declare any JavaScript dependencies.

src

conditional

For all files that are not named Presto libraries (type != library), this is the relative or absolute URL to the file to load with this app.

Relative URLs must point to files within the app package (see App Packages and App Files for more information). They cannot use paths that redirect up the folder tree past the app’s root folder, such as ../above-root/myLibrary.js.

name

conditional

For named Presto libraries (type = ’library’), the name of the library to load.

Important:

Presto includes certain "third party software" which JackBe licenses from third parties. Pursuant to the JackBe EULA for Presto, all Presto users are bound by the license terms and conditions of any third party software licenses. You may review these Third Party Licenses at http://documentation.softwareag.com/legal/.

Software AG does not and cannot authorize any use of third party software that is not permitted by these third party software licenses. You may, however, be able to obtain licenses directly from third parties. In addition, any other software that you add and/or use in connection with Presto is subject to its own licensing requirements and may void the terms of the EULA for Presto.

version

conditional

Identifies a version of this app resource. The specific value and meaning of the resource version depends on the value of the type attribute:

For type = 'library' (named Presto libraries), this idenfies the specific version of the named library to load. If you omit the version, the current version is loaded.

For type != 'library' (any other file), you can use this attribute to ensure that browsers load updated files rather than cached versions.

When you update an app resource, change this attribute to a number greater than the previous version number, if any. The Presto App Framework adds this number to the URL for the resource which ensures that browsers download the updated resource rather than using a cached file.

Tip:	It is a good practice to use simple integers as version numbers for app resources.

loadconfirmation

A boolean expression containing one or more JavaScript namespaces or objects from this library that must exist at runtime to confirm that this library is completely loaded. For example:

MyOrg && MyOrg.Config

Important:

Because the App Spec is XML, the JavaScript & operator must be escaped using &, the XML escape for this character.

This expression is not required but is highly recommended to ensure that libraries for the app are properly loaded before rendering.

Can Contain	Empty
Allowed In	<app> or <requires>