Using Translation Designer

Using the Information Bar

Across the top of the translation grid, an information bar displays helpful information about the project. The target language, current project, and current viewing option (all, translated, untranslated, or modified) are set in italic.

On the left side of the bar, you can see the hierarchical organization that is used to display definitions in the grid: pages (at the highest level), fields (at the next level), and translatable definitions—field labels, page text, and translate values—at the lowest level.

Each definition is color-coded to remind you with which definition type you’re working.

• Fields: blue.

• Field labels: light purple.

• Page text (not derived from a field label): dark purple.

• Translate values: green.

Further, the following graphical cues help you understand the display:

• All fields on the page are displayed, even if they are hidden fields.

• The default label ID appears in italics, but not boldface.

• Any label ID that is used but that is not the default label appears in boldface italics.

• Page text from hyperlinks is displayed.

• If the same field has multiple label IDs on the same page, it appears only once for that page.

Image: Color-coded definitions

This example illustrates the fields and controls on the Color-coded definitions.

In this example, notice that there is a group box with page text that is not derived from a field label. The ADDRESS_TYPE field has a set of associated translate values. All other translatable definitions are field labels.

Notice also that the default label ID is italicized but not bold, while any non-default label IDs used are in bold italics. This is apparent when you look at the ZIP field, which has two labels. The other field labels appearing in the grid are associated with the field, but not used on the page being translated; they are displayed primarily so the translator can see the context in which they are translating the label and ensure consistency of terminology across labels.

Expanding and Collapsing Nodes

The left side of the translation grid is a hierarchical tree control that displays all the definitions on the page.

Field or Control	Definition
	Click once to expand the definition by one level.
	Click once to collapse the definition by one level.

To expand the entire tree structure, from the View menu select Expand All. To collapse the entire tree structure, from the View menu select Collapse All. Right-clicking anywhere in the grid displays a popup menu that contains these options. Another option on the popup menu, Expand Current Definition, expands the selected definition by one level.

Choosing Which Rows to View

Right-click anywhere in the translation grid to see a popup menu that lets you choose which rows are displayed in the grid:

Keep in mind that the options you select in the popup menu work together. If you select Expand Current Object while Untranslated is activated, you might not see anything. This means that everything in the current definition is translated.

Resizing Columns and Rows

To change the column width, place the cursor over the column divider on the information bar. When the cursor changes, drag the column divider to the desired position. You can resize only translatable columns; you cannot resize the columns that display the hierarchical tree of page definitions. Use the same technique to change row height.

Entering Translations

The working area of Translation Designer consists of four columns of data:Base Long Name, Tgt Long Name (target long name), Base Short Name, and Tgt Short Name(target short name).

As the column names imply, the two base language columns display the base language labels for the definitions in the grid. To translate the labels, type the translation into the Tgt Long Name and Tgt Short Name fields.

The grid incorporates standard text editing functionality. Cut, Copy, and Paste operations are available under the Edit menu. To force a line break within a label (so that the text wraps on the page), press CTRL+ENTER.

The first time that you translate a particular field label, the same translation is entered into any other occurrence of that field in the current grid. This ensures consistency and saves time.

The grid automatically limits the length of the text you enter based on the maximum length of the fields. When you reach the maximum length, you cannot add any more characters.

As with any Application Designer definition, changes are not permanent until you save them.

Navigating Translation Designer

Click to move to a cell or node in Translation Designer, or use the standard Microsoft Windows keyboard shortcuts:

• Press TAB or ENTER to move to the right; press SHIFT+TAB to move to the left.

• Use any of the arrow keys to move from cell to cell.

  For example, the UP ARROW key moves you to the cell above the current cell.

• To move from the text cells to the tree, press the LEFT ARROW key.

• To move from the hierarchical tree to the text cells, press TAB.

  You can use the RIGHT ARROW key only when there are text cells in the same row—that is, if the current node is a translatable definition.

• Use the UP ARROW and DOWN ARROW keys to move around in the hierarchical tree—for example, from a field to an adjacent field or to a page.

  To move to a lower level, first press TAB to move into the main Translation Designer. Then move up or down to the desired node. Then use the LEFT ARROW key to move back into the tree.

• If there are several pages in your project, scroll directly to the node for a particular page by right-clicking that page in the project workspace and from the menu select Translate and choose Translate Page Definitions from the popup menu.

Searching and Replacing

To search for a specific word within a single column:

• Place the cursor anywhere in that column, and select Edit, Find and Replace In Current Column.

  To search a column you cannot edit, from the Edit menu choose Find in Current Column.

• The Find and Replace dialog boxes provide standard search and replace functionality, including the Find Next, Replace, and Replace All buttons. In either dialog box, select the Match case check box if you want to enable case-sensitive searching.

• The Find option provides enables you to search up or down the column.

  When you reach the top or the bottom of the column, the search does not cycle back through the column. Therefore, if you want to search the entire column, ensure that you’re in the top row when you press Find Next.

• The Replace function always searches down the column.

  If you want to replace all occurrences in the column, ensure that you’re in the top row when you press Replace.

Using Application Designer Functionality

Because Translation Designer is integrated into the Application Designer, you can use all standard Application Designer features while Translation Designer is open. Some features that are particularly useful during translations are:

• Using the Find Definition References option to research where in the system a particular definition is used. To use this option, from the Edit menu select Find Definition References.

• Opening a translated page in order to realign translated definitions.

• Opening definitions to see the properties.

  Remember, as long as you’re logged on using a non-base language, modifying labels in the definition updates the related language tables, not the base language tables.

There are several ways to open a definition:

• Use standard Application Designer functionality to open the definition from the project window.

• From the File menu, select Open.

• Double-click or right-click the definition within Translation Designer and select View Definition from the popup menu that appears.

  When you have selected page text that is not associated with a field definition, the page itself opens.

If there is a version of the page for the user’s language preference, that version appears; if not, the base language page appears.

See Security Administration.

Integrating with Other Applications

Because Translation Designer emulates a Microsoft Excel spreadsheet, you can use the standard Windows copy and paste tools to copy translations from Translation Designer into Excel or another Windows application. This is useful when running spell check against your translations or when saving your translations in a spreadsheet for offline review.

To copy the entire contents of the currently open Translation Designer into the clipboard:

1. Select the entire grid.

   From the Edit menu choose Select All or click in the top left cell of the grid border.

2. From the Edit menu select Copy.