DynamicTranslation – Client
Die DynamicTranslation- API bietet Methoden, die Text in Echtzeit mithilfe von Übersetzungsdienstanbietern in mehrere Sprachen übersetzen. Diese API ist sowohl für Standard-Clients als auch für Angular-basierte Serviceportal -Clients verfügbar.
Darüber hinaus können Sie diese API verwenden, um die Sprache einer bestimmten Zeichenfolge zu erkennen und zu überprüfen, ob die DynamicTranslation- Methoden für einen Übersetzungsservice aktiviert sind. Verwenden Sie diese API, um eine nahtlose Lokalisierungs-Experience für Ihre Benutzeroberfläche zu erstellen, sodass eine Schnittstelle mehrere Länder bedienen kann.
Derzeit unterstützt diese API drei Übersetzungsdienstanbieter: Microsoft Azure Translator Service, IBM Watson Translator Service und Google Cloud Translator Service. Sie können auch andere Übersetzungsservices in Ihrer Instanz konfigurieren und dann die DynamicTranslation- API verwenden, um Ihren Text zu übersetzen.
Um diese API zu verwenden, müssen Sie das Plugin „Dynamische Übersetzung“ aktivieren. Weitere Informationen zu diesem Plugin und zusätzliche Informationen zur dynamischen Übersetzung finden Sie in der Übersichtüber dynamische Übersetzungen. Um diese API in einem Serviceportal -Widget zu verwenden, müssen Sie außerdem den Service „dynamicTranslation“ in die Skriptfunktion des Widget-Clients einfügen.
DynamicTranslation – getDetectedLanguage(String text, Object parms)
Erkennt die Sprache des übergebenen Texts.
Wenn Sie einen Übersetzer übergeben, verwendet die Methode diesen Übersetzungsservice, um die Ausgangssprache zu erkennen. Andernfalls wird die Erkennung vom Standardübersetzungsservice durchgeführt. Stellen Sie sicher, dass die von Ihnen angegebenen Textzeichenfolgen genügend Ausdrücke enthalten, um die richtige Spracherkennung zu ermöglichen.
Zusätzlich zur erkannten Sprache enthält die Antwort ein Konfidenzniveau der Erkennung sowie andere mögliche Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den Standardübersetzungsservice zurück, der zur Erkennung der Sprache verwendet wird.
| Name | Typ | Beschreibung |
|---|---|---|
| text | Zeichenfolge | Text, der zur Erkennung der Sprache verwendet werden soll. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| parms.translator | Zeichenfolge | Übersetzungsservice, der zum Erkennen der Sprache einer Zeichenfolge verwendet werden soll. Übersetzungsservices werden im Menü „ Übersetzerkonfiguration“ konfiguriert und befinden sich in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration]. Mögliche Werte (Groß-/Kleinschreibung beachten):
Hinweis:
Um benutzerdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsdienstanbieter. Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration] konfiguriert ist. |
| Typ | Beschreibung |
|---|---|
| Alternativen | Array von Objekten, die andere Sprachen beschreiben, die ebenfalls eine Übereinstimmung sein könnten. Datentyp: Array |
| alternatives.code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| alternatives.confidence | Gleitkommawert, der das Konfidenzniveau der Alternativsprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger das Konfidenzniveau. Datentyp: Zeichenfolge |
| alternatives.name | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| erkannte Sprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| erkannteSprache.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| erkannteSprache.Konfidenz | Gleitkommawert, der das Konfidenzniveau der Alternativsprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger das Konfidenzniveau. Datentyp: Zeichenfolge |
| erkannteSprache.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zur Erkennung der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode möglicherweise zurückgibt, und Hinweise zur Ursache des Fehlers.
|
Dieses Beispiel zeigt Code, der eine Zeichenfolge in Englisch mithilfe des Übersetzungsservice von IBM in einem Standard-Client-Skript erkennt.
var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );Ausgabe:
detectedResponse {
detectedLanguage:
{ "code": "en", "confidence": "1", "name": "en" }
alternatives:
[
{ "code": "vi", "confidence": "0.86", "name": "vi" },
{ "code": "id", "confidence": "0.86", "name": "id" }
]
}Dieses Beispiel zeigt ein Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.
var detectedResponse = DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );{"code":"40003","message":"Translator (\"translator\" field) is invalid"}Dieses Beispiel zeigt Code, der eine Zeichenfolge in englischer Sprache mithilfe des Übersetzungsservice von IBM in einem Widget-Client-Skript Serviceportal erkennt. Beachten Sie, dass der Name der Klasse „dynamicTranslation“ und nicht „DynamicTranslation“ lautet.
var detectedResponse = dynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );detectedResponse {
detectedLanguage:
{ "code": "en", "confidence": "1", "name": "en" }
alternatives:
[
{ "code": "vi", "confidence": "0.86", "name": "vi" },
{ "code": "id", "confidence": "0.86", "name": "id" }
]
}Dieses Beispiel zeigt ein Widget-Client-Skript Serviceportal, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird.
var detectedResponse = dynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );{"code":"40003","message":"Translator (\"translator\" field) is invalid"}DynamicTranslation – getDetectedLanguages(Array texts, Object parms)
Erkennt die Sprachen der übergebenen Textzeichenfolgen.
Wenn Sie einen Übersetzer übergeben, verwendet die Methode diesen Übersetzungsservice, um die Ausgangssprache zu erkennen. Andernfalls wird die Erkennung vom Standardübersetzungsservice durchgeführt. Stellen Sie sicher, dass die von Ihnen angegebenen Textzeichenfolgen genügend Ausdrücke enthalten, um die richtige Spracherkennung zu ermöglichen.
Zusätzlich zur erkannten Sprache enthält die Antwort ein Konfidenzniveau der Erkennung sowie andere mögliche Sprachalternativen. Wenn kein Übersetzer übergeben wird, gibt die Methode auch den Standardübersetzungsservice zurück, der zur Erkennung der Sprache verwendet wird.
Wenn Sie diese Methode über ein Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen „dynamicTranslation“. Zum Beispiel „dynamicTranslation.getTranslations()“. Verwenden Sie beim Aufruf über ein Plattform-Client-Skript den Klassennamen DynamicTranslation. wie DynamicTranslation.getTranslations().
| Name | Typ | Beschreibung |
|---|---|---|
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| parms.translator | Zeichenfolge | Übersetzungsservice, der zum Erkennen der Sprache einer Zeichenfolge verwendet werden soll. Übersetzungsservices werden im Menü „ Übersetzerkonfiguration“ konfiguriert und befinden sich in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration]. Mögliche Werte (Groß-/Kleinschreibung beachten):
Hinweis:
Um benutzerdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsdienstanbieter. Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration] konfiguriert ist. |
| Texte | Array | Liste der Textzeichenfolgen, die zum Erkennen der Sprache(n) verwendet werden sollen. |
| Typ | Beschreibung |
|---|---|
| Erkennungen | Spracherkennung von Textzeichenfolgen. Datentyp: Objekt |
| Erkennungen.Alternativen | Array von Objekten, die andere Sprachen beschreiben, die ebenfalls eine Übereinstimmung sein könnten. Datentyp: Array |
| Erkennungen.Alternativen.Code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| Erkennungen.Alternativen.Konfidenz | Gleitkommawert, der das Konfidenzniveau der Alternativsprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger das Konfidenzniveau. Datentyp: Zeichenfolge |
| Erkennungen.Alternativen.Name | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| discovery.detectedLanguage | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| Erkennungen.erkannteSprache.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Erkennungen.ErkannteSprache.Konfidenz | Gleitkommawert, der das Konfidenzniveau der Alternativsprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger das Konfidenzniveau. Datentyp: Zeichenfolge |
| discovery.detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Erkennungen.isError | Kennzeichnung, die angibt, ob die Erkennung der Sprache für den Text zu einem Fehler geführt hat. Gültige Werte:
Datentyp: Boolesch |
| status | Status der Antwort auf den Methodenaufruf. Mögliche Werte:
Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zur Erkennung der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode möglicherweise zurückgibt, und Hinweise zur Ursache des Fehlers.
|
Dieses Beispiel zeigt Code aus einem Portal-Client-Skript, das Englisch als Sprache der übergebenen Zeichenfolgen mithilfe des Microsoft-Übersetzungsservice erkennt.
var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "Microsoft"}).then(function(res) {console.log(res);}, function(res) {console.log(res);});
gs.info(JSON.stringify(detectedResponse));
Ausgabe
{
"translator":"Microsoft",
"status":"Success",
"detections":[
{
"isError":false,
"detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
"alternatives":[
{"name":"id", "code":"id", "confidence":"0.83"},
{"name":"ms", "code":"ms", "confidence":"0.83"}
]
},
{
"isError":false,
"detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
"alternatives":[
{"name":"fr", "code":"fr", "confidence":"0.83"},
{"name":"id", "code":"id", "confidence":"0.83"}
]
}
]
}Dieses Beispiel zeigt Code in einem Portal-Client-Skript, das einen Teilstatus zurückgibt, wenn zwei Textzeichenfolgen übergeben werden und eine davon ungültig ist. Um dieses Codebeispiel in einem Plattform-Client-Skript zu verwenden, ändern Sie „ dynamicTranslation.getDetectedLanguages“ in DynamicTranslation.getDetectedLanguages.
var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", ""], {"translator": "Microsoft"}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
gs.info(JSON.stringify(detectedResponse));Ausgabe
{
"translator":"Microsoft",
"status":"Partial",
"detections":[
{
"isError":false,
"detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
"alternatives":[
{"name":"id", "code":"id", "confidence":"0.83"},
{"name":"ms", "code":"ms", "confidence":"0.83"}
]
},
{
"isError":true,
"code":"40000",
"message":"Text is missing or invalid"
}
]
}Dieses Beispiel zeigt Code aus einem Portal-Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie „ dynamicTranslation.getDetectedLanguages“ in DynamicTranslation.getDetectedLanguages.
var detectedResponse = dynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "123"}).then(function(res) {console.log(res); }, function(res) {console.log(res); } );
gs.info(JSON.stringify(detectedResponse));Ausgabe
{"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}DynamicTranslation – getTranslation(String textToTranslate, Object parms)
Übersetzt den übergebenen Text in eine oder mehrere Sprachen.
Die Methode verwendet Übersetzungsservices wie Microsoft Azure Translator Service, IBM Watson Translator Service und Google Cloud Translator Service, um die Übersetzung durchzuführen. Wenn Sie keine Übersetzungsparameter übergeben, verwendet die Methode den Systemstandard.
| Name | Typ | Beschreibung |
|---|---|---|
| textZuÜbersetzen | Zeichenfolge | Zu übersetzender Text. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| parms.zusätzlicheParameter | Objekt | Optional. Array von JSON-Objekten. Jedes Objekt enthält Schlüssel-Wert-Paare, die zusätzliche Informationen für die Durchführung der Übersetzung bereitstellen. |
| parms.zusätzlicheParameter.parameterName | Zeichenfolge | Optional. Schlüsselname. Gültige Werte: texttype: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Dienst. |
| parms.zusätzlicheParameter.parameterWert | Zeichenfolge | Optional. Wert des zugeordneten Schlüssels. Gültige Werte:
Standard: Klartext |
| parms.sourceSprache | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die zum Übersetzen des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück. Standard: Vom Benutzer bevorzugte Sprache. |
| parms.translator | Zeichenfolge | Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung beachten). Gültige Werte:
Hinweis:
Um benutzerdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsdienstanbieter. Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration] konfiguriert ist. |
| Typ | Beschreibung |
|---|---|
| erkannte Sprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| erkannteSprache.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| erkannteSprache.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Übersetzungen | Array von Objekten, die die Sprachübersetzungen beschreiben. Datentyp: Array |
| Übersetzungen.Zielsprache | Sprachcode, in den der Quelltext übersetzt wurde. Datentyp: Zeichenfolge |
| Übersetzungen.übersetztText | Übersetzter Text. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zur Erkennung der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, und Hinweise zu deren Ursache.
|
Dieses Beispiel zeigt die Übersetzung von Nur-Text-Inhalten aus dem Englischen (erkannt) ins Französische und Italienische mit dem Übersetzungsservice von Microsoft in einem Standard-Client-Skript.
DynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Antwort:
{"translations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre questo testo utilizzando la piattaforma dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire ce texte en utilisant la plate-forme du client"
}
],
"translator":"Microsoft",
"detectedLanguage":{"code":"en","name":"en"}
}Dieses Beispiel zeigt ein Client-Skript, das einen Fehler auslöst, wenn eine ungültige Zielsprache übergeben wird.
DynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": ["123"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Antwort:
{"code":"40054","message":"Target language is invalid"}Dieses Beispiel zeigt die Übersetzung von Nur-Text-Inhalten aus dem Englischen (erkannt) ins Französische und Italienische mithilfe des Übersetzungsservice von Microsoft in einem Serviceportal -Widget-Client-Skript. Beachten Sie, dass der Name der Klasse „dynamicTranslation“ und nicht „DynamicTranslation“ lautet.
dynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Antwort:
{"translations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre questo testo utilizzando la piattaforma dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire ce texte en utilisant la plate-forme du client"
}
],
"translator":"Microsoft",
"detectedLanguage":{"code":"en","name":"en"}
}Dieses Beispiel zeigt ein Widget-Client-Skript Serviceportal, das einen Fehler auslöst, wenn eine ungültige Zielsprache übergeben wird
dynamicTranslation.getTranslation("Translate this text using platform from client", {
"targetLanguages": [123],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});
Antwort:
{"code":"40054","message":"Target language is invalid"}DynamicTranslation – getTranslations(Array texts, Object parms)
Übersetzt die übergebenen Textzeichenfolgen in eine oder mehrere Sprachen.
Die Methode verwendet Übersetzungsservices wie Microsoft Azure Translator Service, IBM Watson Translator Service und Google Cloud Translator Service, um die Übersetzung durchzuführen. Wenn Sie keine Übersetzungsparameter übergeben, verwendet die Methode den Systemstandard.
Wenn Sie diese Methode über ein Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen „dynamicTranslation“. Zum Beispiel „dynamicTranslation.getTranslations()“. Verwenden Sie beim Aufruf über ein Plattform-Client-Skript den Klassennamen DynamicTranslation. wie DynamicTranslation.getTranslations().
| Name | Typ | Beschreibung |
|---|---|---|
| Texte | Array | Liste der zu übersetzenden Textzeichenfolgen. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| parms.zusätzlicheParameter | Objekt | Optional. Array von JSON-Objekten. Jedes Objekt enthält Schlüssel-Wert-Paare, die zusätzliche Informationen für die Durchführung der Übersetzung bereitstellen. |
| parms.zusätzlicheParameter.parameterName | Zeichenfolge | Optional. Schlüsselname. Gültige Werte: texttype: Typ des zu übersetzenden Texts. Nur für Microsoft Azure Translator-Dienst. |
| parms.zusätzlicheParameter.parameterWert | Zeichenfolge | Optional. Wert des zugeordneten Schlüssels. Gültige Werte:
Standard: Klartext |
| parms.sourceSprache | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die zum Übersetzen des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück. Standard: Vom Benutzer bevorzugte Sprache. |
| parms.translator | Zeichenfolge | Optional. Übersetzungsservice, der zum Übersetzen des Texts verwendet werden soll (Groß-/Kleinschreibung beachten). Gültige Werte:
Hinweis:
Um benutzerdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsdienstanbieter. Standard: Übersetzungsservice, der in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration] konfiguriert ist. |
| Typ | Beschreibung |
|---|---|
| status | Status der Antwort auf den Methodenaufruf. Mögliche Werte:
Datentyp: Zeichenfolge |
| Übersetzungen | Array von Objekten, die die Sprachübersetzungen beschreiben. Datentyp: Array |
| Übersetzungen.isError | Kennzeichnung, die angibt, ob die Übersetzung des Texts zu einem Fehler geführt hat. Gültige Werte:
Datentyp: Boolesch |
| Übersetzungen.erkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| Übersetzungen.erkannteSprache.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Übersetzungen.erkannteSprache.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| textTranslations | Array von Objekten. Beschreibung der Sprache, die zum Übersetzen der Textzeichenfolge verwendet wird. |
| textÜbersetzungen.Zielsprache | Sprachcode, in den der Quelltext übersetzt wurde. Datentyp: Zeichenfolge |
| textÜbersetzungen.übersetztText | Übersetzter Text. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der für die Übersetzung des Texts verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die Methode zurückgeben kann, und Hinweise zu deren Ursache.
|
Dieses Beispiel zeigt Code in einem Portal-Client-Skript, das eine Liste von Textzeichenfolgen mithilfe des Microsoft-Übersetzungsservice ins Französische und Italienische übersetzt.
dynamicTranslation.getTranslations(["Translate first text using portal from client", "Translate second text using portal from client"], {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});Antwort:
{
"translations":[
{
"isError":false,
"textTranslations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre il primo testo utilizzando il portale dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire le premier texte à l'aide du portail à partir du client"
}
],
"detectedLanguage": {"name":"en", "code":"en"}
},
{
"isError":false,
"textTranslations":[
{
"targetLanguage":"it",
"translatedText":"Traduci il secondo testo utilizzando il portale dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire le deuxième texte à l'aide du portail à partir du client"
}
],
"detectedLanguage": {"name":"en", "code":"en"}
}
],
"translator":"Microsoft",
"status":"Success"
}Dieses Beispiel zeigt ein Portal-Client-Skript, das einen Teilstatus zurückgibt, wenn eine der beiden übergebenen Textzeichenfolgen ungültig ist. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie „ dynamicTranslation.getTranslations“ in „DynamicTranslation.getTranslations“.
dynamicTranslation.getTranslations(["Translate first text using portal from client", ""], {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": "Microsoft"
}).then(function(res){console.log(res);}, function(res){console.log(res);});Antwort:
{
"translations":[
{
"isError":false,
"textTranslations":[
{
"targetLanguage":"it",
"translatedText":"Tradurre il primo testo utilizzando il portale dal client"
},
{
"targetLanguage":"fr",
"translatedText":"Traduire le premier texte à l'aide du portail à partir du client"
}
],
"detectedLanguage":{"name":"en", "code":"en"}
},
{
"isError":true,
"code":"40000",
"message":"Text is missing or invalid"
}
],
"translator":"Microsoft",
"status":"Partial"
}Dieses Beispiel zeigt ein Portal-Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie „ dynamicTranslation.getTranslations“ in „DynamicTranslation.getTranslations“.
dynamicTranslation.getTranslations(["Translate first text using portal from client", "Translate second text using portal from client"], {
"targetLanguages": ["fr", "it"],
"additionalParameters": [{
"parameterName": "texttype",
"parameterValue": "plain"
}],
"translator": 123
}).then(function(res){console.log(res);}, function(res){console.log(res);});Antwort:
{"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}DynamicTranslation – isEnabled(String Translator)
Bestimmt, ob die verschiedenen Methoden in der DynamicTranslation- API für einen Übersetzungsservice aktiviert sind.
Wenn Sie einen bestimmten Übersetzungsservice übergeben, überprüft die Methode die Methodenaktivierung für diesen Übersetzungsservice. Andernfalls überprüft die Methode den Standardübersetzungsservice.
Wenn Sie diese Methode über ein Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen „dynamicTranslation“. Zum Beispiel „dynamicTranslation.isEnabled()“. Verwenden Sie beim Aufruf über ein Plattform-Client-Skript den Klassennamen DynamicTranslation. wie DynamicTranslation.isEnabled().
| Name | Typ | Beschreibung |
|---|---|---|
| Übersetzer | Zeichenfolge | Optional. Übersetzungsservice, der verwendet werden soll, um zu überprüfen, ob die Methoden aktiv sind. Übersetzungsservices werden im Menü Übersetzerkonfiguration konfiguriert. Mögliche Werte (Groß-/Kleinschreibung beachten):
Hinweis:
Um benutzerdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Weitere Informationen finden Sie unter Integration mit einem Übersetzungsdienstanbieter. Standard: Standardübersetzungsservice. |
| Typ | Beschreibung |
|---|---|
| Batch-Erkennung | Kennzeichnung, die angibt, ob die Methode getDetectedLanguages() aktiviert ist. Mögliche Werte:
Datentyp: Boolesch |
| batchTranslation | Kennzeichnung, die angibt, ob die Methode getTranslations() aktiviert ist. Mögliche Werte:
Datentyp: Boolesch |
| Erkennung | Kennzeichnung, die angibt, ob die Methode getDetectedLanguage() aktiviert ist. Mögliche Werte:
Datentyp: Boolesch |
| Übersetzung | Kennzeichnung, die angibt, ob die Methode getTranslation() aktiviert ist. Mögliche Werte:
Datentyp: Boolesch |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die API möglicherweise zurückgibt, und Hinweise zu deren Ursache.
|
Dieses Beispiel zeigt ein Client-Skript, das überprüft, ob die DynamicTranslation- Methoden für den Microsoft-Übersetzungsservice aktiviert sind. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie „ DynamicTranslation.getTranslations“ in „dynamicTranslation.getTranslations“.
DynamicTranslation.isEnabled('Microsoft').then(function(res){console.log(res);}, function(res){console.log(res);});Ausgabe:
{"detection":true,"batchTranslation":true,"batchDetection":true,"translation":true}Dieses Beispiel zeigt ein Client-Skript, das einen Fehler auslöst, wenn ein ungültiger Übersetzungsservice übergeben wird. Um dieses Codebeispiel für ein Plattform-Client-Skript zu verwenden, ändern Sie „ DynamicTranslation.getTranslations“ in „dynamicTranslation.getTranslations“.
DynamicTranslation.isEnabled(123).then(function(res){console.log(res);}, function(res){console.log(res);});Ausgabe:
{"code":"40003","message":"Translator (\"translator\" field) is invalid"}