Documentation Index

Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt

Use this file to discover all available pages before exploring further.

Language Translation

Prev Next

The Language Translation capability enables organizations to integrate their preferred online translation service into the application, allowing end users to dynamically translate the UI into supported languages (Arabic, German etc.,) using the Language icon available on the Quick Action Bar.

The Apex application leverages Weglot for language translation services. While Weglot provides automatic translations for 100+ languages, administrators also have the flexibility to refine and customize translations through an easy-to-use interface based on their requirements.

Earlier versions relied on built-in Google or Microsoft translators. This dependency was removed and replaced with a flexible integration model, where organizations configure and integrate any supported translation provider (for example, Weglot) through application settings and security configuration.

Note

The online translation feature is compatible with following browsers:

  • Google Chrome

  • Firefox

  • Microsoft Edge

Key Highlight

Languages can be selected in the following ways for a user:

  • The language can be selected by the user on the Quick Action Bar.

  • The language can be selected by the Administrator on the LANGUAGE MAPPING page (Admin > Infrastructure > Language Mapping).

  • The language is selected by the Administrator on the DOMAIN page (Admin > Infrastructure > Domain).

  • If no Language is selected in the above mentioned menus, by default, English language is selected.

User Persona: Administrator

Use Case:

Use Case

Solution

Ira is a Service Desk Analyst at NovaTech, supporting employees across Germany, UAE, and France. Many users are not comfortable using the application in English and prefer working in their native language while logging incidents and service requests.

Users request the ability to view and use the application in German, Arabic, and French to better understand forms, menus, and instructions. NovaTech wants to support multiple languages within the same application without creating separate instances.

The administrator enables Online Language Translation from Application Settings and integrates a supported translation provider by configuring the required Header and Body scripts.

The administrator updates the security configuration to allow the translation provider’s domain and enables the Language icon through Domain and Language Mapping settings.

Users can now click the Language icon from the Quick Action Bar and select their preferred language.

The application dynamically translates menus, forms, pages, and options, allowing users to work comfortably in German, Arabic, or French within the same instance.

Prerequisites

To use the Language Translation feature, the Administrators need to perform the following backend configurations before making any configuration on the APPLICATION SETTINGS page:

  • Update the Domain Name in the Content Security. 

  • To update the Domain Name, a CR is required. The service provider is the Domain Name, which needs to be mentioned in the CR while raising the CR.

Notes:

  • A Translate button is available in the Symptom and Description fields within the Incident Management module, and in the Description field within the Service Request module.

  • This allows users to translate the field content, without changing the overall application language.

  • The feature works within the same instance and supports multiple languages dynamically.

  • When exporting data using Export to Excel or Export All, the records will be exported only in English, even if the UI is currently displayed in a translated language (for example, Arabic or German).

  • This feature does not introduce translation by itself but provides a framework to plug in external translation services securely and seamlessly.

Configure Multi Language Support

The organizations need to specify the Language Translator they want to use and integrate it with the application.

To configure Multi Language Support, perform the following steps:

  1. Login as Administrator

  2. Navigate to Infrastructure and select Application setting

  3. Enable Online Translation and Online Translation Integration Script.

  4. Click Submit

To update content security:

Update Content Security in web.config file of the SummitAI application with the Domain Name. For example, if integrating Weglot, the configuration should be as follows: 

<add name="Content-Security-Policy" value="script-src 'self' *.weglot.com blob:; " />

After the Domain Name is updated in the web.config file and CR is resolved, the Administrators can enable language translation on the APPLICATION SETTINGS page.

Application Settings Configuration

On the APPLICATION SETTINGS page (Admin > Infrastructure > Application Settings), select the Enable Online Translation check box. On selecting this check box, the Online Translation Integration Script text boxes are enabled, where the Header Script and Body Script details need to be provided.

Domain Page Configurations

On the DOMAIN page (AdminInfrastructure > Domain), select the Domain for which the Language Translation option should be available and select the Display LANGUAGE Icon check box. 

Language Mapping Configurations

On the LANGUAGE MAPPING page (Admin > Infrastructure > Language Mapping), select the Domain and Location. Select the Display LANGUAGE Icon check box to display the LANGUAGE icon of the Quick Action Bar of the Application for the selected Domain and Location users. 

The following illustrates the application view when Arabic is selected as the preferred language.

Known Limitation

Tooltip alignment issues are observed on the My Incident page, Category List page, Classification List page, Checklist List page, Closure Code list page, Pending Import page, Priority page, Priority Matrix page, SLA Service Window page, SLA Matrix Page and Urgency page.