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

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

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

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

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

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

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

  1. Откройте в веб-браузере адрес https://machine.domain.com/webadaptor/admin/login.
  2. Выполните вход в ArcGIS Server Administrator Directory под учетной записью администратора.
  3. Щелкните Компьютеры.
  4. Щелкните ссылку <Имя вашего сервера>..<домен>.com.

    К примеру, ссылка может выглядеть так: server1.esri.com.

  5. На странице Свойства компьютера сервера щелкните ссылку Изменить.
  6. Увеличьте значение параметра Максимальный объем динамической памяти SOC (в МБ).
  7. Щелкните Сохранить изменения, чтобы завершить редактирование.

Размер файла загрузки

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

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

    Законченная запись выглядит примерно так: "maxUploadFileSize": 100,.

  7. Щелкните Сохранить изменения.
Примечание:

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

Типы загрузок

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

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

    Законченная запись выглядит примерно так: "allowedUploadFileTypes": ".kml,.gpx".

  7. Щелкните Сохранить изменения.
Примечание:

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

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

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

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

    Законченная запись выглядит примерно так: "maxDomainCodeCount": 25,.

  7. Щелкните Сохранить изменения.

Локальная папка 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, укажите соответствующие настройки журнала сервера.

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

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

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