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 los siguientes tipos de capas web:
- Capas de teselas vectoriales
- Capas de teselas
- Capas de escena publicadas desde una de las siguientes fuentes:
- Paquetes de capas de escena alojados en ArcGIS Online o en un portal de ArcGIS Enterprise
- Cachés de escenas de referencia en carpetas o en data stores de la nube
Para sustituir una capa de teselas vectoriales en un portal de ArcGIS Enterprise, debe utilizar 10.6 o una versión posterior. Para sustituir una capa de teselas, debe utilizar 10.8 o una versión posterior. Para sustituir una capa de escena, debe utilizar 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.
El tipo de capa de escena de las capas de destino y actualización debe coincidir. Por ejemplo, no puede sustituir una capa de escena de edificios por una capa de escena de objetos 3D.
Para sustituir una capa de escena web, la capa de destino y la capa de actualización se deben publicar desde la misma fuente. Por ejemplo, no puede sustituir una capa de escena web publicada desde un paquete de capas de escena por una capa de escena web publicada desde una caché de escena de referencia.
Para sustituir capas de escenas web publicadas desde cachés de escena de referencia, los servicios de escena de la capa de destino y la capa de actualización deben existir en el mismo servidor y carpeta del servidor.
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 asignar 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
arcpy.server.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. 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 de las siguientes:
| 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 de las siguientes:
| 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.
| 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.
| Boolean |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| updated_target_layer | La URL de la capa web actualizada. | Cadena |
Muestra de código
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.")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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí