6.7 Action - Edit INI File

The Action - Edit INI File dialog box lets you specify a configuration file and configure the list of changes to be performed on the file. You can also create a file, if one does not exist. You can also specify the specific requirements that a device must meet for the action to be executed on the device.

To access this dialog box in ZENworks Control Center, click the Bundles tab. Click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Distribute, Install, Launch, Repair, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action.

The following sections contain additional information:

6.7.1 General

The General page lets you specify a configuration file and configure the list of changes to be performed on the file. You can also create a file, if one does not exist.

Filename

Specify the file that you want to change. For example, C:\Program Files\OpenOffice.org 2.0\program\setup.ini.

Encoding

Specify the encoding that you want to use:

Auto detect: Use the encoding used in the original file that you specified in the Filename field. This is the default option.

ASCII: Use ASCII encoding.

Unicode: Use Unicode encoding.

UTF-8: Use UTF-8 (8-bit UCS/Unicode Transformation Format) encoding.

Create File, If Does Not Exist

Specify whether you want to create the file specified in the Filename field, if it does not exist. The file is created with the same name and the extension as specified in File Path. If the file specified in File Path does not have an extension, then the created file also does not have any extension.

If this option is selected and Encoding is set to Auto detect, the file is created in UTF-8 format with the same name and the extension as specified in File Path.

INI Changes

The INI Changes page lets you specify the INI file to change, add sections to the file, add keys to a section in the file, and import changes from another INI file.

The following table lists the tasks you can perform to manage INI changes.

Table 6-1 INI Tasks

Task	Steps	Additional Details
Specify the INI file to change	Specify the file that you want to change.	For example, C:\Program Files\OpenOffice.org 2.0\program\setup.ini.
Add a section	Click Add, then click New Section Change to open the Add a Change dialog box. Fill in the fields, then click OK. Click the Help button for additional information.	If you specify an existing section and add new keys to the list, then the existing section is updated with the newly added keys. For example, if a section sect1 with k1=v1 already exists and if you specify a new section sect1 with k1=v1, k2=v2, then the newly added key k2=v2 is added to sect1.
Add keys to a section	Click the section to which you want to add the keys. Specify the keys to be added to the section in the INI file. Type the key, such as key1 or key1=value1, then click Add to move the key to the list. You can edit or remove an entry, or you can use the Move Up and Move Down buttons to order the list. The changes to the file are made in the order listed.
Edit an INI Change	Click the desired item you want to edit. The Add a Change dialog box is displayed.	The Section Change Type configured for the section is displayed by default in the Add Change dialog box.
Remove a section or keys	Select the check box next to the desired item, then click Delete.
Import INI changes from another file	Click Import to display the Import INI Changes from File dialog box. Specify the file from which you want to import changes, then click OK.
Change the order of items	Select the check box next to an item, click Edit, then select an option (Sort, Move Up, Move Down).
Select all the objects of a parent folder	Select the check box next to the parent folder, then click Edit > Select All Children.
Deselect all the objects of a parent folder	Select the check box next to the parent folder, then click Edit > Deselect All Children.
Clear Selection	Click Edit > Clear Selection.

Run Action As: Specify System (the default) or User from the Run Action As list. Specify System if removing files requires access to all areas of the device’s file system. If you use mapped network drives to specify files and directories, you must run the action as User.

6.7.2 Advanced

The Advanced page lets you create the file (if it does not exist), specify the number of backup files to retain, and specify key-value separators and comment characters.

Create File, If Does Not Exist: Specify whether you want to create the file specified in the Filename field, if it does not exist.

Number of File Backup(s) to Retain: Specify the number of backups of the INI file to retain. The default is 5 backup copies, but you can specify any number between 1 and 25. When the number of backup copies of the file exceeds the number specified here, the oldest backup file is overwritten.

Key-Value Separator: Specify the character you want to separate key values. You can use an equals sign (=) or a colon (:).

Value Separator: Specify the character you want to separate the multiple values. You can use characters such as equals sign (=), comma(,), space( ), hash (#), semicolon (;) or a colon (:).

Comment Character: Specify the character you want precede comments in the INI file. You can use a semicolon (;) or a pound sign (#).

Append key-value separator to the key when value is not available: Select this option to append the key-value separator to the key even if the value is not available. For example, in the setup.ini file used by Acrobat Reader^*, the CmdLine key does not have a value but requires a key-value separator.

6.7.3 Requirements

The Requirements page lets you define specific requirements that a device must meet for the action to be enforced on it. For information about the requirements, see Requirements.