Home Portal

Skip to end of metadata
Go to start of metadata

License Agreement

The article presents the features available in the Premium plan of XTRF Language Business Platform. 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 Language Business Platform 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:

  • Process every file separately: For every file uploaded to the mapped folder, the Smart Connector creates separate folder,
  • Process files in batches: The Smart Connector will create one project for all the files.
 

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:

  • Source language,
  • Target language,
  • The kind of service,
  • Specialization.

If you do not select any option in the menus, the default values are applied.

 

You can now configure settings in other tabs.

  • To select when the Smart Connector attempts to create a project go to the Schedule tab and select the desired options.
  • To configure when and to whom the notifications are sent go to the E-mail Notification tab and select appropriate checkboxes.
 

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:

  • Process every file separately: For every file uploaded to the mapped folder, the Smart Connector creates separate folder,
  • Process files in batches: The Smart Connector will create one project for all the files.
 

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.

  • To select when the Smart Connector attempts to create a project go to the Schedule tab and select the desired options.
  • To configure when and to whom the notifications are sent go to the E-mail Notification tab and select appropriate checkboxes.
 

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:

  • name: the parameter specifies the name of the project,
  • sourceLanguage: this parameter specifies the source language
  • targetLanguages: in this parameter two target languages are specified,
  • service: this parameter specifies the type of workflow in the project,
  • specialization: this parameter specifies the specialization of the translation project,
  • categories: the category of translation is specified by this parameter,
  • notes: the message "Important notes" is added to the Notes section in the Instructions tab of the project will be displayed.
  • instructionsFromCustomer: the message "Important instructions from client" will be displayed in the Special Instructions from Client section of the Instructions tab of the project.
  • internalInstructions: the message "Important internal instructions" will be displayed in the Internal Special Instructions section of the Instructions tab of the project.
  • startDate: the start date of the project is specified by this parameter,
  • deadline: the deadline of the project is specified in this parameter
  • delivery: the directory where the translated files will be uploaded when the project is finished is specified in this parameter.

 

 

Please refer also to the related articles:

  The license could not be verified: License Certificate has expired!