Manage manual data imports
Learn how to manage manual data imports in Snow Management and Configuration Center.
For a successful import of new or updated information in Snow License Manager, certain information must be provided in the import file. For detailed information on the required data and where the data can be found in the user interface of Snow License Manager after the import, see Data Import Field Description.
For information on automated data imports, see Manage automated data imports.
Import data manually
On the Administration menu, click Import.
On the top menu, select the type of import you want to make.
In Upload a data source, do the following:
In Select a file to import, click Browse to select the import source file.
If the first row in the import source file contains column headers, select the Has headers.
Click Next.
In Import settings, do the following:
Note
Available import settings depend on the type of the selected import.
In New organization action, select how to handle organizations that exist in the import source file but not in the Snow License Manager database:
Do nothing
If selected, unknown organizations are ignored. However, information on the organization is required for a successful import. The field will be highlighted in the Preview step of the import, and it will not be possible to import data for that particular row.
Create
If selected, the system will create the new organization node, either directly under the root or according to the path in the import source file.
Example: ROOT/[new organization node], ROOT/IT/[new organization node]
For license imports, in Identity mapping, select which field you want to use for mapping the licenses to the applications: Application name, Part number, or SKU (Stock-keeping unit).
For computer imports, in Obsolete computer action, select how to handle computers that exist in the Snow License Manager database but not in the import source file:
Do nothing
If selected, nothing will happen to the obsolete computers.
Inactivate
If selected, all obsolete computers are inactivated during the import. An inactive computer does not require licenses for its installed applications and is not included in the compliance calculations.
Archive
If selected, all obsolete computers are archived during the import. An archived computer is removed and all licenses currently attached to it are released.
Delete
If selected, all obsolete computers are deleted during the import. A deleted computer is removed from the system; all computer details are deleted and all attachments to users, agreements, licenses, etc. are released.
This option is available when the basic setting IMPORT_ENABLE_DELETE is enabled.
Caution
You cannot restore a computer that has been archived or deleted during import. Only select Archive or Delete if you really want to remove them from the system.
Note
By a configuration setting, it is possible to limit the obsolete computer action to certain computers in the database, see Computer import tab.
For custom object imports, in Object type, select the type of object to import. The available object types are the ones that have been created in the web user interface of Snow License Manager.
Click Next.
In Field mappings, do the following:
For updates of existing objects in Snow License Manager, use the top row to select which Source column to use when mapping the import data to the objects. If the import source file has no column header, select the position of the column that holds the information.
Map the rest of the Source file columns to the corresponding Destination fields in Snow License Manager. If the import source file has no column header, map the column positions of the Source file with the corresponding Destination fields.
Optionally, click the button to the right of each row to see additional options for the data values in the import file. For more information, see Mapping of source and destination fields.
Click Next.
In Preview of import data, do the following:
Review any errors highlighted in red, like conflicts or invalid values. Point to the highlighted field to see more information on the error.
You can continue with the import even if there are invalid rows. However, only rows with no or yellow highlights will be imported. Rows highlighted in red will not be imported.
To correct an error, do the following:
To export the information to an Excel file for analysis, click Export all rows or Export invalid rows.
To go back and correct field mappings and import settings, click Back.
To cancel the import and correct any erroneous values in the import file, click Cancel.
To start the import, click Next.
In Importing data, you see the progress of the import.
Click Finish to exit the data import wizard.
Import Microsoft License Statement files
Note
There must exist an organization node alias in Snow License Manager for each company name listed in the Customer Name on Agreement column on the License Agreements tab of the Microsoft License Statement (MLS) file. The alias is case sensitive.
You can create an alias when you add or edit an organization node. For more information, see Create organization nodes.
On the Administration menu, click Import.
On the top menu, select MLS Licenses.
In Upload an MLS document, do the following:
In Select a file to import, click Browse to select the MLS file.
Click Next.
In Import settings, do the following:
Use the check boxes to link agreements and licenses to organization node aliases. If you leave the boxes cleared, all agreements and licenses will be linked to the root of the organization structure.
To allow import of incomplete licenses, select Import incomplete licenses.
Click Next.
In Preview of agreements to import, do the following:
Verify the agreement data before you import it. Errors are highlighted in red. Point to the highlighted field to see more information on the error.
To export the agreement preview to an Excel file for analysis, click All agreements or Discarded agreements.
In Preview of licenses to import, do the following:
Note
If the basic setting ALLOW_INCOMPLETE_LICENSES is enabled, fields that are missing the required information are highlighted in yellow.
Verify the license data before you import it. Errors are highlighted in red. Point to the highlighted field to see more information on the error.
You can continue with the import even if there are invalid rows. However, rows highlighted in red will not be imported. Rows highlighted in yellow will be imported, but the license will be marked as incomplete.
To export the agreement preview to an Excel file for analysis, click All licenses, Discarded licenses,or Incomplete licenses.
To start the import, click Next.
In Saving data to database, you see the progress of the import. When the import is completed, the licenses and agreements can be exported to an Excel file.
Click Finish to exit the MLS import wizard.
Example: Manual imports of license purchases
Scenario: The license import file is an Excel file with column headers. You want to use the application name when you map the licenses to the applications, and you want unknown organizations in the import source file to be ignored.
On the Administration menu, click Import.
On the top menu, select Licenses.
In Upload a data source, do the following:
In Select a file to import, click Browse to select the import source file.
Select Has headers.
Click Next.
In Import settings, do the following:
In New Organization action, select Do nothing.
In Identity mapping, select Application name.
Click Next.
In Field mappings, do the following:
For each field, verify that the suggested mapping of Source and Destination fields is correct. If not, use the lists to select the appropriate column header in the source file.
Click Next.
In Preview of import data, do the following:
If there are errors in the preview, click Back and correct the field mappings, or click Cancel to correct any erroneous values in the import file.
To start the import, click Next.
When the import is completed, click Finish.