Службы машинного перевода в SharePoint
Узнайте о службе машинного перевода — новом приложении службы в SharePoint, выполняющем автоматический машинный перевод файлов и сайтов.
Обзор службы машинного перевода
Примечание.
- В сентябре 2018 г. было объявлено, что службы машинного перевода станут нерекомендуемыми в SharePoint для Microsoft 365, но продолжат поддерживаться. Эта служба станет недоступной и полностью неподдерживаемой к концу июля 2022 г.
- API службы машинного перевода помечен как нерекомендуемый и будет недоступен в CSOM SharePoint.
- Все существующие экземпляры API сервера машинного перевода перестанут отображать многоязычные функции в среде Microsoft 365 к концу июля 2022 г.
- Эта статья будет удалена в декабре 2022 г.
- Если вы используете современные информационные сайты в SharePoint, рекомендуется использовать современные многоязычные сайты и страницы вместо функции службы машинного перевода вариантов.
Служба машинного перевода — новое приложение службы в SharePoint, выполняющее автоматический машинный перевод файлов и сайтов. Когда приложение Службы машинного перевода обрабатывает запрос на перевод, оно перенаправит его в службу машинного перевода, размещенную в облаке Microsoft Translator , где выполняется фактическая работа по переводу. Эта облачная служба также обеспечивает перевод в Microsoft Office, Lync, Yammer и Bing.
Приложение службы машинного перевода обрабатывает запросы на перевод в асинхронном и синхронном режимах. Асинхронные запросы на перевод обрабатываются при выполнении задания таймера. Интервал задания таймера по умолчанию составляет 15 минут. Вы можете изменить этот параметр в Центре администрирования или с помощью Windows PowerShell. Вы также можете задать немедленное выполнение таймера, используя следующую команду:
$tj = get-sptimerjob "SharePoint Translation Services"
$tj.Runnow()
Синхронные запросы на перевод обрабатываются по мере их отправки.
Общие компоненты с Word Automation Services
У архитектуры службы машинного перевода несколько общих компонентов с архитектурой Microsoft Word Automation Services. Дополнительные сведения об архитектуре Word Automation Services см. в статье Архитектура Служб автоматизации Word.
Объектная модель службы машинного перевода похожа на объектную модель Word Automation Services.
Использование серверной объектной модели службы машинного перевода
Приложения, которые используют серверную объектную модель, должны выполняться непосредственно на сервере с SharePoint. Сведения о создании приложений, которые можно разместить удаленно, см. в разделе Использование клиентской объектной модели служб машинного перевода далее в этом разделе. Серверная объектная модель службы машинного перевода находится в пространстве имен Microsoft.Office.TranslationServices в Microsoft.Office.TranslationServices.dll.
Серверная объектная модель позволяет отправлять запросы в приложение службы машинного перевода в асинхронном или синхронном режиме (для мгновенного перевода). Приложение службы машинного перевода включает две рабочих очереди для хранения запросов на перевод: асинхронную и синхронную. Запросы в синхронной очереди имеют более высокий приоритет и переводятся раньше, чем запросы в асинхронной очереди. Запросы направляются в одну из этих очередей в зависимости от используемого класса.
Пример кода, демонстрирующий использование серверной объектной модели из консольного приложения, см. в статье SharePoint: доступ к службе машинного перевода с помощью серверной объектной модели.
Асинхронный перевод с помощью серверной объектной модели
Класс TranslationJob определяет набор элементов, которые необходимо перевести. Это может быть один или все файлы в папке либо библиотеке документов. Задания на перевод, которые отправляются таким образом, хранятся в базе данных переводов. Всякий раз, когда выполняется задание таймера для перевода, несколько заданий из базы данных переводов добавляются в асинхронную очередь для перевода. Интервал по умолчанию для такого задания таймера составляет 15 минут.
Ниже показано, как выполнить асинхронный перевод одного файла.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
TranslationJob job = new TranslationJob(sc, CultureInfo.GetCultureInfo(culture));
job.AddFile(input, output);
job.Start();
Приведенный ниже код показывает, как выполнять асинхронный перевод для всех файлов в папке.
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();
}
}
}
Приведенный ниже код показывает, как выполнять асинхронный перевод для всех файлов в библиотеке документов.
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();
}
}
}
}
Синхронный перевод с помощью серверной объектной модели
С помощью класса SyncTranslator можно запрашивать мгновенный перевод файлов и потоков. Маршрутизация этих запросов отличается от маршрутизации запросов, выполняемых с помощью класса TranslationJob. Они немедленно добавляются в синхронную очередь для обработки. Класс TranslationItemInfo содержит сведения об одном элементе, переводимом службой машинного перевода. Метод SyncTranslator.Translate возвращает экземпляр этого класса в заданиях синхронного перевода.
Ниже показано, как выполнить синхронный перевод одного файла.
SPServiceContext sc = SPServiceContext.GetContext(new SPSite(site));
SyncTranslator job = new SyncTranslator(sc, CultureInfo.GetCultureInfo(jobCulture));
TranslationItemInfo itemInfo = job.Translate(input, output);
Приведенный ниже код показывает, как выполнять синхронный перевод для потока.
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();
Приведенный ниже код показывает, как выполнять синхронный перевод для последовательности байтов.
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();
Разрешения
Если пользователь, для которого выполняется задание перевода, может получить доступ к файлу, который нужно перевести, и расположению соответствующих выходных данных, пользователь отменяет проверку безопасности, и выполняется перевод.
Использование клиентской объектной модели службы машинного перевода
Служба машинного перевода также включает клиентскую объектную модель (CSOM), которая обеспечивает доступ к API для разработки интернет-, локальных и мобильных приложений. Клиентские приложения могут использовать CSOM для доступа к контенту и функциям сервера. При этом большинство функций перевода реализуются на сервере, но CSOM все же отличается от серверной объектной модели. Поддерживается асинхронный перевод отдельных файлов и файлов в библиотеке документов или папке. Синхронный перевод файлов поддерживается, а файловых потоков — нет.
CSOM службы машинного перевода включает управляемую клиентскую объектную модель .NET, а также объектные модели Microsoft Silverlight и JavaScript. Она встроена в CSOM SharePoint. Поэтому клиентский код сначала получает доступ к CSOM SharePoint, а затем к CSOM службы машинного перевода.
Дополнительные сведения о SharePoint CSOM можно Управляемая клиентская объектная модель. Дополнительные сведения об объекте ClientContext, представляющем собой точку входа в CSOM, см. в статье Контекст клиента как центральный объект.
В таблице 1 показаны эквивалентные объекты, предоставляемые API CSOM для серверных объектов службы машинного перевода.
Таблица 1. Интерфейсы API серверной объектной модели и их эквиваленты CSOM
| Сервер | Управляемая модель .NET и 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 |
Управляемая CSOM .NET службы машинного перевода и CSOM Silverlight
Управляемая CSOM .NET: получите экземпляр ClientContext (расположенный в пространстве имен Microsoft.SharePoint.Client в Microsoft.SharePoint.Client.dll). Затем воспользуйтесь объектной моделью в пространстве имен Microsoft.Office.TranslationServices.Client из Microsoft.Office.TranslationServices.Client.dll.
Пример кода, демонстрирующий использование управляемой CSOM .NET, см. в статье SharePoint: доступ к службе машинного перевода с помощью клиентской объектной модели.
CSOM Silverlight: получите экземпляр ClientContext (расположенный в пространстве имен Microsoft.SharePoint.Client в Microsoft.SharePoint.Client.Silverlight.dll). Затем воспользуйтесь объектной моделью в пространстве имен Microsoft.Office.TranslationServices.Client из Microsoft.Office.TranslationServices.Silverlight.dll.
Пример кода, демонстрирующий использование CSOM Silverlight, см. в статье SharePoint: доступ к службе машинного перевода из приложения Silverlight.
Чтобы выполнить асинхронный перевод одного файла:
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;
Чтобы выполнить асинхронный перевод для папки:
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;
Чтобы выполнить асинхронный перевод для библиотеки:
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;
Чтобы выполнить синхронный перевод одного файла:
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;
Чтобы получить все языки, поддерживаемые службой машинного перевода:
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
IEnumerable<string> supportedLanguages = TranslationJob.EnumerateSupportedLanguages(clientContext);
clientContext.ExecuteQuery();
foreach (string item in supportedLanguages)
{
Console.Write(item + ", ");
}
Чтобы проверить, поддерживается ли конкретный язык:
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
clientResult<bool> isSupported;
isSupported = TranslationJob.IsLanguageSupported(clientContext, "language");
clientContext.ExecuteQuery();
Чтобы получить все расширения имен файлов, поддерживаемые службой машинного перевода:
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
IEnumerable<string> fileExt = TranslationJob.EnumerateSupportedFileExtensions(clientContext);
clientContext.ExecuteQuery();
foreach (string item in fileExt)
{
Console.Write(item + ", ");
}
Чтобы проверить, поддерживается ли конкретное расширение имени файла:
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
clientResult<bool> isSupported;
isSupported = TranslationJob.IsFileExtensionSupported(clientContext, "fileExtension");
clientContext.ExecuteQuery();
Чтобы проверить ограничение на размер файла для конкретного расширения:
ClientContext clientContext = new ClientContext("http://serverName/sites/siteCollectionPath");
clientResult<int> maxSize;
maxSize = TranslationJob.GetMaximumFileSize(clientContext, "fileExtension");
clientContext.ExecuteQuery();
CSOM JavaScript службы машинного перевода
Получите экземпляр SP.ClientContext, а затем воспользуйтесь объектной моделью в файле SP.Translation.js.
Пример кода, демонстрирующий использование CSOM JavaScript, см. в статье SharePoint: доступ к службе машинного перевода с помощью JavaScript.
Чтобы выполнить асинхронный перевод одного файла:
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));
Чтобы выполнить асинхронный перевод для папки:
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));
Чтобы выполнить асинхронный перевод для библиотеки:
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));
Чтобы выполнить синхронный перевод одного файла:
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));
Чтобы получить все языки, поддерживаемые службой машинного перевода:
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));
Чтобы проверить, поддерживается ли конкретный язык:
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));
Чтобы получить все расширения имен файлов, поддерживаемые службой машинного перевода:
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));
Чтобы проверить, поддерживается ли конкретное расширение имени файла:
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));
Служба REST службы машинного перевода
SharePoint включает службу передачи репрезентативного состояния (REST), позволяющую удаленно управлять приложением службы машинного перевода с помощью любой технологии, которая поддерживает веб-запросы REST. Общие сведения о REST в SharePoint см. в статье Использование операций запросов OData в запросах REST SharePoint.
REST API для асинхронного перевода
REST API для асинхронного перевода:
http://serverName/_api/TranslationJob('language')
Чтобы выполнить асинхронный перевод одного файла:
http://serverName/_api/TranslationJob('language')/TranslateFile(inputFile='/path/intput file', outputFile='/path/output file')
Чтобы выполнить асинхронный перевод для папки:
http://serverName/_api/TranslationJob('language')/TranslateFolder(inputFolder='/path/in', outputFolder='/path/out')
Чтобы выполнить асинхронный перевод библиотеки:
http://serverName/_api/TranslationJob('language')/TranslateLibrary(inputLibrary='/LibraryName', outputLibrary='/LibraryName'')
REST API для синхронного перевода
Служба REST службы машинного перевода поддерживает только синхронный перевод файлов. Соответствующий API:
http://serverName/_api/SyncTranslator('language')/Translate(outputFile='/path/output file', inputFile='/path/input file')
Дополнительные REST API службы машинного перевода
Служба REST службы машинного перевода включает дополнительные API, которые позволяют получить информацию о возможностях приложения службы машинного перевода и состоянии задания на перевод.
Чтобы получить все языки, поддерживаемые службой машинного перевода:
http://serverName/_api/TranslationJob.EnumerateSupportedLanguages
Чтобы проверить, поддерживается ли конкретный язык:
http://serverName/_api/TranslationJob.IsLanguageSupported('language')
Чтобы получить все расширения имени файла, поддерживаемые службой машинного перевода:
http://serverName/_api/TranslationJob.EnumerateSupportedFileEXtensions
Чтобы проверить, поддерживается ли конкретное расширение имени файла:
http://serverName/_api/TranslationJob.IsFileExtensionSupported('extension')
Чтобы проверить ограничение на размер файла для конкретного расширения:
http://serverName/_api/TranslationJob.GetMaximumFileSize('extension')
Чтобы получить список всех заданий на асинхронный перевод:
http://serverName/_api/TranslationJobStatus.GetAllJobs
Чтобы получить список всех активных заданий на асинхронный перевод:
http://serverName/_api/TranslationJobStatus.GetAllActiveJobs
Чтобы получить информацию о конкретном задании на асинхронный перевод:
http://serverName/_api/TranslationJobStatus('jobid')/GetAllItems
Чтобы отменить задание на асинхронный перевод:
http://serverName/_api/TranslationJob.CancelJob('jobid')
Требования для документов Microsoft Word
Служба машинного перевода SharePoint использует язык абзаца в качестве исходного языка при переводе документов Microsoft Word. Например, если абзац написан на испанском языке, но для него задан английский язык, служба перевода не будет переводить его на английский язык. Это связано с тем, что для него уже задано значение Английский.
Чтобы выбрать язык абзаца, сделайте следующее:
Выделите абзац.
Перейдите на вкладку ленты "Рецензирование".
Откройте раскрывающееся меню "Язык" и выберите "Язык проверки правописания".