TranslationStudio allows you to easily file translation requests without the need for later manual intervention.
At its core, TranslationStudio distinguishes between urgent translation requests (which will be processed immediately) and regular requests which will be processed if certain quotes are met.
A preview page might be very helpful as it provides additional contextual information which might aid the translator. Preview pages can be generated from an existing output channel (such as PDF). If your project does not have any eligible channel, you may consider adding one, if necessary.
Preview pages, however, are not required by the TranslationStudio in order to work properly. Rather, it is a feature which provides more contextual information to the translator.
In addition, TranslationStudio allows you to define how many pages and datasets should be included in one translatable XML file. This is a crucial aspect, because
The latter aspect is of particular importance, because it allows you to control certain thresholds which guarantee a most efficient translation process. For example, too many files might increase the time needed for translation and splitting files might allow more translators to work on them at the same time.
TranslationStudio is very flexible and offers you a variety of means to customise its usage according to your specific needs. Most of these needs can be operationalised using a proper configuration of your module or workflows.
TranslationStudio can be self-hosted in your on-premise environment or hosted in a cloud.
If self-hosted, you may access TranslationStudio’s complete configuration panel by opening the ServerManager’s server properties and selecting Modules
. To configure the service, select the item TranslationStudio Studio Service
from the list and click the Configure
button as depicted below.
If hosted in a cloud, you cannot access server properties but configure TranslationStudio by navigating to and configuring the TranslationStudio project component.
It does not matter (nor does it make a difference) which project component you use to access the configuration. |
If you configure TranslationStudio via the project component, you do not need to consider certain settings such as connectivity because these information will be administered by your hoster. Hence, you can focus on only those aspects necessary to customise your TranslationStudio instance according to your needs.
You can configure the module at any time. Any changes stored will be sent to the TranslationStudio application automatically.
Make sure to configure TranslationStudio and send it to the TranslationStudio application. If TranslationStudio has never been configured, it will start with a configuration template to make editing easier. Yet, it will be unable to connect to FirstSpirit and actually process your requests. |
This settings category allows you to configure the connection settings necessary for FirstSpirit to communicate with TranslationStudio and vice versa.
Please provide the address and port FirstSpirit will use to access the TranslationStudio Application.
Please provide only the IP or server name. If you use names instead of IP addresses, make sure that the TranslationStudio server can resolve the FirstSpirit address. In addition, FirstSpirit has to be able to resolve the TranslationStudio address. |
You can test the connections by clicking on the respective Test Connection
button.
TLS/SSL should only be used if you installed TranslationStudio with TLS encryption - simply checking the box does not automatically activate TLS in the TranslationStudio Application. |
The TranslationStudio Application uses the given FirstSpirit user to access the respective projects. Make sure that this user has project access to all projects using TranslationStudio.
TranslationStudio has two processes which can be scheduled independently from one another:
Depending on your workload and translation timings it might be a good idea to configure the scheduling. By default, each process will be executed after a one minute break.
Usually, translations take longer and it might be enough wait for 1h between two translation checks.
These settings can be used to control the workload. Since exporting and importing data from and into FirstSpirit might impose significant workload on the server, you may want to avoid intense workload during your office hours. These settings allow you to consider such necessities.
TranslationStudio distinguishes between three kinds of mails:
You can test the connection and send a test e-mail to the administrator by clicking Test Settings
.
The Receive Notifications section allows you to fine tune which kind of emails you would like to receive. By default, a notification will be sent to each user who requested a page or dataset to be translated. Whenever a status change occurs to this page, an email will be sent to the user if provided in the FirstSpirit user configuration. However, you may also only send all email notifications to the administrator’s email. Finally, you may also deactivate any user notification by sending notifications to nobody.
Information on the Mail Server
User notifications use FirstSpirit’s email settings which are set elsewhere. You may, however, decide not to use the FirstSpirit mail service by deselecting the respective box on the lower right.
Quote configurations allow controlling when and how pages and datasets registered for translation are processed and when a translation job is actually being initiated.
There are 2 types of configuration available
Importantly, both types do not differ in terms of available options.
The default quote configuration can be used at any time and will also be used in case a previously defined custom quote configuration is removed from this list although there are elements already registered for translation.
You may add unlimited custom quote configurations under the respective tab’s panel.
The available settings will be described in the following:
A translation will be initiated if at least one of the above criteria is met. |
A zero value in Number of pages required
or Start if oldest element is X day(s) old
deactivates the respective criterion.
A negative value for Start if deadline is reached in X day(s)
deactivates the respective criterion.
All changes made will only be stored if you click on the “Apply Changes” button. |
Connectors are used to connect to various Translation Memory System (TMS). The following types of connectors are available.
Connectors marked with an (*) provide machine translations and the result should be reviewed. There will be no guarantee regarding the correctness of the translations created by any machine translation system. |
The Filesystem Connector can only be configured but not removed. It will be used if no particular connector is required.
The AWS, DeepL and Google Translate connectors can only be used if you provide valid credentials and access keys in its respective configuration panel.
Custom connectors require additional configuration and can be added as needed.
You can activate the TranslationHelper plugin by activating the feature in either of these connectors. |
If your TranslationStudio is hosted in the cloud, you do not necessarily need AWS credentials. Please contact your administrator for further information. |
The custom connector panel consists of 2 areas:
New connectors can be added or removed using the respective icons next to the list and 3 pieces of information are required for each available system in order to work properly:
Configurable
entry holds the fully qualified class name which implements the TranslationMemorySystemConnectorConfigurationGui
interface from the connector API.
Connector
entry holds the fully qualified class name which implements the TranslationMemoryConnector
interface from the connector API.
You can (optionally) load the required data from a connector’s xml file which makes this installation easier. The xml file must follow the xml structure shown below (using data from the above screenshot to provide sample data). You can load the file using the load from file
button in the upper right.
<?xml version="1.0" encoding="UTF-8"?> <connector> <name>Custom Connector</name> <configurable>com.mycompany.connector.configuration.Panel</configurable> <instance>com.mycompany.connector.instance.Connector</instance> <xml-connector></xml-connector> <xml-gui></xml-gui> </connector>
To configure the respective connector, click on the Configure
button. Importantly: All changes made to the connector configuration will have to be confirmed using the Apply Changes
button.
Please note: each connector provides a list of available projects. For example, a given TMS might provide specific projects for certain language pairs, e.g. from English to German or from English to French.
Other connectors, such as the filesystem connector only provide one single project. Importantly, each project has a unique id which is used to identify the respective project in the TMS. The list of available projects per connector is forwarded to FirstSpirit and available to projects and language mappings.
Depending on the connector and the underlying Translation Memory System (TMS), some TMS projects might be deleted or removed and, consequently, wont be available to TranslationStudio anymore.
Yet, existing language mappings might still have stored the id of the removed TMS project. Thus, it might be necessary to change these mappings and choose other target TMS projects or to remove the respective language mappings from the FirstSpirit project.
However, if a translation is requested using a language mapping with an invalid TMS project, the element might not be processed. Consequently, make sure that language mappings always use existing TMS projects.
Connecting to Translation Memory Servers
Sometimes, a connection to a Translation Memory Server may fail because the server uses self-signed certificates, for example. In that case, you have to add the certificate to the JDK’s default keystore on the server running the TranslationStudio Application.
This section contains several features which may be made available to TranslationStudio or not.
translated
flag in FirstSpirit after successful importstranslated
after the successful import.
translate
those non-standard uids. We strongly urge you to use standard uids, because this may cause data confusion and data loss!
Monitor
section.
TranslationStudio provides tools to monitor the application and to react to specific situations.
You may decide how often a check is to be carried out.
TranslationStudio is able to identify if a core process has died unexpectedly (e.g. due to an out of memory error) and to respond to such an event according to the settings provided here.
In addition, you may choose to collect some metrical information. Those information can be accessed using the TranslationStudio Dashboard.
TranslationStudio can be installed automatically whenever you its project component to a FirstSpirit project.
If you want to install TranslationStudio simply by adding its project component automatically, you will have to meet the following requirements:
In order to use TranslationStudio in your project, the project component has to be added to the project and the installation script executed.
Usually, you do not want your editors to decide which translation language combination and TMS is to be used. This may result in illegal language combinations.
Therefore, supported combinations have to be created. Thereby, you as administrator define which languages can be used as source languages and which languages will be translated into.
To create a mapping, navigate to the Mappings folder fts_configuration
in the Global Content Area and create a new page template using the template fts_gca_mapping
as shown below: