Internationalization Sample Project

Use a simple HR hiring process to learn about the internationalization features available in AquaLogic BPM.

A. Required Software

Install AquaLogic BPM Studio 5.7 in order to use the sample project:

B. Open Sample Project

  1. Launch AquaLogic BPM Studio.
  2. Select File | Open | Project.
  3. On the Open Project dialog box, navigate to the HROnboarding sample project. If the default locations were accepted during installation, this sample project will be located under C:\bea\albpm5.7\studio\samples\Tutorial_Introduction.
  4. Click Open.

C. Localize

AquaLogic BPM Studio 5.7 allows process developers to localize four project designe components: processes, activities within processes, BPM Objects, and variables.

  1. Studio inlcudes support for nine languages that can be used to localize activities, processes, objects, and variables for display to end users. To view which of the nine languages are available to localize these process design components, select File | Project Preferences | Languages.
  2. The HROnboarding sample already has the English, French, and Japanese languages available. To make another language available, click Add. Then, on the Add Language dialog box, select a language and click OK.
  3. To change the language used to display activities and processes in the design and development Project pane, on the File | Project Preferences | Languages dialog box, choose a language from the Current Language drop-down list. This selection localizes only the display seen by the Studio user and has no impact on processes and activities that will be seen by end users of deployed projects.
  4. Once languages have been made available for process design and development as described in Step 2, individual activities and processes can be localized for end users of deployed projects. To localize an activity or process label that will be seen by end users during process execution, left-click the activity or process and select Properties. Then click the Localize icon. On the Localize Label dialog box, enter the translated label text that should be used for each available language in the Message field. English, French, and Japanese are already complete in this sample project. To add additional languages, use File | Project Preferences | Languages | Add and then return to the Localize Label dialog box.
  5. To localize busines variables and external variables, on the Variables pane, to the far right of the variable name, click the ... symbol. Then click the Localize icon. On the Localize Label dialog box, enter the translated label text that should be used for each available language in the Message field. English, French, and Japanese are already complete in this sample project. To add additional languages, use File | Project Preferences | Languages | Add and then return to the Localize Label dialog box.
  6. To localize a BPM Object presentation, open the presentation by double-clicking on it. Then click the Localize icon. On the BPM Object Localization dialog box, enter the translated label text that should be used for each available language in the appropriate column. There are two object presentations in this sample project: JobEntry and JobEntry1. English, French, and Japanese are already complete in this sample project. To add additional languages, use File | Project Preferences | Languages | Add and then return to the BPM Object Localization dialog box.

D. Test Localization

To test the localization configured in the HROnboarding process, publish and deploy the process to view the WorkSpace as an end user.

  1. Click Run | Start Engine.
  2. Click Run | Publish and Deploy.
  3. Click Launch WorkSpace.
  4. On the WorkSpace start page, in the Username field, enter test.
  5. Click Login.
  6. In the top-right corner of the WorkSpace, select Options.
  7. On the Options dialog box, under Display Options, in the Language drop-down list, choose one of the languages used in the HROnboarding sample project.
  8. Click Save. The Options Dialog box will refresh and display in the selected language. Close the dialog box.

The object presentations, variables, processes, and activities customized in the localization steps above will display in the selected language as the test user works with the applications and activities in the hiring process.