To install the connector, please install the FSM via FirstSpirit ServerManager.
Thereafter, you can open TranslationStudio’s configuration panel, navigate to custom connectors, click on the add
button and choose the connector from the given list. Its configuration panel will open automatically.
The connector uses the CMS Gateway API or the WSDL API and requires
You have to provide valid credentials here.
The connector creates new projects for every translation job (which may contain several XMLs) using a project template and a given user.
Therefore, pleases click on Update Project Templates and Users
to fetch all available templates and users.
memoQ uses its own language codes whereas FirstSpirit uses language abbreviations.
Consequently, you have to tell memoQ which code to use for a given FirstSpirit language.
Conveniently, you may click on the button Load Language Codes
to automatically fetch all FirstSpirit languages actually in use and try to match it against the known memoQ codes.
If no code can be found, the language abbreviation is added to the list and you have to add its respective memoQ code manually.
In order to make an memoQ project available to TranslationStudio, you have to create a new project by clicking on the button add
.
The project created here will be made available to TranslationStudio’s language mappings requires the following information:
Please do not forget to save your changes
The connector allows you to submit files for translations to memoQ, monitor the translation progress as well as download translated documents and importing them into FirstSpirit automatically.
The memoQ connector monitors the translation progress and downloads files marked as completed automatically.
When a translatable file is stored in an memoQ project, a unique identifier (UID) is created by memoQ which allows the connector to specifically find this particular file at a later stage.
This UID is stored by TranslationStudio and used to monitor the translation progress of the respective file. After a translated file has been downloaded from memoQ, its UID is removed from TranslationStudio’s monitoring database.
Importantly, the connector does not change any states, neither of individual files not of the respective memoQ project.
If you upload a file into memoQ manually TranslationStudio will not be able to monitor the file’s progress sine its UID is not known. For example, you might have downloaded a translatable XML file from memoQ to check its content (and have it removed from the memoQ project). Thereafter, you may wish to upload the file to memoQ again and have it translated. However, since the UID has changed, TranslationStudio will not be able to monitor this file. Fortunately, this is a rather rare scenario but it is sufficient to provide an insight into how the memoQ connector works.
Since there are a few things to configure, it is recommended to create a working configuration in a stage or development environment which allows you to test your memoQ and TranslationStudio settings extensively.
It is recommended to submit only a single file first instead of bulk files.
Once you find that all settings are correct, you then transfer those settings to your production environment.
The following list of potential issues might be helpful to avoid problems:
The connector cannot access memoQ
Assuming that the credentials provided are correct, please make sure that the memoQ api URL is accessible by the server hosting TranslationStudio. You may find further error notifications in TranslationStudio’s log file.
Although some files are uploaded, some translatable files do not appear in memoQ
This is a common issue but solved just as easily. Usually, it is related to missing language configurations. Please make sure that both, the source and target language, have a correct language code assignment.
Translated files are not being imported
There are a few potential causes for such a situation.
First, make sure that the respective file marked as completed
. A mere 100% completion indicator does not suffice. TranslationStudio will only download files that are marked as completed specifically.
Second, you may want to check whether the file has been downloaded and is still waiting to be processed (see TranslationStudio’s working/translated
folder).
Finally, you may always consult the log files to see if there is any other problem, such as rules not met by page or section templates (these may have been introduced only after the translatable file has been stored in memoQ).
Please note that you can always download a translated file manually and store it in TranslationStudio’s working/translated
folder.
memoQ does not show a 100% match although all terms should be known
This is an issue with memoQ and is not related to TranslationStudio.
Please do not hesitate to contact your helpdesk if you experience other issues not mentioned above.