Additional Files

You can use additional files to include, e. g. a tutorial in the app. You can add a specific tutorial to each app. This tutorial can be included as a file or provided via Internet. You can also add an executable file to the app.

In this dialog you can add

1. Extension File

   An extension assembly must be a .NET assembly. Only in this case it can be added as a valid assembly.

2. External Document

   Files with various extensions (*.rtf, *.docx, *.pdf, *.txt ) can be added to an app. These files are shown in workflows and/or the app management dialog.

3. Any desired file

   Can be any file. Usually, these files will be used from within a macro and/or a C# dialog.

4. Web Link (URLs shown in the App Workflow and/or the App Management dialog)

   The selected files will be added to a grid. Based on the document type different grid columns are editable.

Meaning of the grid columns

1. File Name

   Name of the selected file without path. For Web Link this column is editable. The user can enter here two placeholders {id} and {langcode}.

   • {id} stands for the language dependent app ID.
   • {langcode} will be replaced by the current language code (en, es, de, fr, nl, ...)

   The placeholder names must be entered in lowercase characters.

2. Label

   Link entry, which is used in a workflow and/or App Management to call the corresponding text. This entry must be added to a resource file and must be read from there.

3. Use in App Management

   Specifies whether this text shall be shown in App Management form.

4. Use in Workflow

   Specifies whether this text shall be shown in the current workflow.

5. Uninstall

   Previously, when an app was deleted, only the entries from the SmartAnalyzer content database were removed. All additional files remained on the user’s hard disk. With SDK 5.0, you can now determine which files will be removed or retained when the app is uninstalled, because it is possible that additional files are also used by other apps.

6. Version

   Document version if there is any. Usually only used for DLL and EXE files which have version information.

7. Location

   Directory where the file shall be installed. Only editable for Any Desired File. The following placeholders can be used here:

   Placeholders for files 

   Placeholder	Description
   {id}	current language dependent app only values, no separators
   {langcode}	current app language code (en, es, de, fr, nl, …)
   {name}	current app name
   {version}	current app version formatted with '.' (format Major, Minor, Build)
   {alias}	current app alias
   {owner}	current app owner, e. g. CaseWare Germany GmbH

Step-by-Step

1. Click the browse button next to the Additional Files field. A dialog box opens. You can add an Extension File, an External Document or a Web Link.
2. Click the corresponding icon and select a document or enter a link.
3. Double click the Label area and enter a name. The name will be shown in SmartAnalyzer in the Management module. For executable files you cannot enter a name but the version number will be displayed.
4. Save the changes by clicking the Apply and Close icon.

Click the Remove Supplementary File icon to delete the selected additional file.

Using the Cancel icon you can discard all your changes.