Import term base (existing)
You can import data into a new term base or into an existing one.
Important: When you import files into an existing term base, all contents are recreated: the old term base contents (data, languages, structure) are all discarded and created again from the imported file's data. The GUID remains so that the term base can still be accessed by existing projects. Starred entries are not preserved. Cross-references between entries of a term base are deleted on recreation.
Importing into an existing term base is useful when you regularly need to manually fill a QTerm term base with contents of a term base. The formats you can use are XLSX, CSV, TBX or MultiTerm.
Note: When you import Excel or CSV files, their content is added to the earlier content of the term base. TBX and MultiTerm files, however, overwrite the earlier content - just like you were importing into a new term base.
How to get here
- Open memoQWeb in a web browser. Log in as an administrator, project manager, terminologist, or external user.
- Click the QTerm tab. The QTerm - Home page appears.
- In the list, find the term base you want to import.
- In the term base's row, in the Operations column on the left, click the Import icon. The Import term base wizard opens.
What can you do?
Page 1 - Select file(s) to be imported
Click Choose file and browse to the file to upload. You can choose an XLS, XLSX, CSV, or TXT file, zipped or unzipped.
- To go to Page 2: In the upper right corner, click Next.
- To close the wizard and return to the Home screen without importing a term base: In the upper right corner, click Cancel.
Page 2 - File properties
- Choose a Layout. To learn about the options, click their help icons.
-
- If the imported file has column headers in the first row, check the First line contains field names check box.
- To return to Page 1: In the upper right corner, click Back.
- To go to Page 2: In the upper right corner, click Next.
- To close the wizard and return to the Home screen without importing a term base: In the upper right corner, click Cancel.
Page 3 - Define mappings between file columns and term base metadata
The column headers are color-coded:
- Green means QTerm could automatically map this column to a term base field. If it is correct, you do not need to touch it.
- If the automatic mapping is incorrect: Click edit. The column header becomes white (see below).
- To leave the field out of the import: Click ignore. The column header becomes gray.
- Orange means QTerm could not automatically map this column to a term base field. You need tell QTerm how to map it.
- To specify mapping: Click edit. The column header becomes white (see below).
- To leave the field out of the import: Click ignore. The column header becomes gray.
- White means you are telling QTerm how to map this column.
- If the automatic mapping is incorrect: Under Please select field, choose a field, then click ok.
- To leave the field out of the import: Click ignore. The column header becomes gray.
- To jump to the previous unmapped (orange) field: click back.
- To jump to the next unmapped (orange) field: click next.
- Gray means you told QTerm to ignore this column. It will not be imported into the term base.
Select a mapping from the Available mappings dropdown and click Load, or go through the columns and make sure each is either green or gray.
To change the mapping you selected: Click Update.
To delete the mapping you selected: Click Delete.
To save the current mapping: Enter a name in the Save mapping as field, and click Save.
- To return to Page 2: In the upper right corner, click Back.
- To go to Page 4: In the upper right corner, click Next.
- To close the wizard and return to the Home screen without importing a term base: In the upper right corner, click Cancel.
Page 4 - Import options
By default, term base entries are added as new entries to the term base. To update your term base entries instead, check the Update based on entry ID check box.
To set default values for optional metadata which have no default values in the term base definition and in the imported file, check the Set default value for missing optional fields check box. The optional fields are listed in three sections: Entry, Language, and Term.
- To return to Page 3: In the upper right corner, click Back.
- To go to Page 5: In the upper right corner, click Next.
- To close the wizard and return to the Home screen without importing into the term base: In the upper right corner, click Cancel.
Page 5 - Import summary
This page shows the result of the import analysis.
- To return to Page 4: In the upper right corner, click Back.
- To close the wizard and return to the Home screen without importing a term base: In the upper right corner, click Cancel.
- To import the term base data: In the upper right corner, click Start import.
Page 1 - Select file(s) to be imported
- Choose Import type: You can import term bases as a single TBX file or as TBX+XCS, zipped or unzipped. An XCS is a skeleton file that contains structural information for the TBX.
- Click Choose file and browse to the file to upload. If you chose Upload ZIP file above, select a ZIP file that has either a TBX and an XCS file, or a single TBX file inside.
- If the imported term base contains picklists, you can make your QTerm term base more easily readable if you check the Replace underscores with spaces in pick list values check box.
- If the TBX file was created using SDL MultiTerm, check the Multiterm TBX model? check box.
- To return to Page 1: In the upper right corner, click Back.
- To close the wizard and return to the Home screen without importing a term base: In the upper right corner, click Cancel.
- To import the term base data: In the upper right corner, click Start import.
-
Click the MultiTerm data tab.
Importing MultiTerm data into an existing term base deletes earlier entries. The term base will contain only what you import.
- Choose Import type: You can import term bases as a pair of XDT+XML files, zipped or unzipped.
- Click Choose file and browse to the file(s) to upload. If you chose Upload ZIP file above, select a ZIP file that has an XDT and an XML file inside.
- If the MultiTerm export file has spaces in its field names, check the Import spaces in field names as underscore check box.
-
To pick up additional picklist values from metadata during import: Check the Automatically expand value set of pick lists check box.
Sometimes, value sets of MultiTerm picklists are defined in more than one place - not only in the term base definition. Metadata for entries, languages, or terms can contain possible picklist values. QTerm can find these values during the import, and add them to the value set. If you do not check this check box, QTerm ignores such values.
- To map the fields in your MultiTerm export file to this QTerm term base’s built-in fields: Click the Map fields button.
The Term base mapping window opens.
To change MultiTerm fields and values: Click the Edit icon, and choose a new field or value from the dropdowns.
You can only map fields on the same level (Entry, Language, or Term) and of the same field type.
If there are forbidden terms in the MultiTerm term base, always use the settings in the image above: map QTerm's Forbidden field to the Status picklist's Forbidden value.
To apply the changes, click OK. To discard the changes, click Cancel.
- To return to Page 1: In the upper right corner, click Back..
- To close the wizard and return to the Home screen without importing a term base: In the upper right corner, click Cancel.
- To import the term base data: In the upper right corner, click Start import..
When you finish
QTerm generates a term base import report. If there are any errors, you can click the link on that page to download the report.
Click Close. The Term bases screen opens.