GoogleTranslateLogic

Note

This project is using a deprecated NuGet package with frequent errors, from now on, this repository will be labelled as deprecated

Overview

GoogleTranslateLogic is a NetLogic designed to translate missing keys in a localization dictionary of FactoryTalk Optix using the Google Translate API. This class leverages the GTranslate NuGet package to perform translations.

Prerequisites

• FactoryTalk Optix
• .NET 8 SDK
• Visual Studio
• NuGet package: GTranslate (link)

Installation

1. Open the NetSolution in Visual Studio.
2. Install the GTranslate NuGet package using the NuGet Package Manager or by running the following command in the Package Manager Console:

Install-Package GTranslate

How It Works

Main Methods

1. TranslateMissingKeys: This method initiates the translation process by starting a long-running task.

public void TranslateMissingKeys()

2. TranslateMissingKeysMethod: This method performs the actual translation process. It retrieves the localization dictionary, loads its content, translates the missing keys, and updates the dictionary.

private void TranslateMissingKeysMethod()

3. GetLocalizationDictionary: This method retrieves the localization dictionary from the Information Model.

private IUAVariable GetLocalizationDictionary()

4. LoadDictionaryContent: This method loads the content of the localization dictionary.

private string[,] LoadDictionaryContent(IUAVariable localizationDictionary)

5. TranslateDictionaryContent: This method translates the content of the dictionary using non-empty keys.

private string[,] TranslateDictionaryContent(string[,] dictionaryContent)

6. TranslateText: This method uses the GoogleTranslator class from the GTranslate.Translators package to translate text.

private static string TranslateText(string textToTranslate, string targetLanguage, string sourceLanguage)

7. UpdateDictionaryContent: This method updates the localization dictionary with the translated content.

private bool UpdateDictionaryContent(IUAVariable dictionaryToUpdate, string[,] newDictionaryContent)

Usage

1. Ensure that the LocalizationDictionary variable is properly set up in the NetLogic object.
2. Call the TranslateMissingKeys method to start the translation process.

Logging

The class uses the Log object to log information, warnings, and errors throughout the translation process. This helps in monitoring the progress and identifying any issues that may arise.

Notes

• The translation process is synchronous to ensure that all translations are completed before updating the dictionary.
• The first row of the dictionary is assumed to contain the language headers.
• The first column of the dictionary is assumed to contain the localization keys.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Disclaimer

Rockwell Automation maintains these repositories as a convenience to you and other users. Although Rockwell Automation reserves the right at any time and for any reason to refuse access to edit or remove content from this Repository, you acknowledge and agree to accept sole responsibility and liability for any Repository content posted, transmitted, downloaded, or used by you. Rockwell Automation has no obligation to monitor or update Repository content

The examples provided are to be used as a reference for building your own application and should not be used in production as-is. It is recommended to adapt the example for the purpose, observing the highest safety standards.