Difference between revisions of "TQAuditor integration"

From Protemos Wiki
Jump to: navigation, search
(Links Protemos jobs with existing TQAuditor Projects)
 
(67 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
''TQAuditor integration page: https://cloud.protemos.com/account/tqauditor''
 
''TQAuditor integration page: https://cloud.protemos.com/account/tqauditor''
 +
 +
Watch our video tutorial on TQ Auditor integration — [[File:2ag.png|40px|link=https://youtu.be/F0fmYK3hF4Q]]
 
----
 
----
  
Protemos is integrated with '''<U>[https://tqauditor.com/ TQAuditor]</U>''' - the system for evaluation and monitoring translation quality.
+
Protemos is integrated with '''<U><span style="background-color:yellow">[https://tqauditor.com/ TQAuditor]</span></U>''' - the system for evaluation and monitoring translation quality.
  
So now you can create jobs in Protemos, and then link them with existing TQAuditor projects or create new TQAuditor projects based on jobs in Protemos without the need to create all anew in both systems.
+
That means you can create jobs on Protemos, and then link them with existing TQAuditor projects or create new TQAuditor projects based on jobs on Protemos without needs to create all anew in both systems.
  
 
If you do not have TQAuditor account, you can register it directly from the '''<U><span style="background-color:yellow">[https://cloud.protemos.com/account/tqauditor TQAuditor integration]</span></U>''' page.   
 
If you do not have TQAuditor account, you can register it directly from the '''<U><span style="background-color:yellow">[https://cloud.protemos.com/account/tqauditor TQAuditor integration]</span></U>''' page.   
  
Here you can also get a TQAuditor API key for Protemos, as it differs from your normal TQAuditor username and password.
+
Here you can also get a TQAuditor API key for Protemos.
  
 
To do so, please click on the corresponding links:
 
To do so, please click on the corresponding links:
  
[[File:TQAUDITOR API CREDENTIALS links.jpg|border|1000px]]
+
[[File:11.png|border|1000px]]
  
 
== Enable TQAuditor integration in Protemos ==
 
== Enable TQAuditor integration in Protemos ==
  
  
1. First and foremost, you need to enable TQAuditor integration for your account. To do this, go to '''Settings=>Integrations=>TQAuditor''':
+
1.Firt of all, you need to enable TQAuditor integration for your account. To do this, go to '''Settings=>Integrations=>TQAuditor''':
  
[[File:TQA menu.jpg|border|300px]]
+
[[File:Settings TQ.png|border|300px]]
 
    
 
    
2. Then you need to press the "'''Enable'''" button:
+
2. Then you need to click the '''"Enable"''' button:
  
[[File:TQAUDITOR API CREDENTIALS enable.jpg|border|1000px]]
+
[[File:12.png|border|1000px]]
  
 
3. Click on the '''Manage TQAuditor API credentials''' link:
 
3. Click on the '''Manage TQAuditor API credentials''' link:
  
[[File:TQAuditor integration details link.jpg|border|600px]]
+
[[File:2.png|border|600px]]
  
 
4. It will redirect you to the TQAuditor '''Login''' page.
 
4. It will redirect you to the TQAuditor '''Login''' page.
Line 33: Line 35:
 
Enter your TQAuditor username and password and click '''"Log in"''':
 
Enter your TQAuditor username and password and click '''"Log in"''':
  
[[File:TQA login page.jpg|border|250px]]
+
[[File:3.png|border|250px]]
  
<span style="color:#DC143C">'''Note:''' If you do not have TQAuditor account, you should '''<U><span style="background-color:yellow">[https://cloud.tqauditor.com/site/register register]</span></U>''' it first.</span>
+
<span style="color:red">'''Note:'''</span> If you do not have TQAuditor account, you should '''<U><span style="background-color:yellow">[https://cloud.tqauditor.com/site/register register]</span></U>''' it first.
  
 
5. Copy the API key displayed on your TQAuditor '''Account details''' page:  
 
5. Copy the API key displayed on your TQAuditor '''Account details''' page:  
  
[[File:TQA account det.jpg|border|500px]]
+
[[File:Account details TQ Auditor.png|border|450px]]
  
6. Paste it into the '''TQAuditor API key''' field on the '''<U><span style="background-color:yellow">[https://cloud.protemos.com/account/tqauditor-update Update TQAuditor integration details]</span></U>''' page and press '''"Update"''':
+
6. Paste it into the '''TQAuditor API key''' field on the '''<U><span style="background-color:yellow">[https://cloud.protemos.com/account/tqauditor-update Update TQAuditor integration details]</span></U>''' page and click '''"Update"''':
  
[[File:TQAuditor integration key.jpg|border|600px]]
+
[[File:Unable.png|border|600px]]
 
   
 
   
7. When done, your TQAuditor integration page will look like this:
+
7. When it's done, your TQAuditor integration page will look like this:
  
[[File:TQAUDITOR ACCOUNT DETAILS itegrated.jpg|border|1000px]]
+
[[File:6.png|border|1000px]]
 
   
 
   
You’ll be able to disable this integration or update integration details any time by pressing the corresponding buttons.
+
You can disable this integration or update integration details any time by clicking the corresponding buttons.
  
 
[[File:Redirect.jpg|40px|link=TQAuditor integration]] Back to the '''table of contents'''.
 
[[File:Redirect.jpg|40px|link=TQAuditor integration]] Back to the '''table of contents'''.
Line 59: Line 61:
 
1. Create a project in Protemos the way you usually do, but first enable TQA integration for your account, as described '''<U>[[TQAuditor integration#Enable TQAuditor integration in Protemos|above]]</U>'''.
 
1. Create a project in Protemos the way you usually do, but first enable TQA integration for your account, as described '''<U>[[TQAuditor integration#Enable TQAuditor integration in Protemos|above]]</U>'''.
  
<span style="color:#DC143C">'''Note:''' You should define a specialization and language pair for the project when creating it. Otherwise, you won't be able to create TQAuditor project.</span>
+
<span style="color:red">'''Note:'''</span> You should define a specialization and language pair for the project when creating it. Otherwise, you won't be able to create TQAuditor project.
  
2. Now let’s assume that you need to assign translation to one vendor, and then give it for proofreading to another vendor.
+
2. Now let’s assume that you need to assign a translation to one vendor, and then give it for proofreading to another vendor.
  
 
Thus, you should create respective jobs in the project.
 
Thus, you should create respective jobs in the project.
  
3. Having created jobs, you can start creating TQAuditor project based on these jobs.
+
3. Once you created jobs, you can start creating the TQAuditor project based on these jobs.
  
To do so, go to the job assigned for proofreading, scroll down to the '''Linked TQAuditor projects''' section and press '''"Create TQAuditor project"''':
+
To do so, go to the job assigned for proofreading, scroll down to the '''Linked TQAuditor projects''' section and click '''"Create TQAuditor project"''':
  
[[File:TQA create proj.jpg|border|1000px]]
+
[[File:Create TQ project.png|border|1200px]]
 
   
 
   
''Although basically, it doesn't matter based on which Protemos job you create TQAuditor project. The main point is that at least two jobs should be created within the project.''
+
''At least two jobs should be created within the project.''
  
 
''And you can't create TQA project based on Protemos jobs assigned to the same vendor.''
 
''And you can't create TQA project based on Protemos jobs assigned to the same vendor.''
  
4. It will bring you to the '''Create TQAuditor project''' page where you should select the translation job from the drop-down list in the '''Translation job''' box and enter '''CAT word count'''.
+
4. It will bring you to the '''Create TQAuditor project''' page where you should select the translation job from the drop-down list in the '''Translation job''' box.
  
Then you may add a note for an evaluator if necessary, and finally press '''"Create"''' to create the project in TQAuditor:
+
Then you may add a note for an evaluator if necessary, and finally click '''"Create"''' to create the project on TQAuditor:
  
[[File:Job review page.jpg|border|500px]]
+
[[File:The button create22.png|border|850px]]
  
5. If the data on the specialization, project participants etc. in Protemos coincide with the data in TQAuditor, the page of the integrated job in Protemos will be displayed.
+
5. If the data on the specialization, project participants, etc. on Protemos coincide with the data on TQAuditor, the page of the integrated job on Protemos will be displayed.
  
Scroll down to the '''Linked TQAuditor projects''' section to see linked TQAuditor project.
+
Scroll down to the '''Linked TQAuditor projects''' section to see the linked TQAuditor project.
  
 
To continue working on the project in TQAuditor, click the project ID in the '''TQAuditor project ID''' column:
 
To continue working on the project in TQAuditor, click the project ID in the '''TQAuditor project ID''' column:
  
[[File:Linked projects section.jpg|border|1000px]]
+
[[File:IDD 32200 Protemos.png|border|1000px]]
  
You may also unlink Protemos job and TQAuditor project by pressing the '''"Unlink"''' button:
+
You may also unlink Protemos jobs and TQAuditor project by clicking the '''"Unlink"''' button:
  
[[File:Linked projects section unlink.jpg|border|1000px]]
+
[[File:Iunlink D 32200 Protemos.png|border|1000px]]
  
 
In case some data do not match, the system will report you.
 
In case some data do not match, the system will report you.
Line 97: Line 99:
 
Add or edit the corresponding data and try to create the project again.
 
Add or edit the corresponding data and try to create the project again.
  
So to put it simply, to synchronize Protemos and TQAuditor, you should add the same translators, managers, specializations etc. to both systems.
+
To put it simply, to synchronize Protemos and TQAuditor, you should add the same translators, managers, specializations, etc. to both systems.
  
 
[[File:Redirect.jpg|40px|link=TQAuditor integration]] Back to the '''table of contents'''.''.
 
[[File:Redirect.jpg|40px|link=TQAuditor integration]] Back to the '''table of contents'''.''.
  
=='''Links Protemos jobs with existing TQAuditor Projects'''==
+
=='''Link Protemos jobs with existing TQAuditor Projects'''==
  
 
To link Protemos jobs with existing TQAuditor projects, please do the following:
 
To link Protemos jobs with existing TQAuditor projects, please do the following:
Line 107: Line 109:
 
1. Open one of the jobs of the project you need to link.
 
1. Open one of the jobs of the project you need to link.
  
2. Scroll down to the '''Linked TQAuditor projects''' section and press '''"Link TQAuditor project"''':
+
2. Scroll down to the '''Linked TQAuditor projects''' section and click '''"Link TQAuditor project"''':
  
[[file:Link TQA butt.jpg|border|1000px]]
+
[[File:Link TQ project.png|border|1200px]]
  
 
3. It will open the '''Link with TQAuditor project''' page where you should select the translation job from the drop-down list in the '''Translation job''' box, and then click '''"Next"''':
 
3. It will open the '''Link with TQAuditor project''' page where you should select the translation job from the drop-down list in the '''Translation job''' box, and then click '''"Next"''':
  
[[file:Link TQA job det page.jpg|border|500px]]
+
[[File:1link with tq.png|border|550px]]
  
 
4. Then scroll down to the '''TQAditor projects''' section to see a list of TQAuditor projects, and click the '''"Link"''' button in the row of the TQA project you need to link:
 
4. Then scroll down to the '''TQAditor projects''' section to see a list of TQAuditor projects, and click the '''"Link"''' button in the row of the TQA project you need to link:
  
[[file:Link TQA project.jpg|border|1000px]]
+
[[File:2 link with tq.png|border|900px]]
 +
 
 +
5. It will redirect you to the linked job page.
 +
 
 +
Scroll down to the '''Linked TQAuditor projects''' section to see the linked TQAuditor project.
 +
 
 +
To continue working on the project in TQAuditor, click the project ID in the '''TQAuditor project ID''' column:
 +
 
 +
[[File:New ID.png|border|900px]]
 +
 
 +
You may also unlink Protemos jobs and TQAuditor project by clicking the '''"Unlink"''' button:
 +
 
 +
[[File:New unlink.png|border|900px]]
 +
 
 +
 
 +
[[File:Redirect.jpg|40px|link=TQAuditor integration]] Back to the '''table of contents'''.
 +
 
 +
=='''Transfer files from Protemos to TQAuditor'''==
 +
 
 +
Editors can transfer files from Protemos to TQAuditor.
 +
 
 +
To do that, the editor/evaluator should do the following:
 +
 
 +
1. Open the respective job and scroll down to the '''Linked TQAuditor projects''' section and click the '''"Transfer files"''' button:
 +
 
 +
[[File:Transfer the last one.png|border|900px]]
 +
 
 +
3. On the '''"Transfer files to linked TQAuditor project"''' page the editor can choose the needed input file and click '''"Transfer to TQAuditor"''':
 +
 
 +
[[File:1trsfr.png|border|700px]]
 +
 
 +
They can transfer job output files in  the same way:
  
 +
[[File:2trnsfr.png|border|700px]]
  
 +
<span style="color:red">'''Note:'''</span> Only editors/evaluators can transfer files from Protemos to TQAuditor.
  
 
[[File:Redirect.jpg|40px|link=TQAuditor integration]] Back to the '''table of contents'''.
 
[[File:Redirect.jpg|40px|link=TQAuditor integration]] Back to the '''table of contents'''.

Latest revision as of 15:24, 19 September 2022

TQAuditor integration page: https://cloud.protemos.com/account/tqauditor

Watch our video tutorial on TQ Auditor integration — 2ag.png


Protemos is integrated with TQAuditor - the system for evaluation and monitoring translation quality.

That means you can create jobs on Protemos, and then link them with existing TQAuditor projects or create new TQAuditor projects based on jobs on Protemos without needs to create all anew in both systems.

If you do not have TQAuditor account, you can register it directly from the TQAuditor integration page.

Here you can also get a TQAuditor API key for Protemos.

To do so, please click on the corresponding links:

11.png

Enable TQAuditor integration in Protemos

1.Firt of all, you need to enable TQAuditor integration for your account. To do this, go to Settings=>Integrations=>TQAuditor:

Settings TQ.png

2. Then you need to click the "Enable" button:

12.png

3. Click on the Manage TQAuditor API credentials link:

2.png

4. It will redirect you to the TQAuditor Login page.

Enter your TQAuditor username and password and click "Log in":

3.png

Note: If you do not have TQAuditor account, you should register it first.

5. Copy the API key displayed on your TQAuditor Account details page:

Account details TQ Auditor.png

6. Paste it into the TQAuditor API key field on the Update TQAuditor integration details page and click "Update":

Unable.png

7. When it's done, your TQAuditor integration page will look like this:

6.png

You can disable this integration or update integration details any time by clicking the corresponding buttons.

Redirect.jpg Back to the table of contents.

Create new TQAuditor projects based on Protemos jobs

To create new TQAuditor project based on Protemos jobs, please do the following:

1. Create a project in Protemos the way you usually do, but first enable TQA integration for your account, as described above.

Note: You should define a specialization and language pair for the project when creating it. Otherwise, you won't be able to create TQAuditor project.

2. Now let’s assume that you need to assign a translation to one vendor, and then give it for proofreading to another vendor.

Thus, you should create respective jobs in the project.

3. Once you created jobs, you can start creating the TQAuditor project based on these jobs.

To do so, go to the job assigned for proofreading, scroll down to the Linked TQAuditor projects section and click "Create TQAuditor project":

Create TQ project.png

At least two jobs should be created within the project.

And you can't create TQA project based on Protemos jobs assigned to the same vendor.

4. It will bring you to the Create TQAuditor project page where you should select the translation job from the drop-down list in the Translation job box.

Then you may add a note for an evaluator if necessary, and finally click "Create" to create the project on TQAuditor:

The button create22.png

5. If the data on the specialization, project participants, etc. on Protemos coincide with the data on TQAuditor, the page of the integrated job on Protemos will be displayed.

Scroll down to the Linked TQAuditor projects section to see the linked TQAuditor project.

To continue working on the project in TQAuditor, click the project ID in the TQAuditor project ID column:

IDD 32200 Protemos.png

You may also unlink Protemos jobs and TQAuditor project by clicking the "Unlink" button:

Iunlink D 32200 Protemos.png

In case some data do not match, the system will report you.

Add or edit the corresponding data and try to create the project again.

To put it simply, to synchronize Protemos and TQAuditor, you should add the same translators, managers, specializations, etc. to both systems.

Redirect.jpg Back to the table of contents..

Link Protemos jobs with existing TQAuditor Projects

To link Protemos jobs with existing TQAuditor projects, please do the following:

1. Open one of the jobs of the project you need to link.

2. Scroll down to the Linked TQAuditor projects section and click "Link TQAuditor project":

Link TQ project.png

3. It will open the Link with TQAuditor project page where you should select the translation job from the drop-down list in the Translation job box, and then click "Next":

1link with tq.png

4. Then scroll down to the TQAditor projects section to see a list of TQAuditor projects, and click the "Link" button in the row of the TQA project you need to link:

2 link with tq.png

5. It will redirect you to the linked job page.

Scroll down to the Linked TQAuditor projects section to see the linked TQAuditor project.

To continue working on the project in TQAuditor, click the project ID in the TQAuditor project ID column:

New ID.png

You may also unlink Protemos jobs and TQAuditor project by clicking the "Unlink" button:

New unlink.png


Redirect.jpg Back to the table of contents.

Transfer files from Protemos to TQAuditor

Editors can transfer files from Protemos to TQAuditor.

To do that, the editor/evaluator should do the following:

1. Open the respective job and scroll down to the Linked TQAuditor projects section and click the "Transfer files" button:

Transfer the last one.png

3. On the "Transfer files to linked TQAuditor project" page the editor can choose the needed input file and click "Transfer to TQAuditor":

1trsfr.png

They can transfer job output files in the same way:

2trnsfr.png

Note: Only editors/evaluators can transfer files from Protemos to TQAuditor.

Redirect.jpg Back to the table of contents.