Create a custom file rule to manually define file sets

task australia Updated Sep 10, 2026 2 min read create-custom-file-rule.md
Raw file servicenow.com

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).

Field

Description

Publisher

Publisher 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.

Product

Software 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.

Version

Version of the software product.Required if version condition value is [starts with] or [is-].

Edition

Edition of the software product to use when searching for the normalized discovery model.Required if edition condition value is [starts with] or [is].

Platform

Platform of the software product to use when searching for the normalized discovery model.The default is Anything for Windows, macOS, UNIX.

Language

Language 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 service

Option to exclude file set rule from being included in content service library.

File name

Name of file associated with software installation as it exists in the system.

File size

Size of file name file in bytes.

File version

Version of file name file.

2. Click **Submit**.

Result

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

Parent Topic:Software Asset Management administration

Search documentation
Search document titles and file paths on the australia branch