License Agreement This article presents the features available in the Ultimate plan of XTRF Translation Management System. Please keep in mind that your access to the described options might be limited due to your license agreement. If you would like to change your plan of XTRF Translation Management System and gain access to the additional features, contact XTRF Customer Success Manager.
This article presents the features available in the Ultimate plan of XTRF Translation Management System. Please keep in mind that your access to the described options might be limited due to your license agreement. If you would like to change your plan of XTRF Translation Management System and gain access to the additional features, contact XTRF Customer Success Manager.
Target audience: Developers
External File Sharing Service
Your client does not need to configure anything in terms of using external file sharing service integrated with Smart Connectors. They can choose one of the following options to deliver the source files to their Project Manager:
- They can send the files to the Project Manager, who will upload the files to the mapped folder
- You can give them access to the mapped folder, therefore they can upload files themselves.
When the files are uploaded to the mapped folder and the Smart Connector is correctly configured, the project can be created.
Each Smart Connector needs to be configured in XTRF Platform. You can do that using a wizard available in the Home Portal. In the picture below you can see the configuration of the Smart Connector prepared in the configuration wizard just before saving. The code snippets provided further in the article can be typed in the Connector Definition code field. To enable code field you only need to select the Robot Code radio button. Bear in mind that the Name and Client fields need to be filled before saving the Smart Connector or switching to other tabs.
Basic Smart Connector
The project created by the Smart Connector example will involve translation from English to German and the set workflow will be appropriate for the Translation service. The specialization is set to General.
The code snippet provided above was created using the configuration wizard. Similar codes are created every time the configuration wizard is used.
Advanced Smart Connector
The Smart Connector example provided below creates a project named User Manual Translation. The source language is German and the target languages are Polish, PL, and English, EN. The service involved in the project is set to Translation Premium , since its retrieved from the XTRF's database, the workflow applied in the project will be as specified in the Premium Translation service. The specialization of the translation is set to the system's default and the category is Automatic-Project. Current date is set as the start date for the project and the deadline is set to a week after the start date. The directory of the translated files is set to this/is/my/relative/path on an FTP server. Notes that will be displayed in the project's Instructions tab are as follows:
- Important notes - for the Notes section,
- Important notes from client - for the Special Instructions from Client section,
- Important internal instructions - for the Internal Special Instructions section.
The code snippet needs to be entered in the Connector Definition field in the Smart Connector configuration. In the Create Smart Connector display select the Robot Code radio button to enable the code field.
The Smart Connector in the example has fixed parameters, it means that projects created by this Smart Connector will have the same configurations. You can use it for the client who orders multiple translation projects of the same type.
Smart Connector with a Descriptor
Both simple and advanced Smart Connectors provided as examples above contain some fixed settings. Therefore, every time a project is created using one of those Smart Connectors, the language combinations or any other parameters specified in the code of those Smart Connectors will be applied. A Smart Connector with a descriptor can be used for multiple projects with completely different parameters, which can be specified in the descriptor file. A descriptor file with project specifications needs to be prepared and uploaded with the file that needs to be translated for every new project created in this type of Smart Connector. An appropriate Smart Connector needs to be prepared for interpreting of the descriptor file.
The code snippet should be entered in the Connector Definition section. In the Create Smart Connector display select the Robot Code radio button to enable the code field.
The Smart Connector in the example provided below is prepared to retrieve the information from the descriptor file. Name of the project, source and target languages, service and notes will be retrieved from the descriptor.
The descriptor needs to be saved as a
.json file and added together with the files that are to be the subject of the project.
You can see an example of a descriptor file. The data provided for the Smart Connector by the descriptor are as follows:
The Smart Connector retrieves the information from the
descriptor.json file and creates project based on that information. The new project will be named Translation Project, the source language will be German, DE, and there will be three translation tasks: into Polish, PL, English, EN, and French, FR. The project's workflow will be appropriate for the Translation Plus service uploaded to the XTRF's database and in the project's Instructions tab the information Important notes will be displayed in the Notes section.
Keep in mind that the data provided in the descriptor file need to be compatible with the data uploaded to your XTRF Patform.
In the table below you can find the list of all parameters available for creating an advanced Smart Connector and the descriptor file. Parameters necessary to create the project are marked as such in their description, all the parameters that are not marked as necessary are optional and are not required to create a project.
While configuring Robot Code, the system may provide you with suggestions for possible operations. To get suggestions press CTRL and SPACE on your keyboard while typing in the code field. A list with possible operations appears.
|Parameter||Description of the Parameter|
| ||This parameter sets the name for the project created by the Smart Connector. If the parameter is not added to the Smart Connector's code, the name of the project will be empty.|
This parameter specifies the source language in the project. The source language needs to be retrieved from the repository, therefore, the appropriate language needs to be uploaded to the XTRF's database. This parameter is necessary to create a project.
This parameter specifies the target languages in the project. The target languages need to be retrieved from the repository, therefore, appropriate languages need to be uploaded to the XTRF's database. This parameter is necessary to create a project.
This parameter specifies what kind of service is provided in the project. The Smart Connector applies the workflow to the project according to this parameter. The services and their corresponding workflows need to be retrieved from the repository, it means that both services and workflows need to be configured and uploaded to the XTRF's database. This parameter is necessary to create the project.
This parameter specifies the specialization of the translation project. The specialization needs to be retrieved from the repository, therefore, the appropriate specialization needs to be uploaded to the XTRF's database.
This parameter specifies the category of the project. The category needs to be retrieved from the repository, therefore, the appropriate categories need to be uploaded to the XTRF's database.
| ||This parameter allows to add notes to the project. You can add the content of the note in the quotation marks in this parameter. The notes will be displayed in the project's Instructions tab in the Notes section.|
| ||This parameter allows to add instructions from the client. The content of the instructions can be added in the quotation marks in this parameter. The instructions will be displayed in the project's Instructions tab in the Special Instructions from Client section.|
| ||This parameter allows to add special internal instructions to the project. The content of the instructions can be added in the quotation marks in this parameter. The instructions will be displayed in the project's Instructions tab in the Internal Special Instructions section.|
You can add the start date of the project using this parameter. If you provide a specific date, the date will be fixed for this Smart Connector. It means that every time this Smart Connector is used to create different projects, the start date will be always the same as specified in this parameter. You can also set the current date as the start date or add a period of time in milliseconds to the current date, if you wish the start date to be in future, for example 7*24*60*60*1000 for seven days.
| ||You can specify the deadline for the project. You can either provide a specific date, which will then be fixed for this Smart Connector, or you can set the current date or the start date and add a period of time in milliseconds, if you want the deadline to be somewhere in future. For example you can add 7*24*60*60*1000 milliseconds to add 7 days.|
| ||This parameter specifies the list of the source files for the project.|
The parameter specifies values of your custom fields for the project. Use key or label to identify custom field.
You can specify the directory path for the translated files. The translated files will be uploaded to this directory when the project is finished.
Uploading Files to Smart Connector
Once a file is uploaded to the folder mapped or an e-mail with attached files is sent to the address specified in the Scan for Input Files section and the Smart Connector is started, the Smart Connector creates a project. The files are available for the vendors assigned to the project as if the project was created manually. Depending on the configuration of the Smart Connector, once the project has been started, the Smart Connector can create a folder with the project's ID number in the directory specified for the processed files and can store the input files there or remove them. If there are any problems with the uploaded file, which would prevent creating a project, the Smart Connector can create a subfolder with the exact date in the name in the directory specified for the In Case of Errors, Store Files in section or it can remove them.
You need to provide the entire paths in the directories of specific sections.
You can add output path for the target files in the Robot Code of the Smart Connector. If the project includes more than one translation task, the target files are stored in folders with a proper language symbol as a folder name.
Multiple files can be added at the same time as a
.ZIP archive. The Smart Connector recognizes the .
archive, creates a subdirectory with the same name as the .
ZIP archive and extracts the files in the subdirectory.
If the name of the file or .
ZIP archive contains characters unsupported by Microsoft Windows operating system, such as:
, the Smart Connector replaces those characters with
Once the project has started, additional files cannot be uploaded to the project using Smart Connector functionality.
You can select when and to whom the e-mail notifications are sent.
The notifications can be sent when:
- The project is created. The notification is sent to person responsible for the project created with the Smart Connector.
- An error occurs. When error occurs and project cannot be created the notification is sent to the person responsible for the Smart Connector and the project.
- Project is requested with Smart Connector. The notification is sent to the client.
You can specify when the Smart Connector attempts to create a project. The project can be started:
- As soon as the Smart Connector detects files in the mapped folder,
- At a scheduled time. You can specify when the Smart Connector should scan the mapped folder and attempt to run a project:
- Once per day,
- Repeatedly per day,
- On selected days of the week,
- Once a month,
- You can also provide a custom schedule, however it needs to be provided as Cron Expression.
Testing Smart Connectors Configuration
To make sure that the Smart Connector will work properly and the folder in Base Directory is mapped correctly, you can perform the following steps:
- Sign in to the Home Portal of XTRF Platform.
- Click the icon.
- In the accordion configuration menu select the Integration and then select Smart Connectors.
- Click the Add button in the upper side of the Smart Connectors list.
- Prepare a Smart Connector:Upload a file to the folder specified in Input section.
- Provide the name for the Smart Connector in the Name field.
- Select the client to whom the Smart Connector is dedicated. The system provides the suggestions as you start typing the name of your client.
- Select the client's Price List.
- In the Files Aggregation drop-down menu select the way the Smart Connector will handle the files uploaded to the mapped folder.
- Provide the directory of the folder or the access data for the e-mail which will be scanned for input files.
- Select what happens with processed files and provide directory for them if necessary.
- Select what happens with the files if any error occurs and provide directory if necessary.
- Select the Person Responsible for the Smart Connector
- Select the Wizard radio button in the Connector Definition field if you want to prepare a simple Smart Connector or Robot Code radio button if you want to prepare an advanced Smart Connector.
- Click the Save button.
- Click the Test button. Test Smart Connector pop-up window containing logs appear. If the directory in Input section is mapped correctly, the file is processed and a pop-up window informing about the potential project appears. In the pop-up window you can choose to create a project or close the pop-up window.