CheckOutExtension

Zusammenfassung

Lizenz:

CheckOutExtension is only needed when using a Concurrent Use license; for all other cases it has no effect. When using a Concurrent Use license, 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 so other applications can use it. All checked-out extension licenses and set product licenses are returned when a script completes.

Auswertung

Hinweis:

CheckOutExtension is only needed when using a Concurrent Use license; for all other cases it has no effect. When using a Concurrent Use license, 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.

Syntax

CheckOutExtension (extension_code)

Parameter	Erklärung	Datentyp
extension_code	Keyword for the extension product that is being checked. 3D —Erweiterung "ArcGIS 3D Analyst" Aeronautical —ArcGIS Aviation Charting Airports —ArcGIS Aviation Airports ArcScan —ArcScan Bathymetry —ArcGIS Bathymetry BusinessPrem —ArcGIS Business Analyst DataReviewer —ArcGIS Data Reviewer Desktop DataInteroperability —Erweiterung "ArcGIS Data Interoperability for Desktop" Defense —ArcGIS Defense Mapping Foundation —ArcGIS Production Mapping GeoStats —Erweiterung "ArcGIS Geostatistical Analyst" ImageAnalyst —Image Analyst JTX —ArcGIS Workflow Manager (Classic) Desktop LocationReferencing —ArcGIS Pipeline Referencing or ArcGIS Roads and Highways LocateXT —LocateXT extension Nautical —ArcGIS Maritime Network —Erweiterung "ArcGIS Network Analyst" Publisher —ArcGIS Publisher Schematics —Erweiterung "ArcGIS Schematics" SMPAsiaPacific —StreetMap Premium Asia Pacific SMPEurope —StreetMap Premium Europe SMPJapan —StreetMap Premium Japan SMPLatinAmerica —StreetMap Premium Latin America SMPMiddleEastAfrica —StreetMap Premium Middle East Africa SMPNorthAmerica —StreetMap Premium North America Spatial —Erweiterung "ArcGIS Spatial Analyst" Tracking —Erweiterung "ArcGIS Tracking Analyst" Licensing and extensions	String

Rückgabewert

Datentyp	Erklärung
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))