ダイアグラムの保存 (Store Diagram) (ネットワーク ダイアグラム)

概要

一時的なネットワーク ダイアグラムをデータベースに保存します。ダイアグラムのセキュリティと検索可能性を制御するためのアクセス権限およびタグを割り当てることができます。

ネットワーク ダイアグラムの格納の詳細

使用法

  • このツールは、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用している場合には使用できません。関連する公開されたユーティリティ ネットワーク サービス、トレース ネットワーク サービス、またはファイル ジオデータベースのユーティリティ ネットワークあるいはトレース ネットワークを使用してください。

  • 入力ネットワーク ダイアグラム レイヤーは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはネットワーク ダイアグラム サービスから取得する必要があります。

  • デフォルトでは、新しいネットワーク ダイアグラムは一時的なダイアグラムであり、そのダイアグラムが参照されているマップが閉じた時点で破棄されます。一時的なダイアグラムを保存すると、そのダイアグラムがデータベース内に保持され、別の機会にもう一度開くことができます。

  • 不必要にデータベースのサイズを増やしたり、以降の処理 (データセットのコピー、データベースのアップグレードや移行など) に時間をかけたりするのを避けるには、必要に応じてダイアグラムのみを保存します。たとえば、失いたくない調整済みレイアウトを持つダイアグラムを保存したり、共有するダイアグラムを保存したりします。

  • このアクセス レベルは、保存されたダイアグラムにのみ適用されます。一時的なダイアグラムは、データベースでは利用できず、他のユーザーがアクセスすることもできません。ただ 1 つの例外は、一時的なダイアグラムを含むプロジェクトが保存されて他のユーザーに配布されている場合です。

  • 各タグを数字記号 (#) で区切ると、[ダイアグラムの検索] ウィンドウを使用して効率よく検索できます。

  • 整合性のないダイアグラムを保存しようとすると、実行に失敗します。この場合には、[ダイアグラムの更新 (Update Diagram)] ツールを使用して、保存の前に整合性が確保されるようにダイアグラムを更新します。

  • 保存されていない編集を含むダイアグラムを保存しようとすると、実行に失敗します。ネットワーク トポロジがデータベースに最後に保存された時点がダイアグラムに反映されるように、ダイアグラムを保存する前に、編集をすべて保存しておく必要があります。

  • ダイアグラムの格納機能が無効になっているテンプレートに基づいてダイアグラムを格納しようとすると失敗します。ダイアグラムの格納は [ダイアグラム テンプレートの変更 (Alter Diagram Template)] ツールを使用してダイアグラム テンプレート レベルでブロックすることができ、関連性のない格納済みダイアグラムではデータベース領域が無駄になりません。

  • ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用している場合は、ArcGIS Enterprise ポータルに接続しなくても、[パブリック] アクセス権限でダイアグラムを格納することができます。ただし、[保護] または [プライベート] アクセス権限で格納する場合は、接続が必要となります。

構文

arcpy.nd.StoreDiagram(in_network_diagram_layer, out_name, {access_right_type}, {tags})
パラメーター説明データ タイプ
in_network_diagram_layer

保存する一時的なネットワーク ダイアグラム レイヤー。

Diagram Layer
out_name

出力ネットワーク ダイアグラムの名前。

Diagram Layer
access_right_type
(オプション)

入力ダイアグラムのアクセス権限レベルを指定します。

  • PUBLIC他のユーザーにダイアグラムへの完全アクセス権限が付与されます。つまり、すべてのユーザーは、ダイアグラムを表示、編集、更新、および上書きできます。ただし、ダイアグラムの所有者とポータル ユーティリティ ネットワーク の所有者以外のユーザーは、エンタープライズ ジオデータベース内の ユーティリティ ネットワーク に関連するダイアグラムの場合、[ダイアグラム プロパティの変更 (Alter Diagram Properties)] ツールを使用してアクセス権限レベルを変更することができません。これがデフォルトです。
  • PROTECTED他のユーザーにダイアグラムへの読み取り専用アクセス権限が付与されます。他のユーザーは、ダイアグラムを編集、更新、上書きできません。
  • PRIVATE 他のユーザーにダイアグラムへのアクセス権限が付与されません。対応するダイアグラム アイテムが [ダイアグラムの検索] ウィンドウで他のユーザーに表示されなくなります。
String
tags
(オプション)

[ダイアグラムの検索] ウィンドウを使用した、格納済みダイアグラムの検索に役立つタグ。

# 文字を使用して各タグを区切り、効率よくダイアグラムを検索できるようにします。

String

コードのサンプル

StoreDiagram (ダイアグラムの保存) の例 (スタンドアロン)

次のスタンドアロン スクリプトは、ネットワーク ダイアグラムを作成しデータベースに格納する方法を示しています。

# Name: GenerateAndStoreADiagram.py
# Description:  Generate and store a diagram from a set of features based on a feature class and an attribute query.
# Import system modules
import arcpy
# Initialize variables
input_network = "https://cezembre.esri.com/server/rest/services/Naperville_Electric_SQL/FeatureServer/0"
input_fc = "https://cezembre.esri.com/server/rest/services/Naperville_Electric_SQL/FeatureServer/7"
sql_expression = "SUBNETWORKNAME='RMT003'"
template_name = "Basic"
output_diagram_name = "MyBasicRMT003Diagram"
# Set overwrite option
arcpy.env.overwriteOutput = True
# Make a layer from features in the feature class filtered out using an attribute query
FeatureLayer = arcpy.MakeFeatureLayer_management(input_fc, "built_featurelayer", 
                                                 sql_expression)
# Create a diagram based on a given template name from those features
result = arcpy.CreateDiagram_nd(input_network, template_name, 
                                "built_featurelayer")
diagram_name = result[1]
arcpy.MakeDiagramLayer_nd(input_network, diagram_name, 
                          "built_diagramlayer")
# Store the resulting diagram in the database. 
arcpy.StoreDiagram_nd("built_diagramlayer", output_diagram_name)

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック