ArcGIS Help 10.1 - Python でのライセンスおよびエクステンションへのアクセス

ツールをスクリプトから実行する場合は、必ず ArcGIS ライセンスが必要です。ArcGIS Spatial Analyst エクステンションなどの ArcGIS エクステンションのツールを使用するには、そのエクステンションの追加ライセンスが必要です。必要なライセンスがない場合、ツールの実行は失敗し、エラーメッセージが返されます。たとえば、インストールに ArcGIS for Desktop Basic ライセンスをインストールした場合に、Standard または Advanced のライセンスが必要なツールを実行しようとすると、そのツールの実行は失敗します。

ArcGIS for Desktop Basic または Standard のライセンスを使用する場合は、スクリプト上で Basic または Standard に製品を設定する必要があります。同様に、Engine または EngineGeoDB のライセンスを使用する場合は、スクリプト上で製品を Engine または EngineGeoDB に設定する必要があります。ライセンスが明示的に設定されていない場合は、ArcPy のツール、関数、またはクラスに初めてアクセスするときに、使用可能な最上位のライセンスレベルに基づいてライセンスが初期化されます。

適切なライセンスが存在するかどうかのチェックは、すべてのツールで行われます。必要なライセンスがない場合、ツールの実行は失敗します。途中まで実行した後で失敗するという状況を避けるために、スクリプトの先頭でチェックを実行しておけば、失敗した場合にただちに終了できます。

ヒント:

製品とエクステンションの設定は、スタンドアロンスクリプト内でのみ必要です。Python ウィンドウからツールを実行する場合や、スクリプトツールを使用する場合は、製品はアプリケーション内ですでに設定されており、アクティブなエクステンションは [エクステンション] ダイアログボックスに基づいて決められます。

デスクトップ、エンジン/サーバのライセンス

arcpy をインポートする前に製品モジュールがインポートされ、スクリプトによって使用されるデスクトップライセンスが定義されます。CheckProduct 関数を使用してデスクトップライセンスが使用可能かどうか確認できる他、ProductInfo 関数を使用すると現在の製品ライセンス情報が報告されます。

レガシー:

arcpy をインポートする前に、該当する製品モジュール（arcinfo、arceditor、arcview、arcserver、arcenginegeodb、arcengine）をインポートして、製品レベルを設定する必要があります。SetProduct 関数はレガシー関数であり、arcpy がインポートされた後は製品を設定できなくなります。

エクステンションライセンス

エクステンションのライセンスはライセンスマネージャから取得でき、不要になったときは返却できます。特定のタイプのエクステンションについてライセンスがチェックアウト可能かどうか調べるには CheckExtension を使用し、CheckOutExtension はライセンスを実際に取得します。スクリプトでエクステンションライセンスを取得した後、エクステンションツールを実行できます。スクリプトが特定のエクステンションからのツールを使用し終わったら、CheckInExtension 関数を使用してライセンスマネージャにライセンスを返却し、他のアプリケーションがそのライセンスを使用できるようにします。チェックアウトされたエクステンションライセンスと、設定された製品ライセンスはすべて、スクリプトが完了するとライセンスマネージャに返却されます。

次の例では、いくつかの ArcGIS 3D Analyst ツールを実行し、デスクトップ製品ライセンスを ArcGIS for Desktop Basic に設定します。これは、エクステンションからのツールを実行するために ArcGIS for Desktop Advanced ライセンスが必要ないからです。エクステンションツールを実行するにはデスクトップライセンスが必要なので、ArcGIS for Desktop Basic ライセンスが明示的に設定されておらず ArcGIS for Desktop Advanced ライセンスも使用できない場合は、スクリプトの実行は失敗します。

class LicenseError(Exception):
    pass

# Set desktop license used to ArcGIS for Desktop Basic
#
import arcview
import arcpy
from arcpy import env

try:
    if arcpy.CheckExtension("3D") == "Available":
        arcpy.CheckOutExtension("3D")
    else:
        # Raise a custom exception
        #
        raise LicenseError
    
    env.workspace = "D:/GrosMorne"
    arcpy.HillShade_3d("WesternBrook", "westbrook_hill", 300)
    arcpy.Aspect_3d("WesternBrook", "westbrook_aspect")

except LicenseError:
    print "3D Analyst license is unavailable"  
except:
    print arcpy.GetMessages(2)
finally:
    # Check in the ArcGIS 3D Analyst エクステンション
    #
    arcpy.CheckInExtension("3D")

上の例では、ArcGIS 3D Analyst エクステンションが finally 節でチェックインされており、これにより、このエクステンションは例外が発生したかどうかに関係なく常にチェックインし、戻されます。

Failed、Unavailable、または NotLicensed の値が返された場合は、エクステンションのチェックアウトが正常に行われなかったことを示しています。

次に、エクステンションの名前とエクステンションコード名を示します。

エクステンション	エクステンションコード
ArcGIS 3D Analyst エクステンション	3D
ArcGIS Schematics エクステンション	Schematics
ArcScan	ArcScan
Business Analyst	Business
ArcGIS Data Interoperability エクステンション for Desktop	DataInteroperability
ArcGIS Geostatistical Analyst エクステンション	GeoStats
ArcGIS Workflow Manager エクステンション for Desktop	JTX
ArcGIS Network Analyst エクステンション	Network
Esri Aeronautical Solution	Aeronautical
Esri Defense Mapping	Defense
Esri Production Mapping	Foundation
ArcGIS Data Reviewer エクステンション for Desktop	Datareviewer
Esri Nautical Solution	Nautical
Esri Bathymetry	Nauticalb
ArcGIS Spatial Analyst エクステンション	Spatial
StreetMap	StreetMap
ArcGIS Tracking Analyst エクステンション	Tracking

製品コード名

製品コード
ArcView（ArcGIS for Desktop Basic ライセンスに相当）
ArcEditor（ArcGIS for Desktop Standard ライセンスに相当）
ArcInfo（ArcGIS for Desktop Advanced ライセンスに相当）
Engine
EngineGeoDB
ArcServer

ライセンス関数

関数

説明

CheckExtension(extension)

特定のタイプのエクステンションについてライセンスがチェックアウト可能かどうか調べます。

戻り値	意味
Available	リクエストされたライセンスは設定可能です。
Unavailable	リクエストされたライセンスは設定できません。
NotLicensed	リクエストされたライセンスは有効ではありません。
Failed	リクエスト時にシステムエラーが発生しました。

CheckInExtension(extension)

他のアプリケーションが使用できるようにライセンスを返却します。

戻り値	意味
NotInitialized	デスクトップライセンスが設定されていません。
Failed	リクエスト時にシステムエラーが発生しました。
CheckedIn	ライセンスは正常に返却されました。

CheckOutExtension(extension)

ライセンスを取得します。

戻り値	意味
NotInitialized	デスクトップライセンスが設定されていません。
Unavailable	リクエストされたライセンスは設定できません。
CheckedOut	ライセンスが正常に設定されました。

CheckProduct(code)

リクエストされたライセンスが使用可能かどうか調べます。

戻り値	意味
AlreadyInitialized	ライセンスはスクリプト内にすでに設定済みです。
Available	リクエストされたライセンスは設定可能です。
Unavailable	リクエストされたライセンスは設定できません。
NotLicensed	リクエストされたライセンスは有効ではありません。
Failed	リクエスト時にシステムエラーが発生しました。

ProductInfo()

現在の製品ライセンス情報を返します。

戻り値	意味
NotInitialized	ライセンスが設定されていません。
ArcInfo	ArcGIS for Desktop Advanced ライセンスが設定されています。
ArcEditor	ArcGIS for Desktop Standard ライセンスが設定されています。
ArcView	ArcGIS for Desktop Basic ライセンスが設定されています。
ArcServer	ArcGIS for Server ライセンスが設定されています。
EngineGeoDB	EngineGeoDB ライセンスが設定されています。
Engine	Engine ライセンスが設定されています。

SetProduct(code)

デスクトップライセンスを定義します。

戻り値	意味
CheckedOut	ライセンスが正常に設定されました。
AlreadyInitialized	ライセンスはスクリプト内にすでに設定済みです。
NotLicensed	リクエストされたライセンスは有効ではありません。
Failed	リクエスト時にシステムエラーが発生しました。

9/14/2013

Python でのライセンスおよびエクステンションへのアクセス

デスクトップ、エンジン/サーバのライセンス

エクステンション ライセンス

ライセンス関数

エクステンションライセンス