Import Language-Dependent Data from XML - Wizard (ttadv8920m000)

Use this wizard to import XML files with language-dependent components into the data dictionary. When you import the language-dependent components, Tools compiles the imported labels, and converts imported domains to run-time, and converts the imported system overhead to run-time. That is, after the import, the imported components are ready for immediate use at run-time.

In Tools, you can define multiple labels with the same code, that have different heights, and lengths. When Tools displays a label for a software component, by default, Tools displays the longest label defined for the label code. If an imported label is shorter than any existing labels with the same code in the VRC, the existing (older) label displays on the software component. To ensure the imported (new) labels display for your VRC's software components, you must select the Remove Existing Label Variants check box in this session.

Note: If an error occurrs during the import process, Tools does not compile the labels. To compile the labels that are imported during an import process in which an error occurs, use the Compile Labels (ttadv1243m000) session.

If this wizard is started from the Languages (ttpmc4511m000) session, these restrictions apply:

On the first wizard page, only Import File, Get File Header, and Check XML File are enabled.
On the second page, only Remove Existing Label Variants is enabled.
On the last page, only Save Defaults is enabled.
You must select an import file that matches the language and translation run that you selected in the Languages (ttpmc4511m000) session. If you select an XML file for a different translation run or a different language, then an error message is displayed.

Field Information

Import File

Type or select the path to, and the name of, the file you want to import.

When you import your file, LN checks the validity of the file's XML structure. If your XML file contains structural errors, LN stops the import. To check your file's XML structure before you start the import process, click Check XML File.

To display the header of the import file in the File Header field, click Get File Header .

Note: You can start this wizard from the Languages (ttpmc4511m000) session. In that case, the import file must match the language and translation run that you selected in that session. The language is displayed above the Import File field.

File Header

Shows the imported file's header. The header shows the file's settings, made in the Export Language Dependent Data to XML - Wizard (ttadv8910m000) session.

Import the whole file or make own component selection

Select:

Yes , to import all language-dependent components listed in the import file.

No, I want to make my own selection , to make a selection of language-dependent components in the import file to be imported.

Get Defaults

Restores the wizard's default settings. To save your current settings for the wizard as the default, click Save Defaults on the wizard's final dialog.

Language

The code of the language in which you want to import the language-dependent components.

Default value

The language you specified for the Target Language field in the Target Language (optional) box when you created the file to be imported with the Export Language Dependent Data to XML - Wizard (ttadv8910m000) session.

Import VRC

The version code of the VRC into which you want to import the language dependent components from XML.

Default value

The version code specified for the Import VRC field in the Import VRC box, when you created the import file with the Export Language Dependent Data to XML - Wizard (ttadv8910m000) session.

Import VRC

The release code of the VRC into which you want to import the language dependent components from XML.

Default value

The release code specified for the Import VRC field in the Import VRC box, when you created the import file with the Export Language Dependent Data to XML - Wizard (ttadv8910m000) session.

Import VRC

The customer code of the VRC into which you want to import the language dependent components from XML.

Default value

The customer code specified for the Import VRC field in the Import VRC box, when you created the import file with the Export Language Dependent Data to XML - Wizard (ttadv8910m000) session.

Remove Existing Label Variants

If this check box is selected, any existing labels in the import VRC with the same code as labels in your import file, will be removed from the import VRC. The imported labels replace the existing labels that have the same code in the import VRC.

Default value

Checked

If this check box is cleared, existing labels in the import VRC are not removed from the import VRC. The existing labels, and the imported labels with the same code are stored in the import VRC.

Note: In Tools , you can define multiple labels with the same code, that have different heights, and lengths. When Tools displays a label for a software component, by default, Tools displays the label with the longest length defined for the label code. If an imported label is shorter than any existing labels with the same code in the VRC, the existing (older) label displays on the software component. To ensure the imported (new) labels display for your VRC's software components, you must select this check box.

Select list or range of packages

Select:

Specify a list of packages , to specify a list of packages whose language dependent components you want to import. You specify each package's code in the Specify a list of packages to import (example 'tt, tu, ..'): field.

Select a range of packages , to specify a range of packages whose language dependent components you want to import. You specify the start and end values for your range of packages in the Select list or range of packages box.

Specify a list of packages to import (example 'tt, tu, ..'):

Define the list of packages (by code) whose language dependent components you want to import to your import VRC.

Note: You can only maintain this field if you select the Specify a list of packages option in the Choose a way to select packages: box.

Current Package

The start value in the range of packages whose language dependent components you want to import.

Note:

You can only maintain this field if you select the Select a range of packages option, in the Choose a way to select packages: box.
If you select the Exclude the following packages from the range (example 'tt, tu, ..'): check box, in the check box's adjacent field, you can define the packages (by code) to exclude from the range of packages whose language dependent components you want to import.

Package

The end value in the range of packages whose language dependent components you want to import.

Note:

You can only maintain this field if you select the Select a range of packages option, in the Choose a way to select packages: box.
If you select the Exclude the following packages from the range (example 'tt, tu, ..'): check box, in the check box's adjacent field, you can define the packages (by code) to exclude from the range of packages whose language dependent components you want to import.

Exclude the following packages from the range (example 'tt, tu, ..'):

If this check box is selected, in the adjacent field you can define the packages you want to exclude from the range of packages whose language dependent parts are imported from XML.

Note: You can only maintain this check box if you select the Select a range of packages option in the Choose a way to select packages: box.

Exclude the following packages from the range (example 'tt, tu, ..'):

If you select the Exclude the following packages from the range (example 'tt, tu, ..'): check box, in this field you can type the code of the packages whose language dependent components you want to exclude from the import.

Choose to select components within selected package(s)

Select:

Yes , to select the packages' language dependent components that you want to import from XML. You can make selections for the labels, messages, questions to be imported, and/or a selection system overhead components to be imported.

No, I want to import all components , to import all of your selected packages' language dependent components from XML.

Labels

If this check box is selected, in the adjacent fields you can define a range of labels to import from XML. Only labels that belong to your selected package(s) are imported from XML.

If this check box is cleared, no labels are imported from XML.

Labels

The start value in the range of labels you want to import from XML.

Note:

You can only maintain this field if you select the Label check box.
Only labels that belong to the package(s) you selected on the wizard's previous form are imported.

Labels

The end value in the range of labels you want to import from XML.

Note:

You can only maintain this field if you select the Label check box.
Only labels that belong to the package(s) you selected on the wizard's previous form are imported.

Questions

If this check box is selected, in the adjacent fields you can define a range of questions to import from XML. Only questions that belong to your selected package(s) are imported from XML.

If this check box is cleared, no questions are imported from XML.

Questions

The start value in the range of questions you want to import from XML.

Note:

You can only maintain this field if you select the Questions check box.
Only questions that belong to the package(s) you selected on the wizard's previous form are imported.

Questions

The end value in the range of questions you want to import from XML.

Note:

You can only maintain this field if you select the Questions check box.
Only questions that belong to the package(s) you selected on the wizard's previous form are imported.

Messages

If this check box is selected, in the adjacent fields you can define a range of messages to import from XML.

If this check box is cleared, no messages are imported from XML.

Messages

The start value in the range of messages you want to import from XML.

Note:

You can only maintain this field if you select the Messages check box.
Only messages that belong to the package(s) you selected on the wizard's previous form are imported.

Messages

The end value in the range of messages you want to import from XML.

Note:

You can only maintain this field if you select the Messages check box.
Only messages that belong to the package(s) you selected on the wizard's previous form are imported.

Choose to select system overhead

Select:

Yes , to import all system overhead components from XML.

No, I want to make a selection , to select the system overhead components you want to import from XML. You select the system overhead components on the wizard's next form.

No, I do not want to select overhead , to import no system overhead components from XML.

Standard Commands

If this check box is selected, in the adjacent fields you can select the range of standard commands whose language-dependent components are imported from XML.

If this check box is cleared, none of the standard commands' language-dependent components are imported from XML.

Standard Commands

The start value in the range of standard commands whose language dependent components you want to import from XML.

Note: You can only maintain this field if you select the Standard Commands check box.

Allowed values:

Field: Form field options.
Field (vertical occ): Field options on vertical occurrence form.
Form 4GL: Form choice options.
General Table Maintenance: Choice options on vertical occurrence form.
Mark delete: Options during mark delete.
Mark delete (vertical occ): Mark delete options on vertical occurrence form.
Mark one: Options during mark one
Mark one (vertical occ): Mark one option on vertical occurrence form.
Menu: Menu options.
Help viewer: Options in Help viewer.
Print to Display: Options in view of print to display.
Calendar: Options in the calendar.
Text Editor: Options in the text editor.
Form Editor: Options in the form editor.
External Editor: Options in the external text editor.

Standard Commands

The end value in the range of standard commands whose language dependent components you want to import from XML.

Note: You can only maintain this field if you select the Standard Commands check box.

Allowed values:

Field: Form field options.
Field (vertical occ): Field options on vertical occurrence form.
Form 4GL: Form choice options.
General Table Maintenance: Choice options on vertical occurrence form.
Mark delete: Options during mark delete.
Mark delete (vertical occ): Mark delete options on vertical occurrence form.
Mark one: Options during mark one
Mark one (vertical occ): Mark one option on vertical occurrence form.
Menu: Menu options.
Help viewer: Options in Help viewer.
Print to Display: Options in view of print to display.
Calendar: Options in the calendar.
Text Editor: Options in the text editor.
Form Editor: Options in the form editor.
External Editor: Options in the external text editor.

Other System Overhead

If this check box is selected, all of the other system overhead's language dependent components, except pulldown commands, are imported from XML. To import the pulldown command's language dependent components, select the Pulldown Commands check box, and in the check box's adjacent fields, define the range of pulldown commands for XML import.

If this check box is cleared, none of the other system overhead's language dependent components are imported from XML.

Pulldown Commands

If this check box is selected, in the adjacent fields you can define the range of pulldown commands whose language dependent parts are imported from XML.

If this check box is cleared, no pulldown command's language dependent parts are imported from XML.

Note: You can only select this check box if you select the Other System Overhead check box.

Pulldown Commands

The start value in the range of pulldown commands whose language dependent components you want to import from XML.

Note:

You can only maintain this field if you select the Pulldown Commands check box.

Pulldown Commands

The end value in the range of pulldown commands whose language dependent components you want to import from XML.

Note: You can only maintain this field if you select the Pulldown Commands check box.

Check your selections:

Displays your selections for import from XML. To make changes use the Back button to regress to the wizard's appropriate form.

Save Defaults

Saves the current settings as your default settings.

When you click Get Defaults on the wizard's opening form, Tools configures the wizard with your default settings.

Make Job

Click Make Job to start the Add Session to Job (ttaad5102s000) session, which you can use to add the import process to a job.