Dienste für maschinelle Übersetzung in SharePoint
Erfahren Sie mehr über Dienst für maschinelle Übersetzung, eine neue Dienstanwendung in SharePoint , die eine automatische maschinelle Übersetzung von Dateien und Websites bietet.
Dienst für maschinelle Übersetzung-Übersicht
Hinweis
- Im September 2018 wurde angekündigt, dass die Dienste für maschinelle Übersetzungen in SharePoint für Microsoft 365 eingestellt, aber weiterhin unterstützt werden. Dieser Dienst wird ab Ende Juli 2022 vollständig eingestellt und nicht mehr unterstützt.
- Die API des Diensts für maschinelle Übersetzung wurde als veraltet gekennzeichnet und steht über SharePoint-CSOM nicht mehr zur Verfügung.
- Alle vorhandenen Instanzen der APIs des Diensts für maschinelle Übersetzung zeigen in Ihrer Microsoft 365 Umgebung ab Ende Juli 2022 keine mehrsprachigen Funktionen mehr an.
- Dieser Artikel wird im Dezember 2022 eingestellt.
- Wenn Sie moderne Kommunikationswebsites in SharePoint verwenden, empfiehlt es sich, anstelle des Features für maschinelle Übersetzungsdienste das Feature für moderne mehrsprachige Websites und Seiten zu verwenden.
Dienst für maschinelle Übersetzung ist eine neue Dienstanwendung in SharePoint, die eine automatische maschinelle Übersetzung von Dateien und Websites bietet. Wenn die Anwendung für maschinelle Übersetzungsdienste eine Übersetzungsanforderung verarbeitet, leitet sie die Anforderung an den in der Cloud gehosteten maschinellen Übersetzungsdienst von Microsoft Translator weiter, wo die eigentliche Übersetzungsarbeit ausgeführt wird. Dieser Clouddienst betreibt auch die Microsoft Office-, Lync-, Yammer und Bing-Übersetzungsfeatures.
Die Machine Translation Service-Anwendung verarbeitet Übersetzungsanforderungen asynchron und synchron. Asynchrone Übersetzungsanforderungen werden verarbeitet, wenn der Übersetzungszeitgeberauftrag ausgeführt wird. Das Standardintervall des Übersetzungszeitgeberauftrags beträgt 15 Minuten. Sie können diese Einstellung in der Zentraladministration oder mithilfe von Windows PowerShell verwalten. Sie können auch festlegen, dass der Timer sofort ausgeführt wird, indem Sie den folgenden Befehl verwenden:
$tj = get-sptimerjob "SharePoint Translation Services"
$tj.Runnow()
Synchrone Übersetzungsanforderungen werden verarbeitet, sobald sie gesendet werden.
Gemeinsam genutzte Komponenten mit Word Automation Services
Die Dienst für maschinelle Übersetzung-Architektur verwendet mehrere Komponenten der Microsoft Word Automation Services-Architektur. Weitere Informationen zur Word Automation Services-Architektur finden Sie unter Word Automation Services-Architektur.
Das Dienst für maschinelle Übersetzung-Objektmodell ist dem Word Automation Services-Objektmodell nachgebildet, wenn Sie also mit der Word Automation Services-Programmierung vertraut sind, werden Sie Ähnlichkeiten mit der Programmierung mit dem Dienst für maschinelle Übersetzung-Objektmodell feststellen.
Verwenden des Dienst für maschinelle Übersetzung-Serverobjektmodells
Anwendungen, die das Serverobjektmodell nutzen, müssen direkt auf einem Server mit SharePoint ausgeführt werden. Informationen zum Erstellen von Anwendungen, die remote gehostet werden können, finden Sie weiter unten in diesem Thema unter Verwenden des Clientobjektmodells für maschinelle Übersetzungsdienste . Das Dienst für maschinelle Übersetzung-Serverobjektmodell befindet sich im Microsoft.Office.TranslationServices-Namespace, der sich in "Microsoft.Office.TranslationServices.dll" befindet.
Mithilfe des Serverobjektmodells können Sie Anforderungen an die Dienst für maschinelle Übersetzung-Anwendung asynchron oder synchron (für sofortige Übersetzung) übermitteln. Die Dienst für maschinelle Übersetzung-Anwendung weist zwei Arbeitswarteschlangen für das Speichern von Übersetzungsanforderungen auf: die asynchrone Warteschlange und die synchrone Warteschlange. Anfoderungen in der synchronen Warteschlange werden mit höherer Priorität behandelt und vor Anforderungen in der asynchronen Warteschlange übersetzt. Die Anforderungen werden basierend auf der von Ihnen verwendeten Klasse an eine der beiden Warteschlangen weitergeleitet.
Beispielcode, der die Verwendung des Serverobjektmodells über eine Konsolenanwendung veranschaulicht, finden Sie unter SharePoint: Zugreifen auf den maschinellen Übersetzungsdienst mithilfe des Serverobjektmodells.
Asynchrone Übersetzung mithilfe des Serverobjektmodells
Die TranslationJob-Klasse definiert einen Satz von zu übersetzenden Elementen. Dies kann eine einzelne Datei oder jede Datei in einem Ordner oder eine Dokumentbibliothek sein. Übersetzungsaufträge, die auf diese Weise übermittelt werden, werden in der Übersetzungsdatenbank gespeichert. Bei jeder Ausführung des Übersetzungszeitgeberauftrags werden einige Aufträge aus der Übersetzungsdatenbank genommen und für die Übersetzung zu der asynchronen Warteschlange hinzugefügt. Das Standardinterall des Übersetzungszeitgeberauftrags beträgt 15 Minuten.
Der folgende Code zeigt, wie eine einzelne Datei asynchron übersetzt wird.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
TranslationJob job = new TranslationJob(sc, CultureInfo.GetCultureInfo(culture));
job.AddFile(input, output);
job.Start();
Der folgende Code zeigt, wie jede Datei in einem Ordner asynchron übersetzt wird.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
TranslationJob job = new TranslationJob(sc, CultureInfo.GetCultureInfo(culture));
using (SPSite siteIn = new SPSite(inputFolder))
{
using (SPWeb webIn = siteIn.OpenWeb())
{
using (SPWeb webOut = siteOut.OpenWeb())
{
SPFolder folderIn = webIn.GetFolder(inputFolder);
SPFolder folderOut = webOut.GetFolder(outputFolder);
job.AddFolder(folderIn, folderOut, true);
job.Start();
}
}
}
Der folgende Code zeigt, wie jede Datei in einer Dokumentbibliothek asynchron übersetzt wird.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
TranslationJob job = new TranslationJob(sc, CultureInfo.GetCultureInfo(culture));
using (SPSite siteIn = new SPSite(inputList))
{
using (SPWeb webIn = siteIn.OpenWeb())
{
using (SPSite siteOut = new SPSite(outputList))
{
using (SPWeb webOut = siteOut.OpenWeb())
{
SPDocumentLibrary listIn = (SPDocumentLibrary)webIn.GetList(inputList);
SPDocumentLibrary listOut = (SPDocumentLibrary)webOut.GetList(outputList);
job.AddLibrary(listIn, listOut);
job.Start();
}
}
}
}
Synchrone Übersetzung mithilfe des Serverobjektmodells
Sie verwenden die SyncTranslator-Klasse, um eine sofortige Übersetzung für Dateien und Streams anzufordern. Übersetzungsanforderungen, die mithilfe dieser Klasse erfolgen, werden nicht auf die gleiche Art und Weise weitergeleitet wie Anforderungen mithilfe der TranslationJob-Klasse. Sie werden unmittelbar der synchronen Warteschlange für die Bearbeitung hinzugefügt. Die TranslationItemInfo-Klasse enthält die Details für eine einzelne Datei, die von Dienst für maschinelle Übersetzung übersetzt wird. Die SyncTranslator.Translate-Methode gibt eine Instanz dieser Klasse in synchronen Übersetzungsaufträgen zurück.
Der folgende Code zeigt, wie eine einzelne Datei synchron übersetzt wird.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
SyncTranslator job = new SyncTranslator(sc, CultureInfo.GetCultureInfo(jobCulture));
TranslationItemInfo itemInfo = job.Translate(input, output);
Der folgende Code zeigt, wie ein Stream synchron übersetzt wird.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
SyncTranslator job = new SyncTranslator(sc, CultureInfo.GetCultureInfo(jobCulture));
FileStream inputStream = new FileStream(input, FileMode.Open);
FileStream outputStream = new FileStream(output, FileMode.Create);
TranslationItemInfo itemInfo = job.Translate(inputStream, outputStream, fileFormat);
inputStream.Close();
outputStream.Flush();
outputStream.Close();
Der folgende Code zeigt, wie eine Bytesequenz synchron übersetzt wird.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
SyncTranslator job = new SyncTranslator(sc, CultureInfo.GetCultureInfo(jobCulture));
Byte[] inputByte;
Byte[] outputByte;
inputByte = File.ReadAllBytes(input);
outputByte = null;
TranslationItemInfo itemInfo = job.Translate(inputByte, out outputByte, fileFormat);
FileStream outputStream = File.Open(output, FileMode.Create);
MemoryStream memoryStream = new MemoryStream(outputByte);
memoryStream.WriteTo(outputStream);
outputStream.Flush();
outputStream.Close();
Berechtigungen
Wenn der Benutzer, für den die Übersetzungsanforderung ausgeführt wird, auf die zu übersetzende Datei zugreifen kann, und dieser Benutzer auf den Ausgabeort der Datei zugreifen kann, so führt der Benutzer die Sicherheitsüberprüfung durch, und die Datei wird übersetzt.
Verwenden des Dienst für maschinelle Übersetzung-Clientobjektmodells
Dienst für maschinelle Übersetzung umfasst auch ein Clientobjektmodell (CSOM), das Zugriff auf die Dienst für maschinelle Übersetzung-API für Online-, lokale und mobile Entwicklung ermöglicht. Clientanwedungen können das CSOM verwenden, um auf Serverinhalte und -funktionen zuzugreifen. Das CSOM implementiert einen Großteil der Übersetzungsfunktionalität des Servers, das CSOM und das serverseitige Objektmodell verfügen jedoch nicht über eine 1:1-Parität. Die asynchrone Übersetzung einzelner Dateien sowie von Dateien in einer Dokumentbibliothek oder in einem Ordner wird unterstützt. Die synchrone Übersetzung von Dateien wird unterstützt, Dateistreams werden jedoch nicht unterstützt.
Das Dienst für maschinelle Übersetzung-CSOM umfasst ein .NET-verwaltetes clientseitiges Objektmodell sowie Microsoft Silverlight- und JavaScript-Objektmodelle. Es basiert auf dem SharePoint-CSOM. Deshalb greift Clientcode zuerst auf das SharePoint-CSOM und dann auf das Dienst für maschinelle Übersetzung-CSOM zu.
Weitere Informationen zu SharePoint-CSOM finden Sie unter Verwaltetes Clientobjektmodell. Weitere Informationen zum ClientContext -Objekt, das den Einstiegspunkt für das CSOM ist, finden Sie unter Clientkontext als zentrales Objekt.
In Tabelle 1 sind die äquivalenten Objekte dargestellt, die die CSOM-APIs für die Dienst für maschinelle Übersetzung-Serverobjekte bereitstellen.
Tabelle 1. Serverobjektmodell-APIs und die entsprechenden CSOMs
| Server | .NET-verwaltet und Silverlight | JavaScript |
|---|---|---|
| Microsoft.Office.TranslationServices.TranslationJob |
Microsoft.Office.TranslationServices.Client.TranslationJob |
SP.Translation.TranslationJob |
| Microsoft.Office.TranslationServices.TranslationJobInfo |
Microsoft.Office.TranslationServices.Client.TranslationJobInfo |
SP.Translation.TranslationJobInfo |
| Microsoft.Office.TranslationServices.TranslationItemInfo |
Microsoft.Office.TranslationServices.Client.TranslationItemInfo |
SP.Translation.TranslationItemInfo |
| Microsoft.Office.TranslationServices.TranslationJobStatus |
Microsoft.Office.TranslationServices.Client.TranslationJobStatus |
SP.Translation.TranslationJobStatus |
| Microsoft.Office.TranslationServices.SyncTranslator |
Microsoft.Office.TranslationServices.Client.SyncTranslator |
SP.Translation.SyncTranslator |
Dienst für maschinelle Übersetzung .NET-verwaltetes CSOM und Silverlight-CSOM
Rufen Sie für CSOM, das von .NET verwaltet wird, eine ClientContext-Instanz ab (diese befindet sich Microsoft.SharePoint.Client-Namespace in der Microsoft.SharePoint.Client.dll). Verwenden Sie dann das Objektmodell im Microsoft.Office.TranslationServices.Client-Namespace in der "Microsoft.Office.TranslationServices.Client.dll".
Beispielcode zur Veranschaulichung der Verwendung des verwalteten .NET-CSOMs finden Sie unter SharePoint: Zugreifen auf den maschinellen Übersetzungsdienst mithilfe des Clientobjektmodells.
Rufen Sie für das Silverlight-CSOM eine ClientContext-Instanz ab (diese befindet sich im Microsoft.SharePoint.Client-Namespace in der "Microsoft.SharePoint.Client.Silverlight.dll"). Verwenden Sie dann das Objektmodell im Microsoft.Office.TranslationServices.Client-Namespace in der "Microsoft.Office.TranslationServices.Silverlight.dll".
Beispielcode zur Veranschaulichung der Verwendung des Silverlight-CSOMs finden Sie unter SharePoint: Zugreifen auf den maschinellen Übersetzungsdienst über die Silverlight-Anwendung.
So übersetzen Sie eine einzige Datei asynchron
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
string culture = "cultureID";
string name = "translationJobName";
string inputFile = "http://serverName/path/inputFileName";
string outputFile = "http://serverName/path/outputFileName";
TranslationJob job = new TranslationJob(clientContext , culture);
job.AddFile(inputFile , outputFile);
job.Name = name;
job.Start();
clientContext.Load(job);
clientContext.ExecuteQuery();
//To retrieve the translation job ID.
string jobID = job.JobId;
So übersetzen Sie einen Ordner asynchron
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
string culture = "cultureID";
string name = "translationJobName";
string inputFolder = clientContext.Web.GetFolderByServerRelativeUrl("inFolderPath");
string outputFolder = clientContext.Web.GetFolderByServerRelativeUrl("outFolderPath");
TranslationJob job = new TranslationJob(clientContext , culture);
job.AddFolder(inputFolder, outputFolder, true);
job.Name = name;
job.Start();
clientContext.Load(job);
clientContext.ExecuteQuery();
//To retrieve the translation job ID.
string jobID = job.JobId;
So übersetzen Sie eine Bibliothek asynchron
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
string culture = "cultureID";
string name = "translationJobName";
string inputLibrary = clientContext.Web.Lists.GetByTitle("inputLibraryName");
string outputLibrary = clientContext.Web.Lists.GetByTitle("outputLibraryName");
TranslationJob job = new TranslationJob(clientContext , culture);
job.AddFolder(inputLibrary , outputLibrary , true);
job.Name = name;
job.Start();
clientContext.Load(job);
clientContext.ExecuteQuery();
//To retrieve the translation job ID.
string jobID = job.JobId;
So übersetzen Sie eine einzige Datei synchron
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
string culture = "cultureID"
string inputFile = "http://serverName/path/inputFileName";
string outputFile = "http://serverName/path/outputFileName";
SyncTranslator job = new SyncTranslator(clientContext , culture);
job.OutputSaveBehavior = SaveBehavior.AlwaysOverwrite;
ClientResult<TranslationItemInfo> cr = job.Translate(inputFile, outputFile );
clientContext.ExecuteQuery();
//To retrieve additional information about the translation job.
string errorCode = clientContext.Value.ErrorCode;
string errorMessage = clientContext.Value.ErrorMessage;
string translateID = clientContext.Value.TranslationId;
string succeedResult = clientContext.Value.Succeeded;
string failResult = clientContext.Value.Failed;
string cancelStatus = clientContext.Value.Canceled;
string inProgressStatus = clientContext.Value.InProgress;
string notStartedStatus = clientContext.Value.NotStarted;
So rufen Sie alle Sprachen ab, die von Dienst für maschinelle Übersetzung unterstützt werden:
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
IEnumerable<string> supportedLanguages = TranslationJob.EnumerateSupportedLanguages(clientContext);
clientContext.ExecuteQuery();
foreach (string item in supportedLanguages)
{
Console.Write(item + ", ");
}
So überprüfen Sie, ob eine bestimmte Sprache unterstützt wird
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
clientResult<bool> isSupported;
isSupported = TranslationJob.IsLanguageSupported(clientContext, "language");
clientContext.ExecuteQuery();
So rufen Sie alle Dateinamenerweiterungen ab, die von Dienst für maschinelle Übersetzung unterstützt werden:
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
IEnumerable<string> fileExt = TranslationJob.EnumerateSupportedFileExtensions(clientContext);
clientContext.ExecuteQuery();
foreach (string item in fileExt)
{
Console.Write(item + ", ");
}
So überprüfen Sie, ob eine bestimmte Dateinamenerweiterung unterstützt wird
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
clientResult<bool> isSupported;
isSupported = TranslationJob.IsFileExtensionSupported(clientContext, "fileExtension");
clientContext.ExecuteQuery();
So überprüfen Sie die maximale Dateigröße für eine bestimmte Dateinamenerweiterung
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
clientResult<int> maxSize;
maxSize = TranslationJob.GetMaximumFileSize(clientContext, "fileExtension");
clientContext.ExecuteQuery();
Dienst für maschinelle Übersetzung JavaScript-CSOM
Rufen Sie für das JavaScript-CSOM eine SP.ClientContext-Instanz ab, und verwenden Sie dann das Objektmodell in der Datei "SP.Translation.js".
Beispielcode, der die Verwendung des JavaScript-CSOM veranschaulicht, finden Sie unter SharePoint: Zugreifen auf den maschinellen Übersetzungsdienst mit JavaScript.
So übersetzen Sie eine einzige Datei asynchron
var asyncJob;
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
asyncJob = SP.Translation.TranslationJob.newObject(clientContext, "cultureID");
asyncJob.set_outputSaveBehavior(SP.Translation.SaveBehavior.alwaysOverwrite);
asyncJob.addFile("inputFilePath", "outputFilePath");
asyncJob.set_name("translationJobName");
asyncJob.start();
clientContext.load(asyncJob);
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceededASync),Function.createDelegate(this, this.onQueryFailed));
So übersetzen Sie einen Ordner asynchron
var asyncJob;
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
asyncJob = SP.Translation.TranslationJob.newObject(clientContext, "cultureID");
asyncJob.set_outputSaveBehavior(SP.Translation.SaveBehavior.alwaysOverwrite);
var inputFolder = clientContext.get_web().getFolderByServerRelativeUrl("inputFilePath");
var outputFolder = clientContext.get_web().getFolderByServerRelativeUrl("outputFilePath");
asyncJob.addFolder(inputFolder, outputFolder, true);
asyncJob.set_name("translationJobName");
asyncJob.start();
clientContext.load(asyncJob);
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceededASync),Function.createDelegate(this, this.onQueryFailed));
So übersetzen Sie eine Bibliothek asynchron
var asyncJob;
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
asyncJob = SP.Translation.TranslationJob.newObject(clientContext, "cultureID");
asyncJob.set_outputSaveBehavior(SP.Translation.SaveBehavior.alwaysOverwrite);
var inputLibrary= clientContext.get_web().get_lists().getByTitle("inputFilePath");
var outputLibrary= clientContext.get_web().get_lists().getByTitle("outputFilePath");
asyncJob.addLibrary(inputLibrary, outputLibrary);
asyncJob.set_name("translationJobName");
asyncJob.start();
clientContext.load(asyncJob);
clientContext.executeQueryAsync(Function.createDelegate(this,this.onQuerySucceededASync),Function.createDelegate(this, this.onQueryFailed));
So übersetzen Sie eine einzige Datei synchron
var result;
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
var job = SP.Translation.SyncTranslator.newObject(clientContext, "cultureID");
job.set_outputSaveBehavior(SP.Translation.SaveBehavior.alwaysOverwrite);
result = job.translate("inputFilePath", "outputFilePath");
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceededSync),
Function.createDelegate(this, this.onQueryFailed));
So rufen Sie alle Sprachen ab, die von Dienst für maschinelle Übersetzung unterstützt werden:
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
var result= SP.Translation.TranslationJob.enumerateSupportedLanguages(clientContext);
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceededListAllLang),Function.createDelegate(this, this.onQueryFailed));
So überprüfen Sie, ob eine bestimmte Sprache unterstützt wird
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
var result= SP.Translation.TranslationJob.isLanguageSupported(clientContext," language");
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceededTestLang),Function.createDelegate(this, this.onQueryFailed));
So rufen Sie alle Dateinamenerweiterungen ab, die von Dienst für maschinelle Übersetzung unterstützt werden:
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
var result= SP.Translation.TranslationJob.enumerateSupportedFileExtensions(clientContext);
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceededListAllFileExt),Function.createDelegate(this, this.onQueryFailed));
So überprüfen Sie, ob eine bestimmte Dateinamenerweiterung unterstützt wird
var clientContext = new SP.ClientContext("serverRelativeUrl");
var contextSite = clientContext.get_site();
var result= SP.Translation.TranslationJob.isFileExtensionSupported(clientContext," fileExtension");
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceededTestFileExt),Function.createDelegate(this, this.onQueryFailed));
Dienst für maschinelle Übersetzung-REST-Dienst
SharePoint umfasst einen REST-Dienst (Representational State Transfer), mit dem Sie remote mit der Dienst für maschinelle Übersetzung-Anwendung unter Verwendung einer Technologie interagieren können, die REST-Webanforderungen unterstützt. Allgemeine Informationen zu REST in SharePoint finden Sie unter Verwenden von OData-Abfragevorgängen in SharePoint-REST-Anforderungen.
Asynchrone Übersetzungs-REST-API
Die REST-API für die asynchrone Übersetzung ist wie folgt:
http://serverName/_api/TranslationJob('language')
So übersetzen Sie eine einzige Datei asynchron
http://serverName/_api/TranslationJob('language')/TranslateFile(inputFile='/path/intput file', outputFile='/path/output file')
So übersetzen Sie einen Ordner asynchron
http://serverName/_api/TranslationJob('language')/TranslateFolder(inputFolder='/path/in', outputFolder='/path/out')
So übersetzen Sie eine Bibliothek asynchron
http://serverName/_api/TranslationJob('language')/TranslateLibrary(inputLibrary='/LibraryName', outputLibrary='/LibraryName'')
Synchrone Übersetzungs-REST-API
Der Dienst für maschinelle Übersetzung-REST-Dienst unterstützt nur die synchrone Übersetzung von Dateien. Die API hierfür ist wie folgt:
http://serverName/_api/SyncTranslator('language')/Translate(outputFile='/path/output file', inputFile='/path/input file')
Zusätzliche Dienst für maschinelle ÜbersetzungREST-APIs
Der Dienst für maschinelle Übersetzung-REST-Dienst umfasst zusätzliche APIs, die Sie zum Abrufen von Informationen zu den Dienst für maschinelle Übersetzung-Anwendungsfunktionen und zum Status des Übersetzungsauftrags verwenden können.
So rufen Sie alle Sprachen ab, die von Dienst für maschinelle Übersetzung unterstützt werden
http://serverName/_api/TranslationJob.EnumerateSupportedLanguages
So überprüfen Sie, ob eine bestimmte Sprache unterstützt wird
http://serverName/_api/TranslationJob.IsLanguageSupported('language')
So rufen Sie alle Dateinamenerweiterungen ab, die von Dienst für maschinelle Übersetzung unterstützt werden
http://serverName/_api/TranslationJob.EnumerateSupportedFileEXtensions
So überprüfen Sie, ob eine bestimmte Dateinamenerweiterung unterstützt wird
http://serverName/_api/TranslationJob.IsFileExtensionSupported('extension')
So überprüfen Sie die maximale Dateigröße für eine bestimmte Dateinamenerweiterung
http://serverName/_api/TranslationJob.GetMaximumFileSize('extension')
So rufen Sie eine Liste aller asynchronen Übersetzungsaufträge ab
http://serverName/_api/TranslationJobStatus.GetAllJobs
So rufen Sie eine Liste aller aktiven asynchronen Übersetzungsaufträge ab
http://serverName/_api/TranslationJobStatus.GetAllActiveJobs
So rufen Sie die Dokumentinformationen für einen bestimmten asynchronen Übersetzungsauftrag ab
http://serverName/_api/TranslationJobStatus('jobid')/GetAllItems
So rufen Sie einen asynchronen Übersetzungsauftrag ab
http://serverName/_api/TranslationJob.CancelJob('jobid')
Anforderungen für Microsoft Word-Dokumente
Der SharePoint-Dienst für maschinelle Übersetzungen verwendet beim Übersetzen von Microsoft Word-Dokumenten die Sprache des Absatzes als Ausgangssprache. Wenn der Absatz beispielsweise in Spanisch geschrieben wurde, die Sprache für den Absatz jedoch auf Englisch festgelegt ist, übersetzt der Übersetzungsdienst den Absatz nicht ins Englische. Dies kommt daher, dass der Absatz bereits auf Englisch festgelegt ist.
Gehen Sie wie folgt vor, um die Sprache des Absatzes festzulegen:
Markieren Sie den Absatz.
Klicken Sie im Menüband auf die Registerkarte „Überprüfen“.
Klicken Sie im Dropdownmenü auf „Sprache“, und wählen Sie „Sprache für die Korrekturhilfen festlegen“.