| Import
/ Export Data Files Help | |
|
This page allows you to import and export departments, categories, sub-categories, and products through tab-delimited text files. There are several sections contained in this help topic so please use the quick links below to jump to the area you need help with. IMPORTING
HELP EXPORTING
DATA FILES When you press the EXPORT button, the store will gather up all of the department, category, sub-category, product, and product option data. Next, it will store this information in special tab-delimited text files and present a page for you to download them to your computer. NOTE:
This is a very important step that should be done before you attempt to import
data into your store! Each download file will contain a series of "records" which contain information about each item in the database (departments, categories, products...). Each record consists of a series of "fields" separated by tabs. Most database and spreadsheet programs can read and write tab-delimited text files which makes it easy for you to download and manipulate the store's database. The first record in each tab-delimited text file contains "field header" information. This record identifies the name, order, and use of each field that follows in each data record. This "field header" record MUST also exist when importing data back into your store - so please DO NOT DELETE it or change it in any way. The "field header" record must always be the first record in the file. For information about each field in a downloaded tab-delimited text file, please see the appropriate section below.
IMPORTING
DATA FILES IMPORTANT: we strongly recommend using the EXPORT features above to download and inspect how the store's database files are constructed and see how the fields/data relate to each other. This is a very important step that should be done before you attempt to import data into your store. CAUTION - make sure you have a complete store backup BEFORE performing any import function. The very nature of this feature provides for very little in the form of error checking. Be extremely careful when importing data into your store. Failure to carefully construct data within an import file may result in your store malfunctioning or not working at all. Use the import features at your own risk! Importing
Tips and Notes The first record in each tab-delimited text file contains "field header" information. This record identifies the name, order, and use of each field that follows in each data record. This "field header" record MUST exist when importing data back into your store - so please DO NOT DELETE it or change it in any way. The "field header" record MUST always be the first record in the file and MUST contain the same field names in the same order as created by the export function above. DO NOT change it in any way. The actual data contained in each field is equally as important. Some fields are required and must exist for the import feature to be successful. Some data fields are case sensitive while other fields require certain predefined codes to be present. You will find detailed field information for each type of import file in the section below. IMPORTANT: The import file does NOT replace and recreate the store's database in mass - instead the store takes the import file and adds, updates, or deletes records in the store's database for the one or more records it finds in the import file. When importing records, the store will check each import record's primary key (prod_number for example in the product import file) against the data already contained in the database. If a new record is detected (by primary key), the import function will add the import record to the store's database. If an existing record is detected (by primary key), the store will update the record in the database with the information from the import record. If an existing record is detected (by primary key) and its "delete flag" field contains "DELETE", the record will be removed from the database. NOTE: The DELETE FLAG is one of the fields in the import file's record format. To delete a database record using the import file, the record must exist in both the store's database and in the import file (so the store knows to process it). In addition, the import record's field called "delete_flag" must contain the exact phrase "DELETE". TIP: An import file can consist of only one record if needed (say to delete, change, or add just one record). The import file is processed record-by-record and only the records in the import file are processed (worked on) in the store's database. The import function does not delete and recreate the entire store database from the import file. Instead, it simply adds, changes, or deletes one or more database records based on the records in the import file. CAUTION - make sure you have a complete store backup BEFORE performing any import function. The very nature of this feature provides for very little in the form of error checking. Be extremely careful when importing data into your store. Failure to carefully construct data within an import file may result in your store malfunctioning or not working at all. Use the import features at your own risk! Selecting
and Uploading Import Files - When BROWSE BUTTON is Displayed Depending on the size of the import file, this process may take a few minutes. Therefore, please be patient and allow this process to finish. Only press the IMPORT DATA button one time! This is a one step process in which the store will receive the import file from your computer and process its informaiton. NOTE: the store must process the import file by its exact file name and therefore, it must be called: "departments.txt", "categories.txt", "subcategories.txt", "products.txt", or "productoptions.txt" (without the quotes). All files names must be in all lowercase leters, end with the ".txt" extension, and must not contain any spaces or other punctuation. Selecting
and Processing Import Files - When BROWSE BUTTON is *NOT* Displayed Once the import file(s) has been uploaded to the store, enter the name of the import file you want to process in this field. Press the IMPORT DATA button to begin the import process. The store will open, read, and process the import file specified from the Qstore/Qtemp directory of the store. A message will display informing you when the store has completed the process. NOTE: the store must process the import file by its exact file name and therefore, it must be called: "departments.txt", "categories.txt", "subcategories.txt", "products.txt", or "productoptions.txt" (without the quotes). All files names must be in all lowercase leters, end with the ".txt" extension, and not contain any spaces or other punctuation. |