How to import, export, or transfer my data | ParagonERP

How to import, export, or transfer my data

The universal translator is a powerful tool that can be used to import or export large amounts of data to and from Paragon. You can mass update your reference modules and you can also export and import transaction data. As an example, this document will show how to export, add records and then re-import the product file.

Step 1: Go to settings

To access the import and export functions, hit the settings button.


Import and export will be under the reports & data card.


Step 2: Export your configuration

Click on export under the reports & data card.


From the first drop-down scroll, select the module you'd like to export. You also have the option to include inactive products.



In this example, we have selected product. When you're ready, hit export.


Paragon will start exporting your data into a spreadsheet format.


The text box below your selections on the screen will provide you with the detail of the actions taken and their outcome.


Note that your browser may block the file as a security measure. Be sure to allow popups for this URL. The export will go into your downloads folder.


To understand the structure of the export, it helps to take a look at the product screen setup.


All of the attributes that are configured on the product screen will appear as columns in your excel sheet. For example, the attributes called power supply, product group and product name are set up on the product screen. They export as column headers in the file.


The first column is always the unique identifier of the record. This corresponds to code in the screen setup.


There are additional columns in the spreadsheet as well. These are:

status - This can be set to active and inactive. Depending on the status of the reference, you can perform specific actions in Paragon.

isMaterial, isProduct, isTool, isLabor - Use these columns to identify the type of record that you are importing. If the record that you are importing is a product, set the isProduct field to 1. If the record you are importing is also a material, set the isMaterial field to 1. In this example, the isTool and isLabor fields would be left blank. The record would appear in the product and materials modules after import.

Do not modify the names of columns. As explained, the columns are mapped to attributes that are set up on the module you're exporting

Step 3: Add or manipulate your export

Below are requirements for the data that you will try to import. If these are not respected, the import log will inform you that some of the data could not be loaded and will provide an explanation as well as the corresponding row number(s) on the spreadsheet.

  • Attributes set up as drop down lists must be entered exactly as is on the spreadsheet. Suggested values will not appear. If you have not added attribute values to the attribute you set up, they will not be automatically loaded.
  • You must set the status, i.e. temp (only for transactions) active or inactive (only for references)
  • Check-mark attributes need a value of 0 or 1 (0 = unchecked and 1 = checked)
  • For references : You must enter a unique record ID in the column "xxxxID" 
  • For transactions: You must enter a unique record ID in the column "xxxxID" and the column "detailsxxxxDetailID"
 
If you want to add new transactions manually, please make sure to put an asterisk (*) before the transaction ID. 
If you would like to use your own ID number for your new transaction(s) instead of Paragon generating them for you, prefix your ID number with a ~
If you do not use either prefix, the transaction will be rejected on import as invalid.

In this example, we have imported the credit data and we have added new data manually :
  1. imported data ID : 000001, 000002
  2. new data ID : *00045




After importing, ParagonERP  will automatically set an ID based on the existing transactions ID. 
Here, we set *00045 as the credit ID and ParagonERP renamed it into 000003. This is to avoid any inconsistency of data and to prevent errors.


Step 4: Import your data

Click on import under the reports & data card. Please note that the current maximum size limit of a file to be imported should not exceed 1MB.


Select the table or module that you wish to import or update - e.g. products, customers, vendors.


Then hit select a file.


Once you've chosen the correctly formatted file you'd like to import, hit upload.


Paragon will start importing your data from the spreadsheet selected.


The import modal screen will provide you with the detail of the actions taken and their outcome. If any rows in the spreadsheet were unsuccessful in the import, a reason will be given. If you do not see this information on the modal screen, you can scroll down to see additional information.


Any columns in the excel file that failed to import will be mentioned under Import file feedback. In this example, the attribute code nonSufficient failed to import because it was removed from the screen set up for product at the time of import. You will see a similar error message if you try to import a column for which the attribute was never created and applied to screen setup in Paragon.



If there are failures, you can correct your file and return back to the previous step by hitting the back button.

Please note that any column which fills data in a drop down attribute will fail to import if the data has not already been configured for that attribute.  For example, if you are trying to import colors in your product file and your file contains color black but the color attribute in Paragon only contains options for colors red, blue and green; the import for that record will fail and return a message like the one sampled above.

If you're satisfied with the import, hit done.

 

 Export/import custom BOM

In My Company you can set some transactions to have a custom bom (invoice, order, quote, purchase order, and work order). These are the transactions that will show up in the list to be exported and imported.




Once you have exported your file, you should be able to edit: total quantity, UOM, cost, and attributes. For this example we will change the UOM and quantity. 







Please note that if you want to add a new Custom BoM line to the import file, you must leave the LineNumber field blank.


Once you have made your changes, save and Import to Paragon using invoice custom BOM. When the process is complete, navigate to the invoice screen to view your changes in the custom BOM.





Adding a new item

If you decide to add a new item into the custom BOM, leave the line number blank and a new line will be created when your file is imported.





5: Import / export log

In the import / export log you can see the history of the imported files as well as the details of the actions taken and their outcome.


To open the import / export log, go to Settings -> Reports & Data and open the import/export log:




In the import/export log you will see the history of all the Imports that have been made:




If you hover over the  information button - it will show you the details about the import: 




If you want to see the details in full - hit the information button and a log modal will appear. 





From the Import/Export Log you can also download the Imported files by clicking on the file name. 




If you are looking for details on a specific Import you can also use the search bar to filter the log entries.





Other import/export use cases


    • Related Articles

    • How to import and export associations

      ParagonERP allows you to import and export associations that are used to link different pieces of information throughout the system. This can be useful when you want to add an association for multiple items at once. If you are unfamiliar with ...
    • How to import journal entries

      If you have a lot of information for the general ledger, and you don't want to manually enter each record, you can use our universal translator to load the information quickly. Here, we'll walk you through how to import journal entries. If you would ...
    • How to import warehouse locations

      If you have multiple warehouse locations that you want to add to Paragon's warehouse setup, you can import the information using the Universal Translator tool through the Location module. If you are unfamiliar with importing and transferring data ...
    • How to import and export BOMs

      ParagonERP allows you to import and export the BOM (bill of materials) of a product. This can be useful when you want to add to or edit your product BOM information across multiple products at once. Here, we’ll walk you through on how to import and ...
    • Importing GL opening balances into Paragon

      Importing the opening balances in ParagonERP refers to importing the monetary amounts that are being rolled over into a new accounting period for any one of your GL chart of accounts.  You would want to import any outstanding balances from your ...