Acceder a licencias y extensiones en Python
Cada vez que se ejecute una herramienta en una secuencia de comandos, se necesita una licencia de ArcGIS Desktop. Las herramientas de las extensiones de ArcGIS, como ArcGIS Spatial Analyst, requieren licencias adicionales para esa extensión. Si las licencias necesarias no están disponibles, la herramienta falla y arroja mensajes de error. Por ejemplo, si realiza la instalación con una licencia de ArcView y trata de ejecutar un conjunto de herramientas para una licencia de ArcEditor o ArcInfo, la herramienta fallará.
Una secuencia de comandos deberá establecer el producto en ArcView o ArcEditor al utilizar una licencia de ArcView o de ArcEditor. De la misma manera, una secuencia de comandos deberá establecer el producto en Engine o EngineGeoDB al utilizar una licencia de Engine o de EngineGeoDB. Si no se establece una licencia de manera explícita, la primera vez que se acceda a una herramienta, función o clase ArcPy se inicializará la licencia según el nivel de licencia más alto disponible.
Cada herramienta realiza verificaciones para asegurarse de que tiene la licencia apropiada. Si no tiene las licencias requeridas, falla. Para evitar la situación de ejecutar una parte y que falle, puede realizar una verificación en la parte superior de la secuencia de comandos y que falle inmediatamente.
Sugerencia:Solamente es necesario establecer el producto y las extensiones dentro de las secuencias de comandos independientes. Si está ejecutando las herramientas desde la ventana de Python o utilizando herramientas de secuencia de comandos, el producto ya está establecido dentro de la aplicación y las extensiones activas están basadas en el cuadro de diálogo Extensiones.
Licencias Desktop, Engine/Server
Los módulos del producto se importan antes de importar arcpy para definir la licencia de escritorio utilizada por una secuencia de comandos. La función CheckProduct se puede utilizar para verificar la disponibilidad de las licencias de escritorio, mientras que la función ProductInfo informa cuál es la licencia de producto actual.
Legado:El nivel del producto debe establecerse al importar el módulo de producto apropiado (arcinfo, arceditor, arcview, arcserver, arcenginegeodb, arcengine) antes de importar arcpy. La función SetProduct es una función heredada y no puede establecer el producto una vez que se haya importando arcpy.
Licencias de extensión
Las licencias para las extensiones se pueden recuperar desde un administrador de licencias y devolver una vez que ya no se necesitan. CheckExtension se utiliza para ver si una licencia está disponible para que se realice el check-out para un tipo de extensión específico, mientras que CheckOutExtension realmente recupera la licencia. Una vez que la secuencia de comandos recuperó la licencia de extensión, se pueden ejecutar las herramientas de extensión. Una vez que se realiza una secuencia de comandos con las herramientas de una extensión en particular, debe utilizarse la función CheckInExtension para devolver la licencia al administrador de licencias de modo que otras aplicaciones puedan utilizarla. Todas las licencias de extensión a las que se realizó el check-out y las licencias de productos establecidas se devuelven al administrador de licencias cuando se completa una secuencia de comandos.
El siguiente ejemplo ejecuta algunas herramientas de ArcGIS 3D Analyst y establece la licencia de producto de escritorio de ArcView, ya que no se requiere una licencia de ArcInfo para ejecutar las herramientas desde una extensión. La secuencia de comandos fallará si la licencia de ArcView no se establece de manera explícita y no hay una licencia de ArcInfo disponible, ya que se requiere una licencia de escritorio para ejecutar las herramientas de extensión.
class LicenseError(Exception): pass # Set desktop license used to ArcView # 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 3D Analyst extension # arcpy.CheckInExtension("3D")
En el ejemplo anterior, se realiza el check-in de la extensión 3D Analyst en una cláusula finally, lo que asegura que siempre se vuelva a realizar el check-in de la extensión, independientemente de que se haya producido una excepción.
Un valor de retorno Failed, Unavailable o NotLicensed indica que no se pudo realizar correctamente el check-out de la extensión.
A continuación se presentan los nombres de las extensiones y los nombres de sus códigos de extensión:
|
Extensión |
Código de la extensión |
|---|---|
|
3D Analyst |
3D |
|
ArcGIS Schematics |
Schematics |
|
ArcScan |
ArcScan |
|
Business Analyst |
Business |
|
Data Interoperability |
DataInteroperability |
|
Geostatistical Analyst |
GeoStats |
|
ArcGIS Workflow Manager |
JTX |
|
Network Analyst |
Red |
|
Esri Aeronautical Solution |
Aeronautical |
|
Esri Defense Mapping |
Defensa |
|
Esri Production Mapping |
Foundation |
|
ArcGIS Data Reviewer |
Datareviewer |
|
Esri Nautical Solution |
Nautical |
|
Spatial Analyst |
Spatial |
|
StreetMap |
StreetMap |
|
Tracking Analyst |
Tracking |
Nombres de códigos de producto
|
Códigos del producto |
|---|
|
ArcInfo |
|
ArcEditor |
|
ArcView |
|
Engine |
|
EngineGeoDB |
|
ArcServer |
Funciones de licencias
|
Función |
Explicación | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CheckExtension(extensión) |
Verifica si una licencia está disponible para que se realice el check-out para un tipo de extensión específico.
|
||||||||||||||||
|
CheckInExtension(extensión) |
Devuelve la licencia de modo que otras aplicaciones puedan utilizarla.
|
||||||||||||||||
|
CheckOutExtension(extensión) |
Recupera la licencia.
|
||||||||||||||||
|
CheckProduct(código) |
Verifica si la licencia solicitada está disponible.
|
||||||||||||||||
|
ProductInfo() |
Devuelve la licencia de producto actual.
|
||||||||||||||||
|
SetProduct(código) |
Define la licencia de escritorio.
|