Сводка
Заменяет ресурсы веб-слоя портала ресурсами другого веб-слоя.
Использование
Целевым слоем является замещаемый слой. Слоем обновления является веб-слой замещения. Целевым слоем и слоем обновления могут быть слои векторных листов, слои листов или слои сцен, опубликованные из пакетов слоев сцен, размещенных на ArcGIS Online или на портале ArcGIS Enterprise.
Чтобы заменить слой векторных листов на портале ArcGIS Enterprise, необходимо иметь версию 10.6 или более позднюю. Чтобы заменить слой листов, у вас должна быть версия 10.8 или более поздняя. Чтобы заменить слой сцены, у вас должна быть версия 10.8.1 или более поздняя.
Вашим активным порталом ArcGIS Pro должен быть портал, на котором размещены целевой слой и слой обновления. Вы должны выполнить вход в ArcGIS Pro под учетной записью владельца целевого слоя и слоя обновления.
Целевой и обновляющий слои должны быть одного типа. Например, нельзя заменить слой векторных листов слоем листов.
Когда целевой слой будет обновлен, ресурсы этого слоя будут заменены другими. ID элемента и URL сервиса целевого слоя не изменятся.
Замещаемый веб-слой не изменяется. Он будет архивирован на портале под новым именем. По умолчанию, слой архивируется под именем <имя слоя>_archive_<timestamp>. Можно выбрать другое имя, но оно должно быть уникальным именем веб-слоя на портале.
По умолчанию архивный слой использует ID элемента слоя обновления. При необходимости можно задать новый ID элемента для архивного слоя.
При желании вы можете заменить информацию элемента целевого слоя на информацию элемента слоя обновления. При смене информации элемента изменятся также и сводка, описание, тэги и миниатюрное изображение. Прочая информация, в том числе кредиты (авторские права) и условия использования останутся без изменений.
Синтаксис
ReplaceWebLayer(target_layer, archive_layer_name, update_layer, {replace_item_info}, {create_new_item})
Parameter | Объяснение | Тип данных |
target_layer | Замещаемый слой. Укажите идентификатор элемента или URL-адрес сервиса векторных листов, слоя листов или слоя сцены, опубликованного из пакета слоев сцены. Также можете перейти к этому слою или перетащить его из каталога. | Vector Tile Layer; Internet Tiled Layer; Scene Layer |
archive_layer_name | Замененный веб-слой остается на портале в качестве архивного слоя. Укажите уникальное имя для архивного веб-слоя. | String |
update_layer | Подменный (замещающий) веб-слой. Помимо слоя или пути каталога его можно указать с помощью ID элемента или URL сервиса слоя векторных листов, слоя листов или слоя сцены, опубликованных из пакета слоя сцены. | Vector Tile Layer; Internet Tiled Layer; Scene Layer |
replace_item_info (Дополнительный) | Определяет, будет ли производиться замена миниатюрного изображения, сводки и тегов. В любом случае для данного элемента не будет производиться замена информации о кредитах (авторские права), условиях использования и Создано на основе.
| Boolean |
create_new_item (Дополнительный) | Задает, будет ли создан новый элемент для архивного слоя. Эта опция поддерживается на порталах ArcGIS Online и ArcGIS Enterprise 10.8 или более поздних версиях.
| Boolean |
Производные выходные данные
Name | Объяснение | Тип данных |
updated_target_layer | URL обновленного веб-слоя. | Строковое |
Пример кода
Следующий скрипт показывает замену веб-слоя с помощью идентификаторов ID входных слоев.
import arcpy
import time
# Set local variables
targetLayerID = "42994b1a3e63425aa02bcfa1200683ae"
archiveLayerName = "ReplaceWebLayerExample_archive_" + time.strftime("%Y%m%d")
updateLayerID = "9e1d80c874e040fc88ad06b0cfa01381"
replaceItemInfo = "REPLACE"
createNewItem = "TRUE"
# Execute Replace Web Layer
arcpy.ReplaceWebLayer_server(targetLayerID, archiveLayerName, updateLayerID,
replaceItemInfo, createNewItem)
print("Successfully replaced web layer.")
Следующий скрипт показывает замену веб-слоя на ArcGIS Enterprise с помощью URL-сервисов входных слоев.
import arcpy
import time
# Set local variables
targetLayer = "https://webadaptorhost.domain.com/webadaptorname/rest/services/Hosted/targetServiceName/VectorTileServer"
archiveLayerName = "targetServiceName_archive_" + time.strftime("%Y%m%d")
updateLayer = "https://webadaptorhost.domain.com/webadaptorname/rest/services/Hosted/updateServiceName/VectorTileServer"
# Execute Replace Web Layer
arcpy.ReplaceWebLayer_server(targetLayer, archiveLayerName, updateLayer)
print("Successfully replaced web layer.")
Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да