Filter software results using an encoded query in TLM

task brazil Updated Sep 10, 2026 3 min read use-tpm-encoded-query.md
Raw file servicenow.com

Use an encoded query to control which software products appear in the Lifecycle Timeline view of a business application. By default, TLM tracks only licensable software. Set the encoded query system property to include non-licensable software and limit results.

Before you begin

Role required: admin

About this task

Important:

Technology Lifecycle Management (TLM) was previously known as Technology Portfolio Management (TPM). TPM and TLM refer to the same feature. Table names and scheduled job names continue to use TPM and haven't been renamed.

Whether your instance displays TPM or TLM also depends on your application versions. TLM labels appear only when both the Enterprise Architecture Workspace application (version 9.2.1 or later) and the Technology Lifecycle Management plugin, sn_apm_tpm (version 1.11.0 or later), are installed. If either application is on an earlier version, the interface continues to show TPM.

The TLM can track technology lifecycles for both licensable and non-licensable software. When you import non-licensable software, you may end up importing many unnecessary software products. You can restrict the number of results by specifying an encoded query as the value of the sn_apm_tpm.softwareDiscoveryModelProductFilterForTPM system property. When you set a value for this system property and run the TLM scheduled job, you can see the search results that satisfy your encoded query.

Procedure

  1. Generate an encoded query string through a filter on the Software Installations page.

    1. Select All and in the navigation filter, enter cmdb_sam_sw_install.list.

      The Software Installations page appears.

    2. Apply a filter as per your requirement.

    3. Select Run.

    4. Right-click at the end of the filter breadcrumb and select Copy query from the context menu.

      For example: [discovery_model.norm_product.product_type=child] [Omitted image "eaw-tpm-encod-query-copy.png"] Alt text: Copy query

  2. Select All and in the navigation filter, enter sys_properties.list.

    The System Properties page appears.

  3. Open the record for the sn_apm_tpm.softwareDiscoveryModelProductFilterForTPM system property.

  4. Set the value of the system property to an encoded query.

    For example: [discovery_model.norm_product.product_type=child]. If the system prompts you to change the application scope so that you can edit the record, select the provided link.

  5. Select Update.

  6. Run the scheduled job Populate TPM Discovered Technologies and Lifecycles.

    1. Navigate to All > System Definition > Scheduled Jobs.

    2. Find and open the scheduled job Populate TPM Discovered Technologies and Lifecycles.

    3. Select Execute Now.

Result

The technologies and lifecycle values are updated in the TPM Discovered Technologies [sn_apm_tpm_discovered_technology] table.

Parent Topic:Working with Technology Lifecycle Management (TLM) in EA Workspace

Related topics

Update TPM data for a business application or application service

Restart the Populate TPM Discovered Technologies and Lifecycles job

View technology lifecycle details

View TPM risk details

Update the system property to gather software products from a CMDB table

View technology portfolio audit risk details

Update verification status of TPM audit details

View TPM logs

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