Skip to content

Latest commit

 

History

History
39 lines (21 loc) · 2.31 KB

01-main-concept.md

File metadata and controls

39 lines (21 loc) · 2.31 KB

Main Concept

This article explains the architecture and behavior of Virto Commerce Import Framework, which allows you to easily import your data, such as product information, customers, categories, and much more, into the Virto Commerce platform.

Overview

VC Data Import allows you to define what kind of data you want to import into your application using custom configurable Import profiles where one determines what types of data to import and from which data sources.

Data types and sources for import

When using VC Data Import, you can leverage its key advantages:

  • Manage user defined import profiles directly from the platform manager UI

  • See the import history with detailed logs

  • Work with an extensibility model that enables extending the existing built-in importers with new data types and sources

Core Structure

The chart below shows VC Data Import's high level logical structure:

VC Data Import structure

As you can clearly see, VC Data Import is based on three main objects:

  • Import job: An object for a task that imports data according to ImportProfile; you can run it both manually on-demand or regularly based on a schedule.

  • Import profile: A user-defined entity with a unique name acting as its ID. Each profile must be associated with a certain Importer and also can be configured through the runtime parameters in Settings that Importer might provide.

  • Importer: A piece of code that reads data from a specific data source file (CSV, XLS, etc.) and writes an object of a specific data type (products, prices, etc.) to the target system. Each Importer consists of the three main objects:

    • DataReader, which reads data from a file (CSV, XSLS, YML, etc.) or another type of external source (a database, a web service, etc.);

    • DataWriter that writes the imported objects into the system; and

    • Settings, which provides settings that can be used to configure ImportProfile linked to the importer in question.

Note: More information about Module services here.

Note: You can also create your own data importers, which we explain here.