Entitlement import error fields
Summarize
Summary of Entitlement Import Error Fields
This document details the fields and their descriptions on the Entitlement Import Error form and related lists in ServiceNow. It helps customers understand the causes of import errors when adding entitlements and guides them on how to review and correct these errors to successfully manage software entitlements.
Show less
Key Fields and Their Practical Use
- Error status: Indicates whether the entitlement error has been resolved (Manually fixed) or requires review and correction (Needs review).
- Reason: Explains why the entitlement import failed, helping identify the specific issue.
- Asset tag: Tracks the asset via serial number or barcode.
- Publisher part number: Links to predefined software products, triggering automatic software model creation or selection. Customers receive warnings when multiple related software models are involved, prompting validation.
- Software model: Matches the entitlement to a software model; warnings appear if there are mismatches with the publisher or product, allowing manual adjustments.
- License type: Defines if the license grants full access or is an upgrade. Upgrade types show related upgraded entitlements and become read-only after submission. SaaS entitlements default to Full.
- Metric group and License metric: Automatically set based on the software model, specifying how licenses are counted during reconciliation. SaaS entitlements default to User Subscription. Special metrics like Envelopes apply only to specific vendors (e.g., DocuSign).
- Rights per license pack, Number of packs, Purchased right: Used primarily for Microsoft Per Core license types to calculate purchased rights automatically.
- Agreement type: Controls automatic generation of downgrade rights and compliance status. Enterprise License Agreement types mark status as Compliant even if unlicensed installations exist. Changing agreement types impacts downgrade rights generation and retention.
- Purchased rights and Oracle options: Additional entitlement details regarding purchased license quantities and Oracle-specific options.
- Contract number: Associates the entitlement with a specific contract.
Related Lists and Their Importance
- Reference software: Displays the publisher, product, version, edition, language, and platform. These fields assist in matching and normalizing discovery models, aiding accurate entitlement reconciliation.
- General: Captures ownership and organizational information such as asset owner, purchase order number, company, location, and department responsible for the license.
- Financial: Tracks vendor details, unit costs (required for dashboard cost calculations), general ledger accounts, and cost centers responsible for the asset.
Practical Benefits for ServiceNow Customers
Understanding these fields enables customers to efficiently identify and resolve entitlement import errors, ensuring accurate software license management and compliance. Automated software model creation and license metric assignments streamline entitlement mapping, while detailed ownership and financial data support asset tracking and cost management. The form’s status and reason fields help prioritize error correction, improving the accuracy of software asset records and supporting license reconciliation.
Entitlement Import Error form and related list field descriptions.
Entitlement Import Error form
| Field | Description |
|---|---|
| Error status | Status of the entitlement. An error record can have either of the two
statuses:
|
| Reason | Reason the imported entitlement couldn't be added to the Entitlement list. |
| Asset tag | Serial number and the bar code used for tracking the asset. |
| Publisher part number | Publisher part number from the Software Product Definitions lookup list of
predefined software that may have already been purchased. When you select a
publisher part number, you may encounter a message: Many underlying
software models are being created. These might be part of suite components,
downgrade rights or next version. Please validate on completion. The
message appears only if there are greater than or equal to 50 suite components for
the software model and if any of the following conditions are met:
Note: If a software model exists for the publisher part number, the
Software model field is automatically populated.
Otherwise, the software model is automatically created for you directly from this
form. If there are multiple software models created with the same discovery map
conditions, the software model must be selected manually. |
| Software model | The software model to match the entitlement. Note: A warning message is shown
if the publisher part number is not associated with the publisher and product for
the software model. You can either change the software model, or save the
entitlement as is. |
| License type | License type. Whether the rights grant full access to the software or if they are being upgraded from a previous version of the software. When the type is Upgrade, the Upgraded Entitlements related list is shown. The upgrade license type is used to specify the entitlements you are upgrading. This field becomes read-only after the form has been submitted. Note: For SaaS entitlements, keep the default value (Full). |
| Metric group | This field is automatically populated based on the Software Model field. Each metric group has a set of license metrics that are specific to the software publisher. |
| License metric | License metric for the license group that the software license is counted
against when reconciliation is run. The options for license metric change based on
the Metric group field. The default value for SaaS entitlements is User Subscription. For more information, see Software license metrics. Note: Use the Envelopes license metric only for Docusign
entitlements. |
| Rights per license pack | Rights associated with each pack that is purchased for Microsoft Per Core or Microsoft Per Core with CAL licenses. |
| Number of packs | Number of packs for Microsoft Per Core or Microsoft Per Core with CAL licenses. |
| Purchased right | Number of rights that you are purchasing. Note: If you've specified a Microsoft Per Core or Microsoft Per Core with CAL
license type, this field is automatically populated. This value is based on the
values entered in the Rights per license pack field
multiplied by the value in the Number of packs field. |
| Agreement type | Based on the agreement type that you select, downgrade rights are automatically
generated. Note:
If the agreement type is Enterprise License
Agreement or Unlimited Level Agreement, the
Status is Compliant even if there are unlicensed
installations.
|
| Purchased rights | Number of rights that you are purchasing. |
| Oracle options | Oracle options related to the entitlement. |
| Contract number | Contract number for the entitlement. |
Reference software related list
| Field | Description |
|---|---|
| Publisher | Name of the software publisher. |
| Product | Name of the product. |
| Version | Version of the software product. |
| Edition | Edition of the software product. |
| 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. |
| Platform | Platform of the software product to use when searching for the normalized discovery model. |
General related list
| Field | Description |
|---|---|
| Owned by | User or department with financial ownership of the asset. The asset owner can be different than the manager. |
| PO number | Purchase order number. |
| Company | Company that this asset belongs to. |
| Location | Where the license is used. For example, a specific site, country, or region. |
| Department | Department of the person Assigned to this software license. |
Financial related list
| Field | Description |
|---|---|
| Vendor | Company that the asset was purchased from. |
| Unit cost | Unit cost of the software. Note: Required for total cost and savings
calculations on the Software Asset Management dashboard. |
| GL account | General ledger account number associated with the asset. |
| Cost center | Cost center financially responsible for the asset. |