Introduction
This article provides answers to questions that are frequently asked by clients when they begin working with the Bridge connector.
Questions and answers
Why is my project not created in XTM Cloud?
There might be a few reasons why a project does not arrive at your XTM Cloud instance. The first thing worth checking is whether the package itself has been moved to an “invalid” directory. In most cases, this might be because the uploaded package has an incorrect folder structure or the wrong language code has been used.
The second reason why a project does not arrive at your XTM Cloud instance is when a new language code, which was not previously mapped in the connector configuration, is used.
The third reason, which happens rarely, is that the connector instance is down.
Why was my project not retrieved on the FTP server?
If the project did not arrive at your FTP server once it was completed, you should check if the target files were generated properly (no errors are listed in the Files tab, in the XTM Cloud UI). The target file generation history should enable us to identify whether or not the target was generated properly by the connector user.
How can target languages be specified in XTM Bridge?
We have a few ways to specify the place from which XTM Bridge should inherit target languages:
Hard-code one target language.
Set the target languages using the language folder in the package structure. This requires uploading the source files via the appropriate folders named using the language code.
Set the target language using the file name, which can include the language code.
Why are all files not passed to XTM Cloud?
It is possible that XTM Bridge has been configured to only pass specific file extensions for translation in XTM Cloud so it omits any other file formats.
Why can’t I connect to the FTP server, to upload the package?
In the vast majority of cases, this happens when one of the IPs that you are using has not been whitelisted. In some cases, what is whitelisted is the IP of the VPN that our clients are using. For remote work, this means that, without the connection to the company VPN, the connection to the FTP server cannot be established. In this case, we can add the currently used IP to the whitelist (on request, via a Support ticket), or try connecting via the VPN that we use on a daily basis.
Why has my package been moved to the “Invalid” directory?
When a package is moved to the invalid directory, it means that XTM Bridge is working, since it has processed new files. However, for some reason, XTM Bridge was not able to create a project from that package. Most probably, this has happened because of the reasons given in the first question in this section.
Why do the files disappear from the “import” directory on the FTP server?
If files disappear from the “import” directory, this indicates that XTM Bridge has processed the files. They can be moved to the directory that stores ongoing projects (default name “created”), or to the “invalid” directory if the uploaded package will not result in the creation of a project. For details, see Why has my package been moved to the “Invalid” directory?“.
Can I use different templates while creating projects via XTM Bridge?
Yes, if you do not use a single hard-coded template, we can set your XTM Bridge instance to inherit the project templates from the folder structure of a package that is uploaded to the FTP server.
Example:
Template_ID/Project_name/Files.
Can I use different XTM Cloud customers while creating a project via Bridge?
Different XTM Cloud customers can be used in XTM Bridge. The customer identity is set by the folder with the Customer name or ID in the folder structure.
Can I add reference files to projects, using XTM Bridge?
We can configure XTM Bridge to upload reference files to a project as well. In this case, we need to determine the name of the exact folder in which XTM Bridge should look for the files that have to be added to a project, as references.
Can I upload a ZIP package via XTM Bridge?
In XTM Bridge, translation files can be uploaded in a ZIP file (.zip format). However, in this case, we need to specify how XTM Bridge is to behave if a ZIP file is uploaded. We can upload a ZIP file that should be sent directly to XTM Cloud or we can extract it on the FTP server before creating the project. If a package’s folder structure is used, which enables different XTM Cloud customers, project templates etc. to be inherited from that structure, extracting the package before it is be moved to XTM Cloud is the best way to proceed.
How often does XTM Bridge check the folders on the FTP server to determine whether new files have arrived?
In the XTM Bridge connector configuration, we can set the waiting time between iterations for checking the FTP server, creating projects and their statuses. This means that if, for example, project creation from one iteration takes 1 minute, the time between the loops will be 1 minute plus the set waiting time. By default, the waiting time is set to 1 minute.
Why do target files arrive in separate folders with language codes?
This behavior depends on the XTM Bridge connector configuration, in which we can specify if target files should be placed in sub-folders, with a language code or target files should be omitted.