Package template files

When packaging a template, you determine the files to include and how the Template Installer wizard will look and behave. In addition to identifying the template to be packaged, you also decide on the location where it should be installed, the layouts to include, and any external files that need to be installed with the template.

To package template files:

  1. Launch Working Papers.
  2. From the File menu, click Templates.
  3. Add your new template file. Select the template and click Package.
  4. The Create Template Package dialog displays. Click Next.
  5. Set the global options for your template package. Click Next.
  6. Set the branding options for your template package. Click Next.
  7. Select a layout for your template package. Click Next.
  8. Specify the files and folders to include in your template package. Click Next.
  9. Specify any external applications to execute before or after installation. Click Finish.

The template files are packaged. You can distribute the template package to your staff for installation.

Global options

Specify how the Template Installer Wizard will look and behave.

Option Description
Output File

This field displays the file path where the packaged template will be located. Caseware only supports the existence of one .ac or .ac_ file in this folder. Client files residing in subfolders of the top-level folder are not supported. Click Browse to choose a different location and specify a file name.

Client File
  • When selecting a template: Click Browse to select the template you want to package. If a template was selected in the Templates dialog, that selection is automatically input as the client file.

  • When creating a shared files package: Use the drop-down list and select None (Create Shared Files Package). A Shared Files Package will be created. These packages consist of files that target multiple templates and cannot be uninstalled.

Template Name

This field specifies a template name to identify the template that will be installed from this package.

Version

This field specifies a version number for the package. Enter version numbers in the boxes to keep track of different versions.

The version number is added to the registry during the installation of the template. The version information is used to determine which version to overwrite when you are patching a template.

Version Tag

This field specifies a unique tag provided to the package. You might want to have different builds of the same version (for example a US build and a Canadian build).

The version tag is added to the registry during the installation of the template. The version information is used to determine which version to overwrite when you are patching a template.

Registry File

Select a registry file if there are elements in the template that require modification of the registry. Use the drop-down menu or click Browse to select a registry file.

Allow this template to be repackaged

Select to allow the template to be repackaged.

Note: Preventing templates from being repackaged on a machine where the template is already installed is a known security measure.

Allow minimal options on repackage

Select to specify additional controls if Allow this Template to be Repackaged is selected.

When this check box is selected and a template is being repackaged, only the Global Options page is displayed in the wizard. Within the Global Options page only the Output File and Template Name fields can be changed.

Enforce a minimum Caseware version of:

Select to limit the template to be used with a minimum version of Caseware Working Papers.

If this check box is selected, use the drop down list to select a version and enter a build number in the Build field to specify the minimum version of Working Papers and build number for this template to be used in.

Install template in document library

Select to install the repackaged template in the document library.

Do not register template

Select to install the template without registering it. No registry key will be added for the template and it will not be displayed in the list of templates that new client files can be based on.

Note: This option is only available if Install Template in Document Library is selected.

Allow template patch package creation

If selected, the Make Patch button displays when a user selects this template from Tools | Templates.

Allow user to directly open template after install

Select to allow the template to be opened after installation.

In the last page of the installation wizard, a check box (Open the Template for editing) is shown. If this check box is selected the template will be opened in template mode once the template packager is closed.

Ensure that the files in the package match the actual file list

Select to perform a verification of the files when they are compressed into the package.

More...

Click to open the More Options dialog. The dialog provides two drop-down option lists:

Options for backing up the existing template:

  • Default unselected
  • Default selected
  • Do not show backup option

Options for uninstalling the existing template:

  • Optional, default selected
  • Optional, default unselected
  • Force uninstall
  • Force overwrite

Branding options

Customize the branding of the Template Installer Wizard.

Option Description
EULA

Include an End User License Agreement (EULA) that the user must accept before the installation can proceed.

You can enter the file name, use the drop-down list, or click Browse to select an *.rtf or *.txt file.

Intro Page Text

Include text to be displayed on the first page of the installation wizard.

You can enter the file name, use the drop-down list, or click Browse to select an *.rtf or *.txt file.

Watermark

Include a custom image to show on the left side of the first page of the installation wizard.

You can enter the file name, use the drop-down, or click Browse to select a *.bmp file. For optimum resolution, the size of the watermark graphic must be 165x450 pixels.

A preview of the watermark displays at the bottom of the dialog.

Header

Include a custom image in the header of the installation wizard.

You can enter the file path, use the drop-down list, or click Browse to select an *.rtf or *.txt file.

A preview of the header displays at the bottom of the dialog.

Icon

Include a custom icon to represent a template in the Templates dialog.

You can enter a file path, use the drop-down list, or click Browse to select a *.bmp or *.ico file. A preview is shown in the Icon box.

A preview of the icon displays at the bottom of the dialog.

Layout

Customize the layout of the Template Installer Wizard.

Option Description
Change Source

Click this button to select another file path where layouts are located.

Layouts

Select the check box beside each layout you want to include in the template package.

Note: If the selected layout requires dependent layouts, those layouts are automatically included, even if you haven't selected them. The next time you package template files, the layouts previously selected and their dependent layouts are automatically selected and are always included in the package.

Overwrite Actions

Select an option to overwrite existing layouts.

  • Merge folder contents

    Combines the selected layouts and overwrites any existing version of the layouts when the template is installed on the user's machine.

  • Skip if folder exists

    Skips overwriting any layouts if they already exist on the user's machine.

  • Delete existing folder and then replace

    Deletes the existing layout folder and copies layouts from the template package.

Note: If the selected layout requires dependent layouts, those layouts are automatically included, even if you haven't selected them. The next time you package template files, the layouts previously selected and their dependent layouts are automatically selected and are always included in the package.

Specify files

Specify which files to include in the template package and where to install them.

Option Description
Destination

The files selected for each category will be installed to the following locations:

  • CaseView Browse Definitions: <Program Folder>
  • CaseView Stylesheets: <Program Folder>\styles
  • CaseView Cell Group Files: <Program Folder>
  • Scripts: <Program Folder>\scripts
  • Global Databases: <Program Folder>
  • Knowledge Libraries: <Program Folder>\Library or specified during install
  • Program Folder: <Program Folder>
  • Client Files: <Program Folder>
Source File Name

This column specifies the file path of the files to be included.

Add Files

Click this button to include individual files.

Add Folder

Click this button to include folders. Including a folder will include all of the files within the folder.

Remove Click this button to remove a file or folder.

External programs

Specify which external programs to execute before or after installation, or uninstallation of the template package.

Option Description
Add

Add an external program to execute with the template package. You can designate when the program will execute by filing it under the applicable label:

  • Execute before installation: Applications added here will be executed before the template is installed.
  • Execture after installation: Applications added here will be executed after the template is installed.
  • Execute before uninstillation: Applications added here will be executed before the template is uninstalled.
  • Execute after unistillation: Applications added here will be executed after the template is uninstalled.
Remove Remove an external program from executing with the template package.
Label

This field specifies a unique label assigned to each application.

Source Folder

This field specifies the file path of the application.

Executable

This field specifies the name of the application.

Command line

This field specifies additional parameters that are needed to run the executable. When the package is subsequently installed, the macros expand to the corresponding paths entered by the user on the Summary page and pass as parameters to the Template installer.

Available macros include:

  • %PRG_PATH%: Path to the Caseware program folder as entered by the user.
  • %TEMPLATE_PATH%: Path to the Template (or Document Library) folder as entered by the user.
  • %KL_PATH%: Path to the Knowledge Library folder as entered by the user (if specified).
  • %GUID%: GUID of the template being installed.
  • %INSTALL_PATH%: Path to the folder containing the template's files (e.g., C:\Caseware\Template\MyTemplateName).
Include all files and subfolders in the same directory

Select this option to include all supporting files needed for installing the application.

Note: Use this check box with caution; if, for example, you put the executable on your C: drive and select this check box, then all files on your C: drive are included in the template package.

Do not run in unattended mode

Choose this option to prevent the selected executable from running in unattended mode.

Advanced...

The Advanced Options dialog allows you to control how Working Papers should handle external programs and script exit codes when installing templates.

  • Installer waits until external program finishes executing: Removes a subscription to the selected content.

  • Process program exit code: Unsubscribes from all dependent content on the selected item, but leaves you subscribed to the item itself.

    For example, if you unsubscribe from the dependent items on a File Request (an activity), you will not receive any notifications about comments or attachments on the activity. If another user modifies the File Request itself, however, you will receive a notification email.

  • If exit code is: Select the condition that the template packager should verify.

    then: Select the result that the template packager should enforce if the condition is met. Options include:

    • continue install, do not report error

      The installation will continue as if no error occurred. No error will be reported.

    • continue install, report error

      The installation will continue until completion, the final page will indicate that the installation was completed, but an external program reported an error.

    • abort install, report error

      The installation will stop. A pop up dialog will display informing you that an error has occurred with the currently executing external program and installation will terminate. The final page of the installer will inform you that an error has occurred.

    • prompt to continue, report error

      The installation will stop. A prompt will display informing you an error occurred with the currently executing external program and will ask if you wish to continue with the installation. If you select No, installation will terminate and the final page will inform the user an error has occurred. If you select Yes, the installation will proceed and the final page will indicate the installation was completed, but an external program reported an error.