MLS Overview

2016 MetricStream, Inc. All Rights Reserved.

Agenda

What is MLS?

Prerequisites

Why and When we perform MLS Certification ?

MLS Implementation Scope

MLS Deployment Process

MLS Deployment Tool

Scripts to add locale column to LOV and MLOV field

After Translation

Known Limitations

Reference Links

2016 MetricStream, Inc. All Rights Reserved.

Multilingual Language Support

MLS is the process of designing an application so that it can be adapted

to various languages and regions without engineering changes.
MLS can be enabled for all the User Interface objects & emails.
MLS (locale) data is categorized as static text like labels (static pages),
messages (including alert and errors etc..) and dynamic text like forms,
reports, dashboards, assignments, etc..
All users in the system are mapped to certain locale, and defaulted to
English.

2016 MetricStream, Inc. All Rights Reserved.

Prerequisites
The following are the pre-requisites for implementing MLS for the
products:
Database must be configured to support UTF8.
Locale and time zone are set-up according to the language specifications

for the Web application.

A copy of the English resource files is needed.
The contents in the resource files must be localized and saved in a

language-specific folder.
The database queries and stored procedures should use the locale

settings to display results in the desired language.

4

2016 MetricStream, Inc. All Rights Reserved.

Why and When we perform MLS Certification

Apps or Modules we develop should be MLS compliant.
Because we sell our Apps/Modules across the globe.

When we perform MLS Certification?

For every release, MLS certification is a part of Non Functional
testing activity.
During the release planning, we estimate the time required for MLS
certification.
If any release is not covering MLS certification, we need to file an
exception stating why the release cannot be MLS compliant
5

2016 MetricStream, Inc. All Rights Reserved.

MLS Implementation Scope

MLS implementation scope is categorized into:
Level 1
Level 2
Level 3.

The Level 1 scope of the MLS implementation includes all the static
information such as labels, report column names, alerts and so on.
The Level 2 scope of the MLS implementation includes all the library
data such as Processes, Risks and so on.
The Level 3 scope of the MLS implementation includesDynamic
Translationof content (for certain fields) using translation tool.

2016 MetricStream, Inc. All Rights Reserved.

Level 1 Scope
Level 1 Implementation scope covers the following:
Form Loading Messages
My Task Menu
Assignment Text
MetricStream Application Home Page
Browser title bar text
User name text at the top of the home page
Links on the top right of the page: My Profile, Help, and Logout
Infocenter Names
Sub-Infocenter names
Infocenter title etc..

2016 MetricStream, Inc. All Rights Reserved.

Level 1 Scope
Tool Tips
Data Browser
Related Information
Form Details
Form Name
Header fields
Tab Names
Field names
Action field drop-down values
Report links
List of Values
Drop-down List
LOV Popup
8

2016 MetricStream, Inc. All Rights Reserved.

Level 2 Scope

Level 2 Implementation scope covers the following:

Setup Information
Sending Surveys/Checklists
Approvals
E-mails (Triggered from front end and back end)

2016 MetricStream, Inc. All Rights Reserved.

Level 3 Scope
Forms can enable the translation for few types of fields.
Translate ICON will appear next to the field which is configured in
MLS_TRANSLATE column of SI_METRIC_COLUMNS table.
Form Field Types that supports Level 3 Implementation scope are:
Text Box
Text Area
RTF
LOV (only Single LOV)

10

2016 MetricStream, Inc. All Rights Reserved.

MLS Deployment Process

The following two components that covers MLS deployment process:

Properties Files - Platform & Custom/Application properties file
which contains key value pair
Database Tables Platform & Custom/Application tables

11

2016 MetricStream, Inc. All Rights Reserved.

MLS Deployment Tool

We have a tool that converts the English content to any desired

language, which eases the translation of specific objects.

This tool is developed and maintained by Platform Team.
Tool uses the Bing Translator (freeware), to translate the data.
Depending on the configurations, tool will collect the required content

(English) from the tables or Property files.

Translate the collected content to desired language.
Imports the translated content in to DB and Property Files.
Double Byte Character Set:Languages such as Japanese and Chinese

conversion is also supported by the tool.

12

2016 MetricStream, Inc. All Rights Reserved.

Deployment Steps and Commands

STEP
STEP Export Platform Table values in an excel file
1
STEP Send the Excel file values to Bing Translator, and get the
2
translated content
STEP Import the translated content Back to DB
3
STEP Export Properties file values in an excel file
4
STEP Send the Excel file values to Bing Translator, and get the
5
translated content
STEP Import the properties file and place them in the appropriate
6
location
STEP - Repeat the same for Application tables and Property Files
7

13

2016 MetricStream, Inc. All Rights Reserved.

COMMAND
MLSTranslator.bat EXPORT DB
MLSTranslator.bat TRANSLATE
MLSTranslator.bat IMPORT DB
MLSTranslator.bat EXPORT
PROPERTIES
MLSTranslator.bat TRANSLATE
MLSTranslator.bat IMPORT
PROPERTIES

Scripts to add locale column to LOV and MLOV field

In order to make LOV/MLOV column labels as MLS complaint, each
LOV/MLOV infolet should have a number type locale-flag column enabled.
To add a column to existing active infolet it requires deactivation of
infolet by removing them from associated data forms.
If the number of Infolets are more: Need to deactivate all of them Add
locale column Attach back to multiple forms, which takes a
considerable amount of development effort.
To avoid this we have come up with a DB script which will add locale
enabled column to all LOV/MLOV infolets without deactivation or filter
data loss.

14

2016 MetricStream, Inc. All Rights Reserved.

Script to add locale column to LOV and MLOV field

How does script work:

For a given data form, first all the LOV/MLOV Infolets are fetched in

loop.
For each of these infolet, script inserts a new record into si_parameters

table to add LOGIN_ID parameter.

Also adds locale column by inserting records to SI_METRIC_COLUMNS

table, to which LOGIN_ID will be passed as infolet level parameter.

Infolet query is modified by adding the new column as mentioned in

step 3.
15

2016 MetricStream, Inc. All Rights Reserved.

After Translation
System Level Settings

After conversion, Enable language locale in the application

Enabled locale should be assigned to user.

Testing Level 1 Scope Objects

16

Check whether all the Level 1 scope field values are MLS compliant.

No need to check for Spelling and Grammar of the converted text

2016 MetricStream, Inc. All Rights Reserved.

After Translation

Different Ways of MLS Testing:

Multiple Languages : Test by having multiple languages enabled in the
same instance
Prefix and Suffix: The values which cannot be converted to MLS, we
append prefix/suffix and perform the tests.

17

Example: Non dictionary words will not be converted

2016 MetricStream, Inc. All Rights Reserved.

Known Limitations
Bing translator will allow 200K characters translations per month (free

license)
While translating the properties file, if any field value has 4000

characters, such field value will not be converted

Non dictionary words will not be converted
RTF field cannot be configured using the MLS feature
Configuration Parameters are not MLS compliant.
Scalable Repository is not MLS compliant.
All the setup data is always displayed in the language that it is initially

typed.
The form name displayed when clicked on a link always appear in the

base
locale language.
18
2016 MetricStream, Inc. All Rights Reserved.

Reference Links
http://gurukul.metricstream.com/twiki/bin/view/ECP/ECPMLSHome
http://

gurukul.metricstream.com/twiki/pub/ECP/ECPMLSHome/MLS_Deployment_T
ool.zip
http://gurukul.metricstream.com/twiki/pub/ECP/ECPMLSHome/MS_MLS_De
ployment_Tool_User_Guide-V4.pdf
http://
rndsvn/svn/Documentation/BCM/6.1.1.0.0.0/MLS/MLS%20Training/BCM
%20MLS%20Deployment%20Guide.docx
http://gurukul.metricstream.com/twiki/bin/view/Knowledge/ForumKnow
ledgeECP00255
19

2016 MetricStream, Inc. All Rights Reserved.

Q&A

20

2015 MetricStream, Inc. All Rights Reserved.