Adding Files to a Package

Learn how to add files to package.

Import Settings You can add individual files to a package. For details on adding multiple files and directory structures to a package, see Adding Directories and Files to Packages . To add a file to the package:

  1. Switch to the process.
  2. Click on next to Referenced Items and select File from the list.
  3. Select the file you wish to include from the file system.
  4. Files can be either stored as documents in the Aurea.CRM database on the development system or on your local file system. Select the appropriate option under Embed file as:
    • document in the Aurea.CRM database: The selected file is saved in the Documents table in the Aurea.CRM database on the development system.
    • file name only: Only the path to the file is stored in the Aurea.CRM database. If you use this option, ensure that all users who export packages can access the required file paths.
  5. Enter the Destination directory for the file on the target system. When importing the file on the target system, the file is copied to the destination directory on the target system and the file path on the target system is updated. You can use placeholders in the path name. Define placeholders using the '$' character followed by the name of the placeholder, e.g. '$WEB'. The placeholder continues until the next '\' character or until the end of the path if no '\' follows the placeholder. You can use multiple placeholders in the same path (e.g. '$DRIVE\$WEB\$FILE_DIRECTORY').
    Note: A placeholder cannot consist of only the $ character (e.g. '$' and '\$\foo' are invalid) and cannot contain multiple $ characters one after another (e.g. '$$FOO').

    Always use the '$WEB' placeholder for files used by Aurea.CRM web and Aurea.CRM web offline, as CRM.cockpit checks for files containing the '$WEB' placeholder when importing a package if the Deploy web offline files option is enabled. update also recommends using '$WIN' as the placeholder for the Aurea.CRM win installation directory.

When importing the package, you are asked to select directories to replace your placeholders, see Importing Packages . If you are using the command line to import packages, define the target directories for placeholders in the XML file used to define the import settings, see Import Settings .

Generally, files in a package are configuration files, such as XSLT stylesheets or JavaScript files for Aurea.CRM web.