Web レイヤーの置換 (Replace Web Layer) (サーバー)

サマリー

ポータル内の Web レイヤーのコンテンツを別の Web レイヤーのコンテンツに置き換えます。

使用法

• ターゲット レイヤーは、置き換えられる Web レイヤーです。更新レイヤーは、置換 Web レイヤーです。ターゲット レイヤーと更新レイヤーには、次のタイプの Web レイヤーを指定できます。

  • ベクター タイル レイヤー
  • タイル レイヤー
  • 次のいずれかのソースから公開されたシーン レイヤー
    • ArcGIS Online または ArcGIS Enterprise ポータルでホストされているシーン レイヤー パッケージ
    • フォルダーまたはクラウド データ ストア内の参照シーン キャッシュ

• ArcGIS Enterprise ポータルでベクター タイル レイヤーを置き換えるには、10.6 以降のバージョンを使用している必要があります。タイル レイヤーを置き換えるには、10.8 以降のバージョンを使用している必要があります。シーン レイヤーを置き換えるには、10.8.1 以降のバージョンを使用している必要があります。

• ArcGIS Pro のアクティブなポータルは、ターゲット レイヤーおよび更新レイヤーをホストするポータルである必要があります。ターゲット レイヤーおよび更新レイヤーを所有しているアカウントを使用して、ArcGIS Pro にサイン インする必要があります。

• ターゲット レイヤーと更新レイヤーは同じタイプである必要があります。たとえば、ベクター タイル レイヤーをタイル レイヤーに置き換えることはできません。

• ターゲット レイヤーと更新レイヤーのシーン レイヤー タイプは一致する必要があります。たとえば、ビルディング シーン レイヤーを 3D オブジェクト シーン レイヤーに置き換えることはできません。

• Web シーン レイヤーを置き換えるには、ターゲット レイヤーと更新レイヤーが同じソースから公開されている必要があります。たとえば、シーン レイヤー パッケージから公開された Web シーン レイヤーを、参照シーン キャッシュから公開された Web シーン レイヤーに置き換えることはできません。

• 参照シーン キャッシュから公開された Web シーン レイヤーを置き換えるには、ターゲット レイヤーと更新レイヤーのシーン サービスが同じサーバーおよびサーバー フォルダーに存在する必要があります。

• ターゲット レイヤーが更新されると、このレイヤーのコンテンツが置き換えられます。ターゲット レイヤーのアイテム ID およびサービス URL は変更されません。

• 置き換えられる Web レイヤーは、上書きされません。代わりにこのレイヤーは、ポータル内で、新しい名前でアーカイブされます。デフォルトでは、アーカイブ レイヤー名は、<レイヤー名>_archive_<タイムスタンプ> になります。別の名前を割り当てることができますが、その名前は、ポータル内で一意の Web レイヤー名である必要があります。

• デフォルトでは、アーカイブ レイヤーは更新レイヤーのアイテム ID を使用します。アーカイブ レイヤーに新しいアイテム ID を指定することもできます。

• 必要に応じて、ターゲット レイヤーのアイテム情報を、更新レイヤーのアイテム情報に置き換えることができます。アイテム情報を置き換えると、概要、説明、タグ、およびサムネイル画像が置き換えられます。著作権 (帰属) や利用規約などのその他の情報は、置き換えられません。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
ターゲット レイヤー	置き換えられる Web レイヤー。これは、レイヤーまたはカタログ パスに加えて、次のいずれかのアイテム ID またはサービス URL を使用して指定することもできます。 ベクター タイル タイル レイヤー 次のいずれかのソースから公開されたシーン レイヤー シーン レイヤー パッケージ フォルダーまたはクラウド データ ストア内の参照シーン キャッシュ	Vector Tile Layer; Internet Tiled Layer; Scene Layer
アーカイブ レイヤー名	置き換えられた Web レイヤーは、ポータル内にアーカイブ レイヤーとして残ります。アーカイブ レイヤーの一意の名前を指定します。	String
更新レイヤー	置換する Web レイヤー。これは、レイヤーまたはカタログ パスに加えて、次のいずれかのアイテム ID またはサービス URL を使用して指定することもできます。 ベクター タイル タイル レイヤー 次のいずれかのソースから公開されたシーン レイヤー シーン レイヤー パッケージ フォルダーまたはクラウド データ ストア内の参照シーン キャッシュ	Vector Tile Layer; Internet Tiled Layer; Scene Layer
アイテム情報の置換 (オプション)	サムネイル画像、概要、説明、およびタグを置き換えるかどうかを指定します。いずれの場合も、アイテムの著作権 (帰属)、利用規約、および作成元の情報は置き換えられません。 オフ - レイヤーが更新されるときに、ターゲット レイヤーのアイテム情報を置き換えません。これがデフォルトです。 オン - ターゲット レイヤーのアイテム情報を、更新レイヤーのアイテム情報に置き換えます。	Boolean
アーカイブ レイヤー用の新しいアイテムを作成 (オプション)	アーカイブ レイヤーの新しいアイテムを作成するかどうかを指定します。このオプションは、ArcGIS Online および ArcGIS Enterprise 10.8 以降のポータルでサポートされています。 オフ - アーカイブ レイヤーに対して更新レイヤーのアイテム ID が使用されます。ベクター タイル レイヤーおよびタイル レイヤーの場合、これがデフォルトです。 オン - アーカイブ レイヤーに対して新しいアイテム ID が作成されます。シーン レイヤーの場合、これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データ タイプ
更新されたターゲット レイヤー	更新された Web レイヤーの URL。	String

Python

arcpy.server.ReplaceWebLayer(target_layer, archive_layer_name, update_layer, {replace_item_info}, {create_new_item})

名前	説明	データ タイプ
target_layer	置き換えられる Web レイヤー。これは、レイヤーまたはカタログ パスに加えて、次のいずれかのアイテム ID またはサービス URL を使用して指定することもできます。 ベクター タイル タイル レイヤー 次のいずれかのソースから公開されたシーン レイヤー シーン レイヤー パッケージ フォルダーまたはクラウド データ ストア内の参照シーン キャッシュ	Vector Tile Layer; Internet Tiled Layer; Scene Layer
archive_layer_name	置き換えられた Web レイヤーは、ポータル内にアーカイブ レイヤーとして残ります。アーカイブ レイヤーの一意の名前を指定します。	String
update_layer	置換する Web レイヤー。これは、レイヤーまたはカタログ パスに加えて、次のいずれかのアイテム 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	更新された Web レイヤーの URL。	String

コードのサンプル

ReplaceWebLayer (Web レイヤーの置換) の例 1 (スタンドアロン スクリプト)

次のスクリプトは、入力レイヤーのアイテム ID を使用して Web レイヤーを置き換えます。

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 (Web レイヤーの置換) の例 2 (スタンドアロン スクリプト)

次のスクリプトは、ArcGIS Enterprise で入力レイヤーのサービス URL を使用して Web レイヤーを置き換えます。

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: Yes
• Standard: Yes
• Advanced: Yes