|
<< Click to Display Table of Contents >> RayPack > 7.3 u6 > User Guide > PackDesigner > MSI / MST / RPP Based Projects > Visual Designer Mode > Setup Options > System Search Add a Custom Search |
In order to add a new predefined system search to a packaging project, users go to the System Search view of the Visual Designer mode.
With a click on the Create new... button, the options menu is displayed. Click on Custom search to invoke the New System Search Wizard.
Work your way through the steps of the wizard to define all required properties for the new item.
At any time, using the Next or Back buttons, which are displayed at the bottom of the wizard dialog, allows to navigate within the already processed steps.
To exit the wizard without creating a new object, use the Cancel button, also located at the bottom of the wizard dialog.
Property
Please select the property that will store the result of the system search. It has to be a public (Uppercase) property, which is already present in the current packaging project. If the desired one is not shown within the property options, exit the wizard and create it by the interface available from the Properties view.
To actually pick a property, click on the option of the selector controls option list, an use the Next button at the bottom of the dialog, which becomes active as soon as a search type is selected.
There is a predefined set of typical search types, users may select from:
•File - search for a file on the target machine
•Path - search for a directory on the target machine
•Registry - search for a registry value on the target machine
•Component - search for a component on the target machine
•INI - search for a specific INI file value on the target machine
To actually pick a search type, click on the icon at the left-hand side of its name, an use the Next button at the bottom of the dialog, which becomes active as soon as a search type is selected.
If searching for a file has been selected during step 2, this additional step is required to define where the path to the requested file will be stored:
•Path - the path is exactly the same as for the given file source
•Registry - the path is stored within a registry value
•Component - the path is defined by a component key path
•INI - the path is defined within an INI file
To actually pick a search location type, click on the icon at the left-hand side of its name, an use the Next button at the bottom of the dialog, which becomes active as soon as a search type is selected.
If searching for a file has been selected during step 2, this additional step is required to define some key properties used to determine whether a found file matches the search:
File name
Use the browse button at the right-hand side of the input field to select a file from the local system. The properties provided by the selected file will automatically be read to fill in the following properties as well as possible:
Minimum / Maximum version
Enter a value to determine the minimum / maximum version of the searched file. If the file on the target machine does not have a version between minimum and maximum, it is not regarded as a match for the system search task.
If only one version limit is entered, any file version above (if a minimum was given) or below (if a maximum was given) will be valid for a match.
Minimum / Maximum size
Enter a value to determine the minimum / maximum size of the searched file in bytes. If the file on the target machine does not have a file size between minimum and maximum, it is not regarded as a match for the system search task.
If only one size limit is entered, any file size above (if a minimum was given) or below (if a maximum was given) will be valid for a match.
Not older / newer than
Activate the checkbox at the right-hand side of the option label to enable the controls for minimum and / or maximum file age limitation.
Click on the arrow of the active date limitation control to select a date via the interface provided by the calendar helper, or enter a date directly, respecting the format demand of DD.MM.YYYY.
When the calendar helper with its three columns day, month, and year is displayed, move the mouse pointer over the column that has to be changed (e. g. over the day column), and use the mouse wheel to spin it up or down. As an alternative, it is also possible to click on the current column value, and use the up and down arrow keys on the keyboard to change the selection. Using the right and left arrow keys allows to switch between the three rows of the calendar selector dialog.
The values that are currently presented at the middle row of the calender selector helper are immediately taken over into the triggering date field. To close the dialog, users have to either hit Escape on the keyboard, or left-click somewhere outside the calendar selector dialog.
Once the date has been selected, a time index needs to be defined as well. Please make sure to use the right format HH:MM.
Languages
Use the browse button at the right-hand side of the input field to open the language selector dialog. Activate the checkbox at the left-hand side of the language name to add it to the list of possible language matches. Use the OK button at the bottom of the language selector interface to copy the selection into the triggering language version input field (as a comma separated list of language ID's, or use the Cancel button to close the dialog without taking over any new selections.
Depending on the type selected in step 2, there are some location specifications due.
Path
The path of the searched file has to be defined by selecting one of the already given directories within the packaging project, or by creating a new one. Both procedures may be done by clicking the browse button [...] at the right-hand side of the destination folder property control item, and using the interface of the common dialog Select directory.
Depth
Please enter an integer value for the number of levels below the defined path that will be searched for the key object.
Root
Select one of the predefined registry hive options:
•HKEY_CLASSES_ROOT
•HKEY_CURRENT_USER
•HKEY_LOCAL_MACHINE
•HKEY_USERS
The searched registry content must be present within the selected hive.
Key
Enter the full key name that leads to the searched value. Make sure to use backslashes to define the several levels of the requested registry branch.
Name
Enter the name of the registry value to search for. Please make sure to give only the name, without leading or trailing blanks, without hierarchy information (such as parent key levels, etc.) It is recommended to match the case as well.
Type
Please pick one of the predefined options:
•Key path is a directory
•Key path is a file
•Key path is a registry value
Search 64bit portion of the registry
If this checkbox is active, the system search task will be executed on the 64bit branch of the registry. If it is not active, the 32bit branch is scanned.
Component
To select an existing component as search object, users click on the downwards-pointing arrow at the right-hand side of the component selector control. A list of existing components is displayed. The new setting is established with a click on any of the given components.
To create a new component as search object, users click on the browse button [...] at the right-hand side of the component control. The common dialog type Select Component is displayed, ready for creating and selecting components.
Type
Please pick one of the predefined options:
•Key path is a directory
•Key path is a file
FileName
Please enter the file name of the INI file that has to be scanned.
Section
Once the INI file is found, a specific section within that file has to be searched for.
Key
Within the specified INI file and section, the key name entered here will be searched for.
Field
Please enter the numeric index value of the field that has to contain the searched value.
Type
Please pick one of the predefined options:
•.ini value is a directory location
•.ini value is a file location
•Use raw .ini value
Use the summary page to check the correctness of the system search properties that were defined during the previous wizard steps.
•If all properties are set as required, click Process to finally create the system search item.
•If changes are due, click Back until the wizard step with the incorrect property definition(s) is displayed and make modifications as required.
Please note that changes in an early step may lead to different defaults or options in any later step. Therefore, please verify that all steps contain the desired settings whilst NEXTing to the summary page again.
The wizard is closed automatically as soon as the new system search task has been created. The list of existing system search tasks within the System Search view is updated to contain the newly created task.