Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a custom file rule to manually define file sets

Create custom rules to manually define file sets and normalize data not recognized by the SAM API. After you have created custom rules, custom file sets can be discovered with File Signature Normalization and software records can be generated.

Before you begin

Role required: sam_admin

About this task

File Signature Normalization identifies software installation packages based on file attributes in a configuration item. The input is then sent to the SAM API. If there are files properties discovered that are not associated with the File Signature Normalization rule, you can manually normalize the data and send the input to the API to create a software installation record.

Note: File signature rules discovered in the content service library take precedence over custom file signature rules.

Procedure

  1. Navigate to All > Software Asset > Administration > Custom File Normalization Rules and create a new record (see table for field descriptions).
FieldDescription
PublisherPublisher of the software. You can use the lookup list provided.Note: Publisher is a reference to the company [core_company] table. Only companies you are using internally are shown.
ProductSoftware product name. The same lookup list provided on the Software Discovery Models form. You can create a custom product from the lookup list, if desired. Note: If the relationship between the software publisher [samp_sw_publisher] table and the company [core_company] table is not correct, products for that publisher may not be shown.
VersionVersion of the software product.Required if version condition value is [starts with] or [is-].
EditionEdition of the software product to use when searching for the normalized discovery model.Required if edition condition value is [starts with] or [is].
PlatformPlatform of the software product to use when searching for the normalized discovery model.The default is Anything for Windows, macOS, UNIX.
LanguageLanguage of the software product to use when searching for the normalized discovery model, which is populated once it has been normalized or added manually.The default is Anything.
Exclude from content serviceOption to exclude file set rule from being included in content service library.
File nameName of file associated with software installation as it exists in the system.
File sizeSize of file name file in bytes.
File versionVersion of file name file.
  1. Click Submit.

Result

The custom rule is added to the Unidentified File Sets list.

Parent Topic:Software Asset Management administration