I am working on a process that needs to be implemented in an invironment where the users do not understand English. How can I change the language in the entire Workspace from English to another language. I guess there is no translation to Danish (which is the language I need), however in that case how can I make the translation myself?
I am also struggling to make sense of this documentation.
The documentation from page 32-34 guides me to create a new project putting the 3 properties files into "es/" directory. Then, when it comes to compilation, it has a list of things like "SharedResources", collections, controls, core, etc... that I have no idea where they are from.
Secondly, it states an assumption where the compilation command should work:
alc_wks_client_ui SharedResources collections controls core data effects
formatters logging messaging rpc skins states styles utils validators --
It says, "The following command assumes that you installed Flex Builder in the default location and copied the files from the LiveCycle ES SDK folder to the \WSCustomization\SWCS folder on your computer:", what are the files from LiveCycle ES SDK folder should we be copying? and what is the folder \WSCustomization\SWCS as it has not been mentioned so far on this section prior to this?
My last question, I gave it a go to run the command with only few parameters that I understand:
That documentation requires some clean-up i believe.
For step 7, it should read "From the folder where you extracted the Workspace ES source code as a reference, copy the following files from the wsSource\Workspace\src folder
to the folder you created in step 5 to store the properties files:..."
The 3 properties are copied from the source code that you copy from where you unzipped the Workspace source code that comes from installing LiveCycle ES. (Please refer to page 16 for retrieving the Workspace source and upzipping it. - it suggests to unzip source to a folder called wsSource - as an example).
The SharedResources, collections, etc. are property files that are specified in the -source-path C:/program files/adobe/flex builder 2/flex sdk 2/frameworks/locale/[locale]. For example [locale] can be "en_US" or "es".
After you copy the 3 property files from the Workspace source to the "es" folder in your project, the compile error should disappear.
I'll see if I can put together more concise instructions based on your response to the following questions:
- Are you using Flex Builder 2 or Flex Builder 3?
- Which version of LiveCycle are you using? For example, LiveCycle ES (8.0.1)?
- What version of patching are you using (SP1, SP2) - the folder structure for setting up your development environment differs from what I remember because of changes to the LiveCycle_SDK_ES folder that is found in the folder that LiveCycle server is installed.
- What language are you localizing to? I'll make the steps more specific to your case.
Hope that at least helps initially. When I get a response back from you, I'll start putting those steps together so it might take me a day or two to get back.
The ES version that I am running is ES 8.01 SP1b. And intent to move on to SP2.
I am not actually localize to another language, but I have customized the workspace to have extra UI stuffs that needs labeling, and I have added new strings to the property files. When I build my customized workspace, it can resolves the labelling constants against the property file, however, when I include the locale directory in the web app, it gives me error on those new labelling constants that couldn't be found in the property file, because the swf file in the locale folder is based on the original property file.
That is why I need to rebuild the local swf file for en to have those extra property strings added by me.
Regarding your other response, I have tried running the command using
The rest of steps....<br /><br />14. Navigate to the META-INF folder and open the application.xml file in a text editor. <br /> Edit the application.xml file to give a context root for accessing your version of <br /> Workspace ES, a new web URI that specifies the name of the new WAR file, and a new display name:<br /> <display-name>Localized Workspace</display-name><br /> <web-uri>my-localizedworkspace-client.war</web-uri><br /> <context-root>localizedworkspace</context-root><br /><br />15. Create a folder named to store extracted contents from the WAR file, such as C:\WarBuild, <br /> and copy the adobe-workspace-client.war file to this folder.<br /><br />16. In the command prompt, navigate to the folder you created in step 15 and extract the contents of the WAR file by using an archiving utility. You can also use the jar command to extract the<br /> contents of the EAR file. For example, in the command prompt, navigate to the WarBuild folder and<br /> type "jar -xvf adobe-workspace-client.war". <br /><br />17. Delete the adobe-workspace-client.war file from the folder you created in step 15. <br /><br />18. In Windows Explorer, navigate to the locale folder <br /> (You will see other workspace_rb_[locale].swf files.) and copy the newly created <br /> workspace_rb_[locale].swf from step 9 to the locale folder.<br /><br /> NOTE: If you are localizing to another language, navigate back to the root of the WAR file <br /> contents and in a text editor, create a copy of one of the<br /> alc_wks_client_html_[locale].properties files, where [locale] represents the locale, and<br /> modify the strings to match the localization customization you are performing. <br /> Rename the file with the appropriate locale setting.<br /> <br /> For example, for the Spanish locale, you can copy the alc_wks_client_html_en.properties<br /> file, rename it to alc_wks_client_html_es.properties, type Spanish translations for the values of browser.document.title and no.flash.player, and then save the file.<br /><br />20. Repackage the WAR and EAR files by using an archiving tool or the jar command by performing <br /> the following tasks:<br /><br /> * Create the new WAR file with the value you specified for <web-uri> tag in step 14. <br /> For example, navigate to the folder where you extracted the WAR file to in step 16, and <br /> type "jar -cvf my-localizedworkspace-client.war META-INF\MANIFEST.MF *".<br /><br /> * Move the newly created WAR file to the folder you created in step 11. Delete the original<br /> adobe-workspace-client.war file. You should only have the a META-INF folder and the new WAR<br /> file you created from the previous step.<br /><br /> * Create a new EAR file by using the original manifest file, the modified application.xml <br /> file, and the new WAR file. For example, navigate to the folder that contains the <br /> META-INF folder and the new WAR file you created, and type "jar -cvfm my-localizedworkspace-client.ear META-INF\MANIFEST.MF META-INF\application.xml <br /> my-localizedworkspace-client.war".<br /><br /> * Deploy the EAR file you created. For example, copy my-localizedworkspace-client.ear to <br /><br />21. Deploy the new EAR file you created in step 20 to the application server. <br /> By deploying your EAR file to the Application server, it will deploy to the web server <br /> connected to your application server.<br /> <br /> For example, in a JBoss turnkey installation,copy mmy-localizedworkspace-client.ear file <br /> to the[installdir]\jboss\server\all\deploy folder, where [installdir] represents the<br /> installation folder.<br /><br />22. You can access you new version of Workspace by accessing the context root that you specified<br /> step 14. For example, in a browser, type "http://[name of server]:8080/localizedworkspace".<br /> If you want to test the locale, you must modify the settings in your browser first. For example,<br /> in FireFox, perform these steps before accessing the URL. (These step are for international <br /> Spanish):<br /><br /> * Start FireFox and select Tools > Options.<br /><br /> * In the Options dialog box, click Advanced.<br /><br /> * On the General tab, click Choose.<br /><br /> * In the Languages dialog box, in the Select a language to add list, select the language <br /> that corresponds to the new localized SWF file and click Add. For example, if you <br /> created a localization file for international Spanish, you would select Spanish [es].<br /> <br /> * In the Languages In Order Of Preference area, click Move Up or Move Down to the <br /> location of your preference, and then click OK.<br /> <br /> * In the Options dialog box, click OK.<br /><br /> * Restart FireFox and start Workspace ES. Navigate to the Workspace ES screens that you <br /> changed in the new localized SWF file and verify your changes.
You might want to try the instructions that were sent earlier to localize most of the Workspace client. I believe there are more instructions for customizing the queueSharing.lca that works with the Workspace client and also some strings you may need to customize. The differences are the following:
- In your Flex SDK, create a copy of the en_US folder and then translate the strings in each .properties file in addition to the .properties files found in Workspace.
- you may need to find a localized version of the fds.swc and fds_rb.swc file.
Just some questions, which version of LiveCycle are you using? 8.0.1.x? In addition, are you using Flex Builder or the free Flex SDK only? In addition, which version are you using? I'll poke around to see what I can find but it might be a couple of weeks as I am tied up at the moment...
We currently don't ship the source for the Queuesharing.swf form. Alternatively you could just create a new flex form that is translated or even create a PDF in designer (although the later would involve some minor changes to the Queuesharing process).
The source is not available with LiveCycle ES Update 1 SP 1. There is also blog entry from the LiveCycle Docs team to customize the QueueSharing.swf form titled "Localizing the Share Queue Request form (queuesharing.swf file)" at
The instructions you gave me works perfectly for customizing Workspace language properties on ES 8.01. Recently I migrated my system to use ES Update 1 with Service Pack 1. And I tried to do the same thing I did with the earlier version, but ended up with "SWF is not a loadable module. Unable to load resource module from locale/workspace_rb_en_US.swf" error message.
From what I know workspace in ES Update 1 uses Flex 3 instead of Flex 2. I have tried using the instructions on Flex 2 and Flex 3, both to no success. Flex 3 SDK has also different sets of frameworks/locale to Flex 2 SDK, so I presume the instruction on "compc" must have changed to suit different Flex SDK used.
Do you know the right way to compile the language SWF file for ES Update 1 Service Pack 1 using Flex SDK 3 (3.0.0)? Or any documentation of update to what you have given me earlier would be of great help.