CheckOutExtension

Résumé

Retrieves the license from the License Manager.

Licence :

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.

Syntaxe

CheckOutExtension (extension_code)

Paramètre	Explication	Type de données
extension_code	Specifies the extension product to be checked. 3D —Extension 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 —Extension ArcGIS Data Interoperability for Desktop Defense —ArcGIS Defense Mapping Foundation —ArcGIS Production Mapping GeoStats —Extension 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 —Extension ArcGIS Network Analyst Publisher —ArcGIS Publisher Schematics —Extension 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 —Extension ArcGIS Spatial Analyst Tracking —Extension ArcGIS Tracking Analyst Learn more about accessing licenses and extensions in Python	String

Valeur renvoyée

Type de données	Explication
String	The function returns a string indicating the success or failure of the checkout. NotInitialized —No desktop license has been set. Unavailable —The requested license is unavailable to be set. CheckedOut —The license has been set successfully.

Exemple de code

CheckOutExtension example

Checks out the Extension ArcGIS 3D Analyst 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))