Zugreifen auf Lizenzen und Erweiterungen in Python
Für jede Ausführung eines Werkzeugs in einem Skript ist eine ArcGIS-Lizenz erforderlich. Für Werkzeuge aus ArcGIS-Erweiterungen wie der Erweiterung "ArcGIS Spatial Analyst" ist eine zusätzliche Lizenz für die jeweilige Erweiterung erforderlich. Falls die benötigten Lizenzen nicht verfügbar sind, schlägt die Ausführung eines Werkzeugs fehl, und Fehlermeldungen werden ausgegeben. Wenn Sie beispielsweise eine Installation mit einer ArcGIS for Desktop Basic-Lizenz ausführen und versuchen, ein Werkzeug auszuführen, das eine Standard- oder Advanced-Lizenz erfordert, schlägt das Werkzeug fehl.
Bei Verwendung einer ArcGIS for Desktop Basic- oder Standard-Lizenz, muss ein Skript das Produkt auf Basic oder Standard festlegen. Bei der Verwendung einer Engine- oder EngineGeoDB-Lizenz muss ein Skript das Produkt entsprechend auf Engine bzw. EngineGeoDB festlegen. Wenn keine Lizenz ausdrücklich festgelegt ist, wird die Lizenz beim ersten Zugriff auf ein ArcPy-Werkzeug, eine –Funktion oder eine –Klasse in Abhängigkeit von der höchsten verfügbaren Lizenzstufe initialisiert.
Jedes Werkzeug führt eine Überprüfung durch, um sicherzustellen, dass die entsprechende Lizenz vorliegt. Ist dies nicht der Fall, schlägt die Ausführung fehl. Um zu verhindern, dass die Ausführung zum Teil erfolgt und dann fehlschlägt, können Sie am Anfang des Skripts eine Überprüfung durchführen, damit das Fehlschlagen gleich erkannt wird.
Tipp:Die Einstellung des Produkts und der Erweiterungen ist nur innerhalb eigenständiger Skripte erforderlich. Wenn Sie Werkzeuge im Python-Fenster ausführen oder Skriptwerkzeuge verwenden, wird das Produkt bereits in der Anwendung festgelegt, und die aktiven Erweiterungen basieren auf dem Dialogfeld "Erweiterungen".
Desktop- und Engine/Server-Lizenzen
Produktmodule werden vor dem Import von ArcPy importiert, um die von einem Skript verwendete Desktop-Lizenz zu definieren. Mit der Funktion CheckProduct können Sie die Verfügbarkeit von Desktop-Lizenzen überprüfen, und die Funktion ProductInfo meldet die aktuelle Produktlizenz.
Veraltet:Es ist ratsam, die Produktebene festzulegen, indem Sie das entsprechende Produktmodul (arcinfo, arceditor, arcview, arcserver, arcenginegeodb oder arcengine) vor dem Importieren von ArcPy importieren. Die Funktion SetProduct ist eine Legacyfunktion, die das Produkt nicht festlegen kann, nachdem ArcPy importiert wurde.
Erweiterungslizenzen
Lizenzen für Erweiterungen können von einem Lizenzmanager abgerufen und zurückgegeben werden, wenn sie nicht mehr erforderlich sind. CheckExtension wird verwendet, um zu überprüfen, ob eine Lizenz zum Auschecken für einen bestimmten Typ von Erweiterung verfügbar ist. Mit CheckOutExtension wird die Lizenz tatsächlich abgerufen. Nachdem die Erweiterungslizenz vom Skript abgerufen wurde, können die Werkzeuge der betreffenden Erweiterung ausgeführt werden. Nachdem ein Skript die Werkzeuge einer bestimmten Erweiterung ausgeführt hat, sollte die Lizenz mit der Funktion CheckInExtension an den Lizenzmanager zurückgegeben werden, sodass diese von anderen Anwendungen verwendet werden kann. Alle ausgecheckten Erweiterungslizenzen und festgelegten Produktlizenzen werden nach Abschluss eines Skriptes an den Lizenzmanager zurückgegeben.
Im folgenden Beispiel werden Werkzeuge von ArcGIS 3D Analyst ausgeführt und die Desktop-Produktlizenz wird auf ArcGIS for Desktop Basic festgelegt, da eine ArcGIS for Desktop Advanced-Lizenz für die Ausführung von Erweiterungswerkzeugen nicht erforderlich ist. Das Skript schlägt fehl, wenn die ArcGIS for Desktop Basic-Lizenz nicht ausdrücklich festgelegt und keine ArcGIS for Desktop Advanced-Lizenz verfügbar ist, da für die Ausführung von Erweiterungswerkzeugen eine Desktop-Lizenz erforderlich ist.
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 Erweiterung "ArcGIS 3D Analyst"
#
arcpy.CheckInExtension("3D")
Im Beispiel oben wird die Erweiterung Erweiterung "ArcGIS 3D Analyst" nach einer finally-Klausel eingecheckt. Dadurch wird sichergestellt, dass die Erweiterung unabhängig davon, ob ein Fehler aufgetreten ist, immer eingecheckt wird.
Wenn der Wert Failed, Unavailable oder NotLicensed zurückgegeben wird, gibt dies an, dass die Erweiterung nicht erfolgreich ausgecheckt werden konnte.
Im Folgenden sind die Namen der Erweiterungen und die zugehörigen Erweiterungscodes aufgeführt:
|
Erweiterung |
Erweiterungscode |
|---|---|
|
Erweiterung "ArcGIS 3D Analyst" |
3D |
|
ArcGIS Data Interoperability-for-Desktop-Erweiterung |
DataInteroperability |
|
ArcGIS Data Reviewer for Desktop |
Datareviewer |
ArcGIS for Aviation: Airports | Flughäfen |
|
ArcGIS for Aviation: Charting |
Aeronautical |
ArcGIS for Maritime: Bathymetry | Bathymetry |
|
ArcGIS for Maritime: Charting |
Nautical |
|
Erweiterung "ArcGIS Geostatistical Analyst" |
GeoStats |
|
Erweiterung "ArcGIS Network Analyst" |
Netzwerk |
|
Erweiterung "ArcGIS Spatial Analyst" |
Räumlich |
|
Erweiterung "ArcGIS Schematics" |
Schematics |
|
Erweiterung "ArcGIS Tracking Analyst" |
Verfolgung |
|
ArcGIS Workflow Manager for Desktop |
JTX |
|
ArcScan |
ArcScan |
|
Business Analyst |
Unternehmen |
|
Esri Defense Mapping |
Militär |
|
Esri Production Mapping |
Foundation |
Esri Roads and Highways | Fernstraßen |
|
StreetMap |
StreetMap |
Produktcodenamen
|
Produktcodes |
|---|
|
ArcView (entspricht der ArcGIS for Desktop Basic-Lizenz) |
|
ArcEditor (entspricht der ArcGIS for Desktop Standard-Lizenz) |
|
ArcInfo (entspricht der ArcGIS for Desktop Advanced-Lizenz) |
|
Engine |
|
EngineGeoDB |
|
ArcServer |
Lizenzierungsfunktionen
|
Funktion |
Erläuterung | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CheckExtension(Erweiterung) |
Überprüft, ob eine Lizenz verfügbar ist, die für einen bestimmten Typ von Erweiterung ausgecheckt werden kann.
|
||||||||||||||||
|
CheckInExtension(Erweiterung) |
Gibt die Lizenz zurück, sodass andere Anwendungen sie verwenden können.
|
||||||||||||||||
|
CheckOutExtension(Erweiterung) |
Ruft die Lizenz ab.
|
||||||||||||||||
|
CheckProduct(Code) |
Überprüft, ob die angeforderte Lizenz verfügbar ist.
|
||||||||||||||||
|
ProductInfo() |
Gibt die aktuelle Produktlizenz zurück.
|
||||||||||||||||
|
SetProduct(Code) |
Definiert die Desktop-Lizenz.
|