Заменить веб-слой (Сервер)

Сводка

Заменяет ресурсы веб-слоя портала ресурсами другого веб-слоя.

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

  • Целевым слоем является замещаемый слой. Слоем обновления является веб-слой замещения. Целевым слоем и слоем обновления могут быть слои векторных листов, слои листов или слои сцен, опубликованные из пакетов слоев сцен, размещенных на 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
(Дополнительный)

Определяет, будет ли производиться замена миниатюрного изображения, сводки и тегов. В любом случае для данного элемента не будет производиться замена информации о кредитах (авторские права), условиях использования и Создано на основе.

  • KEEPПри обновлении слоя информация об элементе целевого слоя не заменяется. Это значение по умолчанию Короткое целое.
  • REPLACEИнформация об элементе целевого слоя замещается информацией об элементе слоя обновления.
Boolean
create_new_item
(Дополнительный)

Задает, будет ли создан новый элемент для архивного слоя. Эта опция поддерживается на порталах ArcGIS Online и ArcGIS Enterprise 10.8 или более поздних версиях.

  • TRUEДля архивного слоя создается новый ID элемента. Для слоев сцены эта опция используется по умолчанию.
  • FALSEДля архивного слоя используется ID элемента слоя обновления. Это значение используется по умолчанию для слоев векторных листов и слоев листов.
Boolean

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

NameОбъяснениеТип данных
updated_target_layer

URL обновленного веб-слоя.

Строковое

Пример кода

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

Следующий скрипт показывает замену веб-слоя с помощью идентификаторов 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.")
ReplaceWebLayer, пример 2 (автономный скрипт)

Следующий скрипт показывает замену веб-слоя на 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.")

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

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

Связанные разделы