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

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

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

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

  • Целевым слоем является замещаемый слой. Слоем обновления является веб-слой замещения. Целевой слой и слой обновлений должны быть веб-слоями следующих типов:

    • Слои векторных листов
    • Слои листов
    • Слои сцен публикуются с одного из следующих источников:
      • Пакеты слоев сцен, размещенные на ArcGIS Online или на портале ArcGIS Enterprise
      • Связанные кэши сцен в папке или в облачных хранилищах данных
      Примечание:

      Слои вокселов сцены не могут быть заменены.

  • Чтобы заменить слой векторных листов на портале ArcGIS Enterprise, необходимо использовать версию 10.6 или более новую. Чтобы заменить слой листов, необходимо использовать версию 10.8 или более новую. Чтобы заменить слой сцены, необходимо использовать версию 10.8.1 или более новую.

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

  • Целевой и обновляющий слои должны быть одного типа. Например, нельзя заменить слой векторных листов слоем листов.

  • Тип слоя сцены целевого слоя и слоя обновления должен совпадать. Например, нельзя заменить слой зданий сцены слоем 3D-объектов сцены.

  • Чтобы заменить слой веб-сцены, целевой слой и слой обновления должны публиковаться из одного источника. Например, вы не можете заменить слой веб-сцены, опубликованный из пакета слоя сцены, на слой веб-сцены, опубликованный из кэша сцены.

  • Чтобы заменить слои веб-сцен, опубликованные из кэша сцены, сервисы сцен целевого слоя и слоя обновления должны находиться на одном сервере в одной и той же папке.

  • Когда целевой слой будет обновлен, ресурсы этого слоя будут заменены другими. ID элемента и URL сервиса целевого слоя не изменятся.

  • Замещаемый веб-слой не изменяется. Он будет архивирован на портале под новым именем. По умолчанию, слой архивируется под именем <имя слоя>_archive_<timestamp>. Можно назначить другое имя, но оно должно быть уникальным именем веб-слоя на портале.

  • По умолчанию архивный слой использует ID элемента слоя обновления. При необходимости можно задать новый ID элемента для архивного слоя.

  • При желании вы можете заменить информацию элемента целевого слоя на информацию элемента слоя обновления. При смене информации элемента изменятся также и сводка, описание, тэги и миниатюрное изображение. Прочая информация, в том числе кредиты (авторские права) и условия использования останутся без изменений.

Параметры

ПодписьОписаниеТип данных
Целевой слой

Замещаемый слой. Помимо слоя или пути каталога его можно указать с помощью ID элемента или URL сервиса одного из следующего:

  • Векторный лист
  • Слой листов
  • Слой сцены публикуются с одного из следующих источников:
    • Пакет слоя сцены
    • Связанный кэш сцены в папке или в облачных хранилищах данных

Vector Tile Layer; Internet Tiled Layer; Scene Layer
Имя архивного слоя

Уникальное имя для архивного слоя. Замененный веб-слой остается на портале в качестве архивного слоя.

String
Обновить слой

Подменный (замещающий) веб-слой. Помимо слоя или пути каталога его можно указать с помощью ID элемента или URL сервиса одного из следующего:

  • Векторный лист
  • Слой листов
  • Слой сцены публикуются с одного из следующих источников:
    • Пакет слоя сцены
    • Связанный кэш сцены в папке или в облачных хранилищах данных

Vector Tile Layer; Internet Tiled Layer; Scene Layer
Замена информации об элементе
(Дополнительный)

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

  • Не отмечено – при обновлении слоя информация об элементе целевого слоя не будет заменена. Это значение по умолчанию
  • Отмечено – информация об элементе целевого слоя будет заменена информацией об элементе слоя обновления.
Boolean
Создать Новый элемент для архивного слоя
(Дополнительный)

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

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

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

ПодписьОписаниеТип данных
Обновленный целевой слой

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

String

arcpy.server.ReplaceWebLayer(target_layer, archive_layer_name, update_layer, {replace_item_info}, {create_new_item})
ИмяОписаниеТип данных
target_layer

Замещаемый слой. Помимо слоя или пути каталога его можно указать с помощью ID элемента или 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

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

ИмяОписаниеТип данных
updated_target_layer

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

String

Пример кода

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: Да

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