Across Connector

You have to provide valid credentials here.

Figure 1. Account Configuration

The connector allows you to either add translation requests to existing projects or to create new projects by duplicating an existing project (i.e. used as project template).

Therefore, pleases click on Update Projects and Workflows to fetch all available projects and workflows.

You may use project and workflow filters to reduce the number of projects and workflows.

Across uses its own language code identifiers (LCI) whereas FirstSpirit uses language abbreviations.

Consequently, you have to tell across which LCI to use for a given FirstSpirit language.

Figure 2. Languages and LCIs

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 LCIs.

If no LCI can be found, the language abbreviation is added to the list and you have to add a LCI manually. A full list can be obtained here:

https://confext.across.net/display/ASGI/Across+SDK+-+LCIDs

In order to make an across project available to TranslationStudio, you have to create a new project by clicking on the button add.

Figure 3. Project Settings

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 across connector provides 2 ways of storing translatable XML files.

Either of these two approaches can be chosen when configuring your project settings using the across connector’s configuration panel.

The across connector monitors the translation progress and downloads files marked as completed automatically.

When a translatable file is stored in an across project, a unique identifier (GUID) is created by across which allows the connector to specifically find this particular file at a later stage.

This GUID is stored by TranslationStudio and used to monitor the translation progress of the respective file. After a translated file has been downloaded from across, its GUID is removed from TranslationStudio’s monitoring database.

Importantly, the connector does not change any states, neither of individual files not of the respective across project.

If you upload a file into across manually TranslationStudio will not be able to monitor the file’s progress sine its GUID is not known. For example, you might have downloaded a translatable XML file from across to check its content (and have it removed from the across project). Thereafter, you may wish to upload the file to across again and have it translated. However, since the GUID 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 across 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 across 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 across
Assuming that the credentials provided are correct, please make sure that the across 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 across
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 across). Please note that you can always download a translated file manually and store it in TranslationStudio’s working/translated folder.

Across does not show a 100% match although all terms should be known
This is an issue with across and is not related to TranslationStudio.

Please do not hesitate to contact your helpdesk if you experience other issues not mentioned above.

TranslationStudio cannot upload files
It is possible that XML files cannot be uploaded to the TMS. The reason given might be this:

Invalid Content-Type:text/html. Is this an error message instead of a SOAP response

This misleading error message points to the XML exceeding file size limitations. You can find further information at https://confext.across.net/display/ASCS/FileManager.SendFileToServer

In the meantime, you may split the page to be translated into several parts (using the "translate this page" workflow) to temporarily reduce the file size.