EC5.4 FEAtures 3.3 Guide 9 Localise

Localise
Guide 9
Software Version 5.4.1-0
Document Version 3.3
Release Date 1 July 2016
Status Release
FEAtures Localise
Table of Contents
History ............................................................................................................................................................ 3
Tell Me About… ............................................................................................................................................... 4
Generate Language Map Wizard (Expandable Tool) ................................................................................................ 4
Update Language Map Wizard (Expandable Tool)..................................................................................................10
Language .................................................................................................................................................................15
Language Map Editor ..............................................................................................................................................22
Language Editor ......................................................................................................................................................26
What Can I Build? .......................................................................................................................................... 29
Home Page Localisation ..........................................................................................................................................29
Exercise 1 » Add a Language ...............................................................................................................................31
Exercise 2 » Add Mapped Text to Process Items ................................................................................................42
Exercise 3 » Add Mapped Text to Presentation Items ........................................................................................47
Exercise 4 » Add Mapped Text to Hybrid Messages ...........................................................................................49
Exercise 5 » Switch Languages with Language Editor and Live Bar.....................................................................51
Exercise 6 » Add an Error Management Phase to Manage Language Map Rule Errors .....................................56
Exercise 7 » Add a Container Rule as a Startup Rule...........................................................................................61
Exercise 8 » Select a Startup Rule .......................................................................................................................65
Exercise 9 » Add a Load Language Map Rule ......................................................................................................68
Exercise 10 » Add a Set Language Map Rule .......................................................................................................76
Dr Kevin M Potter Strategy-Dev

FEAtures Localise
History
Author Version Date Comments
Dr Kevin M Potter 1.0 7 August 2014 Initial document.
Dr Kevin M Potter 2.0 15 January 2015 New Foundation, Enterprise, Advanced Features
(FEAtures) true multi-channel learning platform.
Dr Kevin M Potter 2.3 3 July 2015 Q3 Release.
Dr Kevin M Potter 2.4 18 September 2015 Q4 EC54 New Features Release.
Dr Kevin M Potter 3.1 15 January 2016 2016 Q1 EC54 Release.
Dr Kevin M Potter 3.2 8 April 2016 2016 Q2 EC54 Release.
Dr Kevin M Potter 3.3 1 July 2016 2016 Q3 EC54 Release.

FEAtures Localise
Tell Me About…
Generate Language Map Wizard (Expandable Tool)
What you need to know
In a real edgeConnect solution, you are going to add and want to localise lots of text not only within a single Project
but rather when working with multiple Projects. Developer provides you with an Advanced Generate Language
Map wizard to help you to localise text across all Projects that comprise your solution. This is one of your Expandable
Tools. 
Figure 1 Generate Language Map Wizard (Expandable Tool).

FEAtures Localise
Essential Commands
Open Bulk Generate Language Map Wizard (Expandable Tool)

 Tools » Language Maps » Bulk Generate Language Map: Display the Bulk Generate Language Map wizard.
Figure 2 Open Bulk Generate Language Map Wizard (Expandable Tool).

FEAtures Localise
User Interface
Input / Output Screen

The Input / Output Screen allows you to specify localisation scope and the generated Language Maps save Location.
Figure 3 Input / Output Screen.
You can set the following options.

 Scope: Specify localisation scope.
 Standard (within current IDE): Generate Language Maps for the current Project only.
 Projects within a directory: Generate Language Maps for all Projects in a specified directory.
 Directory to Process: Select the directory that you want to process.
 Within open IDE(s): Generate Language Maps for all open Projects.
 Location: Specify where you would like Generated Language Map Documents to be saved to (for each
Project). The Language Map Document file names are the same as respective Project Names. Use
$$PROJECTHOME$ to generate each Language Map Document relative to each respective Project Folder.
Alternatively, generate all Language Map Documents in the specified folder.

FEAtures Localise
Details Screen
The Details Screen allows you to describe your Language.
Figure 4 Details Screen.

 Alias: A meaningful name that you use with Rules to identify your Language when it is loaded (into RAM
memory on the Web Server computer) at run-time.
 ISO Code: Select the International Standards Organisation (ISO) Language code that describes the localised
language.
 Language Map Type: Select the type of Language Map Document that you want to generate.
 Connect XML Language Map V1.0: An XML Language Map Document that you can edit using Language
Map Editor.
 Excel Spreadsheet: A Microsoft Excel Spreadsheet that you can edit using Microsoft Excel.
 XLIFF 1.2 Language Map: An XML Language Map Document that you can edit using an XLIFF Editor.

FEAtures Localise
 Source Language: Select the ISO Language code that describes the default Language.
 Presentations (blank for all): Select Presentations using the Presentation Chooser dialog if you want
localisation to apply to specific Presentations only. Leave blank if you want localisation to apply to all
Presentations.
 Auto-load on startup: Mark to automatically load your Language (into RAM memory on the Web Server
computer) at start-up.

FEAtures Localise
Comment Screen
The Comment Screen allows you to include solution specific information about your Language.
Figure 5 Comment Screen.

 Comment: Enter a comment to include solution specific information about your Language.

FEAtures Localise
Update Language Map Wizard (Expandable Tool)

In a real edgeConnect solution, you are going to add and want to localise lots of text not only within a single Project
but rather when working with multiple Projects. Developer provides you with an Advanced Update Language Map
wizard to help you to update localised text across all Projects that comprise your solution. This is one of your
Expandable Tools. 
Figure 6 Update Language Map Wizard (Expandable Tool).
10

FEAtures Localise
Essential Commands
Open Bulk Update Language Map Wizard (Expandable Tool)

 Tools » Language Maps » Bulk Update Language Map: Display the Bulk Update Language Map wizard.
Figure 7 Open Bulk Update Language Map Wizard (Expandable Tool).
11

FEAtures Localise
User Interface
Input / Output Screen

The Input / Output Screen allows you to specify localisation scope and the generated Language Maps save Location.
Figure 8 Input / Output Screen.

 Scope: Specify localisation scope.
 Standard (within current IDE): Update Language Maps for the current Project only.
 Projects within a directory: Update Language Maps in all Projects in a specified directory.
 Directory to Process: Select the directory that you want to process.
 Within open IDE(s): Update Language Maps for all open Projects.
 Location: Specify where you would like Generated Language Map Documents to be saved to (for each
Project). The Language Map Document file names are the same as respective Project Names. Use
$$PROJECTHOME$ to generate each Language Map Document relative to each respective Project Folder.
Alternatively, generate all Language Map Documents in the specified folder.
12

FEAtures Localise
Details Screen
The Details Screen allows you to describe your Language.
Figure 9 Details Screen.

 Language Map Type: Select the type of Language Map Document that you want to update.
Map Editor.
Presentations.
13

FEAtures Localise
Comment Screen
The Comment Screen allows you to include solution specific information about your Language.
Figure 10 Comment Screen.

 Comment: Enter a comment to include solution specific information about your Language.
14

FEAtures Localise
Language
A Language allows you to localise your solution. Each Language is bound to a Language Map Document; a Generated
Document that initially contains all default solution text. You edit a Language Map Document to add locale specific
text.
 Connect XML Language Map: An XML Language Map Document that you can edit using Language Map
Editor.
 Excel Spreadsheet Language Map: A Microsoft Excel Spreadsheet that you can edit using Microsoft Excel.
 XLIFF Language Map: An XML Language Map Document that you can edit using an XLIFF Editor.
A Language has a Source ISO Language Code and a Locale Specific ISO Language Code.
A Language can apply to all solution Presentations or to one or more specific Presentations. This allows you to
selectively localise parts of your solution.
You can mark a checkbox to automatically load a Language (into RAM memory on the Web Server computer) at
solution startup. Alternatively, you can build a Load Language Map Rule to load a Language (into RAM memory on
the Web Server computer) at any time.
Figure 11 Language.
Best It is best practice to use meaningful Customer and/or Project Specific Language names.
Practice

15

FEAtures Localise
Essential Commands
Manage Language
Language Editor allows you to manage Languages.
Right-click Languages root node.
 Add Language: Display the Add Language dialog. Add a new Language.
 Import from Language Map: Display the Add Language dialog. Add a new Language by importing information
from an existing Language Map Document.
 Update all Language Maps: Run utility to ensure that all Language Maps are up to date.
Right-click Language.
 Copy: Copy an existing Language.
 Paste: Paste an existing Language.
 Move Up: Move a Language above the previous Language.
 Move Down: Move a Language below the next Language.
 Properties: Display the Language Properties dialog. The dialog allows you to edit the Language.
 Update Language Map: Run utility to ensure that the Language Map is up to date.
Figure 12 Manage Language.
16

FEAtures Localise
User Interface
Add Language Dialog and Language Properties Dialog

The Add Language dialog and Language Properties dialog are identical. The Add Language dialog allows you to add
a new Language. The Language Properties dialog allows you to edit an existing Language.
Details Tab
The Details tab allows you to describe your Language.
Figure 13 Language dialog » Details tab.

 ISO Code: Select the ISO Language code that describes the localised Language.
Map Editor.
17

FEAtures Localise
 Language Map File: Select the full path and file name for the Language Map Document.
 Source Language: Select the ISO Language code that describes the default Language.
Presentations.
18

FEAtures Localise
Comment Tab
The Comment Tab allows you to include solution specific information about this Language.
Figure 14 Language dialog » Comment tab.

 Comment: Enter a comment to include solution specific information about this Language.
19

FEAtures Localise
(Import) Add Language Dialog

The (Import) Add Language dialog allows you to add a new Language by importing information from an existing
Language Map Document.
Details Tab
The Details tab allows you to describe your Language.
Figure 15 (Import) Add Language dialog » Details tab.

Map Editor.
 Language Map File: Select the full path and file name for the Language Map Document.
20

FEAtures Localise
21

FEAtures Localise
Language Map Editor

Language Map Editor allows you to load an XML Language Map Document and localise all text. An XML Language
Map Document contains solution text that originates in Process Items, Presentation Items, Design Items, Lists and
Hybrid Messages.
Figure 16 Language Map Editor.
Best It is best practice to use meaningful Customer and/or Project Specific XML Language Map Document
Practice file names.
22

FEAtures Localise
File and Folder Best Practice

Language Map Documents are stored in your Projects Home folder.
Figure 17 Best practice localisation folder.
Figure 18 Localisation folder.
Best It is best practice to place all Language Map files that belong to your solution into a sub-folder within
Practice your Project folder. 
 <Project Home>/Localisation/<Your Language Map Files>
23

FEAtures Localise
Essential Commands
Start Language Map Editor
Click a shortcut to the Language Map Editor EXE file to open Language Map Editor.
Figure 19 Start Language Map Editor.
24

FEAtures Localise
User Interface
Language Map Editor User Interface

Language Map Editor is an Integrated Development Environment (IDE) that provides you with all of the tools that
you need to localise your solution.
 The left-hand-side view provides you with access to solution text that originates in Process Items,
Presentation Items, Design Items, Lists and Hybrid Messages.
 The right-hand-side view allows you to provide Mapping Values; alternative and equivalent text in a target
language.
Figure 20 Language Map Editor User Interface.
25

FEAtures Localise
Language Editor
Language Editor allows you to add one or more Languages to localise your solution. Each Language is bound to a
Language Map Document; a Generated Document that initially contains all default solution text. You edit a
Language Map Document to add locale specific text.
 Connect XML Language Map: An XML Language Map Document that you can edit using Language Map
Editor.
 Excel Spreadsheet Language Map: A Microsoft Excel Spreadsheet that you can edit using Microsoft Excel.
 XLIFF Language Map: An XML Language Map Document that you can edit using an XLIFF Editor.
Figure 21 Language Editor.
Information XLIFF (XML Localisation Interchange File Format) is an XML-based format created to standardize the
way localizable data are passed between tools during a localization process. XLIFF was standardized
by OASIS in 2002.
Best It is best practice to use meaningful Customer and/or Project Specific Language and Language Map
Practice Document names.

26

FEAtures Localise
Essential Commands
Open Language Editor

Select Window menu » Language Editor to open the Language Editor.
Figure 22 Open Language Editor.
27

FEAtures Localise
User Interface
Language Editor
Language Editor allows you to add one or more Languages to localise your solution.
28

FEAtures Localise
What Can I Build?

Home Page Localisation
The Exercises in this Chapter show you how to build Home Page solution localisation.
 Language Editor: You are going to add a “French” Language to Language Editor.
 Language Map: Language Editor allows you to build a Language Map; a Document that contains all solution
text. Solution text originates in Process Items, Presentation Items, Design Items, Lists and Hybrid Messages.
 Language Map Editor: You are going to use Language Map Editor to add alternative solution text in French
to an XML Language Map Document.
 Load Language Map Rule: You are going to add a Load Language Map Rule to load the contents of the
Language Map Document into RAM memory on the Web Server at run-time.
 Set Language Map Rules: You are going to add Set Language Map Rules to the “English” and “French” Action
Buttons in the solution Header to allow you to swap between English and French at run-time.
Figure 24 Sketch a Design » Home Page Localisation.
29

FEAtures Localise
User Interface
The Header English and French Buttons are bound to Set Language Map Rules.
Figure 25 Home Page Localisation.
30

FEAtures Localise
Exercise 1 » Add a Language

Step-By-Step
The following steps show you how to use Language Editor to add a new Language.
1. Start Developer.
2. Select Window menu » Language Editor.
31

FEAtures Localise
3. Right-click Languages root node » Add Language.

4. Enter Alias.
FEAturesFrenchLanguage
5. Select ISO Code. (Items in this list are NOT in alphabetical order.)
French, France (fr-FR)
6. Select Language Map Type.
Connect XML Language Map V1.0
7. Click Language Map File Select button.
Figure 27 Add Language dialog » Details tab.
32

FEAtures Localise
The next few steps will help you to create a best practice Localisation folder and help you to name your Language
Map file.
Figure 28 Best practice localisation folder.
Best It is best practice to place all Language Map files that belong to your solution into a sub-folder within
Practice your Project folder. 
 <Project Home>/Localisation/<Your Language Map Files>
33

FEAtures Localise
The Select language map file dialog is displayed.

8. Navigate to FEAtures Project Home folder.
C:\ECProject\Projects\FEAturesHybridSolution
9. Click Create New Folder button.
10. Enter Folder Name.
FEAturesLocalisation
Figure 29 Create FEAturesLocalisation folder.
Best It is best practice to create your own Folders within the Project Folder to manage custom Files that
Practice are going to be part of your solution.
 It’s simply good housekeeping! 
34

FEAtures Localise
11. Navigate into FEAturesLocalisation Folder.

12. Enter File name.
FEAturesFrenchLanguageMap.xml
Figure 30 Name Language Map Document.
13. Click Select to close the Select language map file dialog.
35

FEAtures Localise
The Add Language dialog is displayed.

14. Confirm that Language Map File property is correctly set.
$$PROJECTHOME$/FEAturesLocalisation/FEAturesFrenchLanguageMap.xml
15. Select Source Language. (Items in this list are NOT in alphabetical order.)
English, United Kingdom (en-GB)
16. Click Presentations (blank for all) Select button.
36

FEAtures Localise
The Presentation Chooser dialog is displayed.

17. Select Presentation.
FEAturesPresentation (using Theme: FEAturesTheme)
Figure 32 Presentation Chooser dialog.
18. Click OK to close the Presentation Chooser dialog.
37

FEAtures Localise
The Add Language dialog is displayed.

19. Confirm that Presentations (blank for all) property is correctly set.
FEAturesPresentation
38

FEAtures Localise
20. Select Comment tab.

21. Enter Comment.
A single Project, single Presentation Language that allows localisation between English (default) and French.
Figure 34 Add Language dialog » Comment tab.
22. Click OK.
39

FEAtures Localise
A Warning dialog may be displayed.
Figure 35 Warning dialog.
23. Click Yes.

The Success dialog is displayed.
Figure 36 Success dialog.
24. Click OK.
40

FEAtures Localise
The FEAturesFrenchLanguage [fr-FR] Language is added to the Language Editor tree-structure.
25. Select File menu » Save.

Let’s confirm that the XML Language Map Document was also created.
26. Open Windows Explorer.
27. Navigate to your Project Localisation Folder.
C:\ECProject\Projects\FEAturesHybridSolution\FEAturesLocalisation
28. Confirm that the Localisation Folder contains your new XML Language Map Document.
Figure 38 Windows Explorer » FEAtures Localisation Folder containing an XML Language Map Document.
29. Close Windows Explorer.
41

FEAtures Localise
Exercise 2 » Add Mapped Text to Process Items

Step-By-Step
The following steps show you how to use Language Map Editor to open an XML Language Map Document and how
to add localised text to Process Items.
1. Start Language Map Editor.
Figure 39 Language Map Editor.
42

FEAtures Localise
2. Select File menu » Open.

3. Navigate to Localisation Folder.
4. Select XML Language Map Document.
Figure 40 Open dialog.
5. Click Open to close the Open dialog.
43

FEAtures Localise
Language Map Editor displays the contents of the XML Language Map Document.
Figure 41 Language Map Editor » FEAturesFrenchLanguageMap.xml.
44

FEAtures Localise
6. Expand Language Map root node.

7. Expand Process Items node.
8. Expand Home Page Process.
9. Expand Home Page Phase.
10. Select Device Heading.
11. Enter Mapped Display Text.
Portable
Figure 42 Process Items.
45

FEAtures Localise
Now You Try

Use Language Map Editor to add the following Mapped Text to Process Items.
Mapped Text
Phase Item Original Text Mapped Text (Field)
Find Out More Find Out More Savoir plus Button Text
Application Form Application Form Forme Display Text
Login Login Login Display Text
Table Table Liste Display Text
Chart Chart Chart Display Text
Table 1 Mapped Text.
46

FEAtures Localise
Exercise 3 » Add Mapped Text to Presentation Items

Step-By-Step
The following steps show you how to use Language Map Editor to add French localised text to Presentation Items.
2. Expand Presentation Items.
3. Expand FEAturesPresentation.
4. Expand Home Page Process.
5. Expand Home Page Phase.
6. Expand Device Topic [Column].
7. Expand Text [Section].
8. Select Text Display Item.
9. Enter Mapped Text.
Construire une solution de portable qui vous montre comment obtenir des informations de portable et
comment utiliser ces informations pour modifier dynamiquement le look-and-feel de votre solution.
Figure 43 Presentation Items.
47

FEAtures Localise
Now You Try

Use Language Map Editor to add the following Mapped Text to Presentation Items.
Mapped Text
Presentation Item Original Text Mapped Text
(Application Form) Build a data entry solution that shows you Construire une solution de saisie de
Text how to format data and make decisions. données qui vous montre comment mettre
Integrate the solution with an external en forme des données et prendre des
data source. décisions. Localiser l'solution et l'intégrer
avec une source de données externe.
(Login Topic) Text Build a solution as a reusable Component. Construire une solution comme un
Format the solution using Live composant réutilisable. Formater la solution
Presentation. en utilisant Live Présentation.
(Table Topic) Text Build a solution that shows you how to use Construire une solution qui vous montre
different types of Table to display data. comment utiliser différents types de tableau
pour afficher les données.
(Chart Topic) Text Build a solution that shows you how to use Construire une solution qui vous montre
different types of Chart to display data. comment utiliser différents types de
graphique pour afficher les données.
48

FEAtures Localise
Exercise 4 » Add Mapped Text to Hybrid Messages

Step-By-Step
The following steps show you how to use Language Map Editor to add French localised text to Hybrid Messages.
2. Expand Hybrid Messages node.
3. Select ok Hybrid Message.
4. Enter Mapped Text.
Dáccord
Figure 44 Hybrid Messages.
49

FEAtures Localise
Now You Try

Use Language Map Editor to add the following Mapped Text to Presentation Items.
Mapped Text
Hybrid Message Original Text Mapped Text
not_now Not Now Pas maintenant
user_settings Settings Paramètres de l'utilisateur
check_updates Check for updates Vérifiez les mises à jour
developer_settings Developer Settings Paramètres de développeur

We’re finished with Language Map Editor (for now) so do please Save and Close Language Map Editor. 
50

FEAtures Localise
Exercise 5 » Switch Languages with Language Editor and Live Bar

Step-By-Step
Language Editor allows a Language to be loaded into RAM memory on the Web Server computer at solution startup.
Live Bar allows you to dynamically switch Languages at run-time.
The following steps show you how to use Language Editor and Live Bar to set and switch your Languages at run-
time.
1. Select Developer.
2. Select Language Editor.
3. Right-click FEAturesFrenchLanguage » Properties.
4. Mark Auto-load on startup.
Figure 45 Language Properties dialog » Details tab.
5. Click OK.
51

FEAtures Localise
7. Mark Toolbar » Run Options » Run With Presentation Switcher.
Figure 46 Toolbar » Run Options » Run With Presentation Switcher.
8. Select Window menu » Presentation Editor.

9. Expand FEAturesPresentation.
10. Right-click Home Page Process » Run with Options: Presentation Switcher.
11. Hover over the Open Live Bar (˅) button.
Figure 47 Open Live Bar (˅) button.
Live Bar is displayed.

12. Click the Pin button.
Figure 48 Live Bar.
52

FEAtures Localise
13. Click the VIEW button to show Live Bar Switcher options.
Figure 49 Live Bar.
14. Select Language.

Figure 50 FEAturesFrenchLanguage.
53

FEAtures Localise
15. Select Language.

default
Figure 51 Default language.
16. Close browser.
54

FEAtures Localise
17. Select Language Editor.

18. Right-click FEAturesFrenchLanguage » Properties.
19. Unmark Auto-load on startup.
Figure 52 Language Properties dialog » Details tab.
20. Click OK.

55

FEAtures Localise
Exercise 6 » Add an Error Management Phase to Manage Language Map Rule Errors
Step-By»-Step
Errors can occur when using the Load Language Map Rule and the Set Language Map Rule. For example, if you
misspell the name of the required XML Language Map Document an error is thrown. The Rules allow you to specify
the name of a Phase to jump to when an error occurs.
The following steps show you how use Process Editor to add a new Phase to the Error Management Process to
manage Language Map Rule Errors.
1. Select Window menu » Process Editor.
2. Expand Error Management Process.
3. Right-click General Error Phase » Copy.
4. Right-click Error Management Process » Paste.
5. Expand General Error – Copy Phase.
Figure 53 Copy and Paste General Error Phase.
56

FEAtures Localise
6. Right-click General Error – Copy Phase » Properties.

7. Enter a new Phase Name.
Language Map Rule Error
Figure 54 Phase Properties dialog » Properties tab.
8. Click OK.
57

FEAtures Localise
9. Right-click Language Map Rule Error Phase FEAtures Info Note » Properties.
10. Enter new Note text.
A Language Map Rule Error occurs when an XML Language Map Document cannot be found and when an
Alias is misspelt.
Figure 55 Note Properties dialog.
11. Click OK.
58

FEAtures Localise
12. Right-click Language Map Rule Error Phase Heading 2 Really sorry but… » Properties.
13. Enter new Display Text.
Really sorry but your web page could not be localised. Please try again...
Figure 56 Heading Properties dialog.
14. Click OK.
59

FEAtures Localise
The new Language Map Rule Error Phase is now ready for use. 
Figure 57 New Error Management Phase for use with Language Map Rules.
60

FEAtures Localise
Exercise 7 » Add a Container Rule as a Startup Rule

Step-By-Step
edgeConnect allows you to run Rules when your solution starts. You add Startup Rules to Rule Editor and select the
Rules as Startup Rules on the Startup tab of the Project Properties dialog.
You are likely to want to run several Rules when your solution starts. To make it easier for you to correctly select
the Startup Rules that you need within the Project Properties dialog it is best practice to add all of your functional
Rules to a Container Rule. A Container Rule is essentially just a grouping mechanism.
Figure 58 It is best practice to use a Container Rule to manage Rules that you want to run when your solution starts.
Best To make it easier for you to correctly select the Startup Rules that you need within the Project
Practice Properties dialog it is best practice to add all of your functional Rules to a Container Rule. A
Container Rule is essentially just a grouping mechanism.

We’ll create the Container Rule; then we’ll add a Load Language Map Rule to the Container Rule as we want to Load
our Language Map into RAM memory when the FEAtures solution starts. Our solution will know that the Container
Rule is going to be used as a Startup Rule because we’ll update the Project Properties dialog Startup Rules property.
61

FEAtures Localise
So to begin!  The following steps show you how to use the Rule Editor to add a new Container Rule.
1. Select Window menu » Rules Editor.
Figure 59 Rule Editor.
62

FEAtures Localise
2. Right-click Rules root node » Add Rule.

3. Enter Rule Name.
FEAtures Startup Rules
4. Select Rule Type.
Evaluation
5. Select Rule Class.
Container Rule
Figure 60 Add Container Rule dialog » Definition tab.
63

FEAtures Localise
6. Select Details Tab.

7. Enter Comment.
Container Rule to group together functional Rules that are run at solution start-up.
Figure 61 Add Container Rule dialog » Details tab.
8. Click OK.
The Container Rule is added to the Rule Editor tree-structure.
Figure 62 Rule Editor » FEAtures Startup Rules Container Rule.
64

FEAtures Localise
Exercise 8 » Select a Startup Rule

Step-By-Step
The following steps show you how to use the Project Properties dialog to select a Rule that you want to run when
your solution starts.
1. Select Project menu » Properties.
2. Select Startup tab.
3. Click Startup Rules Select Button.
Figure 63 Project Properties dialog » Startup tab.
65

FEAtures Localise
The Rule Chooser dialog is displayed.

4. Select a Rule.
Figure 64 Rule Chooser dialog.
5. Click OK to close the Rule Chooser dialog.
66

FEAtures Localise
The Project Properties dialog is displayed.

6. Confirm that the Startup Rules property is correctly set.
Figure 65 Project Properties dialog » Startup tab.
7. Click OK.
67

FEAtures Localise
Exercise 9 » Add a Load Language Map Rule

Step-By-Step
The following steps show you how to use Rule Editor to add a Load Language Map Rule to the FEAtures Startup
Rules Container Rule.
1. Select Rule Editor.
2. Right-click FEAtures Startup Rules Container Rule » Add » True Rule.
3. Enter Rule Name.
Load FEAturesFrenchLanguageMap
Load Language Map Rule
Figure 66 Load Language Map Rule dialog » Definition tab.
68

FEAtures Localise
5. Select Error Handling tab.

6. Click Specific Error Phase Select Button.
Figure 67 Load Language Map Rule dialog » Error Handling tab.
69

FEAtures Localise
The Error Phase Chooser dialog is displayed.

8. Select an Error Phase.
Figure 68 Error Phase Chooser dialog.
9. Click OK to close the Error Phase Chooser dialog.
70

FEAtures Localise
The Load Language Map Rule dialog is displayed.

10. Confirm that the Specific Error Phase property is correctly set.
Error Management.Language Map Rule Error
Figure 69 Load Language Map Rule dialog » Error Handling tab.
71

FEAtures Localise
11. Select Details tab.

12. Click Language Map File Select button.
Figure 70 Load Language Map Rule dialog » Details tab.
72

FEAtures Localise
The Language Map File Chooser dialog is displayed.

13. Navigate to the Localisation Folder.
14. Select XML Language Map Document.
Figure 71 Language Map File Chooser dialog.
15. Click Select to close the Language Map File Chooser dialog.
73

FEAtures Localise
The Load Language Map Rule dialog is displayed.

16. Confirm that the Language Map File name and path are correctly set.
$$PROJECTHOME$/FEAturesLocalisation/FEAturesFrenchLanguageMap.xml
17. Enter Language Map Alias.
Figure 72 Load Language Map Rule dialog » Details tab.
18. Click OK.

A Warning dialog is displayed.
Figure 73 Warning dialog.
19. Click OK.
74

FEAtures Localise
The Load Language Map Rule is added (as a True Rule) to the FEAtures Startup Rules Container Rule.
Figure 74 Rule Editor » Load Language Map Rule.
75

FEAtures Localise
Exercise 10 » Add a Set Language Map Rule

Step-By-Step
The following steps show you how to build a Set Language Map Rule to display mapped Language Map text at run-
time.
1. Select Process Editor.
2. Expand Header and Footer Process.
3. Expand Header Item Group.
4. Right-click French Action Button » Add » Button Rule » Other.
5. Enter Rule Name.
Set Language To French
Set Language Map Rule
Figure 75 Set Language Map Rule dialog » Definition tab.
76

FEAtures Localise
7. Select Error Handling tab.

8. Click Specific Error Phase Select Button.
Figure 76 Set Language Map Rule dialog » Error Handling tab.
77

FEAtures Localise
The Error Phase Chooser dialog is displayed.

10. Select an Error Phase.
Figure 77 Error Phase Chooser dialog.
11. Click OK to close the Error Phase Chooser dialog.
78

FEAtures Localise
The Set Language Map Rule dialog is displayed.

12. Confirm that the Specific Error Phase property is correctly set.
Error Management.Language Map Rule Error
Figure 78 Set Language Map Rule dialog » Error Handling tab.
79

FEAtures Localise
13. Select Details Tab.

14. Enter Language Map Alias.
Figure 79 Set Language Map Rule dialog » Details tab.
15. Click OK.
80

FEAtures Localise
The Set Language Map Rule is added to the French Action Button.
Figure 80 Set Language Map Rule added to an Action Button.
81

FEAtures Localise
Test Functionality Test

Run the Home Page Process and confirm that you can now localise the Home Page web page (or
Phase).
1. Select Process Editor.
2. Right-click Home Page Process » Run.
3. Click French button.
4. Confirm that web page (or Phase) text is localised into French.
5. Close browser.
Figure 81 Home Page Process localisation.
82

FEAtures Localise
Now You Try

Use the Process Editor to add a Set Language Map Rule to the Header and Footer Process English Action Button.
Set Language Map

Rule
Add To Item Rule Name Specific Error Phase Details Tab » Action Property
English Action Button Reset Language To English Language Map Rule Error Reset the language map
Table 4 Set Language Map Rule.
The English Action Button now has a Set Language Map Rule.
Figure 82 Set Language Map Rule added to an Action Button.
83

FEAtures Localise
Test Functionality Test

Run the Home Page Process and confirm English and French Action Button localisation functionality.
 Click the French Action Button to display the Home Page web page in French.
 Click the English Action Button to display the Home Page web page in English.
Figure 83 Home Page Process localisation » French.
84

FEAtures Localise
Figure 84 Home Page Process localisation » English.
Brilliant, you’ve finished all of the exercises in this chapter. Go back to the Introduction Guide and build something else! 
85

EC5.4 FEAtures 3.3 Guide 9 Localise

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

EC5.4 FEAtures 3.3 Guide 9 Localise

Enviado por

Direitos autorais:

Formatos disponíveis

Localise

Document Version 3.3

Release Date 1 July 2016

Dr Kevin M Potter Strategy-Dev

Dr Kevin M Potter 1.0 7 August 2014 Initial document.

Dr Kevin M Potter 2.3 3 July 2015 Q3 Release.

Dr Kevin M Potter 2.4 18 September 2015 Q4 EC54 New Features Release.

Dr Kevin M Potter 3.1 15 January 2016 2016 Q1 EC54 Release.

Dr Kevin M Potter 3.2 8 April 2016 2016 Q2 EC54 Release.

Dr Kevin M Potter 3.3 1 July 2016 2016 Q3 EC54 Release.

Dr Kevin M Potter Strategy-Dev

Figure 1 Generate Language Map Wizard (Expandable Tool).

Dr Kevin M Potter Strategy-Dev

Open Bulk Generate Language Map Wizard (Expandable Tool)

Figure 2 Open Bulk Generate Language Map Wizard (Expandable Tool).

Dr Kevin M Potter Strategy-Dev

Input / Output Screen

Figure 3 Input / Output Screen.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Figure 4 Details Screen.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Dr Kevin M Potter Strategy-Dev

Figure 5 Comment Screen.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Update Language Map Wizard (Expandable Tool)

Figure 6 Update Language Map Wizard (Expandable Tool).

Dr Kevin M Potter Strategy-Dev

Open Bulk Update Language Map Wizard (Expandable Tool)

Figure 7 Open Bulk Update Language Map Wizard (Expandable Tool).

Dr Kevin M Potter Strategy-Dev

Input / Output Screen

Figure 8 Input / Output Screen.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Figure 9 Details Screen.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Figure 10 Comment Screen.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Dr Kevin M Potter Strategy-Dev

Figure 12 Manage Language.

Dr Kevin M Potter Strategy-Dev

Add Language Dialog and Language Properties Dialog

Figure 13 Language dialog » Details tab.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Dr Kevin M Potter Strategy-Dev

Figure 14 Language dialog » Comment tab.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

(Import) Add Language Dialog

Figure 15 (Import) Add Language dialog » Details tab.

You can set the following options.

Dr Kevin M Potter Strategy-Dev

Dr Kevin M Potter Strategy-Dev

Language Map Editor

Figure 16 Language Map Editor.

Dr Kevin M Potter Strategy-Dev

File and Folder Best Practice

Figure 17 Best practice localisation folder.