Управление листами кэша картографического сервера (Сервер)

Краткая информация

Создает и обновляет листы в существующем кэше веб-слоя листов (в ArcGIS Enterprise или ArcGIS Online), слоев изображений карты в ArcGIS Enterprise и кэшированных картографических сервисах или сервисах изображений в автономном сервере. Этот инструмент используется для создания новых листов, замены отсутствующих листов, перезаписи устаревших листов и удаления листов.

Использование

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входной сервис	Веб-слой листов, слой изображений веб-карты или слой изображения карты, листы кэша которого нужно обновить.	Image Service; Map Server
Масштабы	Список уровней масштабов, в которых будут созданы листы. По умолчанию, масштабы, перечисленные в диалоговом окне инструмента, находятся между минимальным и максимальным масштабами кэша для сервиса. Нельзя изменить диапазон масштабов кэша сервиса в ArcGIS Pro.	Double
Режим обновления	Определяет режим, который будет использован при обновлении кэша. Заново создать пустые листы—В этом случае создаются только пустые листы. Существующие листы останутся неизменными. Эта опция недоступна для веб-слоев листов, опубликованных в ArcGIS Online ArcGIS Online. Повторно создать все листы—Существующие листы будут заменены, а новые листы добавлены, если экстент изменился. Удалить листы—Листы будут удалены из кэша. Структура папки кэша не будет удалена.	String
Число экземпляров кэшированного сервиса (Дополнительный)	Общее количество экземпляров сервиса System/CachingTools, которое будет выделено для работы этого инструмента. Если применено значение по умолчанию -1, будут использованы все экземпляры инструмента кэширования установки ArcGIS Enterprise. Указать меньшее значение, чтобы использовать меньше экземпляров инструмента кэширования. Вы можете увеличить параметр Максимальное число экземпляров на компьютер для сервиса System/CachingTools в окне Редактор сервисов, которое доступно через административное подключение к ArcGIS Server. Убедитесь, что эти компьютеры сервера смогут поддерживать выбранное количество экземпляров. При подключении к автономному серверу, число экземпляров по умолчанию равно значению, заданному для параметра Максимальное число экземпляров сервиса инструмента кэширования.	Long
Область интереса (Дополнительный)	Область интереса, содержащая листы, которые будут созданы или удалены. Этот параметр полезен, если вы хотите управлять листами для областей неправильной формы. Он также применяется, если выполняется предварительное кэширование каких-то районов, а менее посещаемые области остаются некэшированными. Если не указать значение этого параметра, по умолчанию используется полный экстент карты.	Feature Set
Экстент обновления (Дополнительный)	Прямоугольный экстент, используемый для создания или удаления листов, в зависимости от значения параметра Режим обновления. Если указаны и Экстент обновления, и Область интересов, будет использовано значение параметра Область интересов. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты. Нарисовать экстент - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Эта опция создает класс пространственных объектов в базе геоданных проекта и добавляет слой на карту. Класс объектов будет иметь ту же систему координат, что и карта. Примечание: Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Среды диалогового окна инструмента. Примечание: Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент. Экстент слоя — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями. У каждого слоя карте есть следующие опции: Все объекты - экстент всех объектов слоя. Выбранные объекты - экстент всех выбранных объектов слоя. Отображаемые объекты - экстент всех отображаемых объектов слоя. Примечание: Экстенты опций Выбранные объекты и Отображаемые объекты доступны только для векторных слоев. Обзор — Экстент будет основан на существующем наборе данных. Буфер обмена - экстент может быть скопирован в буфер обмена и вставлен из него. Копировать экстент - копирует координаты экстента и систему координат в буфер обмена. Использовать Вставить экстент - вставляет координаты экстента и, дополнительно, систему координат из буфера обмена. Если значения буфера обмена не содержат систему координат, экстент будет использовать систему координат карты. Примечание: Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта ArcPy Extent: x-min, y-min, x-max, y-max и пространственная привязка. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты. Внимание: На карте могут использоваться единицы отображения, отличные от введенных координат. Использование направления по сторонам света (N, S, E, W) не поддерживается. Используйте знак отрицательного значения для координат юга и запада.	Extent
Дождитесь завершения задания (Дополнительный)	Определяет, будет ли инструмент продолжать работать, если задание кэширования выполняется в ArcGIS Online или Portal for ArcGIS. Отмечено - инструмент будет продолжать работать, если задание кэширования выполняется в ArcGIS Online или Portal for ArcGIS. С помощью этой опции вы можете запросить подробные отчеты о ходе процесса в любое время и просматривать сообщения геообработки по мере их появления. Это значение по умолчанию Не отмечено – задание будет отправлено на портал, позволяя вам запускать другие задачи геообработки в ArcGIS Pro или закрыть его. Эта опция используется, если вы хотите построить кэш автоматически в момент публикации сервиса. Вы также можете установить эту опцию на любом другом создаваемом кэше.	Boolean
URL портала (Дополнительный)	URL портала	String

Производные выходные данные

Подпись	Описание	Тип данных
URL-адрес выходного картографического сервиса	Выходной URL-адрес.	String

Python

arcpy.server.ManageMapServerCacheTiles(input_service, scales, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {update_extent}, {wait_for_job_completion}, {portal_url})

Имя	Описание	Тип данных
input_service	Веб-слой листов, слой изображений веб-карты или слой изображения карты, листы кэша которого нужно обновить.	Image Service; Map Server
scales [scales,...]	Список уровней масштабов, в которых будут созданы листы.	Double
update_mode	Определяет режим, который будет использован при обновлении кэша. RECREATE_EMPTY_TILES—В этом случае создаются только пустые листы. Существующие листы останутся неизменными. Эта опция недоступна для веб-слоев листов, опубликованных в ArcGIS Online ArcGIS Online. RECREATE_ALL_TILES—Существующие листы будут заменены, а новые листы добавлены, если экстент изменился. DELETE_TILES—Листы будут удалены из кэша. Структура папки кэша не будет удалена.	String
num_of_caching_service_instances (Дополнительный)	Общее количество экземпляров сервиса System/CachingTools, которое будет выделено для работы этого инструмента. Если применено значение по умолчанию -1, будут использованы все экземпляры инструмента кэширования установки ArcGIS Enterprise. Указать меньшее значение, чтобы использовать меньше экземпляров инструмента кэширования. Вы можете увеличить параметр Максимальное число экземпляров на компьютер для сервиса System/CachingTools в окне Редактор сервисов, которое доступно через административное подключение к ArcGIS Server. Убедитесь, что эти компьютеры сервера смогут поддерживать выбранное количество экземпляров. При подключении к автономному серверу, число экземпляров по умолчанию равно значению, заданному для параметра Максимальное число экземпляров сервиса инструмента кэширования.	Long
area_of_interest (Дополнительный)	Область интереса, содержащая листы, которые будут созданы или удалены. Этот параметр полезен, если вы хотите управлять листами для областей неправильной формы. Он также применяется, если выполняется предварительное кэширование каких-то районов, а менее посещаемые области остаются некэшированными. Если не указать значение этого параметра, по умолчанию используется полный экстент карты.	Feature Set
update_extent (Дополнительный)	Прямоугольный экстент, используемый для создания или удаления листов, в зависимости от значения параметра update_mode. Если указаны и update_extent, и area_of_interest, будет использовано значение параметра area_of_interest. MAXOF – Будет использоваться максимальный экстент всех входных данных. MINOF – Будет использоваться минимальная область, которая является общей для всех входных данных. DISPLAY — Экстент равен видимому отображению. Имя слоя - будет использоваться тот же экстент, что и в указанном слое. Объект Extent — будет использоваться экстент указанного объекта. Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.	Extent
wait_for_job_completion (Дополнительный)	Определяет, будет ли инструмент продолжать работать, если задание кэширования выполняется в ArcGIS Online или Portal for ArcGIS. WAIT—Отмечено - инструмент продолжать работать, если задание кэширования выполняется в ArcGIS Online или Portal for ArcGIS. С помощью этой опции вы можете запросить подробные отчеты о ходе процесса в любое время и просматривать сообщения геообработки по мере их появления. Это значение по умолчанию Рекомендуется использовать эту опцию в скриптах Python. DO_NOT_WAIT—Задание будет отправлено на сервер, позволяя вам запускать другие задачи геообработки. Эта опция используется, если вы хотите построить кэш автоматически в момент публикации сервиса. Вы также можете установить эту опцию на любом другом создаваемом кэше.	Boolean
portal_url (Дополнительный)	URL портала	String

Производные выходные данные

Имя	Описание	Тип данных
out_job_url	Выходной URL-адрес.	String

Пример кода

ManageMapServerCacheTiles, пример (автономный скрипт)

В примере показано, как перестроить весь кэш листов для картографического сервиса или сервиса изображений в области интереса.

# Name: ManageMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to Recreate all 
#               cache tiles for for a map or image service using an area of interest.
#               This tool works for weblayers published to ArcGIS Enterprise and ArcGIS Online.
#               and for map and image services on a stand alone ArcGIS Server

# Example: This sample script updates map cache tiles.

import arcpy
import os

# Sign in to portal
myPortal= "https://www.myArcGISEnterprise.com/webadaptor"
arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
serviceName= "MyCounty"
serviceType= "MapServer"
myPortalServiceURL = (myPortal + "/" + "rest/services" +"/" + serviceName + "/" + serviceType)


# Stand alone ArcGIS Server
target_server_connection = r"C:\Project\gisserver.ags.esri.com (publisher).ags"
serviceName= "MyCounty"
serviceType= "MapServer"
myServerServiceURL= target_server_connection + "/" + serviceName + "." + serviceType


#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1


# List of input variables for map or image service 
scales = [500000,250000]
numOfCachingServiceInstances = 8
updateMode = "RECREATE_ALL_TILES"
areaOfInterest = "C:/data/shp/CaTxFlMaMin.shp"
waitForJobCompletion = "WAIT"
updateExtents = ""
portalURL =""

# Variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1

# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ManageMapServerCacheTiles(mytest, scales, updateMode,
                                                    numOfCachingServiceInstances, areaOfInterest,
                                                    updateExtents, waitForJobCompletion,
                                                    portalURL)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Created cache tiles for given schema successfully for " + serviceName )
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()

print ("Completed update of cache tiles for " + serviceName)

Параметры среды

Текущая рабочая область

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да