Bulk import of your enterprise models and assets

Use a subflow to import enterprise models and assets of multiple types to your ServiceNow instance at one go. You can also perform a bulk update on existing models and assets.

Overview of Bulk import

Use the Enterprise Asset workspace to do a bulk transfer of all your enterprise models and asset from a different database to the ServiceNow instance.

Create an import record by downloading a template in the form of a spreadsheet (.xlsx). Ensure that you enter valid values in all the mandatory fields before uploading the template. Attach the template to the import record and select Import to begin the import process.

After you select Import, the EAM Bulk Import subflow gets triggered. Scheduled jobs are initiated and data in the spreadsheet is copied to the appropriate staging tables. The staging tables are validated and records are created in the ServiceNow instance.

Modes

Modes refer to the type of import that you want to process. There are modes for only importing models, assets, and a combined mode for both models and assets. You can choose from the following available modes:

• Create models
• Update models
• Create assets
• Update assets
• Create models and assets
• Update models and assets

Templates

Based on the mode you select in the import record, you can download the corresponding template.

注:

Ensure that you enter valid values in all the mandatory fields for the import process to run effectively. For a list of all the mandatory fields, see Mandatory fields in the bulk import spreadsheets.

表 : 1. Modes and templates

Modes	Corresponding template
Create models Update models	Model template
Create assets Update assets	Asset template
Create models and assets Update models and assets	Model and asset template

注:

From the Yokohama release onward, the MAC address field is available in the Download template of the following Bulk import modes:

• Create assets
• Update assets
• Create models and assets

After a successful import, the MAC address that you provided in the template is added to the MAC address [mac_addr] field in the Asset [alm_asset] table.

When the OT Asset Management application is activated, you can bulk import hardware assets and models in both the Enterprise Asset Workspace and the OT Asset Workspace only if the OT entity column is marked as TRUE.

Starting with the Zurich release, the bulk import templates include OT entity and Parent asset attribute columns. When the OT Asset Management application is activated, you can bulk import hardware assets and models in both the Enterprise Asset Workspace and the OT Asset Workspace only if the OT entity column is marked as TRUE. With theParent asset attribute field, you can choose to identify the parent of a child asset using either the asset tag, serial number, or MAC address.

To view instructions for bulk importing assets, select the Bulk import instructions icon [] on the contextual side bar.

You can customize the templates to add more columns. Make the following modifications to add more columns:

1. Add the new columns to the staging tables.
2. Modify the list view on the Database view table [sn_eam_import_template] to include the columns you want to display in the spreadsheet. Enter the string sn_eam_import_template.list in the filter field on your instance's navigation bar.
3. Add field mappings in the Model or Asset transform map.

Scheduled jobs

The following scheduled jobs execute as part of the EAM Bulk Import subflow.

The scheduled jobs execute based on the mode that you select.

The EAM Bulk Import - Upload File job is executed for all modes. For the Create Model or Update Model modes, the EAM Bulk Import - Transform Asset doesn't execute. Similarly, for the Create asset or Update asset modes, the EAM Bulk Import - Transform Model doesn't execute.

For example, if you select the Create models and assets mode, the scheduled job, EAM Bulk Import - Upload file uploads the data from the spreadsheet to the three staging tables. Then the Scheduled job, EAM Bulk Import - Transform Model executes the model and model component transform maps. After the model transform maps are complete, the EAM Bulk Import -Transform Asset scheduled job executes the asset transform map.

Staging tables

The data that you enter in the spreadsheet is copied to one or more of the following staging tables:

• Model Import Staging [sn_eam_model_import_row]​
• Model Component Import Staging [sn_eam_mc_import_row]​
• Asset Import Staging [sn_eam_asset_import_row]​