CheckOutExtension (arcpy)

Zusammenfassung

Retrieves the license from the License Manager.

Once the extension license has been retrieved by the script, tools using that extension can be used. Once a script is finished with an extension's tools, the CheckInExtension function should be used to return the license to the License Manager so other applications can use it. All checked-out extension licenses and set product licenses are returned to the License Manager when a script completes.

Diskussion

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".

Syntax

CheckOutExtension (extension_code)

Parameter	Erläuterung	Datentyp
extension_code	Keyword for the extension product that is being checked. 3D —Erweiterung "ArcGIS 3D Analyst" Datareviewer —ArcGIS Data Reviewer for Desktop DataInteroperability —ArcGIS Data Interoperability-for-Desktop-Erweiterung Airports —ArcGIS for Aviation: Airports Aeronautical —ArcGIS for Aviation: Charting Bathymetry —ArcGIS for Maritime: Bathymetry Nautical —ArcGIS for Maritime: Charting GeoStats —Erweiterung "ArcGIS Geostatistical Analyst" Network —Erweiterung "ArcGIS Network Analyst" Spatial —Erweiterung "ArcGIS Spatial Analyst" Schematics —Erweiterung "ArcGIS Schematics" Tracking —Erweiterung "ArcGIS Tracking Analyst" JTX —ArcGIS Workflow Manager for Desktop ArcScan —ArcScan Business —Business Analyst Defense —Esri Defense Solution Foundation —Esri Production Mapping Highways —Esri Roads and Highways StreetMap —StreetMap Licensing and extensions	String

Rückgabewert

Datentyp	Erläuterung
String	There are three possible returned values for CheckOutExtension: NotInitialized —No desktop license has been set. Unavailable —The requested license is unavailable to be set. CheckedOut —The license has been set successfully.

Codebeispiel

CheckOutExtension example

Check out 3D extension for use by tools.

import arcpy

class LicenseError(Exception):
    pass

try:
    if arcpy.CheckExtension("3D") == "Available":
        arcpy.CheckOutExtension("3D")
    else:
        # raise a custom exception
        raise LicenseError

    arcpy.env.workspace = "c:/GrosMorne"
    arcpy.HillShade_3d("WesternBrook", "wbrook_hill", 300)
    arcpy.Aspect_3d("WesternBrook", "wbrook_aspect")
    arcpy.CheckInExtension("3D")

except LicenseError:
    print("3D Analyst license is unavailable")
except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))