Product Documentation

Self-Provisioning settings

Oct 08, 2015

The Settings dialog box contains general AppDNA options. To open the Settings dialog box, choose Edit > Settings from the menus.

Use the Self-Provisioning page of the Settings dialog to configure Self-Provisioning and customize how the stand-alone Self-Provisioning client appears to your users. For example, you can add welcome, completion, and error texts, and also your company logo.

After making changes in this dialog, click Save to preserve your changes.

General Tab

Output Path – Replace the default value (\\<server>\<share>\appdna_capture) with the path to the location where you want the output to be stored. This defines where the Self-Provisioning client instruction files are stored. When working in connected mode, it also defines the location where the Self-Provisioning client stores the output.

Logo – Add your company logo so that it is displayed when a user runs the stand-alone Self-Provisioning tool.

Execution Profiles Tab

Execution profiles control the tasks and resources that are run on the Self-Provisioning client machine. The Execution Profiles tab lists the execution profiles that already exist. Each execution profile has a unique name, which is used to identify it – for example, in the execution profile drop-down box on the Self-Provisioning tab in the Import Applications screen.

The Execution Profiles tab provides the following buttons:

New – Add a new execution profile. This opens the Edit an execution profile.

Edit – Edit the selected execution profile. This opens the Edit an execution profile where you can make any necessary modifications to the selected execution profile.

Delete – Delete the selected execution profile.

Set as Default – Set the selected execution profile as the default execution profile. This means that it is selected by default in the execution profile drop-down box on the Self-Provisioning tab in the Import Applications screen.

Import – Import an execution profile from an XML file. This can be an XML file that you saved earlier or an XML file provided by Citrix.

Export – Export an execution profile to an XML file. It is recommended that you use this feature to create a backup of an execution profile before changing it.

Replaceables Tab

Use the Replaceables tab in Self-Provisioning Settings to define replaceable values for use in the execution profiles used in the Self-Provisioning tool. However, the replaceable values you define here are overridden if values are explicitly defined for those replaceables in the execution profile itself or in the Quick Edit Parameter box in the Import Applications screen.

Replaceables are placeholders that are replaced by a value provided at run time. The syntax for including a replaceable in the execution profile is: $(replaceable_name), where replaceable_name is the name of the replaceable.

The AppToolsFolder replaceable is used to specify the location of the tools installed on the Self-Provisioning client machine by the Citrix AppDNA VM Configuration MSI. By default, these are installed to C:\Program Files\Citrix\AppDNA\VM Configuration (or C:\Program Files (x86)\Citrix\AppDNA\VM Configuration on 64-bit machines). The default value for the AppToolsFolder replaceable uses the %APPDNAVMCONFIG% environment variable. This stores the actual installed location of the tools. It is created by the AppDNA VM Configuration MSI when the tools are installed.

To define a replaceable value for Self-Provisioning:

  • If the replaceable whose value you want to change is in the list, select it and click Edit. This opens the Edit Text dialog box, in which you can enter or paste the new value.
  • If the replaceable whose value you want to define does not appear in the list, click New. This opens the Edit Replaceable dialog box, in which you can enter the new replaceable and its value.

The following list shows replaceables that are used internally. AppDNA automatically sets the values of these replaceables and you do not need to do this manually.

  • App:InstallCommand
  • App:InstallDriveLetter
  • App:InstallWrkDir
  • App:Manufacturer (Only used in Forward Path task scripts.)
  • App:Name (Only used in Forward Path task scripts.)
  • App:Version (Only used in Forward Path task scripts.)
  • Capture:ImportInputFile
  • Capture:InputFile
  • Capture:Mode
  • Capture:OutputFile
  • Capture:OutputDirectory
Note: These replaceables have a colon (:) in their name. This indicates that this is an internal replaceable defined by Citrix. If you create your own replaceables, make sure that they do not include a colon in the name. This will ensure that the name will not conflict with an internal replaceable provided by Citrix in the future. The part of the name before the colon provides an indication of how the replaceable is used. For example, App indicates that the replaceable provides information about the application that is being processed and Capture indicates that it relates to the current capture state.

Text Tab

Use the Text tab to define text to be displayed to the user of the stand-alone Self-Provisioning tool.

Error Text – This is displayed when an error occurs.

Completion Text – This is displayed to users when they finish an application capture.

Welcome Text – This is displayed to users when they start the tool.

Advanced Tab

Restore Defaults – This restores all of the Self-Provisioning settings to their default values. For example, it deletes any replaceables that have been created and removes any changes to the default execution profile.

Click Save to preserve your changes.