Translator Kit

The Translator Kit contains, among other things, an XLIFF file. This XLIFF file contains the texts to be processed for the respective ONTRAM job. The file can be edited with XLIFF compatible editors. The export can be configured by several options.

Option

Description

Language codes source and target language

The Translator Kit is exported with ONTRAM's default language and country abbreviations. For example, the source language is preassigned with the de-DE identifier and the target language is preassigned with en-GB. You can override these presets with the values from your translation software here.

XLIFF type

 

Name
Abbreviation
Recommendation
Description

Standard:

e

Swordfish and others

For programs, which are compatible with XLIFF. The programs must support segment status changes.

Note: The segment status is taken into account when reimporting to ONTRAM. Only segments with the status “translated” are imported into ONTRAM. The status change of translated segments to “translated” must be made before the reimport.

Simplified (with preallocation):

b

MemoQ

For tools that support XLIFF in part. Target language segments without TM matches are preallocated by the source language text. Texts in the target language are not exported.

When reimporting to ONTRAM, all segments, regardless of status, are imported again.

Simplified (without preallocation):

c

Trados, MemoQ

For programs that only support XLIFF to a limited extent. Target language segments without Translation Memory matches are not preallocated by source language text. Texts in the target language are exported with the status “translated”.

When reimporting to ONTRAM, all segments, regardless of status, are imported again.
 
Recommendations
 
Standard
Simplified (with preallocation)
Simplified (without preallocation)
Trados
      
MemoQ
      
Swordfish
      
Others
      

 

 

 

Add TMX file

A TMX file is added to the download. The translation memory determined by the system for this translation job is contained in the TMX file. The TMX file can be used for a local TM comparison.

Note: If there are no matches from the translation memory for this job, this menu item will be grayed out and cannot be selected. If this occurs, no TMX file will be added to the Translator Kit.

Add TBX File 

A TBX file is added to the download. The terminology matches determined by the system for this translation job are contained in the TBX file. The TBX file can be used for a local terminology comparison.

Note: If there are no matches from the terminology database for this job, this menu item will be grayed out and cannot be selected. If this occurs, no TBX file will be added to the Translator Kit.

Add Information

Any reference files stored in the ONTRAM system are added to the download. The reference files can refer to both source and target language(s). The reference files related to the source language are located in the “reference_files” directory. The reference files, which refer to one or more target languages, are each located in a separate directory “Reference_files_LANG_CODE”.

Add History and Statistics

An HTML file is added to the download, which contains the previous history of the translation job. It includes comments as well as the statistics on the translation job. With the help of this information, you can understand any comments outside the system.

Only recent changes (Not available on all instances)

Special Delta export, in which only the changes in the current workflow step are exported to the XLIFF of the Translator Kit. Any initial translations made in the current step will not be considered for export.

Note on comments

Any comments on segments of the target language that are present in the job are exported to the XLIFF by default. If supported, you can also enter comments on individual target language segments in your CAT tool, which are then assigned to the corresponding segment in ONTRAM when the XLIFF is reimported. These comments can then be viewed by the other project participants.

 

Note: You can activate settings in your user profile under Settings -> Email settings at the point “Send an offline translator kit to me on handover”. If activated, an XLIFF translator kit is automatically generated and is included as an attachment in the ONTRAM notification email. This is especially useful if you generally want to work offline and do not want to log in to the system for every translation job.

Tip: Jobs that you have exported as a Translator Kit will be displayed in your “My Jobs View” in the “Actions” column with an “[ICON]”. So you can see in the overview whether certain jobs have already been exported as Translator Kit or not.

 

Translate jobs offline with the Translator Kit

  1. Log into a job.
  2. Click the Offline Translation menu.
  3. Optionally, configure export options.
  4. Click Generate Translator Kit. The Translator Kit is generated. After generation, a download link appears in the generation bar.
  5. Click in the generation bar and save and extract file locally.
  6. Open the XLIFF of the Translator Kit with an XLIFF editor and translate content.
  7. Log into previously opened job.
  8. Click the Offline Translation menu.
  9. Select XLIFF file and click Upload.

Result: The job has been imported. In addition, the system provides a summary of the import activities in an import log. This Protocol shall include:

 
Entry
Description

Start of the import

Timestamp (server time) - start of the import process

Duration of the import

Duration of the import process in the format 0:00

Job language

ONTRAM path of the job to which is currently being imported

Imported file

Imported file name

Number of segments of the job

Number of all segments present in the job

Number of imported segments

Number of imported segments. The number of imported segments may be reduced due to errors (see Error section) or a segment status in the offline file.

Error

Output of faulty segments that could not be returned. This can be the case, for example, if placeholders have not been adopted into the target language or an incomplete inline formatting within a segment is detected. The system outputs the ONTRAM segment ID and an error description.

Example:

Error: Incorrect placeholders in segment 1_1-50-0-0. Missing placeholder in target language: {/style1}

With the help of the ONTRAM segment ID and the error description, you can correct the error in the offline file and make a new import. Alternatively, you can try to return the corresponding text manually in the ONTRAM online editor. If this is not possible, please contact the ONTRAM support channel you have been notified. The ONTRAM team will support you in returning the segments.
 

Bulk Translator Kit Import/Export

This function is available for power users with appropriate permissions directly in the Jobs tab. Users with this permission can export multiple jobs simultaneously as a Translator Kit. The prerequisite is the permission:

 
Permission
Description

Job Handling: Enable export for multiple offline translation packages

Enable users to export offline translation packages for multiple jobs from the "Jobs" tab.
 

Carry out bulk export

  1. Navigate to the Jobs tab
  2. On the left side, select the checkboxes of the jobs you want to export
  3. Click on the “Translator Kit” button at the top right of the toolbar
  4. Configure the export in the bulk menu according to your wishes. The same options are available as in the offline translation menu
  5. Select whether you want to export individual packages for the jobs or all Translator Kits in a zip archive (checkbox: Package wise: All Translator Kits as own ZIP file)
  6. Click on “Generate Translator Kit”

Result: The Translator Kit is created according to your configuration. You can download the data from the generation menu. The system remembers your settings. If you use this function more often. So you do not have to make the settings again every time.

Carry out bulk import

  1. Navigate to the Jobs tab
  2. Click on the “Translator Kit” button
  3. In the bulk menu that has now been opened, select the package to be imported from the “Import” menu
  4. Click on “Import”

Result: The XLIFF files of the package are analyzed and the translations made in the XLIFF are returned to the corresponding jobs. The system provides a summary of the import activities in an import log. This protocol shall include:

 
Entry
Description

Start of the import

Timestamp (server time) - start of the import process

Duration of the import

Duration of the import process in the format 0:00

Job language

ONTRAM path of the job to which is currently being imported

Imported file

Imported file name

Number of segments of the job

Number of all segments present in the job

Number of imported segments

Number of imported segments. The number of imported segments may be reduced due to errors (see Error section) or a segment status in the offline file.

Error

Output of faulty segments that could not be returned. This can be the case, for example, if placeholders have not been adopted into the target language or an incomplete inline formatting within a segment is detected. The system outputs the ONTRAM segment ID and an error description.

Example:

Error: Incorrect placeholders in segment 1_1-50-0-0. Missing placeholder in target language: {/style1}

With the help of the ONTRAM segment ID and the error description, you can correct the error in the offline file and make a new import. Alternatively, you can try to return the corresponding text manually in the ONTRAM online editor. If this is not possible, please contact the ONTRAM support channel you have been notified. The ONTRAM team will support you in returning the segments.