Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
The All Contents Tab
The All Contents tab displays a a hierarchical structure of software publishers, application names, releases, application versions, and files contained in the SAI file.
- Click the + (plus) sign next to a Publisher to expand the tree.
- Expand an Application to display the Releases for it.
- Expand a Release to display the Versions of that particular software application release that are in the database.
- Expand a Version of the software to display the Files for that version.
All the Applications by that software publisher are shown.
The following information is shown in the columns:
- Size - The size of the file
- Signature - The signature is a checksum of the first 8 Kilobytes of a file.
- Exe Type - This indicates the type of the executable (for example, Win32 exe).
- Relation - Whether the file is a Main, Associated, or 3rd Party file. See Viewing Information on the Files Tab for definitions of these terms.
- ID - The unique identifier for that particular entry. This column is only shown if you selected the Show ID Column option in the SAI Editor Options dialog box. See page Setting Properties for the SAI Editor for further information.
Note If none of the files identified for a particular version has the relation of Main file for that version, the version will be displayed in red in the SAI Editor to highlight this fact. The reason to flag this condition is that if a version does not have one or more Main files, the application will not be recognized. So you must identify one or more files with the relation of Main if you want application recognition to occur. There are only a few cases when it makes sense to teach an application without a Main file. These would include, for example, a set of drivers or internal utilities for which it is convenient to have corresponding files recognized, but it is not important to report them as individual applications.
Right-Click Menus
Different right-click menus are available for different nodes of the Publisher tree.
Node | Menus Available |
---|---|
Root - the User SAI | New Item |
Publisher |
|
Application |
|
Release |
|
Version |
|
File |
|
Node | Menus Available |
---|---|
Root - the User SAI | New Item |
Publisher |
|
Application |
|
Release |
|
Version |
|
File |
|
Note Master SAIs are read-only, so menu items relating to editing the SAI content are disabled for Master SAIs.
This procedure is used to add a new software publisher to a User SAI.
To add a new software publisher to a User SAI:
- Right-click the root User SAI File entry in the tree. It is the first entry (the root) of the tree
- Select the New Item option.
- Enter the Name and Description for the new software publisher.
- If the publisher already exists in the Master SAI, copy it from the Master SAI to your User SAI.
The Publisher Properties box is displayed.
Note Ensure that the Publisher Name is spelled correctly. Before adding a publisher name to the file, check whether the entry for the publisher already exists in the Master SAI file.
This procedure is used to delete an existing software publisher from a User SAI.
To delete an existing publisher:
- In the tree, right-click the software publisher to be deleted.
- Select the Delete option or hit the Delete key on your keyboard.
- Click Yes to delete the software publisher and all its associated sub-items.
A confirmation message is displayed.
This procedure is used to edit the properties for a software publisher.
- In the tree, right-click the software publisher to be edited.
- Select the Properties option.
- Edit the details as required.
- Click the OK button to complete the edit.
The Publisher Properties box appears.
Once the publisher details have been edited, the amended details are displayed in the tree.
You can merge the contents of a software publisher with another publisher within the same SAI so that they are contained under the same entry. You would do this, for example, if a software publisher has been acquired by another company.
To merge the contents of publishers:
- Drag and drop the publisher to another publisher entry in the tree.
- Click the OK button to accept the merge.
A confirmation dialog box is displayed.
You can merge the contents of a software publisher to a different User SAI.
To copy a publisher to another SAI:
Drag and drop the publisher into the appropriate User SAI entry in the left hand pane of the Editor.
The publisher entry is copied to the other SAI. This will only copy the publisher information. If you want to copy the file-level data to the other User SAI, you should select the files that you want to copy and then drag and drop the data into the appropriate User SAI.
Alternatively, you can hold down the CTRL key and drag the publisher to another SAI. This will result in a “deep” copy that will copy the publisher and all of its child items (applications, releases, versions, and files).
You can move the contents of a publisher to another publisher within the same SAI.
To move the contents of a publisher to another publisher within the same SAI:
- Select the applications under the publisher and drag them to the publisher to which you want to move them.
- Click the OK button to accept the move.
A confirmation dialog box is displayed.
This procedure is used to add a new software application to a User SAI.
To add a new software application to a User SAI:
- Right-click the appropriate software publisher entry in the tree.
- Select the New Item option.
- Enter the Name and Description for the new software publisher.
- From the Application Type drop-down list, select the software category that the application falls under (for example, word processor software or spreadsheet software).
The Application Properties box is displayed.
Ensure that the Application Name is spelled correctly. Before adding an application name to the file, check whether the entry for the application already exists in the SAI file.
This procedure is used to delete an existing software application from a User SAI.
To delete an existing application:
- In the tree, right-click the software application to be deleted.
- Select the Delete option or press the DELETE key on your keyboard.
- Click Yes to delete the software application and all its associated sub-items.
A confirmation message is displayed.
This procedure is used to edit the properties for a software application.
To edit the properties for an existing application:
- In the tree, right-click the software application to be edited.
- Select the Properties option.
- Edit the details as required.
- Click the OK button to complete the edit.
The Application Properties box appears.
After the application details have been edited, the amended details are displayed in the tree.
Application rules are used for software recognition. You can teach Universal Discovery how to recognize a new application – or a new version of an existing application – by creating recognition rules.
To edit an application’s rules:
- In the tree, right-click the software application that you want to work with.
- Select Edit Application Rules. The Application Rules Editor opens.
- Choose one of the following actions:
- To modify an existing rule, select the rule, and click Edit.
- To create a new rule, click Add.
- To delete an existing rule, select the rule, and click Remove.
See the Rule-Based Application Teaching on page 348 for information about creating and modifying recognition rules.
You can merge the contents of an application with another application within the same SAI so that they are contained under the same entry.
To merge the contents of applications:
- Drag and drop the application onto another application entry in the tree.
- Click the OK button to accept the merge.
A confirmation dialog box is displayed.
You can copy a software application to a different User SAI.
To copy a software application to another SAI:
Drag and drop the application into the appropriate User SAI entry in the left hand pane of the Editor.
The application and the publisher entries are copied to the other SAI. If the publisher for this application does not already exist in new User SAI, it will be copied into it automatically.
Alternatively, you can hold down the CTRL key and drag the application to another SAI. This will result in a “deep” copy that will copy the application and all of its child items (releases, versions, and files).
You can move an application to another application publisher within the same SAI.
To move an application to another publisher within the same SAI:
- Select the application and drag it to the publisher you want it moved to.
- Click the OK button to accept the move.
A confirmation dialog box is displayed.
This procedure is used to add a new software release to a User SAI.
To add a new software release to a User SAI:
- Right-click the appropriate software application entry in the tree.
- Select the New Item option.
- Enter the Name for the new software release.
The Release Properties box is displayed.
Note Ensure that the Release is spelled correctly. Before adding a release to the file, check whether the entry for the release already exists in the SAI file.
This procedure is used to delete an existing software release from a User SAI.
To delete an existing release:
- In the tree, right-click the software release to be deleted.
- Select the Delete option or hit the Delete key on your keyboard.
- Click Yes to delete the software release and all its associated sub-items.
A confirmation message is displayed.
This procedure is used to edit the properties for a software application.
To edit the properties for an existing release:
- In the tree, right-click the software release to be edited.
- Select the Properties option.
- Edit the details as required.
- Click the OK button to complete the edit.
The Release Properties box appears.
After the release details have been edited, the amended details are displayed in the tree.
You can merge the contents of a release with another release within the same SAI so that they are contained under the same entry.
To merge the contents of releases:
- Drag and drop the release onto another release entry in the tree.
- Click the OK button to accept the merge.
A confirmation dialog box is displayed.
You can copy a software release to a different User SAI.
To copy a software release to another SAI:
Drag and drop the release into the appropriate User SAI entry in the left hand pane of the Editor.
The release, application name and publisher are copied to the other SAI. If the publisher and application for this release do not already exist in new User SAI, they will be copied into it automatically.
Alternatively, you can hold down the CTRL key and drag the release to another SAI. This will result in a “deep” copy that will copy the release and all of its child items (versions and files).
You can move a software release to another application within the same SAI.
To move a software release to another application within the same SAI:
- Select the release, and drag it to the application to which you want it moved.
- Click the OK button to accept the move.
A confirmation dialog box is displayed.
This procedure is used to add a new software version to a User SAI.
To add a new software version to a User SAI:
- Right-click the appropriate software release entry in the tree.
- Select the New Item option.
- Name. Name of the new version (must be entered)
- Description. This is a user defined field that can contain any text.
- Install Strings
- This is the text that the installer of the program uses to describe the software in the Control Panel > Add/Remove programs (Windows prior to Windows Vista), Control Panel > Programs and Features (Windows Vista and above), or the operating system package manager (UNIX/Mac OS X).
- Normally there is only one install string, which is entered on the first line of the entry field. Occasionally, it may be necessary to make a match based on multiple install strings. For example, if you add a service pack for a product, there may be an install string for the service pack, in addition to the install string for the product itself. In this case, the install string match should be based on both install strings. You can enter additional install strings on the subsequent lines of this entry field.
- The install strings can also be found from the Hardware and Configuration tab and the Operating System Data and Operating System Installed Application Description columns for the Windows applications.
- Operating System
- Language
- Click OK to add the new software version to the SAI file.
The Version Properties box is displayed.
Enter the following details for the new software version.
The Base Operating System of the application version (for example, Windows Vista). Select the Base OS from the drop-down list.
Select the language of the application version from the drop-down list.
Note Before adding a software version, check whether the entry already exists in the SAI file.
- Right-click the appropriate software release entry in the tree.
- Select the New Item option.
- Name. Name of the new version (must be entered)
- Description. This is a user defined field that can contain any text.
- Install Strings
- This is the text that the installer of the program uses to describe the software in the Control Panel > Add/Remove programs (Windows prior to Windows Vista), Control Panel > Programs and Features (Windows Vista and above), or the operating system package manager (UNIX/Mac OS X).
- Normally there is only one install string, which is entered on the first line of the entry field. Occasionally, it may be necessary to make a match based on multiple install strings. For example, if you add a service pack for a product, there may be an install string for the service pack, in addition to the install string for the product itself. In this case, the install string match should be based on both install strings. You can enter additional install strings on the subsequent lines of this entry field.
- The install strings can also be found from the Hardware and Configuration tab and the Operating System Data and Operating System Installed Application Description columns for the Windows applications.
- Operating System
- Language
- Click OK to add the new software version to the SAI file.
The Version Properties box is displayed.
Enter the following details for the new software version.
The Base Operating System of the application version (for example, Windows Vista). Select the Base OS from the drop-down list.
Select the language of the application version from the drop-down list.
Note Before adding a software version, check whether the entry already exists in the SAI file.
This procedure is used to delete an existing software version from a User SAI.
To delete an existing version:
- In the tree, right-click the software version to be deleted.
- Select the Delete option or hit the Delete key on your keyboard.
- Click Yes to delete the software version and all its associated sub-items.
A confirmation message is displayed.
This procedure is used to edit the properties for a software version.
To edit the properties for an existing version:
- In the tree, right-click the software version to be edited.
- Select the Properties option.
- Edit the details as required.
- Click the OK button to complete the edit.
The Version Properties box appears.
After the version details have been edited, the amended details are displayed in the tree.
You can merge the contents of a version with another version within the same SAI so that they are contained under the same entry.
To merge the contents of versions:
- Drag and drop the version onto another version entry in the tree.
- Click the OK button to accept the merge.
A confirmation dialog box is displayed.
You can copy a software version to a different User SAI.
To copy a software version to another SAI:
Drag and drop the version into the appropriate User SAI entry in the left hand pane of the Editor.
The version, release, application name and publisher are copied to the other SAI. If the publisher, application and release for this version do not already exist in new User SAI, they will be copied into it automatically.
Alternatively, you can hold down the CTRL key and drag the version to another SAI. This will result in a “deep” copy that will copy the version and all of its child items (files).
You can move a software version to another release within the same SAI.
To move a software version to another release within the same SAI:
- Select the version entry and drag it to the release you want it moved to.
- Click the OK button to accept the move.
A confirmation dialog box is displayed.
There are two methods of adding a new file to a User SAI.
Method 1—Add a new file to a User SAI using the Editor:
- Right-click the appropriate software version entry in the tree.
- Select the New Item option.
- Enter the name of the file and click the OK button. The File Properties dialog box is displayed.
- Enter the following details for the file:
- Size
- The size of the file
- Care about Size
- Relation to App
- Signature
- Exe File Type
- Click OK to add the new file to the SAI.
The Filename box is displayed.
When this option is enabled, the size of the file is used as a recognition criterion. When disabled, file size will not be used in recognition, and N/A will be displayed in the size column.
Note Be careful when disabling this setting, especially for main files. If the setting is disabled, only the match on the file name is needed to produce a good file match – and if the file is main, simply the presence of the file in the scan file will cause the application to be recognized.
Whether the file is a Main, Associated or 3rd Party file. See Viewing Information on the Files Tab for definitions of these terms.
The signature is a checksum of the first 8 Kilobytes of a file.
Note If the signature is unknown, use FFFF-FFFF.
The type of executable file (for example, Win 32 exe or Archive).
Note Ensure that the file name is spelled correctly. Before adding the file, check whether it already exists for this version.
Method 2—Add a new file to a User SAI using Windows Explorer:
Using Windows Explorer you can automatically add the file to the software version.
In Windows Explorer, navigate to the file you want to add.
Drag the file onto the version in the SAI Editor. The file will be added to the version automatically with the properties details filled in. These properties can be amended as necessary - see Editing the Properties for Files in the Files Tab on page 279 for information on how to do this.
This procedure is used to delete an existing file from a User SAI.
To delete an existing file:
- In the tree, right-click the file to be deleted.
- Select the Delete option or hit the Delete key on your keyboard.
- Click Yes to delete the file.
A confirmation message is displayed.
This procedure is used to edit the properties for a file. For more information, see Editing the Properties for Files in the Files Tab.
You can copy a file to a different User SAI.
To copy a file to another SAI:
Drag and drop the file into the appropriate User SAI entry in the left hand pane of the Editor.
The file is copied to the other SAI. If the publisher, application, release and version for this file do not already exist in new User SAI, they will be copied into it automatically.
Note You can select multiple files by pressing the SHIFT key and clicking on the files.
You can move a file to another version within the same SAI.
To move a file to another version within the same SAI:
- Select the file entry and drag it to the version you want it moved to.
- Click the OK button to accept the move.
A confirmation dialog box is displayed.
This procedure enables you to change the relationship of multiple files to the application. To change the relationship of one file to the application, see the Editing the Properties for Files in the Files Tab.
To set relationship to application:
- In the tree, right-click the file(s) to be edited. To select multiple files, hold the SHIFT key while clicking on the files.
- Select the Relationship to Application option.
- Select one relationship from the Main, Associated, and 3rd Party options.
Note See Viewing Information on the Files Tab for definitions of these terms.
After you edit the file details, the amended details are displayed in the tree.
We welcome your comments!
To open the configured email client on this computer, open an email window.
Otherwise, copy the information below to a web mail client, and send this email to cms-doc@microfocus.com.
Help Topic ID:
Product:
Topic Title:
Feedback: