DigitalSuite distinguishes between the following types of files associated with projects but non-native to the platform:
Versioned files: These files contain code or data for an application. Like other application resources, they can have multiple revisions. Although the supported file types are not limited, versioned files are typically in one of the following formats: CSS (
.js), FreeMarker Template Library (
.ftl), PDF (
Non-versioned files: These files can hold any kind of contents, ranging from plain text and images to reports and database dumps. Like versioned files, they are stored with projects in DigitalSuite, but they cannot have different revisions and are independent of project versions. Non-versioned files may be created, for example, by uploads at a web interface, downloads from a web service, or exports of a report or a collection.
If required, non-versioned files can be turned into versioned files, but not vice-versa.
Files and their configuration comprise the following settings, which are described in detail in the sections below:
The following settings identify both versioned and non-versioned files in DigitalSuite:
- Name: The name of the file, optionally including an extension that determines the file type, for example,
.xmlfor XML files.
- Type: The file type, depending on the extension, for example,
image/png. If the extension is unknown or not present, the type is
- ID: A generated number used to uniquely identify the file.
- URL: A generated URL including the DigitalSuite base URL (
live.runmyprocess.com). The URL can be used, for example, to access the file from web interfaces or external web services.
- Engine: The DigitalSuite Web Interface Engine used to create or upload the file. This setting is only available for non-versioned files.
Designers can create and manage versioned and non-versioned files at their projects in DigitalSuite Studio. A built-in editor allows for viewing and editing the contents of files of specific known types, such as CSS, CSV, FTL, HTML, JS, TXT, or XML. Files of other types can be created and updated by uploading them to the projects.
Non-versioned files can also be created and accessed in the following ways:
- FreeMarker functions in processes.
- Specific actions in DigitalSuite, such as exporting a collection or a report.
For files which are created or updated during the execution of a web interface or process, the execution mode is recorded.
Access to both versioned and non-versioned files can be set to public or private. Public files can be used and downloaded on web pages and interfaces without verification while users need to authenticate and have the required permissions to access private files.