Поделиться через

Пакетное применение модели

  • Статья

Применяет (или синхронизирует) обученную модель осмысления документации к одной или нескольким библиотекам (см. пример).

HTTP-запрос

POST /_api/machinelearning/publications HTTP/1.1

Параметры URI

None;

Заголовки запросов

Заголовок Значение
Accept application/json;odata=verbose
Content-Type application/json;odata=verbose;charset=utf-8
x-requestdigest Подходящий дайджест для текущего сайта.

Текст запроса

Имя Обязательный Тип Описание
__metadata да строка Настройте метаданные объекта в SPO. Всегда используйте значение {"type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningPublicationsEntityData"}.
Publications Да MachineLearningPublicationEntityData[] Коллекция объектов MachineLearningPublicationEntityData, каждый из которых определяет модель и целевую библиотеку документов.

MachineLearningPublicationEntityData

Имя Обязательный Тип Описание
ModelUniqueId да строка Уникальный идентификатор файла модели.
TargetSiteUrl да строка Полный URL-адрес сайта целевой библиотеки.
TargetWebServerRelativeUrl да строка Относительный URL-адрес сервера для веб-сайта целевой библиотеки.
TargetLibraryServerRelativeUrl да строка Относительный URL-адрес сервера целевой библиотеки.
ViewOption Нет string Указывает, следует ли установить новое представление модели в качестве библиотеки по умолчанию.

Отклик

Имя Тип Описание
201 Создано Это настраиваемый API для поддержки применения модели к библиотекам с несколькими документами. В случае частичного успеха также может возвращаться отклик "201 создано" и вызывающей стороне необходимо проверить текст отклика, чтобы понять, применена ли модель к библиотеке документов.

Текст отклика

Имя Тип Описание
TotalSuccesses int Общее количество успешных применений модели к библиотеке документов.
TotalFailures int Общее количество неудачных применений модели к библиотеке документов.
Сведения MachineLearningPublicationResult[] Коллекция объектов MachineLearningPublicationResult, каждый из которых определяет подробный результат применения модели к библиотеке документов.

MachineLearningPublicationResult

Имя Тип Описание
StatusCode int Код состояния HTTP.
ErrorMessage строка Сообщение об ошибке, уведомляющее о проблемах при применении модели к библиотеке документов.
Publication MachineLearningPublicationEntityData Указывает сведения о модели и целевую библиотеку документов.

MachineLearningPublicationEntityData

Имя Тип Описание
ModelUniqueId строка Уникальный идентификатор файла модели.
TargetSiteUrl строка Полный URL-адрес сайта целевой библиотеки.
TargetWebServerRelativeUrl строка Относительный URL-адрес сервера для веб-сайта целевой библиотеки.
TargetLibraryServerRelativeUrl строка Относительный URL-адрес сервера целевой библиотеки.

Примеры

Применение модели к библиотеке контрактных документов на сайте репозитория

В этом примере для модели осмысления документации контрактов Contoso используется ИД 7645e69d-21fb-4a24-a17a-9bdfa7cb63dc.

Пример запроса

{
    "__metadata": {
        "type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningPublicationsEntityData"
    },
    "Publications": {
        "results": [
            {
                "ModelUniqueId": "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc",
                "TargetSiteUrl": "https://contoso.sharepoint.com/sites/repository/",
                "TargetWebServerRelativeUrl": "/sites/repository",
                "TargetLibraryServerRelativeUrl": "/sites/repository/contracts",
                "ViewOption": "NewViewAsDefault"
            }
        ]
    }
}

Пример отклика

В отклике параметры TotalFailures и TotalSuccesses указывают на количество сбоев и успешных выполнений модели, применяемой к указанным библиотекам.

Код состояния: 201

{
    "Details": [
        {
            "ErrorMessage": null,
            "Publication": {
                "ModelUniqueId": "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc",
                "TargetSiteUrl": "https://contoso.sharepoint.com/sites/repository/",
                "TargetWebServerRelativeUrl": "/sites/repository",
                "TargetLibraryServerRelativeUrl": "/sites/repository/contracts",
                "ViewOption": "NewViewAsDefault"
            },
            "StatusCode": 201
        }
    ],
    "TotalFailures": 0,
    "TotalSuccesses": 1
}

См. также

REST API модели осмысления документации Syntex