ArcMap

CheckExtension

Zusammenfassung

Checks to see if a license is available to be checked out for a specific type of extension.

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.

Learn more about licensing and extensions

Syntax

CheckExtension (extension_code)
ParameterErläuterungDatentyp
extension_code

Keyword for the extension product that is being checked.

  • 3D —Erweiterung "ArcGIS 3D Analyst"
  • Aeronautical —ArcGIS for Aviation: Charting
  • Airports —ArcGIS for Aviation: Airports
  • ArcScan —ArcScan
  • Bathymetry —ArcGIS for Maritime: Bathymetry
  • Business —ArcGIS Business Analyst
  • DataReviewer —ArcGIS Data Reviewer for Desktop
  • DataInteroperability —Erweiterung "ArcGIS Data Interoperability for Desktop"
  • Defense —Esri Defense Solution
  • Foundation —Esri Production Mapping
  • GeoStats —Erweiterung "ArcGIS Geostatistical Analyst"
  • Highways —Esri Roads and Highways
  • JTX —ArcGIS Workflow Manager for Desktop
  • LocationReferencing —ArcGIS Pipeline Referencing
  • Nautical —ArcGIS for Maritime: Charting
  • Network —Erweiterung "ArcGIS Network Analyst"
  • Schematics —Erweiterung "ArcGIS Schematics"
  • Spatial —Erweiterung "ArcGIS Spatial Analyst"
  • StreetMap —StreetMap Premium for ArcGIS
  • Tracking —Erweiterung "ArcGIS Tracking Analyst"
String

Rückgabewert

DatentypErläuterung
String

There are four possible returned values for CheckExtension:

  • Available —The requested license is available to be set.
  • Unavailable —The requested license is unavailable to be set.
  • NotLicensed —The requested license is not valid.
  • Failed —A system failure occurred during request.

Codebeispiel

CheckExtension example

Check for availability of Erweiterung "ArcGIS 3D Analyst" before checking it out.

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))

Verwandte Themen