Управление статусом кэша картографического сервиса (Серверные инструменты)
Краткая информация
Управляет хранящимися на сервере внутренними данными о созданных листах в кэше картографического сервиса или сервиса изображений.
Использование
Инструмент используется для перестроения статуса кэша после того, как вы вручную скопировали листы в директорию кэша либо построили листы по запросу.
Инструмент является единственным способом построения статуса кэша, созданного в предыдущей версии ArcGIS Server или Portal for ArcGIS.
Вместо создания статуса всего кэша вы можете воспользоваться этим инструментом, чтобы получить отчеты о статусе интересующих вас территорий и масштабных уровней. Это можно сделать, установив параметр Режим управления на Перестроить статус пакета. Отчет сохраняется в новой файловой базе геоданных, названной Status.gdb, в классе объектов TaskStatus.
Помните, что ваша директория кэша также содержит базу Status.gdb, относящуюся ко всему кэшу и обновляемую при использовании других опций Режима управления для этого инструмента. В этом местоположении вы не можете заменить базу Status.gdb на другую.
Слой изображений карты, у которого будет изменен статус кэша. Его можно выбрать, указав нужный сервис на портале или перетащив веб-слой листов с панели Каталог, с вкладки Портал, чтобы задать этот параметр.
Image Service; Map Server
Режим управления
Указывает действие, которое будет выполнено с информацией о состоянии кэша, используемой сервером.
Удалить статус кэша–Удаляет информацию о статусе, используемую сервером.
Перестроить статус кэша–Удаляет и создает заново информацию о статусе, используемую сервером.
Перестроить статус пакета–Создает информацию о статусе в новой файловой базе геоданных Status.gdb в указанной вами в параметре Выходная папка. Данная опция используется, когда вы собираетесь создать пользовательский отчет о статусе для конкретной интересующей вас области либо определенного набора масштабов.
String
Масштабы
(Дополнительный)
Масштабные уровни, для которых будет изменен статус. Этот параметр применим только при создании пользовательского статуса с использованием опции Перестроить статус пакета параметра Режим управления.
Double
Число экземпляров кэшированного сервиса
(Дополнительный)
Задает число экземпляров, использующихся для обновления/создания листов. Значение этого параметра установлено как – без ограничений (-1) и не может быть изменено.
Long
Выходная папка
(Дополнительный)
Выходная директория для базы Status.gdb. Этот параметр применяется только при создании пользовательского статуса с использованием опции Перестроить статус пакета.
Folder
Область интереса
(Дополнительный)
Область интереса (полигон), определяющая территорию, покрываемую отчетом о статусе. Этот параметр применяется только при создании пользовательского статуса с использованием опции Перестроить статус пакета.
Feature Set
Экстент отчета
(Дополнительный)
Прямоугольный экстент определяет территорию, для которой будет построен статус. Этот параметр применяется только при создании пользовательского статуса с использованием опции Перестроить статус пакета.
Помните, что параметр Область интереса позволяет вам указать непрямоугольную интересующую вас область.
Текущий экстент отображения — Экстент будет основан на активной карте или сцене.
Нарисовать экстент - Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене.
Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции:
Все объекты - Экстент всех объектов.
Выбранные объекты - используйте экстент выбранных объектов.
Отображаемые объекты - Экстент отображаемых объектов.
Обзор — Экстент будет основан на наборе данных.
Буфер обмена - Экстент может быть скопирован в буфер обмена и вставлен из него.
Копировать экстент - Копирует координаты экстента и систему координат в буфер обмена.
Вставить экстент - Вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержит систему координат, экстент будет использовать систему координат карты.
Сбросить экстент — Экстент будет сброшен до значения по умолчанию.
Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.
Слой изображений карты, у которого будет изменен статус кэша. Его можно выбрать, указав нужный сервис на портале или перетащив веб-слой листов с панели Каталог, с вкладки Портал, чтобы задать этот параметр.
Image Service; Map Server
manage_mode
Указывает действие, которое будет выполнено с информацией о состоянии кэша, используемой сервером.
DELETE_CACHE_STATUS–Удаляет информацию о статусе, используемую сервером.
REBUILD_CACHE_STATUS–Удаляет и создает заново информацию о статусе, используемую сервером.
REPORT_BUNDLE_STATUS–Создает информацию о статусе в новой файловой базе геоданных Status.gdb в указанной вами в параметре report_folder. Данная опция используется, когда вы собираетесь создать пользовательский отчет о статусе для конкретной интересующей вас области либо определенного набора масштабов.
String
scales[scales,...]
(Дополнительный)
Масштабные уровни, для которых будет изменен статус. Этот параметр применим только при создании пользовательского статуса с использованием опции REPORT_BUNDLE_STATUS для параметра manage_mode.
Double
num_of_caching_service_instances
(Дополнительный)
Задает число экземпляров, использующихся для обновления/создания листов. Значение этого параметра установлено как – без ограничений (-1) и не может быть изменено.
Long
report_folder
(Дополнительный)
Выходная директория для базы Status.gdb. Этот параметр применяется только при создании пользовательского статуса с использованием опции REPORT_BUNDLE_STATUS.
Folder
area_of_interest
(Дополнительный)
Область интереса (полигон), определяющая территорию, покрываемую отчетом о статусе. Этот параметр применяется только при создании пользовательского статуса с использованием опции REPORT_BUNDLE_STATUS.
Feature Set
report_extent
(Дополнительный)
Прямоугольный экстент определяет территорию, для которой будет построен статус. Этот параметр применяется только при создании пользовательского статуса с использованием опции REPORT_BUNDLE_STATUS.
Помните, что параметр area_of_interest позволяет вам указать непрямоугольную интересующую вас область.
MAXOF – Будет использоваться максимальный экстент всех входных данных.
MINOF – Будет использоваться минимальная область, которая является общей для всех входных данных.
DISPLAY — Экстент равен видимому отображению.
Имя слоя — Будет использоваться экстент указанного слоя.
Extent Объект — будет использоваться экстент указанного объекта.
Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.
Extent
Производные выходные данные
Имя
Объяснение
Тип данных
output_folder
Выходной URL-адрес сервиса.
String
Пример кода
ManageMapServerCacheStatus, пример (автономный скрипт)
Удаление информации о статусе кэша.
# Name: ManageMapServerCacheStatus.py
# Description: The following stand-alone script demonstrates how to delete
# Status of cache using ManageMapServerCachStatus tool
# Any line that begins with a pound sign is a comment and will not be run
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
# "sys.argv[]"
# Import system modules
import arcpy
import sys
import time
import datetime
# Set environment settings
arcpy.env.workspace = "C:/data"
# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapService"
inputService = f"{connectionFile}\\{server}\\{serviceName}"
scales = ""
manageMode = "DELETE_CACHE_STATUS"
numOfCachingServiceInstances = "2"
outputFolder = ""
areaOfInterest = ""
reportExtents = ""
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = f'C:/data/report_{arg1}.txt'
# Print results of the script to a report
report = open(file, 'w')
# Use "scales[0]", "scales[-1]", "scales[0:3]"
try:
starttime = time.clock()
result = arcpy.server.ManageMapServerCacheStatus(
inputService,
manageMode,
scales,
numOfCachingServiceInstances,
outputFolder,
areaOfInterest,
reportExtents
)
finishtime = time.clock()
elapsedtime = finishtime - starttime
#print messages to a file
while result.status < 4:
time.sleep(0.2)
resultValue = result.getMessages()
report.write(f"completed {resultValue}")
print(f"Reported the Bundle status for scale = {scales[-1]} of {serviceName} at {outputFolder}")
print(f"using specified feature class {areaOfInterest} in {elapsedtime} sec {arg2}")
except Exception as err:
# If an error occurred, print line number and error message
tb = sys.exc_info()[2]
report.write(f"Failed at step 3 \nLine {tb.tb_lineno}")
report.write(str(err))
report.close()
Параметры среды
Этот инструмент не использует параметры среды геообработки.
— Экстент будет основан на активной карте или сцене.
- Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене.
— Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции:
- Экстент всех объектов.
- используйте экстент выбранных объектов.
- Экстент отображаемых объектов.
— Экстент будет основан на наборе данных.
- Экстент может быть скопирован в буфер обмена и вставлен из него.
- Копирует координаты экстента и систему координат в буфер обмена.
— Экстент будет сброшен до значения по умолчанию.