<?xml version="1.0" encoding="utf-8"?>
<ManualTopic ID="/baanerp/tt/onlinemanual/mle_multi_language_application_data" xml:lang="en" UserLevel="Expert">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Multilanguage Application Data</Title>
		<Keyword ContextSensitive="No"><Level1>printer</Level1>
			<Level2>Multilanguage Application Data</Level2>
		</Keyword>
	</Header>
	<GeneralSection><SectionTitle>Overview</SectionTitle>
		<Paragraph class="Default">When your ERP LN system uses the Unicode character set, you can run multiple languages of the ERP LN software, such as Chinese, English, and French in one ERP LN environment.</Paragraph>
		<Paragraph class="Default">Also, you can enable ERP LN to store shared application data in multiple languages. This is useful if users from all over the globe are using the same environment. Depending on the user’s software language, the application data can also be displayed in the same language. If a report for a business partner is printed, the layout and data of the report are in the business partner’s language.</Paragraph>
		<Paragraph class="Default">To do this, you must configure Multilanguage Fields Support. For details, refer to the following section.</Paragraph>
		<Note><SectionTitle>
                                 Note
                              </SectionTitle>
			<Paragraph class="Default">You can only configure Multilanguage Fields Support for fields of the Multibyte String data type.</Paragraph>
			<Paragraph class="Default">To support all languages available for ERP LN in one environment, you must install ERP LN in Unicode mode. Unicode is the standard for multilanguage support and provides a unique code for each character regardless of the language.</Paragraph>
		</Note>
		<GeneralSection><SectionTitle>Language types</SectionTitle>
			<Paragraph class="Default">The following language types exist:</Paragraph>
			<TABLE border="1" borderstyle="default" space-and-orientation="indented-estimated"><TBODY><TR><TD rowspan="1" colspan="1">Software Language</TD>
						<TD rowspan="1" colspan="1">The language in which the software components, such as forms and reports, are displayed. For each user, the default software language is defined in the ERP LN user data.</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">Data Language</TD>
						<TD rowspan="1" colspan="1">The language in which the application data is displayed. Data languages are linked to users and software languages.</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">Base Language</TD>
						<TD rowspan="1" colspan="1">The fallback language used to display application data. <ProcedureList><ListIntro>
                                                ERP LN uses the following fallback mechanism:</ListIntro>
								<ListItem>
                                                ERP LN displays the application data in the data language specified in your user data.</ListItem>
								<ListItem>If no data language is specified in your user data, ERP LN displays the application data in the data language linked to your software language.</ListItem>
								<ListItem>If no data language is linked to your software language, ERP LN displays the application data in the base language.</ListItem>
							</ProcedureList>
						</TD>
					</TR>
				</TBODY>
			</TABLE>
		</GeneralSection>
		<GeneralSection><SectionTitle>ISO standards</SectionTitle>
			<Paragraph class="Default">In Infor Enterprise Server versions prior to 8.4.1, the coding of data languages is based on the ISO 639-2 standard. However, this standard is not sufficient for coding languages such as Simplified Chinese, Traditional Chinese and Portuguese, and Brazilian Portuguese.</Paragraph>
			<List><ListIntro>To support these languages, language coding in Infor Enterprise Server 8.4.1 and higher is done according to the ISO standards used for Java programs. A data language code consists of:</ListIntro>
				<ListItem>A language code based on the ISO 639-1 standard.</ListItem>
				<ListItem>Optional: a country code based on the ISO 3166-1 standard.</ListItem>
			</List>
			<Paragraph class="Default">The language code and the country code are separated by an underscore (_).</Paragraph>
			<Paragraph class="Default">For example:</Paragraph>
			<TABLE border="1" borderstyle="default" space-and-orientation="indented-estimated"><THEAD><TR><TD rowspan="1" colspan="1">Data Language</TD>
						<TD rowspan="1" colspan="1">Description</TD>
					</TR>
				</THEAD>
				<TBODY><TR><TD rowspan="1" colspan="1">de</TD>
						<TD rowspan="1" colspan="1">German</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">en_GB</TD>
						<TD rowspan="1" colspan="1">English_UNITED KINGDOM</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">en_US</TD>
						<TD rowspan="1" colspan="1">English_UNITED STATES</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">he</TD>
						<TD rowspan="1" colspan="1">Hebrew</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">it</TD>
						<TD rowspan="1" colspan="1">Italian</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">ja</TD>
						<TD rowspan="1" colspan="1">Japanese</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">nl</TD>
						<TD rowspan="1" colspan="1">Dutch; Flemish</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">pt_BR</TD>
						<TD rowspan="1" colspan="1">Portuguese_BRAZIL</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">pt_PT</TD>
						<TD rowspan="1" colspan="1">Portuguese_PORTUGAL</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">zh_CN</TD>
						<TD rowspan="1" colspan="1">Chinese_CHINA (Simplified)</TD>
					</TR>
					<TR><TD rowspan="1" colspan="1">zh_TW</TD>
						<TD rowspan="1" colspan="1">Chinese_TAIWAN (Traditional)</TD>
					</TR>
				</TBODY>
			</TABLE>
			<Important><SectionTitle>
                                    Important!
                                 </SectionTitle>
				<Paragraph class="Default">To use the new Enterprise Server 8.4.1 coding standards, a migration can be required for data languages created in earlier Enterprise Server versions. For details, refer to the Specific Installation Guide - Updates (U9497 US), chapter To migrate Data Langauages.</Paragraph>
			</Important>
		</GeneralSection>
	</GeneralSection>
	<GeneralSection><SectionTitle>Configuration</SectionTitle>
		<GeneralSection><SectionTitle>Prerequisites</SectionTitle>
			<Paragraph class="Default">To support multilanguage fields, ERP LN must be installed in Unicode mode. You can choose the Unicode character set in the ERP LN Installation Wizard.</Paragraph>
			<Paragraph class="Default">For more information on the prerequisites for a Unicode installation, refer to the Technical Notes.</Paragraph>
		</GeneralSection>
		<Important><SectionTitle>
                                 Important!
                              </SectionTitle>
			<Paragraph class="Default">Before you start the configuration of Multilanguage Fields Support, it is recommended you create a backup of the application data. For example, you can extract your application data through the <GUIRef href="/baanerp/tt/aad/ttaad4226m000" role="session">Create Sequential Dump of Table (ttaad4226m000)</GUIRef> session, or you can create a backup through the backup tools in your RDBMS.</Paragraph>
		</Important>
		<ProcedureSection><SectionTitle>To configure Multilanguage Fields Support</SectionTitle>
			<Steps><Step><StepTitle>Enable support for Multilanguage Fields</StepTitle>
					<ProcedureList><ListIntro>To enable support for Multilanguage Fields, complete the following steps:</ListIntro>
						<ListItem>Start the <GUIRef href="/baanerp/tt/adv/ttadv4106m000" role="session">Parameters Multi Language Support (ttadv4106m000)</GUIRef> session.</ListItem>
						<ListItem>Configure Multibyte and Unicode, and perform the required steps for this configuration. See the instructions displayed in the session's window.</ListItem>
						<ListItem>Select the <GUIRef href="/baanerp/tt/adv/ttadv4106m000#ttadv406.mdls" role="manual">Multi Language Fields Support</GUIRef> check box.</ListItem>
						<ListItem>Save the changes and close the session.</ListItem>
					</ProcedureList>
				</Step>
				<Step><StepTitle>Define data languages</StepTitle>
					<ProcedureList><ListIntro>To define <Link href="/baanerp/tt/glossary/glossary#100111" role="glossary" Update="No">data languages</Link>, complete the following steps:</ListIntro>
						<ListItem>Start the <GUIRef href="/baanerp/tt/aad/ttaad1111m000" role="session">Data Languages (ttaad1111m000)</GUIRef> session.</ListItem>
						<ListItem>Define the desired data languages. A data language consists of an ISO 639-1 language code and, optionally, an ISO 3166-1 country code. You can zoom to the <GUIRef href="/baanerp/tt/aad/ttaad1512m000" role="session">ISO 639 Languages (ttaad1512m000)</GUIRef> session and the <GUIRef href="/baanerp/tt/aad/ttaad1513m000" role="session">ISO 3166-1 Countries (ttaad1513m000)</GUIRef> session.</ListItem>
						<ListItem>Define the base language: Select a data language and, on the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="/baanerp/tt/aad/ttaad1111m000#make.base" role="command">Make Base Language</GUIRef>. <List><ListIntro>Note: The base language is used as a fall back language. Application data is displayed in the base language if both of the following scenarios occur:</ListIntro>
								<ListItem>No data language is defined in the user data of an ERP LN user.</ListItem>
								<ListItem>No data language is linked to the user's software language.</ListItem>
							</List>
						</ListItem>
						<ListItem>Convert the data languages to the runtime data dictionary. On the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="/baanerp/tt/aad/ttaad1111m000#convert.to.runtime" role="command">Convert Data Languages to Runtime</GUIRef>. The conversion process generates the $BSE/lib/data_langs file. <List><ListTitle>Important:</ListTitle>
								<ListItem>Only perform this step if you are sure you no longer want to change the base language. See the restrictions listed in the online help of the <Link href="/baanerp/tt/aad/ttaad1111m000" role="session">Data Languages (ttaad1111m000)</Link> session.</ListItem>
								<ListItem>During the conversion to runtime, all users must be logged off.</ListItem>
								<ListItem>When the conversion to runtime has finished, you must restart the ERP LN environment.</ListItem>
							</List>
						</ListItem>
						<ListItem>Close the session.</ListItem>
					</ProcedureList>
					<Paragraph class="Default">Data Languages have a status that is used to control their life cycle. For details, refer to "Life cycle of a data language" in the online help of the <Link href="/baanerp/tt/aad/ttaad1111m000" role="session">Data Languages (ttaad1111m000)</Link> session.</Paragraph>
				</Step>
				<Step><StepTitle>Link data languages to software languages</StepTitle>
					<Paragraph class="Default">You must link data languages to the corresponding software languages.</Paragraph>
					<ProcedureList><ListIntro>To link a data language to a software language, complete the following steps:</ListIntro>
						<ListItem>Start the <GUIRef href="/baanerp/tt/aad/ttaad1510m000" role="session">Software Languages (ttaad1510m000)</GUIRef> session.</ListItem>
						<ListItem>To start the <GUIRef href="/baanerp/tt/aad/ttaad1110s000" role="session">Software Languages (ttaad1110s000)</GUIRef> session, double-click a software language. In the <GUIRef href="/baanerp/tt/aad/ttaad1110s000#ttaad110.za_dlan" role="manual">Data Language</GUIRef> field, enter the desired data language. <List><ListIntro>Note:</ListIntro>
								<ListItem>You can zoom to the <GUIRef href="/baanerp/tt/aad/ttaad1111m000" role="session">Data Languages (ttaad1111m000)</GUIRef> session.</ListItem>
								<ListItem>You can only select data languages with status "Base Language" and "Available".</ListItem>
								<ListItem>If you leave the <GUIRef href="/baanerp/tt/aad/ttaad1110s000#ttaad110.za_dlan" role="manual">Data Language</GUIRef> field blank, ERP LN displays the application data in the data language defined in the user data of an ERP LN user, or in the base language.</ListItem>
							</List>
						</ListItem>
						<ListItem>Save the changes and close the sessions.</ListItem>
					</ProcedureList>
					<Paragraph class="Default">To ensure that application software and application data are displayed in the same language, link the data languages to the software languages.</Paragraph>
				</Step>
				<Step><StepTitle>Register Multilanguage Tables and Table Fields</StepTitle>
					<Paragraph class="Default">Register the tables and table fields that must be multilanguage enabled.</Paragraph>
					<ProcedureList><ListIntro>For all package combinations you want to be multilanguage-enabled, complete the following steps:</ListIntro>
						<ListItem>Start the <GUIRef href="/baanerp/tt/adv/ttadv4137m000" role="session">Registered Tables with Multi Language Fields (ttadv4137m000)</GUIRef> session.</ListItem>
						<ListItem>Select a package combination.</ListItem>
						<ListItem>Add the tables you want to be Multilanguage Enabled.</ListItem>
						<ListItem>Double-click a table. The <GUIRef href="/baanerp/tt/adv/ttadv4138m000" role="session">Registered Multi Language Fields (ttadv4138m000)</GUIRef> session starts.</ListItem>
						<ListItem>For each field you want to be multilanguage enabled, select the <GUIRef href="/baanerp/tt/adv/ttadv4138m000#ttadv438.enab" role="manual">Enabled</GUIRef> check box.</ListItem>
						<ListItem>Save the changes and close the sessions.</ListItem>
					</ProcedureList>
				</Step>
				<Step><StepTitle>Convert to runtime</StepTitle>
					<ProcedureList><ListIntro>To convert the multilanguage settings to the runtime data dictionary, complete the following steps:</ListIntro>
						<ListItem>Start the <GUIRef href="/baanerp/tt/adv/ttadv5215m000" role="session">Convert to Runtime Data Dictionary (ttadv5215m000)</GUIRef> session.</ListItem>
						<ListItem>Select the <GUIRef href="/baanerp/tt/adv/ttadv5215m000#table.def" role="manual">Tables</GUIRef> check box and the <GUIRef href="/baanerp/tt/adv/ttadv5215m000#reconfig.files" role="manual">Reconfigure Tables</GUIRef> check box.</ListItem>
						<ListItem>For package combinations, packages, and tables, enter the appropriate selection ranges.</ListItem>
						<ListItem>Click <GUIRef href="/baanerp/tt/adv/ttadv5215m000#exec.cont.process" role="command">Convert to Runtime</GUIRef>.</ListItem>
					</ProcedureList>
				</Step>
			</Steps>
			<GeneralSection><Note><SectionTitle>
                                       Note
                                    </SectionTitle>
					<Paragraph class="Default">Optionally, start the <GUIRef href="/baanerp/tt/aad/ttaad2500m000" role="session">User Data (ttaad2500m000)</GUIRef> session, and define a data language per user. The data language specified in the user data takes precedence over the data language linked to a software language. For more information, refer to "Language types" earlier in this section.</Paragraph>
				</Note>
			</GeneralSection>
		</ProcedureSection>
	</GeneralSection>
	<GeneralSection><SectionTitle>Data translation</SectionTitle>
		<Paragraph class="Default">When a user inserts new records, the multilanguage field descriptions are stored in the user's data language. ERP LN automatically copies the new field descriptions to the other data languages. These descriptions must be translated to ensure that all users who are running another data language code can read the new fields in their own language.</Paragraph>
		<Paragraph class="Default">It is recommended to assign dedicated users to perform the data translation; these users must be authorized to switch between different data languages.</Paragraph>
		<Paragraph class="Default">To ensure that a user can switch to another data language, you must select the <GUIRef href="/baanerp/tt/ams/ttams1110m000#ttams110.swdl" role="manual">Switch Data Languages</GUIRef> check box in the user's user data template properties ( <GUIRef href="/baanerp/tt/ams/ttams1110m000" role="session">User Data Template (ttams1110m000)</GUIRef> session).</Paragraph>
		<Paragraph class="Default">WebTop and WorkTop users can switch to another data language:</Paragraph>
		<TABLE border="1" borderstyle="default" space-and-orientation="indented-estimated"><TBODY><TR><TD rowspan="1" colspan="1">WebTop user</TD>
					<TD rowspan="1" colspan="1">On the <GUIRef href="" role="manual">Options</GUIRef> menu, click <GUIRef href="" role="manual">Infor ERP Options</GUIRef>. Subsequently, click <GUIRef href="" role="command">Change Data Language</GUIRef>.</TD>
				</TR>
				<TR><TD rowspan="1" colspan="1">WorkTop user</TD>
					<TD rowspan="1" colspan="1">On the <GUIRef href="" role="manual">Tools</GUIRef> menu, click <GUIRef href="" role="command">Change Data Language</GUIRef>.</TD>
				</TR>
			</TBODY>
		</TABLE>
		<GeneralSection ID="insertion_and_translation_process"><SectionTitle>Insertion and translation process</SectionTitle>
			<Paragraph class="Default">The steps that you must take to translate multilanguage field descriptions depend on the data language the new records are entered in. See the following sample scenarios:</Paragraph>
			<GeneralSection><SectionTitle>Scenario 1: A user works in the base language and inserts a record</SectionTitle>
				<ProcedureList><ListItem>When the user inserts a record, the descriptions of the multilanguage-enabled table fields are inserted in the base language code, and are automatically copied to all other linked data languages.</ListItem>
					<ListItem>For each table involved, you must run the <GUIRef href="/baanerp/tt/adv/ttadv4438m000" role="session">Print Multi Language Application Data (ttadv4438m000)</GUIRef> session. The session prints a report that shows the records that must be translated to other languages.</ListItem>
					<ListItem>Switch to the other data language(s) and translate the descriptions of these records.</ListItem>
				</ProcedureList>
			</GeneralSection>
			<GeneralSection><SectionTitle>Scenario 2: A user works in another language and inserts a record</SectionTitle>
				<ProcedureList><ListItem>When the user inserts a record, the descriptions of the multilanguage enabled table fields are inserted in the other language code, and are automatically copied to all other available data languages and the base language.</ListItem>
					<ListItem>For each table involved, you must run the <GUIRef href="/baanerp/tt/adv/ttadv4438m000" role="session">Print Multi Language Application Data (ttadv4438m000)</GUIRef> session. The session prints a report that shows the records that must be translated.</ListItem>
					<ListItem>Switch to the base language and translate the descriptions of these records to the base language. The translated descriptions are automatically copied from the base language code to all other available data language codes. <List><ListItem>Note: the descriptions in the original language code (the language code the records were created in) are overwritten.</ListItem>
						</List>.</ListItem>
					<ListItem>Run the <GUIRef href="/baanerp/tt/adv/ttadv4438m000" role="session">Print Multi Language Application Data (ttadv4438m000)</GUIRef> session again for each table involved . The session prints a report that shows the records that must be translated from the base language to other languages.</ListItem>
					<ListItem>Switch to the other data language(s) and translate the descriptions of these records. <List><ListItem>Important: You must also translate the descriptions stored in the original language code (the language code the records were created in).</ListItem>
						</List>
					</ListItem>
				</ProcedureList>
			</GeneralSection>
		</GeneralSection>
	</GeneralSection>
</ManualTopic>
