Using the Translation Studio

The Magentrix platform includes the Translation Studio — a customizable translation engine that allows administrators to manage how elements of the portal are translated into different languages. Administrators can use the Translation Studio to specify how the names for portal components like Tabs, Apps, and Entities are translated in specified languages.

Understanding Translation Studio

What is Translation Studio?

Translation Studio allows you to:

• Customize translations for portal component names and labels
• Manage language-specific terminology across the platform
• Control how interface elements appear to users in different languages
• Maintain consistent multilingual branding and terminology

Translation Types

Manual Translation: Portal component names, labels, and interface elements that require administrator-defined translations through Translation Studio.

Automatic Translation: Inline text content is automatically translated by the system and does not require manual configuration through Translation Studio.

Component Types Available for Translation

Translation Studio organizes translatable elements into several component categories:

Entities

• Database objects and their field labels
• Entity names that appear throughout the portal
• Custom entity labels and descriptions

Apps

• Application names and descriptions
• App-specific interface labels
• Navigation elements within applications

Tabs

• Tab names and labels
• Tab-specific interface elements
• Navigation menu items

Custom Labels

• System-wide custom labels and text
• User-defined interface elements
• Platform-specific terminology

Custom Labels are created by developers using Setup > Develop > Labels and can be translated through Translation Studio when properly implemented in Active Pages and Classes.

Requirements

To use the Translation Studio, you must have one of the following:

• Administrator System Role permissions
• Security Role with Additional Settings: Access Translation Studio Enabled

Configuring Translation Studio Access

For non-Administrator users to access Translation Studio:

1. Navigate to Setup Home > Security > Security Roles
2. Select the target Security Role
3. Click Edit
4. Select the Additional Settings tab
5. Check "Access Translation Studio Enabled"
6. Click Save & Close

Using Translation Studio

Accessing Translation Studio

1. Navigate to the Setup Home page
2. Click Manage > Language Settings
3. Click Translation Studio

Translation Process

Step-by-Step Translation Configuration

1. In the Language dropdown list, select the target language for translation
2. In the Components pane, navigate the tree structure to locate the component type you want to translate
3. Expand component categories (Entities, Apps, Tabs, Custom Labels) to access specific elements
4. Select a portal component from the expanded tree
5. In the Translations pane, review the translation table with the following columns:
   • Aspect: The type of element being translated
   • Master Value: The original text in the default language
   • Translation Value: The target language translation (editable field)
   • Unique Name: The system identifier for the element
6. Click in the Translation Value field beside the component you want to translate
7. Enter the appropriate translation for the target language
8. Click Save to store the translation
9. Repeat for additional components as needed

Navigation and Organization

Component Tree Structure

• Expandable Categories: Click arrows to expand or collapse component sections
• Hierarchical Organization: Components are organized in logical groups for easy navigation
• Search and Filter: Use filter boxes in the Translations pane to locate specific elements:
  • Filter by Aspect to find specific types of elements
  • Filter by Master Value to search original text
  • Filter by Translation Value to find existing translations
  • Filter by Unique Name to locate specific system identifiers

Translation Management

• Master Value Reference: The Master Value column shows the original text that serves as the basis for translation
• Translation Tracking: Empty Translation Value fields indicate components that need translation
• Bulk Translation: Work through components systematically to ensure complete language coverage

Best Practices

Translation Strategy

• Consistency: Maintain consistent terminology across related components
• Context Awareness: Consider how translations will appear in the user interface
• Brand Alignment: Ensure translations align with your organization's multilingual branding
• User Experience: Test translations in context to verify they make sense to end users

Implementation Planning

• Component Prioritization: Focus on user-facing components first (Tabs, Apps, frequently used Entities)
• Quality Review: Have native speakers review translations for accuracy and appropriateness
• Testing: Verify translations appear correctly in the portal interface
• Documentation: Maintain records of translation decisions for consistency

Ongoing Management

• Regular Review: Periodically review translations for accuracy and relevance
• New Component Translation: Translate new components as they are added to the portal
• User Feedback: Gather feedback from multilingual users about translation quality
• Version Control: Track translation changes when portal components are updated

Translation Studio provides comprehensive control over portal localization, enabling organizations to deliver consistent, professional multilingual experiences for all users while maintaining centralized translation management.

<< Return to Configuring Language Settings