Microsoft Translator Connector - Revision history

Kuro2: /* Limitations */

2019-08-23T08:44:22Z

Limitations

← Older revision		Revision as of 04:44, 23 August 2019
Line 55:		Line 55:
	* According to the [https://docs.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-translate?tabs=curl#request-body API document], at most 100 JSON array elements can be supplied and the entire text cannot exceeds 5000 characters.		* According to the [https://docs.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-translate?tabs=curl#request-body API document], at most 100 JSON array elements can be supplied and the entire text cannot exceeds 5000 characters.
	* The service may, on occasion, not generate back the proper spaces. This happens especially when there are inline codes present in the source.		* The service may, on occasion, not generate back the proper spaces. This happens especially when there are inline codes present in the source.
			* Only the translation feature of the Translator Text Service is supported by the connector. Obtaining a list of supported languages, transliteration, or language identification (detection) is not supported.
			* Only the category parameter can be specified. Profanity detection and deletion, script conversion, and other features are not supported.

	==History==		==History==

Kuro2: Minor fix

2019-08-15T01:07:00Z

Minor fix

← Older revision		Revision as of 21:07, 14 August 2019
Line 11:		Line 11:

	<cite>Azure Key</cite> — The Microsoft Azure key to use this Translator Text and other Microsoft Cognitive Services.		<cite>Azure Key</cite> — The Microsoft Azure key to use this Translator Text and other Microsoft Cognitive Services.

	<cite>Category</cite> — An optional category to use when working with trained engines. The service defaults to "general" if none is supplied.		<cite>Category</cite> — An optional category to use when working with trained engines. The service defaults to "general" if none is supplied.

Line 18:		Line 19:
	azureKey=myAzureKey		azureKey=myAzureKey
	category=general		category=general


	==Details==		==Details==

Kuro2: Update to match v3 API, first attempt

2019-08-15T01:06:15Z

Update to match v3 API, first attempt

← Older revision		Revision as of 21:06, 14 August 2019
Line 1:		Line 1:
	{{Connectors Header}}		{{Connectors Header}}
	__TOC__		__TOC__
	==~~Retirement of version 2 API~~==		==Overview==
	~~<span class="red">MICROSOFT CONNECTOR~~ of ~~the Okapi stable releases will STOP WORKING<~~/~~span> at~~ the ~~end of April, 2019~~.		The Microsoft [https://docs.microsoft.com/en-us/azure/cognitive-services/translator/ Translator Text Service] provides a machine translation over a REST API. The service supports a large number of language pairs, both common and less common. The list is available at [https://docs.microsoft.com/en-us/azure/cognitive-services/Translator/language-support#translation]. (Please see the list under '''V3 Translator API'''.)

	~~Microsoft will retire their version 2 API on 2019-4-30 as described in~~ [https://docs.microsoft.com/en-us/azure/cognitive-services/translator/~~migrate~~-to-~~v3 this page~~].		This connector uses [https://docs.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-reference the V3 API]. To use this connector you need an '''Azure Key''' from Microsoft. See [https://translatorbusiness.uservoice.com/knowledgebase/articles/1078534-microsoft-translator-on-azure#signup the Microsoft pages] for more information.
	~~Because of~~ this~~, the~~ Microsoft ~~Connector found in the latest stable release, M37, will no longer work~~ on ~~and after 2019~~-~~5-01~~.

	~~The support of~~ the ~~version 3 API has been added to Okapi~~ in ~~mid April after~~ the ~~M37 release~~. ~~If you need to use Microsoft's machine translation service, please pick up~~ the ~~M38 snapshot version from~~ [~~http://okapiframework.org/snapshots/ here~~].		For more examples on how to use this connector see the article "[[Trying out the Microsoft Translator Connector]]" in the [[Knowledge Base]]. See also the [[Microsoft Batch Translation Step]].
	~~Please note this is a minimal implementation and it does not support any new features such as profanity filtering,~~

	~~Because the version 3 API no longer supports the translation memory, that aspect of function is not available even if you use the latest Okapi M38 snapshot version.~~		==Parameters==

	~~You will need an "azure~~ key" to use ~~the version 3 API. If you already have a key for version 2, the same key should work~~.		<cite>Azure Key</cite> — The Microsoft Azure key to use this Translator Text and other Microsoft Cognitive Services.
	~~For information on how~~ to ~~obtain an azure key, please see [https://azure~~.~~microsoft.com/en-us/pricing/details/cognitive-services/ this page]~~.		<cite>Category</cite> — An optional category to use when working with trained engines. The service defaults to "general" if none is supplied.

	~~'''Information below is mostly out~~ of ~~date. It is kept as reference until full update of this page is done.'''~~		Example of a configuration file:

	~~==Overview==~~		#v1
	The Microsoft MT engine is freely available from Microsoft at [http://www.microsofttranslator.com http://www.microsofttranslator.com]. Volume limitations apply. The engine supports a large number of language pairs, both common and less common. The list is available at [http://www.microsofttranslator.com/help http://www.microsofttranslator.com/help].		azureKey=myAzureKey
			category=general
	~~This connector uses the HTTP v2 API. You can get more information about the API and its terms here: [http://sdk.microsofttranslator.com http://sdk.microsofttranslator.com].~~

	~~To use this connector you need a "Azure Key" from Microsoft. See [https://translatorbusiness.uservoice.com/knowledgebase/articles/1078534-microsoft-translator-on-azure~~#~~signup the Microsoft pages] for more information.~~

	You must also respect Microsoft's Terms of Service. If you intend to use the Microsoft Translator API for commercial or high volume purposes, you would need to sign a commercial license agreement and provide your AppID to the Microsoft Translator team. For more details contact [mailto:mtlic@microsoft.com mtlic@microsoft.com].

	~~The engine supports inline codes.~~

	When using the query functions of this connector, you are accessessing a remote server and makes your '''source text''' available to Microsoft, but no corresponding translation is sent to Microsoft when doing queries.

	~~For more examples on how to use this connector see the article "[[Trying out the Microsoft Translator Connector]]" in the [[Knowledge Base]]. See also the [[Microsoft Batch Translation Step]].~~

			==Details==
	==== Calculation of the combined score ====		==== Calculation of the combined score ====

Line 61:		Line 50:
	If a result has no <code>Rating</code> the default is set to 5. Unverified MT translation will generally return a <code>MatchDegree</code> of 100 and a <code>Rating</code> of 5, which will compute into a combined score of 95 in the Okapi interface.		If a result has no <code>Rating</code> the default is set to 5. Unverified MT translation will generally return a <code>MatchDegree</code> of 100 and a <code>Rating</code> of 5, which will compute into a combined score of 95 in the Okapi interface.

	~~==Parameters==~~

	===~~Starting with M32~~:===		==Limitations==

			* According to the [https://docs.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-translate?tabs=curl#request-body API document], at most 100 JSON array elements can be supplied and the entire text cannot exceeds 5000 characters.
			* The service may, on occasion, not generate back the proper spaces. This happens especially when there are inline codes present in the source.

			==History==
			===Retirement of version 2 API===
			Microsoft has retireed their version 2 API on 2019-4-30 as described in [https://docs.microsoft.com/en-us/azure/cognitive-services/translator/migrate-to-v3 this page].
			Because of this, the Microsoft Connector found in the latest stable release, M37, will no longer work on and after 2019-5-01.

	~~<cite>Azure Key</cite> —~~ The ~~Microsoft Azure key to connect~~ to the ~~MT server. See See~~ [~~https~~://~~translatorbusiness~~.~~uservoice.com~~/~~knowledgebase~~/~~articles/1078534-microsoft-translator-on-azure#signup the Microsoft pages~~] ~~for more information~~.		The support of the version 3 API has been added to the M38 snapshot version from [http://okapiframework.org/snapshots/ here] in April 2019.

	~~<cite>Category</cite> — An optional category to use when working with trained engines.~~		Please note this is a minimal implementation and it does not support any new features such as profanity filtering,

	~~Example~~ of ~~a configuration file:~~		Because the version 3 API no longer supports the translation memory, that aspect of function is not available even if you use the latest Okapi M38 snapshot version.

	~~#v1~~		You will need an "azure key" to use the version 3 API. If you already have a key for version 2, the same key should work.
	~~azureKey=myAzureKey~~		For information on how to obtain an azure key, please see [https://azure.microsoft.com/en-us/pricing/details/cognitive-services/ this page].
	~~category=~~

	===Prior M32:===		===Old Parameters Prior To M32===

	<cite>Client ID</cite> — The Client ID to use to connect to the MT server. See See [http://msdn.microsoft.com/en-us/library/hh454950.aspx the MSDN pages] for more information.		<cite>Client ID</cite> — The Client ID to use to connect to the MT server. See See [http://msdn.microsoft.com/en-us/library/hh454950.aspx the MSDN pages] for more information.
Line 89:		Line 84:
	secret=theSecretForThatClientID		secret=theSecretForThatClientID

	~~==Limitations==~~

	* The engine may, on occasion, not generate back the proper spaces. This happens especially when there are inline codes present in the source.

	[[Category:Connectors]]		[[Category:Connectors]]

Kuro2: Added minimum info about MS API v3

2019-04-25T03:21:33Z

Added minimum info about MS API v3

@@ Line 1: / Line 1: @@
 {{Connectors Header}}
 __TOC__
 ==Overview==
 The Microsoft MT engine is freely available from Microsoft at [http://www.microsofttranslator.com http://www.microsofttranslator.com]. Volume limitations apply. The engine supports a large number of language pairs, both common and less common. The list is available at [http://www.microsofttranslator.com/help http://www.microsofttranslator.com/help].

Okapifra: /* Overview */

2016-11-26T14:32:03Z

Overview

← Older revision		Revision as of 10:32, 26 November 2016
Line 7:		Line 7:
	This connector uses the HTTP v2 API. You can get more information about the API and its terms here: [http://sdk.microsofttranslator.com http://sdk.microsofttranslator.com].		This connector uses the HTTP v2 API. You can get more information about the API and its terms here: [http://sdk.microsofttranslator.com http://sdk.microsofttranslator.com].

	To use this connector you need a "~~Client ID" and a "Client Secret~~" from Microsoft~~. If you get those by obtaining a Windows Live ID, and then registering an application in your Live account~~. See [~~http~~://~~msdn~~.~~microsoft~~.com/~~en-us~~/~~library~~/~~hh454950.aspx~~ the ~~MSDN~~ pages] for more information.		To use this connector you need a "Azure Key" from Microsoft. See [https://translatorbusiness.uservoice.com/knowledgebase/articles/1078534-microsoft-translator-on-azure#signup the Microsoft pages] for more information.

	You must also respect Microsoft's Terms of Service. If you intend to use the Microsoft Translator API for commercial or high volume purposes, you would need to sign a commercial license agreement and provide your AppID to the Microsoft Translator team. For more details contact [mailto:mtlic@microsoft.com mtlic@microsoft.com].		You must also respect Microsoft's Terms of Service. If you intend to use the Microsoft Translator API for commercial or high volume purposes, you would need to sign a commercial license agreement and provide your AppID to the Microsoft Translator team. For more details contact [mailto:mtlic@microsoft.com mtlic@microsoft.com].

Okapifra: /* Parameters */

2016-11-26T14:28:38Z

Parameters

← Older revision		Revision as of 10:28, 26 November 2016
Line 47:		Line 47:

	==Parameters==		==Parameters==

			===Starting with M32:===

			<cite>Azure Key</cite> — The Microsoft Azure key to connect to the MT server. See See [https://translatorbusiness.uservoice.com/knowledgebase/articles/1078534-microsoft-translator-on-azure#signup the Microsoft pages] for more information.

			<cite>Category</cite> — An optional category to use when working with trained engines.

			Example of a configuration file:

			#v1
			azureKey=myAzureKey
			category=

			===Prior M32:===

	<cite>Client ID</cite> — The Client ID to use to connect to the MT server. See See [http://msdn.microsoft.com/en-us/library/hh454950.aspx the MSDN pages] for more information.		<cite>Client ID</cite> — The Client ID to use to connect to the MT server. See See [http://msdn.microsoft.com/en-us/library/hh454950.aspx the MSDN pages] for more information.

Ysavourel: 1 revision imported

2016-06-04T23:19:53Z

1 revision imported

← Older revision	Revision as of 19:19, 4 June 2016
(No difference)

Ysavourel: /* Overview */

2012-08-25T12:28:48Z

Overview

New page

{{Connectors Header}}
__TOC__
==Overview==

The Microsoft MT engine is freely available from Microsoft at [http://www.microsofttranslator.com http://www.microsofttranslator.com]. Volume limitations apply. The engine supports a large number of language pairs, both common and less common. The list is available at [http://www.microsofttranslator.com/help http://www.microsofttranslator.com/help].

This connector uses the HTTP v2 API. You can get more information about the API and its terms here: [http://sdk.microsofttranslator.com http://sdk.microsofttranslator.com].

To use this connector you need a "Client ID" and a "Client Secret" from Microsoft. If you get those by obtaining a Windows Live ID, and then registering an application in your Live account. See [http://msdn.microsoft.com/en-us/library/hh454950.aspx the MSDN pages] for more information.

You must also respect Microsoft's Terms of Service. If you intend to use the Microsoft Translator API for commercial or high volume purposes, you would need to sign a commercial license agreement and provide your AppID to the Microsoft Translator team. For more details contact [mailto:mtlic@microsoft.com mtlic@microsoft.com].

The engine supports inline codes.

When using the query functions of this connector, you are accessessing a remote server and makes your '''source text''' available to Microsoft, but no corresponding translation is sent to Microsoft when doing queries.

For more examples on how to use this connector see the article "[[Trying out the Microsoft Translator Connector]]" in the [[Knowledge Base]]. See also the [[Microsoft Batch Translation Step]].

==== Calculation of the combined score ====

The original score of the query is preserved in the <code>score</code> field of the query result.

The <code>combinedScore</code> of the query result holds a re-calculated value that takes into account both the <code>MatchDegree</code> and <code>Rating</code> values returned by the engine.

For the results with a <code>MatchDegree</code> or 90 or above, the combined score is computed by adding the <code>Rating</code> value minus 10. For the results with a <code>MatchDegree</code> below 90, the combined score is simply the <code>MatchDegree</code>.

{| border="1" cellpadding="5" cellspacing="0"
|+
| '''MatchDegree''' || '''Rating''' || '''Combined Score'''
|- valign="top"
| 100 || 5 || 95 (i.e. 100+(5-10))
|- valign="top"
| 100 || 6 || 96 (i.e. 100+(6-10))
|- valign="top"
| 100 || 0 || 90 (i.e. 100+(0-10))
|- valign="top"
| 100 || -3 || 87 (i.e. 100+(-3-10))
|- valign="top"
| 98 || 9 || 97 (i.e. 98+(9-10))
|- valign="top"
| 95 || 5 || 90 (i.e. 95+(5-10))
|}

Such calculation is far from perfect especially between highly rated high fuzzy matches and a low rated exact matches. But such entries are difficult to rank even manually. We will try to improve this scoring and welcome any feedback you may have.

If a result has no <code>Rating</code> the default is set to 5. Unverified MT translation will generally return a <code>MatchDegree</code> of 100 and a <code>Rating</code> of 5, which will compute into a combined score of 95 in the Okapi interface.

==Parameters==

<cite>Client ID</cite> — The Client ID to use to connect to the MT server. See See [http://msdn.microsoft.com/en-us/library/hh454950.aspx the MSDN pages] for more information.

<cite>Secret</cite> — The secret corresponding to the Client ID.

<cite>Category</cite> — An optional category to use when working with trained engines.

Example of a configuration file:

#v1
clientId=myPersonalClientID
secret=theSecretForThatClientID

==Limitations==

* The engine may, on occasion, not generate back the proper spaces. This happens especially when there are inline codes present in the source.

[[Category:Connectors]]