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 your XTRF Customer Success Manager.
Target audience: Administrators
Smart Connectors are powerful tools that allow creating predefined projects as soon as a file is uploaded to the folder or send in a message to the e-mail address specified in the Smart Connector configuration. They work similarly to the periodic jobs and are designed to save Project Manager's time when your client orders multiple translation projects of the same type. This article presents you how to create and configure a Smart Connector. Depending on your knowledge of JavaScript you can either configure the basic Smart Connector, which does not require any knowledge of the JavaScript, or you can prepare an advanced Smart Connector, which requires at least basic knowledge of Java Script. The information how to prepare both types of the Smart Connectors is provided below. Mind, that steps in both section I and section II need to be performed to set up a Smart Connector, however in section II you can choose whether you want to set up a basic or advanced Smart Connector.
Prepare Folders for Smart Connectors
Before following the steps in this guide, make sure that the folder in a files sharing service or an e-mail address is already prepared, therefore it can be mapped for the Smart Connector to scan.
Before Reading a Guide
- The steps without any marking are mandatory to perform because they ensure carrying on a proper function of the Home Portal.
- The steps marked with the (Optional) label give you information about settings useful for you in terms of fulfilling specific requirements for your projects, but if you skip them it will have no negative effect on the function of the Home Portal.
I. Find Smart Connectors
Sing in to the Home Portal of XTRF Platform. | |
Click the icon. | |
In the configuration accordion menu click the Integration and then select the Smart Connectors. | |
Click the Add button at the top of the Smart Connectors list or Add Smart Connector button in the upper right corner. You are directed to the Add Smart Connector page.
|
II. Set up Smart Connector
At this point you can decide what kind of Smart Connector you want to set up. The type of Smart Connector depends on your needs and your JavaScript proficiency. If you have no basic knowledge of JavaScript, you can easily set up basic Smart Connector.
Set Up a Basic Smart Connector
In case of basic Smart Connector any knowledge of JavaScript is not required. You can use drop-down menus available in the configuration wizard to easily and quickly set up the Smart Connector. To set up a basic Smart Connector, perform the following steps:
You are unable to save the Smart Connector or switch to other tabs unless the information is provided to the fields marked with the asterisk.
In the Name field provide the name of the Smart Connector. Smart Connector Name != Project Name The information provided in this field does not apply to the project created by the Smart Connector. Project name can be specified in the Robot Code.
| |
Select the Active checkbox. If it is not selected, the Smart Connector is disabled and does not attempt to create projects. | |
In the Client field start typing the name of the client to whom the Smart Connector is dedicated. The system will provide suggestions as you start typing. The Smart Connector selects the default Contact Person specified in the client's Price List. If there is no default Contact Person, the first Contact Person from the client's Price List is selected.
| |
(Optional) Select the Client's Price Profile. Default Price Profile If there is only one Price Profile for the selected client, it is selected automatically.
| |
From the Files Aggregation drop-down menu select how the Smart Connector will handle the source files. The Smart Connector can:
| |
Provide the directory of a folder that the Smart Connector will scan for files. It can be either located on your local machine, on the FTP or SFTP server or it can be an e-mail address. Provide the necessary information in the available fields. | |
Provide the directory for the processed files . You can select the directory on your local machine, an FTP server or an SFTP server or you can select the Do not store option, if you do not want to store processed files. | |
Provide the directory where files will be stored, if any errors occur. You can select the directory on your local machine, an FTP server or SFTP server, or you can select the Do not store option, if you do not want to store files in case of errors. | |
Select the person that will be responsible for the Smart Connector. You can select the Project Manager or select a user from the drop-down menu. | |
In the Connector Definition section select the Wizard radio button. | |
Select the specifications of the project from the drop-down menus. You can specify:
If you do not select any option in the menus, the default values are applied. | |
You can now configure settings in other tabs.
| |
Click the Save button. Below you can see an example of a Smart Connector set up in the configuration wizard. |
Set Up an Advanced Smart Connector
In advanced Smart Connector you can add more parameters to the project, however this requires at least basic knowledge of JavaScript. To do so, follow the steps:
You are unable to save the Smart Connector or switch to other tabs unless the information is provided to the fields marked with the asterisk.
In the Name field provide the name of the Smart Connector. Smart Connector Name != Project Name The information provided in this field does not apply to the project created by the Smart Connector. Project name can be specified in the Robot Code. | |
Select the Active checkbox. If it is not selected, the Smart Connector is disabled and does not attempt to create projects. | |
In the Client field start typing the name of the client to whom the Smart Connector is dedicated. The system will provide suggestions as you start typing. The Smart Connector selects the default Contact Person specified in the client's Price List. If there is no default Contact Person, the first Contact Person from the client's Price List is selected. | |
(Optional) Select the Client's Price Profile. Default Price Profile If there is only one Price Profile for the selected client, it is selected automatically. | |
From the Files Aggregation drop-down menu select how the Smart Connector will handle the source files. The Smart Connector can:
| |
Provide the directory of a folder that the Smart Connector will scan for files. It can be either located on your local machine, on the FTP or SFTP server or it can be an e-mail address. Provide the necessary information in the available fields. | |
Provide the directory for the processed files . You can select the directory on your local machine, an FTP server or an SFTP server or you can select the Do not store option, if you do not want to store processed files. | |
Provide the directory where files will be stored, if any errors occur. You can select the directory on your local machine, an FTP server or SFTP server, or you can select the Do not store option, if you do not want to store files in case of errors. | |
Select the person that will be responsible for the Smart Connector. You can select the Project Manager or select a user from the drop-down menu. | |
In the Connector Definition section select the Robot Code radio button. You can see the default settings in the Connector Definition code filed. | |
Change the settings according to your needs. You can find the list of available parameters in the Smart Connectors - Technical Guide, section Available Parameters. | |
You can now configure settings in other tabs.
| |
Click the Save button. Below you can see an example of an advanced Smart Connector. The advanced parameters added in the robot code in the example are as follows:
|
- Basic Definition :
- XTRF Modules Context-Sensitive Help:
- Technical Article: