DynamicTranslation : Client
Die DynamicTranslation- API bietet Methoden, die Text mithilfe von Übersetzungsdienstanbietern in Echtzeit 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 Anwenderoberfläche zu schaffen, sodass eine Schnittstelle mehrere Länder bedienen kann.
Derzeit unterstützt diese API zwei Übersetzungsdienstanbieter: Microsoft Azure Translator Service und Google Cloud Translator Service. Sie können auch andere Übersetzungsservices in Ihrer Instanz konfigurieren und dann die DynamicTranslation- API zum Übersetzen Ihres Texts verwenden.
Zur Verwendung dieser API müssen Sie das Plugin „Dynamische Übersetzung“ aktivieren. Informationen zu diesem Plugin und zusätzliche Informationen zu dynamischer Übersetzung finden Sie unter Übersichtüber dynamische Übersetzung . Um diese API in einem Serviceportal -Widget zu verwenden, müssen Sie außerdem den Service „dynamicTranslation“ in die Client-Skriptfunktion des Widgets einfügen.
DynamicTranslation – getDetectedLanguage(Zeichenfolgentext, Objektparameter)
Erkennt die Sprache des übergebenen Textes.
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 Formulierungen enthalten, um eine ordnungsgemäße 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 standardmäßigen Übersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.
| Name | Typ | Beschreibung |
|---|---|---|
| text | Zeichenfolge | Zur Erkennung der Sprache zu verwendender Text. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| parms.translator | Zeichenfolge | Übersetzungsservice, der zum Erkennen der Sprache einer Zeichenfolge verwendet wird. Übersetzungsservices werden im Menü „ Übersetzerkonfiguration“ konfiguriert und befinden sich in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration]. Mögliche Werte, Groß-/Kleinschreibung nicht relevant:
Hinweis:
Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie unter Mit einem Übersetzungsserviceanbieter integrieren. Standard: In der Übersetzerkonfigurationstabelle [sn_dt_translator_configuration] konfigurierter Übersetzungsservice. |
| Typ | Beschreibung |
|---|---|
| Alternativen | Array von Objekten, die andere Sprachen beschreiben, die möglicherweise ebenfalls übereinstimmen. Datentyp: Array |
| alternatives.code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| alternatives.confidence | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| alternatives.name | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| erkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| erkannteSprache.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| erkannteSprache.Konfidenz | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zum Erkennen der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die -Methode zurückgeben kann, sowie Hinweise zur Fehlerursache.
|
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 Englisch mithilfe des Übersetzungsservice von IBM in einem Widget-Client-Skript Serviceportal erkennt. Beachten Sie, dass der Name der Klasse „dynamicTranslation“ und nicht „DynamicTranslation“ist.
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-Texte, Objektparameter)
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 Formulierungen enthalten, um eine ordnungsgemäße 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 standardmäßigen Übersetzungsservice zurück, der zum Erkennen der Sprache verwendet wird.
Wenn Sie diese Methode aus einem Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen dynamicTranslation; Beispiel : dynamicTranslation.getTranslations(). Wenn Sie es aus einem Plattform-Client-Skript aufrufen, verwenden Sie 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 wird. Übersetzungsservices werden im Menü „ Übersetzerkonfiguration“ konfiguriert und befinden sich in der Tabelle „Übersetzerkonfiguration“ [sn_dt_translator_configuration]. Mögliche Werte, Groß-/Kleinschreibung nicht relevant:
Hinweis:
Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie unter Mit einem Übersetzungsserviceanbieter integrieren. Standard: In der Übersetzerkonfigurationstabelle [sn_dt_translator_configuration] konfigurierter Übersetzungsservice. |
| Texte | Array | Liste der Textzeichenfolgen, die zum Erkennen der Sprache(n) verwendet werden. |
| Typ | Beschreibung |
|---|---|
| Erkennungen | Spracherkennung von Textzeichenfolgen. Datentyp: Objekt |
| discoverys.alternatives | Array von Objekten, die andere Sprachen beschreiben, die möglicherweise ebenfalls übereinstimmen. Datentyp: Array |
| discoverys.alternatives.code | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| discoverys.alternatives.confidence | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| detections.alternatives.name | Sprachcode der alternativen Sprache. Datentyp: Zeichenfolge |
| discoverys.detectedLanguage | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| discoverys.detectedLanguage.code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| discoverys.detectedLanguage.confidence | Gleitkommawert, der das Konfidenzniveau der alternativen Sprache angibt. Wert liegt zwischen null und eins. Je niedriger der Wert, desto niedriger ist das Konfidenzniveau. Datentyp: Zeichenfolge |
| detections.detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| discoverys.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 zum Erkennen der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die -Methode zurückgeben kann, sowie Hinweise zur Fehlerursache.
|
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 Partiellen Status 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 pars)
Übersetzt den übergebenen Text in eine oder mehrere Sprachen.
Die -Methode verwendet Übersetzungsservices wie Microsoft Azure 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 |
|---|---|---|
| textToTranslate | Zeichenfolge | Zu übersetzender Text. |
| parms | Objekt | Optional. JSON-Objekt, das zusätzliche Übersetzungsparameter enthält. |
| parms.additionalParameters | 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 bieten. |
| 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.sourceLanguage | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die für die Übersetzung des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück. Standard: Vom Anwender bevorzugte Sprache. |
| parms.translator | Zeichenfolge | Optional. Übersetzungsservice für die Übersetzung des Texts (Groß-/Kleinschreibung nicht relevant). Gültige Werte:
Hinweis:
Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie unter Mit einem Übersetzungsserviceanbieter integrieren. Standard: In der Übersetzerkonfigurationstabelle [sn_dt_translator_configuration] konfigurierter Übersetzungsservice. |
| Typ | Beschreibung |
|---|---|
| erkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| erkannteSprache.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| detectedLanguage.name | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| translations | Array von Objekten, die die Sprachübersetzungen beschreiben. Datentyp: Array |
| „translations.targetLanguage“ | Sprachcode, in den der Quelltext übersetzt wurde. Datentyp: Zeichenfolge |
| Übersetzungen.translatedText | Übersetzter Text. Datentyp: Zeichenfolge |
| Übersetzer | Übersetzungsservice, der zum Erkennen der Sprache verwendet wird. Datentyp: Zeichenfolge |
| Fehlermeldungen | Im Folgenden finden Sie Fehlermeldungen, die die -Methode zurückgibt, sowie Hinweise zu ihrer Ursache.
|
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 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 Widget-Client-Skript Serviceportal. Beachten Sie, dass der Name der Klasse „dynamicTranslation“ und nicht „DynamicTranslation“ist.
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-Texte, Objektparameter)
Übersetzt die übergebenen Textzeichenfolgen in eine oder mehrere Sprachen.
Die -Methode verwendet Übersetzungsservices wie Microsoft Azure 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 aus einem Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen dynamicTranslation; Beispiel : dynamicTranslation.getTranslations(). Wenn Sie es aus einem Plattform-Client-Skript aufrufen, verwenden Sie 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.additionalParameters | 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 bieten. |
| 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.sourceLanguage | Zeichenfolge | Optional. Sprachcode des Quelltexts. Standard: Der Übersetzungsservice erkennt die Ausgangssprache. |
| parms.targetLanguages | Array | Optional. Liste der Sprachcodes, die für die Übersetzung des Texts verwendet werden sollen. Die Methode gibt übersetzten Text für jeden Sprachcode zurück. Standard: Vom Anwender bevorzugte Sprache. |
| parms.translator | Zeichenfolge | Optional. Übersetzungsservice für die Übersetzung des Texts (Groß-/Kleinschreibung nicht relevant). Gültige Werte:
Hinweis:
Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie unter Mit einem Übersetzungsserviceanbieter integrieren. Standard: In der Übersetzerkonfigurationstabelle [sn_dt_translator_configuration] konfigurierter Übersetzungsservice. |
| Typ | Beschreibung |
|---|---|
| status | Status der Antwort auf den Methodenaufruf. Mögliche Werte:
Datentyp: Zeichenfolge |
| translations | Array von Objekten, die die Sprachübersetzungen beschreiben. Datentyp: Array |
| Übersetzungen.isError | Kennzeichnung, die angibt, ob bei der Übersetzung des Texts ein Fehler aufgetreten ist. Gültige Werte:
Datentyp: Boolesch |
| Übersetzungen.erkannteSprache | Beschreibung der erkannten Sprache. Datentyp: Objekt |
| Übersetzungen.erkannteSprache.Code | Sprachcode der erkannten Sprache. Datentyp: Zeichenfolge |
| translations.detectedLanguage.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.übersetzterText | Ü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ückgibt, sowie Hinweise zu ihrer 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 den Status „Teilweise“ zurückgibt, wenn eine der beiden übergebenen Zeichenfolgen 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, prüft die Methode die -Methodenaktivierung für diesen Übersetzungsservice. Andernfalls überprüft die Methode den Standardübersetzungsservice.
Wenn Sie diese Methode aus einem Portal-Client-Skript aufrufen, verwenden Sie den Klassennamen dynamicTranslation; wie beispielsweise dynamicTranslation.isEnabled(). Wenn Sie es aus einem Plattform-Client-Skript aufrufen, verwenden Sie den Klassennamen DynamicTranslation; wie DynamicTranslation.isEnabled().
| Name | Typ | Beschreibung |
|---|---|---|
| Übersetzer | Zeichenfolge | Optional. Übersetzungsservice, mit dem überprüft werden kann, ob die Methoden aktiv sind. Übersetzungsservices werden im Menü Übersetzerkonfiguration konfiguriert. Mögliche Werte, Groß-/Kleinschreibung nicht relevant:
Hinweis:
Um anwenderdefinierte Übersetzungsservices zu verwenden, müssen Sie den Übersetzungsservice zuerst in Ihrer Instanz konfigurieren. Einzelheiten hierzu finden Sie unter Mit einem Übersetzungsserviceanbieter integrieren. Standard: Standardübersetzungsservice. |
| Typ | Beschreibung |
|---|---|
| batchDetection | 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 zurückgibt, sowie Hinweise zu ihrer 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"}