ECLASS Advanced Data file can be imported into STEP by uploading it to either a configured hotfolder, or through a File Loading Widget on a Web UI Homepage. The purpose of the Data Importer Web UI setup outlined in this topic is to offer a readily available solution for importing data in a supported ECLASS Advanced Data format. Only the BMEcat 2005.1 data is allowed to be imported as the ECLASS Advanced Data file.
Because only supported versions will successfully upload, before attempting to upload a Data file, confirm the file version being uploaded is listed within the ECLASS Standard Supported Versions and Formats topic.
Considerations before initiating the data import
Before importing a BMEcat 2005.1 file into the system, it's important to consider the following:
-
BMEcat 2005.1 is purposefully designed for transporting ECLASS Advanced data, making it exclusively compatible with ECLASS Advanced.
-
BMEcat data corresponds to specific ECLASS Advanced version(s), requiring the prior import of the corresponding / matching ECLASS Advanced version before commencing the BMEcat data import.
-
The BMEcat 2005.1 Importer exclusively handles ECLASS Advanced data. Standard BMEcat (1.2 or 2005) fields will not undergo import.
-
Unlike the ECLASS Advanced Dictionary file, which is language-specific, the BMEcat 2005.1 file includes multiple languages. Therefore, it's imperative to execute Language Mapping before initiating the import of BMEcat 2005.1 data.
Prerequisites
The Data Importer exclusively supports BMEcat 2005.1 file format. In case the XML file is zipped, it is essential to manually extract the .zip file to access the Data file.
Before engaging in any BMEcat 2005.1 import scenarios, it is essential to import the related ECLASS Advanced unit and ECLASS Advanced Dictionary file into the system.
The BMEcat 2005.1 Reference Feature System should be mapped with the corresponding ECLASS Advanced Version. For information about how to map BMEcat 2005.1 Reference Feature System with the Corresponding ECLASS Advanced Version, refer to Mapping BMEcat 2005.1 Reference Feature System with the Corresponding ECLASS Advanced Version topic available within the ECLASS Advanced Quick Start Guide section of the STEP Online Help.
Language Mapping has to be established. For information about how to perform Language Mapping, refer to Prepare the Language Dimension Mappingtopic available within the ECLASS Advanced Quick Start Guide section of the STEP Online Help.
If you have completed the Easy Setup actions for the ECLASS Advanced Model, the functionalities outlined in this topic should be readily available for use. Unlike other ECLASS Advanced importers, the IIEP used for ECLASS Advanced Data Importer requires some manual configuration before using it for the first time. For information about updating the newly Easy Setup created IIEP, refer to Update IIEPsavailable within the ECLASS Advanced Quick Start Guide section of the STEP Online Help. For a detailed information on how to configure ECLASS Advanced Data importer, refer to Configuring ECLASS Advanced Data Importer topic.
Import Process Overview
Once a valid ECLASS Advanced file is uploaded using a File Loading Widget (or uploaded directly to a hotfolder), the file is picked up from the hotfolder by an IIEP, and the IIEP starts a Background Process.
Procedure
-
Access the ECLASS Advanced Web UI Homepage.
-
Drag and drop a valid Data file into the 'Data Import' File Loading Widget, or upload to the hotfolder (root/upload/hotfolders/EclassAdvDataImporter/In).
For information about File Loading Widget, refer to File Loading Widget topic within the Web User Interfaces section of the STEP Online Help.
For more information about uploading files directly to the hotfolder, refer to ECLASS Advanced Import Frameworktopic.
-
Once the upload has started, users can view the progress of the upload using the 'Recent background processes' side panel.
For more information on using the 'Recent background processes' side panel, refer to Recent Background Processes Side Panel topic within the Main Properties Overview section of the STEP Online Help.
After uploading the file, the IIEP picks it up and initiates a Background Process for the import process. The file loading widget does not provide background process monitoring in the Web UI. You can monitor the import status within the workbench through the IIEP Background Process that is generated.
For more information about monitoring the IIEP via background process, refer to Monitoring an IIEP via Background Process topic within the Data Exchange section of the STEP Online Help.