Sustituir capa web (Servidor)

Resumen

Sustituye el contenido de una capa web de un portal por el contenido de otra capa web.

Uso

• La capa de destino es la capa web que se va a sustituir. La capa de actualización es la capa web de sustitución. Las capas de destino y actualización pueden ser capas de teselas vectoriales o capas de escenas publicadas desde paquetes de capas de escenas alojados en ArcGIS Online o en un portal de ArcGIS Enterprise.

• Para sustituir una capa de teselas vectoriales en un portal de ArcGIS Enterprise, debe tener 10.6 o una versión posterior. Para sustituir una capa de teselas, debe tener 10.8 o una versión posterior. Para sustituir una capa de escenas, debe tener 10.8.1 o una versión posterior.

• Su portal activo de ArcGIS Pro debe ser el portal que aloje las capas de destino y actualización. Debe haber iniciado sesión en ArcGIS Pro con la cuenta a la que pertenecen las capas de destino y actualización.

• Las capas de destino y actualización deben ser del mismo tipo. Por ejemplo, no puede sustituir una capa de teselas vectoriales por una capa de teselas.

• Cuando se actualiza la capa de destino, se sustituye el contenido de la capa. El Id. de elemento y la URL de servicio de la capa de destino no cambian.

• La capa web que se sustituye no se sobrescribe. En su lugar, se archiva en su portal con un nombre nuevo. De forma predeterminada, el nombre de la capa de archivo es <nombre de la capa>_archive_<marca de hora>. Puede elegir otro nombre, pero debe ser un nombre de capa web único en el portal.

• De forma predeterminada, la capa de archivo utiliza el Id. de elemento de la capa de actualización. Si lo desea, puede especificar un nuevo Id. de elemento para la capa de archivo.

• Si lo desea, puede sustituir la información del elemento de la capa de destino por la información del elemento de la capa de actualización. Si sustituye la información del elemento, se sustituyen el resumen, la descripción, las etiquetas y la imagen de vista en miniatura. Otra información, como los créditos (atribución) y las condiciones de uso, no se sustituyen.

Sintaxis

ReplaceWebLayer(target_layer, archive_layer_name, update_layer, {replace_item_info}, {create_new_item})

Parámetro	Explicación	Tipo de datos
target_layer	La capa web que se va a sustituir. Proporcione el Id. de elemento o URL del servicio de una tesela vectorial, capa de teselas o capa de escenas publicada desde un paquete de capas de escenas. También puede ir a la capa o arrastrarla desde el catálogo.	Vector Tile Layer; Internet Tiled Layer; Scene Layer
archive_layer_name	La capa web que se sustituye sigue en el portal como capa de archivo. Proporcione un nombre único para la capa de archivo.	String
update_layer	La capa web de sustitución. Además de una capa o ruta de catálogo, también se puede especificar con el Id. de elemento o la URL de servicio de una tesela vectorial, capa de teselas o capa de escenas publicada desde un paquete de capas de escenas.	Vector Tile Layer; Internet Tiled Layer; Scene Layer
replace_item_info (Opcional)	Especifica si se sustituirán la imagen de vista en miniatura, el resumen, la descripción y las etiquetas. En cualquier caso, no se reemplazará la información del elemento referente a Créditos (atribución), Condiciones de uso ni Creado a partir de. KEEP —La información del elemento de la capa de destino no se sustituye cuando se actualiza la capa. Esta es la opción predeterminada. REPLACE —La información del elemento de la capa de destino se sustituye por la información del elemento de la capa.	Boolean
create_new_item (Opcional)	Especifica si se crea un nuevo elemento para la capa de archivo. Esta opción se admite en portales en ArcGIS Online y ArcGIS Enterprise 10.8 o posterior. TRUE —Se crea un nuevo Id. de elemento para la capa de archivo. Este es el valor predeterminado para capas de escenas. FALSE —El Id. de elemento de la capa de actualizaciones se utiliza para la capa de archivo. Este es el valor predeterminado para capas de teselas vectoriales y capas de teselas.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
updated_target_layer	La URL de la capa web actualizada.	Cadena

Muestra de código

Ejemplo 1 de ReplaceWebLayer (script independiente)

El siguiente script sustituye una capa web por los Id. de elemento de las capas de entrada.

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.")

Ejemplo 2 de ReplaceWebLayer (script independiente)

El siguiente script sustituye una capa web de ArcGIS Enterprise por las URL de servicio de las capas de entrada.

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.")

Entornos

Espacio de trabajo actual

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí