In this part, you find descriptions of what you can do with all kinds of translation material in OpenTM2. Each type of data, such as documents, dictionaries, and folders, is considered as an object on which you can perform an action, such as copying, changing, and deleting.
For each OpenTM2 object, you find a chapter that contains :
- A general description of what the object is
- An overview of the functions and the terminology related to the object
- Detailed descriptions of the actions you can perform on the object
How a task is described
Each task is described according to the following structure:
- In an introduction, the individual task is explained such as when and why to do it.
- How to perform the task is usually described as follows:
Prerequisites
What the prerequisites are
Calling sequence
How to get to the windows required for performing the task
Options and parameters
Which options and parameters to specify and how to specify them
Results
What is achieved by the task
Export and import
To exchange translation material with other OpenTM2 users or other programs, OpenTM2 offers functions to exporting and importing the translation material.
To import an object, for example a folder, is a prerequisite for working with it in OpenTM2. You export an object to work with it outside OpenTM2. Exported objects can be in OpenTM2 format or in external format.
Objects in OpenTM2 format are files in a compressed format and can be imported only by other OpenTM2 users. For files in this format, you only have to specify the drive where to export to, or where to import from. These files are stored in the eqf\export directory of the selected drive.
Objects in external format are ASCII encoded files that can be edited with a text editor. They can be imported by other OpenTM2 users and processed by other systems. For files in external format you must specify the fully qualified DOS file name where to export to, or where to import from.
Files in external format contain SGML tags that describe the structure of the files and the data it contains. For a complete description of SGML, refer to ISO 8879, Information Processing – Text and Office Systems – Standard Generalized Markup Language (SGML).
Printing
In several windows you can request to print information.
You can print:
- The contents of all list windows, such as the “Folder List” window or the “Dictionary List” window
- The details of a folder to be imported
- The terms in an exclusion list
- The terms in a new terms list or a found terms list
- The data of a dictionary entry
- A complete dictionary or selected parts of it
- A document file
- The results of counting words
- The key assignments in the Translation Enviroment
You are prompted with the “Print Setup” window where you can specify the destination of your printout.
Printing list windows
You can print the contents of all list windows, such as the “Folder List” window or the “Dictionary List” window on a printer of your selection.
Prerequisites
The respective window that contains the list to be printed is active.
Calling sequence
Select Print list… from the File menu. The “Print Setup” window is displayed where you can specify the printer you want and the layout of your printout.
Results
The list is printed on the printer of your choice. The printout reflects the columns and column widths of the list window that is displayed. If the list window has autotext columns, for example for long document names, the width of the printed columns is adjusted to the actual length.
Windows
To perform an action on an object in OpenTM2, you can specify the options and parameters in a window specific for this action. At the bottom of the window you find pushbuttons, where you can:
- Start the action (left pushbutton)
- Leave the window without any further action (Cancel)
- Ask for information about this window (Help)
Message windows
When you work with OpenTM2, the system prompts you with message windows if necessary. There are several types of messages:
Informational
For example, to inform you that a Translation Memory was imported completely
Error
For example, if something critical happens
Warning or Question
For example, to ask whether you really want to delete a folder
All messages have a unique number and start with EQF to identify them as OpenTM2 messages.
With all message windows where you are asked to confirm actions on an object, you can select a Yes to All button in the first message window that pops up after an action has been requested. When you pressed this button, OpenTM2 assumes the answer Yes on all subsequent message windows that ask for a confirmation. For example, while analyzing documents of a folder, a message asks if you want to overwrite the target document because translation for a document has already started. If you answer Yes to All, all subsequent messages are suppressed.
Progress windows
Some actions may require some time to complete, for example:
- Organizing a dictionary
- Exporting a Translation Memory
- Analyzing all documents of a folder
The progress of such an action is indicated by a so-called progress window (see Figure 19).
Figure 19. Organizing Dictionary sample window
This type of window can be minimized to let you do other work in OpenTM2. When the action is completed, a message with the result of the action is displayed.
If you want to interrupt the action, double-click the system icon of the progress window. In the following message window, you can confirm the cancellation request.
Menus
To perform an action on a list window such as the “Translation Memory List” window in OpenTM2, you can do one of the following:
- Select the appropriate item from the OpenTM2 menu bar to access a menu of actions.
- Click the icon in the toolbar representing this action. The most important tasks are represented as icons.
- Open a context-sensitive popup menu where you can select the same items as from the OpenTM2 menu bar. The menu shows only the selection of tasks that can be started from the currently active list window. You open the popup menu by pressing the right mouse button.
Specifying an output file
You may need to specify an output file when working with one of the following windows:
- “Count Words” for documents or a folder (see)
- “Print Dictionary” ()
When you select the output option File and click Select…, the “Select File” window is displayed (see Figure 20).
Figure 20. Select File window
Specify the fully qualified file name, consisting of drive, directory and file name, as follows:
- Select the drive where the file is to reside from Save in.
- Select the directory to hold the file by double-clicking it.
- Specify a name in the File name field.
- Select the file type from Save as type.
Alternatively, you might select an existing file name as the output file. Its content will be overwritten upon completion of the operation.
When you have specified the file name, click Save to return to the previous window.
Results
The drive, directory, and file name you select are used by the respective function.
Selecting multiple objects in list windows
Several list windows in OpenTM2 allow you to select more than one object on which you want to perform the same task. This allows you to perform repeatable and time-consuming tasks unattended.
In the following chapters, whenever a “Calling sequence” asks you to select “one or more” objects in one of the list windows, you can use this capability. If unsure, just try to select multiple objects in a window. OpenTM2 only allows you to select multiple objects if it can safely perform the task on multiple objects in one run.
The selection of multiple objects is done much like in the Windows environment. You use the mouse to click list items. Holding down the Ctrl key, and then clicking list items, lets you randomly select list items in a list window. Holding down the Alt key, and then clicking list items, lets you select a series of list items. If you prefer to use key combinations only, or need information about more sophisticated selection methods, see the Windows Help facility.
Multiple object selection is supported in the following windows:
Document List window
Almost all OpenTM2 tasks can be applied to multiple documents in this window.
Note:Â If you view document properties for multiple documents, the “Document Properties” window shows:
- Property values that are equal for all selected documents in black color.
- Property values that are different for all selected documents in grey color. Only the property values of the first document are shown.
If you change document properties for multiple documents, the changed values are applied to all selected documents, and unchanged values are left as they are.
For example, assume that document A (properties are markup EQFAMRI, and editor STANDARD) and document B (properties are markup EQFAMRI, and editor XLATE) are selected in the “Document List” window. The “Document Properties” window shows markup EQFAMRI in black color (because it is equal for both documents) and editor STANDARD in grey (because the second document uses a different editor). If you change the editor in the “Document Properties” window to RTFEDIT, and save the change, this editor is now associated with the selected documents.
Folder List window
The Export, Delete, and Analyze tasks can be applied to multiple folders in this window.
Note:Â If you prefer to use the Explorer-like tree view, you cannot select multiple folders from the directory tree displayed on the left. Instead, click the parent folder on the left, and click the individual folders on the right.
Translation Memory List window
The Export, Delete, and Organize tasks can be applied to multiple Translation Memories in this window.
Dictionary List window
The Export, Delete, and Organize tasks can be applied to multiple dictionaries in this window.
The Access and Disconnect tasks can be applied to multiple shared Translation Memories in this window.
The Access and Disconnect tasks can be applied to multiple shared dictionaries in this window.
Import … windows
Import tasks can be applied to multiple objects in the various import windows, such as the “Import Documents”, “Folder”, “Translation Memory”, “Dictionary”, “New Terms Lists”, “Found Terms Lists”, “Exclusion Lists”, and “Markup Table” windows.
Notes:
- In the “Import Folder” window the options you specify are applied to all folders to be imported. The option cannot be selected if multiple folders are to be imported. Also, the “Details” page in the “Import Folder” window cannot be selected.
- In the “Import Dictionary” window the option cannot be selected if multiple dictionaries are to be imported. The dictionaries are imported using the file names given when they were exported. For every dictionary to be imported the “New Dictionary” window is shown before the import starts.
- In the “Import Translation Memory” window the option cannot be selected if multiple Translation Memories are to be imported. The Translation Memories are imported using the file names given when they were exported. For every Translation Memory to be imported the “New Translation Memory” window is shown before the import starts.
Viewing and changing the details of a list item
In the list windows, OpenTM2 can show you more information in addition to the names of the list items. You can ask the system to display these view details selectively and in a sequence defined by you.
The details contain properties and statistical information of the list items, such as the:
- Name of a document
- Source language of a Translation Memory
- Size of a new terms list
- Date when a document was analyzed
- Date when a found terms list was updated
- Drive where a folder is stored
Details can be displayed for:
- Folders
- Documents
- Dictionaries
- Translation Memory databases
- New terms lists
- Found terms lists
- Exclusion lists
- Markup table list
You can view the selected details and change which details are displayed on a list window.
Viewing selected details
Prerequisites
The respective list window is already selected.
Calling sequence
Select Details from the View menu.
Results
The list window contains for each list item the detail information as previously defined. As an example, the “Document List” window is shown in Figure 21.
Figure 21. Document List window sample with selected details
As a default setting, only the names are displayed. You can change the details to be displayed (see Changing the details setting). Once you have defined your setting of the details, they are displayed as selected.
Changing the details setting
OpenTM2Â lets you customize the view details in the respective list window.
If not all details of a list item, for example a folder, fit on one line in the list window, you should set priorities.
As an example, this window is explained for the details of documents in the “Document List” window.
Prerequisites The respective list window is already selected, for example a “Document List” window.
Calling sequence Select Change Details… from the View menu.
The “Change View Details” window is displayed.
Figure 22. Change View Details sample window for documents
Options and parameters
Details
This box displays all the view details available, for example, name, drive, dates.Double-click those view details you want to be displayed in the “Document List” window.
Selected
This box displays the view details selected. The items are displayed from left to right in the same order you selected them from the Details list box.To deselect an item, double-click the entry in theSelected box. Click Clear to remove all items from the Selected box. You can then begin to define a new sequence of details.
When you have selected the desired details, click Change to activate the new setting.
Click Cancel at any time to leave the “Change View Details” window. No changes are made.
Results
The list window contains the selected details in the newly defined sequence. This setting remains active throughout the current session until you change it again.
To save the settings for future OpenTM2 sessions, respond with Yes to the prompt Do you want to save the current workbench? when you leave OpenTM2. The current settings will then be used the next time you start OpenTM2.
Arranging and filtering list items
In the list windows, all items are listed and sorted by name in alphabetical order. For example, in the “Folder List” window, you always find all the folders that you created in, or imported into, OpenTM2, sorted by name.
You can change this by arranging the items according to specific details and by filtering specific items. For example, you can arrange the folders by name in descending order, or by markup table and within the same markup table by description. In addition, you can define that only those folders are displayed whose name starts with a W.
You can arrange and filter items in the following list windows:
- “Folder List”
- “Document List”
- “Dictionary List”
- “Translation Memory List”
- “New Terms Lists”
- “Found Terms Lists”
- “Exclusion Lists”
- Markup table list
Arranging list items
OpenTM2Â provides several sort keys that enable you to arrange the items in the list windows according to your needs.
Prerequisites
The respective list window is selected.
Calling sequence
Select Sort… from the View menu.
The “Sort List Items” window is displayed.
Figure 23. Sort List Items window
Options and parameters
1st sort key
Select the detail according to which the list is to be sorted, for example, markup table. Also decide whether items are to be sorted in ascending or descending order.
2nd sort key
Select the detail according to which the list is to be sorted within the first sort and decide whether the items are to be sorted in ascending or descending order.For example, when you decide to sort your folders by markup table (1st sort key) and several folders have the same markup table, these folders are automatically sorted by name within the markup table. If, however, you want to sort the folders that use the same markup table by their description, you select Description as the 2nd sort key.
3rd sort key
Select the detail to be used as third sort key and specify the direction of the sort.
After selecting your sort keys, click Sort to reflect your specifications in the appropriate list window.
Click Cancel to leave the “Sort List Items” window without rearranging the items on your list window.
Results The list window displays the items sorted according to your specifications.
Filtering list items
If a list window contains too many items, you can reduce its contents.
Prerequisites
The respective list window is selected.
Calling sequence
Select Filter… from the View menu.
The “Filter List Items” window is displayed.
Figure 24. Filter List Items window
Options and parameters
Column
Select the detail that you want to use as filter condition. For example, if you wanted to list only those folders that were updated before, on, or after a certain date, you would select the detail Updated.
Operator
Select one of the available operators.
Value
Specify a name or date, or part of a name. It can be up to 15 characters long and be specified in uppercase, lowercase, or mixed case. You can also use a wildcard (*) in the value.
The individual operators and possible values are explained using the following folder list:
The Equal operator
Use this operator to search for a single folder that exactly matches a specific value. You cannot use a wildcard in the value.
Example 1:Â To display only the folder SHOWME, you must specify the following:
Figure 25. Specifying the Equal operator (Example 1)
Example 2:Â To display the folder that was updated on February 27, 1998, you must specify the following:
Figure 26. Specifying the Equal operator (Example 2)
The Not equal operator
Use this operator to search for all folders that do not match a specific value. You cannot use a wildcard in the value.
Example 1: If you want all folders whose name is not SHOWME, your specification will look similar to the one in Figure 25 except that you select the Not equal operator instead of the Equal operator.
Example 2: If you want all folders that were not updated on February 27, 1998, your specification will look similar to the one in Figure 26 except that you select the Not equal operator instead of theEqual operator.
The Less operator
Use this operator to search for all folders updated before a certain date or for all folders the detail of which precedes the letters that you specify. You can use a wildcard in the value.
Example 1:Â To list all folders that were updated before March 29, 2000, you specify the following:
Figure 27. Specifying the Less operator (Example 1)
Example 2: To list all folders whose name precedes the letters WORKFLG, you specify the following:
Figure 28. Specifying the Less operator (Example 2)
You then get the following list:
Figure 29. Result of a Less operation
The Less or equal operator
Use this operator to search for all folders updated on or before a certain date or for all folders the detail of which precedes or matches the letters that you specify. If you specify a wildcard in the value or do not specify the full value, you will not get an exact match.
Example 1:Â To list all folders that were updated on or before February 27, 1998, you specify the following:
Figure 30. Specifying the Less or equal operator (Example 1)
You then get all folders updated in 1996, and the folder updated on the specified date.
Example 2: To list all folders whose name precedes or matches the letters WORKFLG, you specify the following:
Figure 31. Specifying the Less or equal operator (Example 2)
In this example you get the same list as in Figure 29 described in The Less operator because the value WORKFLG is not the full name of a folder and therefore no exact match can be listed.
The Greater operator
Use this operator to search for all folders updated after a certain date or for all folders the detail of which follows the letters that you specify. You can use a wildcard in the value.
Example 1:Â To list all folders that were updated after March 22, 1996, you specify the following:
Figure 32. Specifying the Greater operator (Example 1)
Example 2: To list all folders whose dictionary name follows the letters WORKDIF, you specify the following:
Figure 33. Specifying the Greater operator (Example 2)
You then get the following folders:
Figure 34. Result of a Greater operation
The Greater or equal operator
Use this operator to search for all folders updated on or after a certain date or all folders the detail of which follows or matches the letters that you specify. If you specify a wildcard in the value or do not specify the full value, you will not get an exact match.
Example 1:Â To list all folders that were updated on or after February 27, 1998, you specify the following:
Figure 35. Specifying the Greater or equal operator (Example 1)
You then get all folders updated in 2000, and the folder updated on the specified date.
Example 2: To list all folders whose Translation Memory name follows or matches the letters SH*, you specify the following:
Figure 36. Specifying the Greater or equal operator (Example 2)
In this example you get the following list:
Figure 37. Result of a Greater or equal operation
The Like operator
Use this operator to search for folders the detail of which matches, starts with, or ends with, the value that you specify. If you do not specify the full name, you must represent the missing characters by an asterisk.For example, if you want to list only those folders whose description starts with Folder, you specify the following:
Figure 38. Specifying the Like operator
After making your selections, click Activate filter to reflect them in the appropriate list window.
Click Cancel to leave the “Filter List Items” window without changing the contents of your list window.
If you want to have a complete list of your folders again, select Show all from the View menu.
Viewing and changing the system preferences
You can view and change the properties of your system.
Calling sequence
Select System Preferences from the File menu.
The “General page” of the “System Preferences” window is displayed. For more advanced options select the “Advanced” page of this window.
Figure 39. General page of System Preferences window
Options and parameters
Replace generic inline tagging during automatic substitution
Select this check box if you want OpenTM2 to adapt the tagging in the Translation Memory during automatic substitution for exactly matching segments that differ only in inline tags. If selected, OpenTM2 replaces the tagging in a translation proposal and the source of this proposal with the tagging from the currently active segment. As a result, the Translation Memory becomes format-independent, which results in more automatic translations because of more exact matches.
The automatic tagging replacement occurs only if:
- Exact text matches are encountered
- Tagging between the currently active segment and the translation proposal is different
- A one-to-one correspondence between the taggings in the currently active segment, the translation proposal, and the source of the proposal can be proven.If an active segment does not contain a tagging that is, on the other hand, contained in a translation proposal, OpenTM2 deletes this tagging from the translation proposal and the source of this proposal.
- All taggings in a segment are suitable for replacement or deletion. No partial replacement or deletion takes place.
This option is helpful if you translate updated documents that were meanwhile converted to a different document format. For example, if you first translated a BookMaster document, and you now translate an update of the same document in SGML format, the Translation Memory for this document successively converts to SGML.
As a side effect, inline tags convert to lower, upper, or mixed case, dependent on the preference in the translated document.
Logo display time in ms
Specify for how many milliseconds (ms) the OpenTM2 logo is to be displayed when you log on to OpenTM2 before the Translation Workbench appears.
Standard Web Browser
Specify the name of the Web Browser to be called. You can also click Browse to display the “Select a Web Browser” window on which you can select it.
Use Explorer-like tree view
Select this check box if you want to have your folder list displayed in an Explorer-like tree view. Your “Folder List” window would then look as follows:
Figure 40. Folder List window in Explorer-like tree view
Fuzzy match overlap ratio — for Translation Memory Lookup
You can specify individual overlap ratio thresholds for the retrieval of fuzzy matches in small, medium, and large segments. You can specify values from 5% to 50%. If nothing is specified, the default overlap ratio is 33% regardless of a segment’s length.
Fuzzy matches with an overlap smaller than the specified percentage (or default) are not retrieved from the translation memory as translation proposals. Further, all matches below 50% are considered as “no matches” when OpenTM2 counts matches (see Counting the number and type of matches in a document and Creating a Counting Report).
See Translation Memory matches for more details, if required.
Fuzzy match overlap ratio – for display
For the display in the translation environment, you can specify individual overlap ratio thresholds for fuzzy matches in small, medium, and large segments. You can specify values from 5% to 99%. If nothing is specified, the default overlap ratio is 33% regardless of a segment’s length.
Fuzzy matches with an overlap smaller than the specified percentage (or default) are not displayed as translation proposals in the translation environment.
Default Target Language:
For the editor and translation memory handling as well as some other functionalities, it is necessary to specify the default target language.
Memory import in ANSI or ASCII format:
- The default target language is used to obtain the codepage which is used to convert the input data from ASCII/ANSI to Unicode (UTF-16). It is therefore import that the “default target language” mathches exactly the language of the target segments in the imported memory.
Memory export in ANSI or ASCII format:
- The default target language is used to obtain the codepage which is used to convert the internal Unicode (UTF-16) data to ASCII/ANSI. When the defualt target language does not match the target language of the exported segments most likely some special characters will be corrupted. Memories with a source language other than English should always be exported in Unicode format to avoid corrupted charactes on the source or the target side of the segments.
Other:
- There are several other locations within OpenTM2 which require a conversion to/from Unicode. At all locations where no specific language is available (i.e. all non-document related functions) the default target language is used to obtain the codepage for the conversion.
After making your selections, click Set to activate the new settings.
Click Cancel to leave the “System Preferences” window without activating any new settings.
Results
The settings become effective immediately. If you selected the Explorer-like tree view for your folder list, however, close OpenTM2 and then open it again to get the “Folder List” window in this view.