Import DELTA file

Remark:

With this form you can import data from a file in DELTA format into the database. Choose Data -> Import -> Import DELTA ... from the menu to open the window for the import. In the window click on the button to select the file with the data you want to import. If the Multi-file option is selected before pressing the button, a folder selection window opens to select the folder where the DELTA files are located. For muti-file processing currently the files "chars", "items", "specs" and "extra" are evaluated. If during analysis or import any problems occur, you may click on the button to reload the file and re-initialize the window.

 

The contents of the file will be shown in the upper part of the File tree section. If special characters are not displayed corretly, try a different Encoding setting, e.g. "ANSI", and reload the document using the button. In the bottom part of the window you find the import database and the actual processing state.

In the file tree you may deselect entries that shall not be imported into the database. Use that option very carefully, because if you deselect entries that are being referenced by other parts of the input tree, e.g. descriptors referenced by descriptions, the analysis or import step might become erronous!

If during reading of the files expressions cannot be interpreted, suspicious entries are maked with yellow background (warning) in the file tree. When you move the mouse curser over the marked entries, you get additional information as tool tip or the tree node text itself tells the problem (see example below).  

 

 

Analysis

To analyse the data in the file click on the Analyse data button. During the analysis the program checks the dependencies between the different parts of the data and builds up an analysis tree in the lower part of the window. The analysis tree contains all data in a suitable format for the final import step. During data analysis the icon of the button changes to  and you may abort processing by clicking the button. 

In the Analysis settings section (see image below) you set the document's Language. You man change the display and sorting of the entries in the Language combo box from "<code> - <description>" to "<description> - <code>" (and back) by clicking the button . If you need language codes that are not included in the list, click the button. For more details see Edit language codes.

The Insert "variable" state controls the handling of the DELTA state "V" for categorical summary data. If possible, a categorical state "variable" is inserted to the descriptor data and set in the summary data, when the state "V" is present in the description data.

If the Check strings for illegal characters  option is checked, all string literals that shall be exported from database are scanned for illegal non-printable characters and matches are replaced by a double exclamation mark ("‼"). Activating this option may increase the analysis processing time.

In DELTA text in angle bracket (<text>) usually denotes comments, which are by default imported into the "Details" fields of the database. In the lower parts of the Analysis settings you may adjust a different handling for description, descriptor and categorical state items. 

After changing one of these settings click on the Analyse data button to make the changes effective.

 

After analysis a message window informs you if any warnings or errors occured. You can find detailled error and warning information at the file and/or analysis trees by entries with red text (error) or yellow background (warning). When you move the mouse curser over the marked entries, you get additional information as bubble help or the tree node text itself tells the problem (see example below). By clicking on the status text besides the progress bar, you can open an analysis protocol (see below, right). 

 

If an analysis error occured, you are not able to proceed. You will first have to correct the problem, e.g. by excluding the erronous descriptor in the example above (after reloading the file). If a warning occured, it might not cause problems during import, but you should take a closer look if the imported data will be correct.

 

Import

If you want to import new data to a project you have two import options:

Before starting the import, you should take a look at the import settings:

To start the import click on the Start import button. Now the data from the analysis tree are written into a local database cache and finally stored into the database.

 

After import a message window inform you if any warnings or errors occured. You can find detailled error and warning information at the file and/or analysis trees by entries with red text (error) or yellow background (warning). When you move the mouse curser over the marked entries, you get additional information as bubble help or the tree node text itself tells the problem. By clicking on the status text besides the progress bar, you can open an import protocol (see below). 

 

 

Handling of special DELTA states

In the DELTA format the special states "-" (not applicable), "U" (unknown) and "V" (variable) are available for categorical and quantitative characters. These states are treated in the folloging manner during import:

 

Update

If you imported new data using option New import, a new import session with the following data will be created:

For those entities you may update the columns "label", "detail" and "data_entry_notes" (only for descriptors). To achive this, you must specify the same Language in the Analysis settings as adjusted as project language. If you specify a different Default language, the data will be imported as translations for the columns "label" rsp. "detail" (see image below). For descriptor column "data_entry_notes" translations are not supported.

 

Preparation

By changing the Analysis settings and a clicking the Analyse data button you may modify the handling of DELTA comments. E.g. if you used the default settings during a past import, a DELTA character "data record <type>" was imported as descriptor "data record" and "type" was written into the columns "detail". In the Analysis settings you may now select option Keep comments in descriptor titles to update the descriptor title to "data record <type>". 

 

Import settings

Before starting the import, you should take a look at the import options:

Start the import click on the Start import button. Now the data from the analysis tree are written into a local database cache and finally stored into the database.