Overview

The import of all files is performed via the Gateway card. All import procedures require the import files to be uploaded before you can start the import process.

There are four key stages in the process of importing data into Alloy:

  • Creating an import - This creates an import item and identifies the files that are going to be imported.
  • Configuring an import - This allows you to link the import data file to the relevant designs or interfaces within Alloy to correctly format the data items when they are created.
  • Validate the import - The data needs to be validated once the configuration is finished.
  • Commit the import - Once the data has been configured and validated satisfactorily you need to commit the import for it to be added to the project.
Note

The following procedure assumes that the correct import files have been uploaded to the system.

Creating an import

To create an import item use the following procedure:

  1. Select the Gateway module.

alt text

  1. Select Create import.

alt text

  1. Select the Custom option for all imports other than NSG or NLPG data.

alt text

  1. Complete the Name field to identify the import item.

  2. Select the Files field, a dialog is displayed that lists all the uploaded files, see Upload files. Refer to the relevant import type for more information on whether you can select more than one file to include in the import.

  3. When you have selected the required file or files select Create. The new import item is displayed in the Item details panel and a notification appears at the top of the panel to indicate that the import file has been created.

alt text

  1. Select the notification to reload and refresh the browser. At this stage Alloy indicates that the status of the import item is Initialised.

Configuring an import

When the import item has been successfully created you need to configure the import to ensure it is processed correctly:

  1. With the import item displayed in the Item details panel, select the more actions button from the action bar.
  2. Select the Configure button.

alt text

  1. The Custom configuration page appears on the left hand side.

alt text

Note

NSG and NLPG imports have a similar page, refer to Configuring NSG and NLPG imports, for more information about how to configure those imports.

  1. You are presented with five steps that you can use to configure the import, which steps you complete is dependent on the type of data and whether you are inserting, updating, merging or replacing the data, see Configuring an import for more information about each of the individual steps.

    • Destination - this step is mandatory and allows you to define the design that is used to import the data correctly, the collection and how the data is handled.
    • Attributes - this step is optional and allows you to map the data to attributes within the design that you selected.
    • Geometry - this step is optional and applies only to data that includes geometry.
    • Network references - this step is optional and allows you associate asset data with a network.
    • Parents - this step is optional and allows you to enter the parents links associated with the data that you are importing.
Note

Depending on whether your data file includes geometry, Alloy may complete some of the steps automatically.

  1. When you have completed all the necessary steps for the data that you are importing you can proceed to validate the import.

Validate an import

  1. Select the Validate button when you have completed the configuration steps. A message appears to indicate that the import is being validated.

alt text

  1. A notification appears at the top of the Item details panel to indicate that the import file has been updated if the validation has been successful.

alt text

Note

If the validation is successful, but generates any warnings or errors you can reconfigure the import. A log file is generated that you can download to help you identify the errors. You can validate again once you have reconfigured the import.

Note

If the validation is unsuccessful an error message is displayed. A log file is generated that you can download to help you identify the errors and correct them, you will need to upload and re-import the corrected file.

  1. Select the notification to reload and refresh the browser. At this stage Alloy indicates that the status of the import item is Validated.

alt text

Committing an import

Once an import has been successfully validated you can commit the import. Depending on the type of import the data is either inserted, updated, merged or replaced in the system.

  1. With the import item displayed in the Item details panel, select the more actions button from the action bar.

alt text

  1. Select the Commit button. A message appears to indicate that the import is being processed.

alt text

  1. A notification appears at the top of the Item details panel to indicate that the import file has been processed if the commit has been successful.

alt text

Note

If the processing is unsuccessful an error message is displayed. A log file is generated that you can download to help you identify the errors and correct them, you will need to upload and re-import the corrected file.

  1. Select the notification to reload and refresh the browser. At this stage Alloy indicates that the status of the import item is Processed.

alt text

You should check the data has been imported correctly by examining items affected by the import.