How to use the ezLocaliser Translation Tool
You want to localise the resources associated with QuickApps for SharePoint so that options, parameters and menu items within the tool will appear in your selected language and not the default English language.
<P><FONT face=Arial>To configure translation the following must be completed.</FONT></P> <P><FONT face=Arial>Please ensure you have taken a server backup and have performed testing in a live environment before committing these changes to your live, production environment:</FONT></P> <OL> <LI><FONT face=Arial>Install the <STRONG>ezLocalizer</STRONG> tool that is found inside the tools folder from the QuickApps (QA) installation media.</FONT></LI> <LI><FONT face=Arial>Run the tool.</FONT></LI> <LI><FONT face=Arial>Select <STRONG>File</STRONG> | <STRONG>New</STRONG> then select a folder and version of QA you are configuring for. Click <STRONG>OK</STRONG>.</FONT></LI> <LI><FONT face=Arial>On the right-hand side of the window is a blue button "<STRONG>Select Languages</STRONG>". Click this button and add in the language you want to translate too. Click <STRONG>OK</STRONG> when you have selected your target language.</FONT></LI> <LI><FONT face=Arial>Many groups of parameters will appear in the left-hand column. You can click on each of the sub-headings for each assembly and see the various parameters that can be changed.</FONT></LI> <LI><FONT face=Arial>The "<STRONG>Name</STRONG>" is the reference to the context of the value and the "<STRONG>Invariant Value</STRONG>" is how the value appears within the tool.</FONT></LI> <LI><FONT face=Arial>When you find the <STRONG>Invariant Value</STRONG> you want to translate you can click inside the corresponding field on the right-hand column underneath your chosen language to input the translation.</FONT></LI> <LI><FONT face=Arial>If you want to search for values to change click on the <STRONG>Actions</STRONG> menu | <STRONG>Find</STRONG>.</FONT></LI> <LI><FONT face=Arial>From this search pane you can type in various search strings to search for. The results of your search will be displayed in the right-hand pane for you to edit.</FONT></LI> <LI><FONT face=Arial>When you have completed all translations click on the blue <STRONG>Save</STRONG> button above the right-hand pane.</FONT></LI> <LI><FONT face=Arial>With the files saved you will now need to compile them into DLL assemblies. Click on the <STRONG>Actions</STRONG> menu | <STRONG>Compile</STRONG></FONT></LI> <LI><FONT face=Arial>A warning will appear to indicate if you have not completed all values. Click <STRONG>Yes</STRONG> to continue.</FONT></LI> <LI><FONT face=Arial>On the compile screen the translation options allow two options for compilation of the files. Please choose "<STRONG>Overwrite the blank values with invariant values</STRONG>". This setting will replace any blank entries in the assembly with the original English text and avoid any missing entries.</FONT></LI> <LI><FONT face=Arial>Click to select both files in the <STRONG>Compile Options</STRONG> part of the window.</FONT></LI> <LI><FONT face=Arial>Click <STRONG>OK</STRONG> to compile the DLL files. They will be saved in the location you specified in step 3.</FONT></LI> <LI><FONT face=Arial>You now must upload these new DLL files into the Global Assembly Cache (GAC) of a web front-end (WFE) server where QA in installed.</FONT></LI> <LI><FONT face=Arial>Click and drag the files from the folder in step 2 into the <STRONG>c:WindowsAssembly</STRONG> folder to install them into the GAC.</FONT></LI> <LI><FONT face=Arial>Perform an <STRONG>iisreset</STRONG> on the WFE server.</FONT></LI> <LI><FONT face=Arial>Your new translations will be available immediately for any site collection that is based on the language you translated. It will not be available to sites that were not created based on this language.</FONT></LI> <LI><FONT face=Arial>If you have multiple languages that you wish to translate for then at step 4, select each language that you need and then use the drop-down menu in the right-hand pane to change the language in focus. When all language translation is complete for all languages you can then compile and upload these DLL files to the GAC.</FONT></LI> <LI><FONT face=Arial>If you make a mistake with the translation and wish to modify it you can load the project within the ezLocalizer tool, modify the translation and then re-compile the DLL files to be uploaded into the GAC once again. Each time this is done you must remember to perform an iisreset for the QuickApps tool to access the new changes.</FONT></LI></OL>
