Основные рекомендации по использованию веб-инструментов

Загрузка и выгрузка больших наборов данных

Существует ограничения размера файла для загрузки данных при публикации веб-инструмента и загрузке выходных данных во время запуска веб- инструмента. Ограничения зависят от объема динамической памяти интегрированного сервера, на котором размещается веб-инструмент. Размер динамической памяти по умолчанию составляет 64 Мб; это значение может изменить администратор сервера. Уточните у администратора сервера, можно ли увеличить размер динамической памяти для следующих элементов:

  • Выгрузка растровых данных размером больше 64 Мб
  • Выгрузка векторных данных размером 64 Мб или больше
  • Загрузка векторных данных размером 64 Мб или больше

Более подробную информацию об отношениях между объемом динамической памяти и отправкой и загрузкой наборов данных см. в разделе Объем динамической памяти Расширенные настройки веб-инструмента.

При загрузке больших наборов векторных данных, максимальное число записей, возвращаемых сервером, также должно быть определено. По умолчанию число записей равно 1000. Если количество возвращаемых записей будет больше 1000, вы можете выполнить следующее:

  • Сбросить значение максимального числа записей в настройках веб-инструмента при публикации.
  • Если вы не выполните сброс во время процесса публикации, данные не будут загружены, и при выполнении веб-инструмента в истории геообработки появится сообщение о том, что данные превышают ограничения переноса. Вы должны войти в менеджер интегрированного сервера и сбросить максимальное число записей для сервиса геообработки, на котором хранится веб-инструмент.
  • Используйте веб-инструменты с выходной сервис пространственных объектов, чтобы избежать загрузки больших объемов выходных данных.

Отправка больших наборов данных из веб-приложения

Веб-приложения используют операцию отправки REST для передачи файлов. Эта функция определяется функцией Загрузка на странице свойств сервиса геообработки. Максимальный размер отправляемых данных по умолчанию равен 2 ГБ. Вы можете изменить максимальный размер файла отправки, сделав его меньше 2 Гб, выполнив шаги, описанные в разделе Размер отправляемых данных Расширенные настройки сервиса геообработки. Вы не можете изменять максимальный размер отправляемых данных на более, чем 2 Гб.

Если в качестве входных данных используются файлы .txt, .zip или .jpg, можно использовать операцию ресурсов uploads для передачи этих типов файлов. Настройка типа отправляемых файлов описана в разделе Типы отправляемых данных Расширенные настройки сервиса геообработки.

Веб-инструменты из ArcMap

Вы можете использовать веб-инструменты, используя файл подключения к серверу. Если веб-инструмент опубликован с любого клиента до версии ArcGIS Enterprise 10.9.1 или более ранней версии, вы можете использовать его с любым типом подключения и правами общего доступа. Публикация из ArcMap в ArcGIS Enterprise 11 и более позней версии не поддерживается. Однако вы можете использовать веб-инструменты, опубликованные из ArcGIS Pro по ArcGIS Enterprise 11, со следующими требованиями:

Входные данные в виде сервиса объектов или сервиса изображений

Вы можете предоставить входные данные из сервиса пространственных объектов для сервиса объектов или сервиса изображений для растрового типа данных, введя адрес URL сервиса, выбрав слой сервиса в таблице контента или выбрав сервис на панели Портал в ArcGIS Pro .

Выходные данные в виде сервиса объектов

При использовании веб-инструмента, выходные данные могут быть созданы в виде выходного класса объектов или таблицы, или в виде выходного сервиса объектов с помощью параметра Имя выходного сервиса объектов. Эта опция может ускорить процесс использования, когда размер выходных объектов является большим. Это также делает ваши данные постоянно доступными для использования в различных клиентах, например, в веб-клиентах, настольных приложениях и полевых приложениях. Вы можете ознакомиться с более подробной информацией о сохранении выходных данных в виде сервиса объектов в разделе Использование веб-инструментов с выходным сервисом объектов

Использование пользовательского географического преобразования

Здесь вам может понадобиться указать файл пользовательского географического преобразования (.gtf) для публикуемого веб-инструмента. В этом случае необходимо убедиться, что файл .gtf присутствует на интегрированном сервере, на котором размещен веб-инструмент. Более подробную информацию о создании и сохранении на сервере файла .gtf см. в разделе Использование сервисов геообработки с пользовательским географическим преобразованием. Путь к файлу .gtf, сохраняемый в ArcGIS Pro, похож на тот же путь в ArcGIS Desktop. Все, что вам нужно сделать - это заменить часть Desktop10.x пути .gtf на ArcGISPro.

Использование параметров среды

При использовании веб-инструмента из ArcGIS Pro, вы можете воспользоваться вкладкой инструмента Параметры среды, чтобы задать настройки параметров среды для запуска инструмента. Некоторые параметры среды, такие как Выходная система координат и Маска, принимают в качестве параметра введенный адрес URL сервиса объектов или картографического сервиса, дополнительно к выбору параметра из ниспадающего списка. Некоторые параметры среды, такие как Растр привязки и Размер ячейки, принимают в качестве параметра введенный адрес URL сервиса изображений, дополнительно к выбору параметра из ниспадающего списка. Настройки Параметра среды, выбранные на вкладке Анализ, которые используются при локальной геообработке в ArcGIS Pro, не будут обрабатываться при использовании веб-инструмента. Ниже представлен список поддерживаемых параметров среды:

  • Выходные координаты - Выходная система координат, Географические преобразования
  • Экстент обработки - Экстент
  • Параллельная обработка - Коэффициент параллельной обработки
  • Растровый анализ - Размер ячейки, Метод проекции размера ячейки, Маска, Растр привязки
  • База геоданных - Автоподтверждение
  • M-значения - Выходные данные имеют M-значения
  • Значения Z - Выходное значение Z по умолчанию, Выходные данные имеют значения Z
  • Случайные числа - Генератор случайных чисел
  • Хранение растров - NoData
  • Тип процессора - Тип процессора, GPU ID

Фильтры параметров

При создании инструментов можно задатьфильтр на вкладке Параметры диалогового окна Свойства инструмента. Начиная с версии ArcGIS Server 10.7, при публикации инструмента с фильтрами информация о фильтрах также будет опубликована. Поддерживаются только фильтры для входных типов данных, кроме фильтра Дата.

Пример

В инструменте, показанном ниже, Фильтр диапазона задан для параметра Двойной с Минимальным значением 213 и - Максимальным - 123132.123.

Обновление фильтра диапазона инструмента

Если инструмент был опубликован и использовался в качестве веб-инструмента в ArcGIS Pro, входное значение, не попадающее в фильтр диапазона, вызывает ошибку о выходе значения за пределы допустимого диапазона.

Использование фильтра диапазона предотвращает использование значений, находящихся вне заданного вами диапазона

Python - среда, используемая веб-инструментами

Как и ArcGIS Pro, ArcGIS Enterprise использует среды Python в ArcGIS Server.

По умолчанию ваши веб-инструменты публикуются из ArcGIS Pro с использованием среды Python по умолчанию, которая находится в каталоге установки ArcGIS Server на вашем серверном компьютере. Если ваш ArcGIS Server находиться в месте установки по умолчанию, ваша среда Python находится в C:\Program Files\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3.

Если при создании анализа вы используете пользовательскую среду Python со сторонними пакетами Python, эти пакеты Python не загружаются автоматически на ArcGIS Server в процессе публикации. Чтобы загрузить свои пакеты, см. Развертывание пользовательских пакетов Python для ArcGIS Server. В противном случае ваши веб-инструменты не выполнятся и выдадут ошибки Python.

Рекомендации по различным типам развертываний ArcGIS Enterprise

Существует множество сценариев развертывания. Некоторые развертывания могут потребовать внимания при определенных обстоятельствах.

Отказоустойчивость в ArcGIS Enterprise

Если вы публикуете веб-инструменты в отказоустойчивом развертывании ArcGIS Enterprise с файловыми хранилищами NFS, убедитесь, что вы не задали параметр NOLOCK для файловых хранилищ NFS. Блокировка файлов может обеспечить надлежащий механизм блокировки важных файлов, записывающих статус задания веб-инструмента с помощью асинхронного сервиса геообработки. Если параметр NOLOCK установлен для файлового хранилища NFS, несколько компьютеров могут обрабатывать один и тот же запрос, что приведет к дублированию результатов. Дополнительные сведения об этом развертывании и устройстве NAS см. в разделах Отказоустойчивость в ArcGIS Enterprise и Выбор устройство NAS для ArcGIS Server.

Сайт ArcGIS Server с несколькими компьютерами

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