Installing Languages into ActiveVOS Central

You can configure ActiveVOS Central for a preferred language. The following instructions describe how to install one or more languages.

Step One. Download and Add the Language Archive to ActiveVOS Designer

1. Download activevos_central_lang.zip from activevos.com. This instructions file is contained within the zip file.
2. Launch ActiveVOS Designer.
3. Select File>Import>General>Existing Projects into Workspace.
4. On the Import Projects page, select the radio button for Select Archive File.
5. Select Browse to navigate to activevos_central_lang.zip, select the file and select Finish.
6. Notice that a new project is added to the workspace called com.activee.avoscentral.services.

Tip: There is no editing required for the languages provided. However, if you want to edit a property file (in the bundle folder), or help file (in the html folder), you must set the Text file encoding Property of the file to UTF-8. To do so, in your Project Explorer, right-mouse click on a file, select Properties, and set the Text file encoding. Repeat this for each file that you want to modify.

Step Two. Start the Server and Deploy the Language Archive

1. Ensure that the ActiveVOS server is running.

Note: If your server is not running at the host and port of localhost:8080, you must modify the deployment file of each language as described below. Also, if your server requires a login User Name and Password, you must add that information as well.

2. In ActiveVOS Designer, expand the com.activee.avoscentral.services project to display the deploy folder.
3. Double-click one of the *.bprd files in the deploy folder to open it in the appropriate editor. For example, double-click avoscentral_de.bprd to open the deployment file for the German language.
4. If necessary, edit the file as follows:
   • Locate the archive.deploypath property. If necessary, modify the host and port in the following URI.
   http://localhost:8080/active-bpel/services/ActiveBpelDeployBPR
   • Locate target name="deploy". If necessary, add a login user name and password as shown:
   <deploybpr type="webservice" file="${archive.filename}" username="USER_NAME" password="PASSWORD" tourl="${archive.deploypath}"/>
5. Save the *.bprd file. You are now ready to deploy the file to the server.
6. Right-mouse click the file and select Execute.
7. A deployment log appears to tell you if the deployment is successful or contains errors. You can fix errors and re-execute the *.bprd file.
8. For each language that you deploy, a Help WAR file is added to the dist folder. The next step tells you how to deploy Help.

Step Three. Deploy the ActiveVOS Central Help War

1. Refresh the dist folder by right-mouse clicking it and selecting Refresh. A WAR file is displayed.
2. Deploy this WAR file to your application server where ActiveVOS Server is running. Use the basic steps provided, and consult your application server documentation for details.
• Tomcat. Copy each WAR file from the dist folder to [Apache Tomcat installation]\webapps
• JBoss. Copy each WAR file from the dist folder to [JBoss installation]\jboss-as\server\<activevos server name>\deploy
• WebLogic. Open the WebLogic Server Administration Console, select the Deployments feature, and follow the instructions for uploading and installing the WAR.
• WebSphere. On the WebSphere Console, select Enterprise Applications and select Install. Browse to the WAR file and select it. For the Context root, type in /ActiveVOSCentralHelp_[lang] , where lang matches the language you are deploying, and select Next. Follow the prompts to complete the installation.
3. Ensure that ActiveVOS Server is started, and open ActiveVOS Central in a browser. Check with your administrator for the user name and password. To view the language, on the login page, append ?lang=fr (or other language) to the URL. For example:

http://localhost:8080/activevos-central/login.jsp?lang=fr

Viewing ActiveVOS Central in a Preferred Language

Once a language has been deployed, you can login to ActiveVOS Central to view it. You must verify that your browser's locale is set for the desired language.

In ActiveVOS Central, the following items appear in the preferred language:

• All user interface elements such as buttons, links, and tooltips
• Tasks tab and tab details
• Requests tab and tab details
• Reports tab, and preview
• Reports when open in a separate tab. All the tools and other info will appear in the preferred language. Errors, warnings and information also appear in the preferred language.
• Invoking help, which is present in the right side top corner opens help pages in the preferred language.

Note: Currently, a few items in individual tasks, such as the task name, may appear in English. If other items do not appear in the preferred language, check with your ActiveVOS administrator to ensure that all additional language configuration files are deployed. There are additional files associated with individual reports, tasks, and requests that are not included in the language package but are typically generated when the item is developed in ActiveVOS Designer. See ActiveVOS Designer Online Help for details on enabling different languages for reports, tasks and request forms.