Skill inputs and triggers for ServiceNow Otto for Software Asset Management \(SAM\)

reference brazil Updated Sep 10, 2026 10 min read now-assist-sam-skills-inputs.md
Raw file servicenow.com

Get a quick overview of the skill inputs and triggers for ServiceNow Otto for Software Asset Management (SAM). By configuring the inputs or triggers for a skill, you can determine how and when a skill is used.

Depending on the selected skill, you can configure the inputs or triggers. These settings determine how and when a skill is used. An input identifies the data that is used for a skill, such as the table and fields that are used to generate a publisher summary. A trigger initiates an action, such as when the system generates a publisher summary.

Publisher compliance summarization skill

For the publisher compliance summarization skill, select the triggers that determine when a publisher compliance summary is generated. You can also select the properties that control how a publisher compliance summary is displayed. To display the publisher compliance summary, you need to select the Display toggle button on the Choose where to display page while configuring Now Assist for SAM. For details on the Display toggle button, see Configuring ServiceNow Otto for Software Asset Management (SAM) skills.

The following table lists the triggers that determine when a publisher compliance summary is generated and how a publisher compliance summary is displayed.

Trigger Description
User-triggered Publisher compliance summary that is generated when the agent manually triggers the skill by selecting Summarize in the Publisher details page.

The following table lists the inputs for the publisher compliance summarization skill.

Input Description
Reconciliation results Compliance status of the software products with regards to the discovery and entitlements.
Software Lifecycle Report [sam_sw_product_lifecycle_report] Product life-cycle details for all the software products that are installed in your environment.
Dashboards Dashboards include Discovered inventory, Normalization and content, and Health check.

Product compliance summarization skill

For the product compliance summarization skill, select the triggers that determine when a product compliance summary is generated. You can also select the properties that control how a product compliance summary is displayed. To display the product compliance summary, you need to select the Display toggle button on the Choose where to display page while configuring Now Assist for SAM. For details on the Display toggle button, see Configuring ServiceNow Otto for Software Asset Management (SAM) skills.

The following table lists the triggers that determine when a product compliance summary is generated and how a product compliance summary is displayed.

Trigger Description
User-triggered Product compliance summary is generated when the agent manually triggers the skill by selecting Summarize in the Publisher details page.

The following table lists the inputs for the product compliance summarization skill.

Input

Description

Reconciliation results

Compliance status of the software products with regards to the discovery and entitlements.

Software Lifecycle Report [sam_sw_product_lifecycle_report]

Contains product life-cycle details for all the software products that are installed in your environment.

Dashboards

Dashboards include Discovered inventory, Normalization and content, Health check, and Optimization and Savings dashboard.

SAP related tables

The SAP related tables include:- SAP Document Type [samp_sap_document_type]

  • SAP Digital Access Usage [samp_sap_digital_access_usage]
  • SAP Engine Usage [samp_sap_sw_client_access]
  • SAP System User [samp_sap_system_user]

Software Subscription [samp_sw_subscription] table

Contains information pertaining to user software subscriptions.

Purchased Subscription Details [samp_purchased_subscription_details]

Contains the information pulled from the Microsoft Azure portal related to subscriptions purchased and assigned for Microsoft 365.

Software Installation table [cmdb_sam_sw_install]

Contains information on all software installed in your environment.

## Recommended actions skill

For the recommended actions skill, select the triggers that determine when a list of recommended actions is generated. You can also select the properties that control how recommended actions is displayed. To display recommended actions, you need to select the Display toggle button on the Choose where to display page while configuring Now Assist for SAM. For details on the Display toggle button, see Configuring ServiceNow Otto for Software Asset Management (SAM) skills.

The following table lists the triggers that determine when recommended actions are generated and how the list of recommended actions is displayed.

Trigger

Description

User-triggered

Recommended actions is generated when the user manually triggers the skill by selecting either of the two options in the Publisher details page:

  • Get recommendations icon on Recommended actions sidebar and then select Get recommendations.
  • Summarize button for a product. When you select Summarize, both the product summary along recommended actions gets generated.
The following table lists the inputs for the recommended actions skill.

Inputs

Source

Configuration inputs

Health check issues

Scan Findings [Scan_finding]

Installs requiring actions

Installs Unlicensed Reasons [samp_install_unlicensed_reason]

Normalization Rate

Software Discovery Models [cmdb_sam_sw_discovery_model]

Normalization suggestions

Normalization Suggestions [samp_normalization_suggestion]

Maintenance inputs

Remediation options

Remediation Options [samp_remediation_option]

End of Life

Software Lifecycle Report [sam_sw_product_lifecycle_report]

Missing end of life dates

Software Lifecycle Report [sam_sw_product_lifecycle_report]

Expiring entitlements

Software Entitlements [alm_license]

Optimization inputs

Removal candidates

Removal Candidates [samp_sw_reclamation_candidate]

Optimization (Microsoft):

  • Inactive subscriptions
  • Unassigned subscriptions
  • Licensing optimizations

Software Subscriptions [samp_sw_subscription]

Purchased Subscription Details [samp_purchased_subscription_details]

Microsoft Core License Optimization Reports [samp_ms_optimization_report]

Optimization (Adobe):

  • Inactive users
  • Unresolved subscriptions

Software Subscriptions [samp_sw_subscription]

Optimization (Red Hat): Licensing optimizations

Potential savings by optimizing licenses [samp_license_optimization_summary]

Optimization (SAP):

  • Inactive users
  • Named user assignment
  • Locked out user
  • Licensed non-dialog users
  • Role based license optimization
  • Transaction based license optimization
  • Unused engines

SAP System Users [samp_sap_system_user]

License Metric Results [samp_license_metric_result]

Removal Candidates [samp_sw_reclamation_candidate]

## SaaS user resolution skill

The following table lists the trigger for the SaaS user resolution skill.

Trigger

Description

Auto-triggered

User resolution rules are automatically generated upon the activation of the SaaS user resolution skill.

The following table lists the inputs for the SaaS user resolution skill.
Input Description
List of fields with the String and Email type. User [sys_user]

Contract entitlement data extraction skill

Trigger

Description

User-triggered

An entitlement is automatically generated from a contract when the user manually triggers the skill by selecting Import contract document in the software contract page.

The following table lists the inputs for the Contract entitlement data extraction skill.
Input Description
The contract document The contract document that the user uploads that is used for extracting the entitlement information.

Error log summarization skill

The Error log summarization skill transforms raw and cluttered application logs into clean, structured error summaries through systematic analysis. The skill identifies error patterns and classifies failure types such as API, code, infrastructure, database, and configuration. It traces root causes through stack traces and extracts key technical details while filtering out irrelevant log information. This skill also processes complex log traces that contain multiple errors, timeouts, exceptions, and system failures to provide concise, actionable error summaries that enable faster debugging and issue resolution. It handles various log formats and error patterns across different technology stacks, making it essential while dealing with production incidents.

The following table lists the trigger for the Error log summarization skill.

Trigger

Description

User-triggered

Error log summary is generated when the user manually triggers the skill by selecting Troubleshoot on the SaaS integration profile page.

The following table lists the inputs for the Error log summarization skill.
Input Description
Outbound HTTP Logs [sys_outbound_http_log] 4xx and 5xx outbound request and response details, scoped by hostname, job sys_id, and time window.
Flow Execution Context [sys_flow_context] Most recent errored flow or subflow execution context for the failing job or validate-connection action.
Action Type Definition [sys_hub_action_type_definition] Resolves the internal name and scope of the action into the flow source sys_id that is used for context lookup.
Integration Profile [samp_sw_subscription_profile] Profile metadata and custom properties such as action name, scope, validate timestamps, and troubleshooting parameters that scope the log queries.
Step-Level Execution Reports Per-step inputs, outputs, and error details that are fetched through FlowExecutionSummaryUtil for the errored context.

Error resolution recommendation skill

The Error resolution recommendation skill synthesizes the error summary that is produced by the Error log summarization skill with available knowledge resources to generate prioritized, step-by-step resolution guidance. The skill correlates identified errors with knowledge base articles, historical solutions, support cases, and web search results to recommend the most effective troubleshooting approach. The skill consolidates information from multiple sources, removes redundant steps, and sequences actions from quick fixes to comprehensive solutions based on failure type, system impact, and resolution probability.

The following table lists the trigger for the Error resolution recommendation skill.

Trigger

Description

Auto-triggered

Resolution recommendations are automatically generated after the Error log summarization skill produces an error summary.

The following table lists the inputs for the Error resolution recommendation skill.
Input Description
Error summary Consolidated error signature such as status codes, messages, failing action, and profile context that is produced by the Error log summarization skill.
Web search results External guidance, vendor documentation, and API deprecation or known-issue references that are matched to the error signature.

Spend transaction software classification skill

The Spend transaction software classification skill first identifies whether each imported spend transaction is a software purchase. If the transaction is classified as software, then the skill extracts the raw publisher and raw product details using the vendor name, transaction description, and GL account columns. Transactions that the skill classifies as non-software skip the extraction step for raw publisher and raw product and are not passed to the Spend transaction software normalization skill.

The following table lists the trigger for the Spend transaction software classification skill.

Trigger

Description

Auto-triggered

The skill classifies spend transactions as part of the spend transaction import pipeline through the SAM - Label Spend Transactions scheduled job. The job processes batches of transactions that haven't yet been classified.

The following table lists the input for the Spend transaction software classification skill.
Input Description
Software Spend Transactions [sam_spend_transaction] The skill reads the vendor name, transaction description, and GL account fields from imported spend transaction records.

The following table lists the plugin and store app dependencies for the Spend transaction software classification skill.

Release

Plugin

Store App with Version

Brazil

  • Software Asset Management Professional [com.snc.samp]
  • Software Asset Management - Spend Detection [com.sn_sam_spend]
  • ServiceNow Otto for Software Asset Management (SAM) [sn_now_assist_sam] - 11.0.0
  • Software asset workspace [sn_sam_workspace] - 12.0.4
## Spend transaction software normalization skill

The Spend transaction software normalization skill matches software spend transactions to existing publisher and product records to enable accurate spend reporting and license position tracking. The skill uses AI search to normalize the raw publisher and raw product derived by the Spend transaction software classification skill. When the skill finds a reliable match in existing publisher and product records, it populates the publisher and product fields on the spend transaction record. If no reliable match exists, the transaction remains unnormalized.

The following table lists the trigger for the Spend transaction software normalization skill.

Trigger Description
Auto-triggered The skill normalizes the raw publisher and raw product after the Spend transaction software classification skill identifies a transaction as software. When a match is found in existing publisher and product records, the skill populates the Publisher and Product fields on the spend transaction record.

The following table lists the input for the Spend transaction software normalization skill.

Input Description
Extracted publisher and product values Raw publisher and product produced by the Spend transaction software classification skill for transactions identified as software.

The following table lists the plugin and store app dependencies for the Spend transaction software normalization skill.

Release

Plugin

Store App with Version

Brazil

  • Software Asset Management Professional [com.snc.samp]
  • Software Asset Management - Spend Detection [com.sn_sam_spend]
  • ServiceNow Otto for Software Asset Management (SAM) [sn_now_assist_sam] - 11.0.0
  • Software asset workspace [sn_sam_workspace] - 12.0.4
**Parent Topic:**[Configuring ServiceNow Otto for Software Asset Management \(SAM\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-asset-management/software-asset-management/now-assist-sam-configuration.md)

Parent Topic:Software Asset Management references

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