Настройки расширенных свойств веб-инструмента—ArcGIS Pro

Настройки веб-инструмента, описанные ниже, являются расширенными, которые нельзя задать с помощью ArcGIS Server Manager; по сути, они являются сервисами геообработки, на которые ссылаются веб-инструменты, и настроить их можно только используя интегрированный ArcGIS Server Administrator REST API. Эти настройки необходимо изменять только для определенных веб-инструментов для различных задач.

Изменение объема динамической памяти

Объем динамической памяти управляет максимальным размером файла, который может быть предоставлен клиентом. Он может быть задан на двух уровнях: сервера или сервиса.

Объем динамической памяти на уровне сервиса позволяет обеспечить лучшую производительность по сравнению с изменением объема динамической памяти на уровне сервера. В версии ArcGIS Server 10.7 и более поздних, объем динамической памяти может быть установлен на уровне сервиса. Значение по умолчанию для всех сервисов - 64 МБ. Если у вас есть входной файл или класс пространственных объектов, больший объема, заданного по умолчанию, измените объем динамической памяти службы следующим образом:

Из веб-браузера перейдите к https://machine.domain.com/webadaptor/admin/login.
Выполните вход в ArcGIS Server Administrator Directory под учетной записью администратора.
Щелкните ссылку Ресурсы: сервисы, чтобы увидеть новую страницу со всеми опубликованными сервисами.
Щелкните сервис с объемом динамической памяти, который вы хотите изменить, и откройте страницу со всеми свойствами сервиса.
На странице свойств сервиса щелкните ссылку frameworkProperties, чтобы просмотреть страницу редактируемых свойств сервиса в формате JSON.
Если javaHeapSize отсутствует в списке свойств сервиса, добавьте в JSON свойство {"javaHeapSize":"128"}. Если свойство javaHeapSize есть, соответственно увеличьте значение.
Щелкните кнопку Сохранить изменения, чтобы сохранить и завершить редактирование.

Для изменения объема динамической памяти на уровне сервера, выполните указанные ниже шаги. По умолчанию максимальный объем динамической памяти компонента серверного объекта (SOC) - 64 МБ. Увеличьте значение свойства по умолчанию до нужного значения.

Откройте в веб-браузере адрес https://machine.domain.com/webadaptor/admin/login.
Выполните вход в ArcGIS Server Administrator Directory под учетной записью администратора.
Щелкните Компьютеры.
Щелкните ссылку <Имя вашего сервера>..<домен>.com.
К примеру, ссылка может выглядеть так: server1.esri.com.
На странице Свойства компьютера сервера щелкните ссылку Изменить.
Увеличьте значение параметра Максимальный объем динамической памяти SOC (в МБ).
Щелкните Сохранить изменения, чтобы завершить редактирование.

Установка размера файла загрузки

Управление размером файла загрузки служит для контроля за размером файла, который может быть загружен клиентами, подключенными к сервису через конечную точку REST. Как правило, эти клиенты являются веб-клиентами, использующими сервис через пользовательское веб-приложение. По умолчанию установлено ограничение 2 ГБ. Используйте эту настройку для предоставления значения по умолчанию в целях предотвращения загрузок больших файлов через сервис.

Чтобы установить размер файла загрузки, выполните следующие шаги:

Откройте в веб-браузере адрес https://machine.domain.com/webadaptor/admin/login.
Выполните вход в ArcGIS Server Administrator Directory под учетной записью администратора.
Щелкните сервисы.
Щелкните на имени сервиса.
Щелкните на ссылке Редактировать в нижней части страницы, в разделе Поддерживаемые операции.
В текстовом окне Сервис (в формате JSON):* найдите тег maxUploadFileSize и задайте максимальный размер файла после двоеточия (:).
Законченная запись будет выглядеть примерно так - "maxUploadFileSize": 100,.
Щелкните Сохранить изменения.

Примечание:

При публикации веб-инструмента убедитесь, что поставлена отметка Загрузки на панели Конфигурация Веб-инструмента Опубликовать как. Либо включите эту настройку в существующем сервисе с помощью ArcGIS Server Manager на странице настроек сервиса Возможности.

Установка типа файлов загрузки

Только определенные файлы могут быть загружены в веб-инструмент. Файлы с какими расширениями могут быть загружены с помощью сервиса определяется на уровне сервиса.

Чтобы установить тип файлов загрузки, выполните следующие шаги:

Откройте в веб-браузере https://machine.domain.com/webadaptor/admin/login.
Выполните вход в ArcGIS Server Administrator Directory под учетной записью администратора.
Щелкните сервисы.
Щелкните на имени сервиса.
Щелкните на ссылке Редактировать в нижней части страницы, в разделе Поддерживаемые операции.
В текстовом окне Сервис (в формате JSON):* найдите тег allowedUploadFileTypes и добавьте файловые расширения, которые следует разрешить, заключив их в кавычки и поместив после двоеточия (:).
Законченная запись будет выглядеть примерно так - "allowedUploadFileTypes": ".kml,.gpx".
Щелкните Сохранить изменения.

Примечание:

Изменение максимального количества доменов

Настройка maxDomainCodeCount управляет количеством доменов, которое будет возвращено с ответом сервиса. Описание домена сопоставлено с кодом, возвращаемым с выходными объектами ответа. По умолчанию эта настройка установлена на 1000. Если выходные объекты содержат более 1000 участвующих доменов, информация о доменах возвращена не будет. Возвращаемая информация о доменах может превысить размер ответа. Если для домены не нужны, задайте это значение равным нулю или меньшим, чем количество доменов в сервисе.

Чтобы изменить максимальное количество доменов, выполните следующие действия:

Откройте в веб-браузере адрес https://machine.domain.com/webadaptor/admin/login.
Выполните вход в ArcGIS Server Administrator Directory под учетной записью администратора.
Щелкните сервисы.
Щелкните на имени сервиса.
Щелкните на ссылке Редактировать в нижней части страницы, в разделе Поддерживаемые операции.
В текстовом окне Сервис (в формате JSON):* найдите тег maxDomainCodeCount и задайте максимальный предел после двоеточия (:).
Законченная запись будет выглядеть примерно так - "maxDomainCodeCount": 25,.
Щелкните Сохранить изменения.

Локальная папка temp

Локальная папка temp является каталогом, в который ArcGIS Server записывает промежуточные выходные данные, если сервер, наряду с другими компьютерами, участвует в кластере, или если ссылки на каталоги оформлены в виде путей UNC. Это устраняет необходимость записи промежуточных данных во временную базу геоданных по пути UNC или временную папку, что повышает производительность сервиса. Когда операция будет выполнена, результаты будут скопированы из локальной временной папки в директорию с заданиями, которая может быть путем UNC.

Повторное использование каталога заданий для синхронных сервисов

Если ваш веб-инструмент основан на синхронном сервисе геообработки, вы можете повторно использовать рабочую директорию для повышения производительности, применив "reusejobdir": "true". Как правило, каждый раз, когда вы запускаете синхронный сервис геообработки, в папке arcgisjobs на вашем сервере создается рабочая директория. По завершении ArcGIS Server удалит эту рабочую директорию. Если установить для свойства reusejobdir значение true, то рабочая директория останется даже после завершения выполнения задания. Это может сэкономить время на создании временной базы геоданных и временной папки для следующего выполнения, что обеспечивает некоторые преимущества в части производительности. Также, когда вы вернете этому свойству значение "false" или удалите это свойство, обратитесь к своему администратору, чтобы удалить любую существующую папку заданий для этого сервиса.

Чтобы установить это свойство, обратитесь к системному администратору, чтобы редактировать свойство сервиса в API администратора.

Далее приведен упрощенный JSON, показывающий параметр reusejobdir. Другие свойства были скрыты, чтобы выделить изменения, относящиеся к этому свойству.

{
    "serviceName": "sample",
    "type": "GPServer",
    "manyotherkeys": "manyothervalues",
    "properties": {
        "manyotherkeys": "manyothervalues",
        "reusejobdir": true,
        "executionType": "Synchronous"
    },
    "portalProperties": {},
    "extensions": []
}

Запись сообщений в журнал ArcGIS Server

Если веб-инструмент опубликован в ArcGIS Server версии 11.3 или более поздней, вы можете включить копию сообщений веб-инструмента в журнал ArcGIS Server. Уровень сообщений журнала ArcGIS Server будет соответствовать уровню сообщений веб-инструмента. Для сообщения веб-инструмента существует три уровня: ошибка, предупреждение и информация - которые соответствуют критичным, предупреждающим и информационным сообщениям в ArcGIS Server. Ручная настройка сообщений веб-инструмента с помощью сообщений инструмента-скрипта. Многие инструменты геообработки также содержат предустановленные сообщения. Чтобы убедиться в том, что сообщения правильно регистрируются в ArcGIS Server, укажите соответствующие настройки журнала сервера.

Чтобы установить свойство logGPMessages, обратитесь к системному администратору, чтобы установить свойство редактировать сервис – в Administrator REST API.

Упрощенный JSON, показывающий параметр logGPMessages. Другие свойства были скрыты, чтобы выделить изменения, относящиеся к этому свойству.

{
    "serviceName": "sample",
    "type": "GPServer",
    "other_keys": "other_values",
    "properties": {
        "other_keys": "other_values",
        "logGPMessages": true,
        "executionType": "Asynchronous"
    },
    "portalProperties": {},
    "extensions": []
}

Возвращаемые результаты в особенных случаях

При сбое или отмене работы асинхронного сервиса геообработки или веб-инструмента, основанного на асинхронном сервисе геообработки, результаты недоступны. Если такой веб-инструмент или сервис геообработки опубликованы в ArcGIS Server версии 11.5 или более поздней, вы все равно можете включить ArcGIS Server для возврата результатов, если вы обращаетесь к ним через results или result ресурсы в ArcGIS REST API. Эта функция недоступна при использовании синхронного сервиса геообработки или веб-инструмента, основанного на синхронном сервисе геообработки. Вы также не можете получить доступ к результатам невыполненных или отмененных заданий в ArcGIS Pro.

Чтобы установить свойство saveRESTResultsOnFailOrCancel, обратитесь к системному администратору, чтобы установить свойство редактировать сервис в Administrator REST API.

Упрощенный JSON, показывающий параметр saveRESTResultsOnFailOrCancel. Другие свойства были скрыты, чтобы выделить изменения, относящиеся к этому свойству.

{
    "serviceName": "sample",
    "type": "GPServer",
    "other_keys": "other_values",
    "properties": {
        "other_keys": "other_values",
        "saveRESTResultsOnFailOrCancel": true,
        "executionType": "Asynchronous"
    },
    "portalProperties": {},
    "extensions": []
}

Блокировка определенных инструментов

При публикации веб-инструментов или сервисов геообработки, может понадобиться отключение или блокировка доступа к определенным задачам. Начиная с ArcGIS Server версии 11.5, добавьте свойство blockedTools или allowedTools к свойствам сервиса, чтобы заблокировать определенные инструменты.

Используйте свойство blockedTools, чтобы сделать определенные инструменты недоступными. Используйте свойство allowedTools, чтобы сделать доступными только определенные инструменты; все остальные инструменты будут недоступны. Для удобства используйте любое из свойств. Чтобы определить задачу, используйте либо имя, либо отображаемое имя задачи. Если имя задачи совпадает с отображаемым именем другой задачи, обе задачи будут распознаны и заблокированы или разрешены одновременно.

Упрощенный JSON, показывающий параметр blockedTools с несколькими именами задач для блокировки. При указании нескольких имен они разделяются точками с запятой.

{
    "serviceName": "sample",
    "type": "GPServer",
    "other_keys": "other_values",
    "properties": {
        "other_keys": "other_values",
        "blockedTools": "extractData;bufferInputs",
        "executionType": "Synchronous"
    },
    "portalProperties": {},
    "extensions": []
}

Отзыв по этому разделу?

Изменение объема динамической памяти

Установка размера файла загрузки

Примечание:

Установка типа файлов загрузки

Примечание:

Изменение максимального количества доменов

Локальная папка temp

Повторное использование каталога заданий для синхронных сервисов

Запись сообщений в журнал ArcGIS Server

Возвращаемые результаты в особенных случаях

Блокировка определенных инструментов

В этом разделе