Accès aux licences et aux extensions dans Python
Chaque fois qu’un outil est exécuté dans un script, une licence ArcGIS est requise. Les outils des extensions ArcGIS, tels que l'Extension ArcGIS Spatial Analyst, nécessitent une licence supplémentaire pour cette extension. Si les licences requises ne sont pas disponibles, un outil échoue et renvoie des messages d'erreur. Par exemple, si vous effectuez l'installation avec une licence ArcGIS for Desktop Basic et que vous essayez d'exécuter un outil nécessitant une licence Standard ou Advanced, l'outil échoue.
Lors de l'utilisation d'une licence ArcGIS for Desktop Basic ou Standard, un script doit définir le produit sur Basic ou Standard. De même, lors de l'utilisation d'une licence Engine ou EngineGeoDB, un script doit définir le produit sur Engine ou EngineGeoDB. Si aucune licence n'est spécifiée explicitement, elle est initialisée en fonction du niveau de licence disponible le plus élevé lors du premier accès à un outil, une fonction ou une classe ArcPy.
Chaque outil vérifie la présence de la licence appropriée. S'il ne dispose pas des éléments nécessaires, il échoue. Pour vous protéger contre une exécution partielle suivie d'un échec, effectuez une vérification en début de script pour échouer immédiatement.
Astuce:La définition du produit et des extensions est uniquement nécessaire dans les scripts autonomes. Si vous exécutez des outils à partir de la fenêtre Python ou à l'aide d'outils de script, le produit est déjà défini à partir de l'application et les extensions actives sont basées sur la boîte de dialogue Extensions.
Licences Desktop, Engine/Server
Les modules de produit sont importés avant l'importation d'arcpy pour définir la licence bureautique utilisée par un script. La fonction CheckProduct permet de vérifier la disponibilité des licences bureautiques, tandis que la fonction ProductInfo indique la licence de produit actuelle.
Legacy :Le niveau de produit doit être défini en important le module de produit approprié (arcinfo, arceditor, arcview, arcserver, arcenginegeodb ou arcengine) avant d'importer arcpy. La fonction SetProduct est une fonction héritée et ne permet pas de définir le produit après l'importation d'arcpy.
Licences d'extensions
Les licences des extensions peuvent être récupérées à partir d'un gestionnaire de licences et renvoyées lorsqu'elles ne sont plus utiles. CheckExtension permet de vérifier si une licence est disponible pour être utilisée avec un type d'extension spécifique, tandis que CheckOutExtension effectue l'extraction de la licence. Lorsque la licence de l'extension a été extraite par le script, les outils de l'extension peuvent être exécutés. Lorsqu'un script a terminé l'utilisation des outils d'une extension particulière, la fonction CheckInExtension doit être utilisée pour restituer la licence au gestionnaire de licence afin de permettre à d'autres applications de l'utiliser. Toutes les licences d'extension extraites et les licences de produit définies sont renvoyées au gestionnaire de licences lorsqu'un script est terminé.
L'exemple suivant exécute certains outils ArcGIS 3D Spatial Analyst et définit la licence de produit sur ArcGIS for Desktop Basic, car aucune licence ArcGIS for Desktop Advanced n'est requise pour exécuter des outils à partir d'une extension. Le script échoue si la licence ArcGIS for Desktop Basic n'est pas définie de façon explicite et si aucune licence ArcGIS for Desktop Advanced n'est disponible, car une licence est nécessaire pour exécuter les outils de l'extension.
class LicenseError(Exception):
pass
# Set desktop license used to ArcGIS for Desktop Basic
#
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 Extension ArcGIS 3D Analyst
#
arcpy.CheckInExtension("3D")
Dans l'exemple ci-dessus, l'Extension ArcGIS 3D Analyst est insérée selon une clause finally, ce qui signifie qu'elle est toujours réinsérée, qu'une exception se produise ou pas.
Les valeurs renvoyées Failed, Unavailable ou NotLicensed indiquent que l'utilisation de l'extension n'a pas réussi.
Vous trouverez ci-dessous les noms des extensions et leurs noms de code d'extension :
|
Extension |
Code extension |
|---|---|
|
Extension ArcGIS 3D Analyst |
3D |
|
Extension ArcGIS Schematics |
Schematics |
|
ArcScan |
ArcScan |
|
Business Analyst |
Affaires |
|
Extension ArcGIS Data Interoperability pour Desktop |
DataInteroperability |
|
Extension ArcGIS Geostatistical Analyst |
GeoStats |
|
Extension ArcGIS Workflow Manager for Desktop |
JTX |
|
Extension ArcGIS Network Analyst |
Réseau |
|
Esri Aeronautical Solution |
Aeronautical |
|
Esri Defense Mapping |
Défense |
|
Esri Production Mapping |
Foundation |
|
Extension ArcGIS Data Reviewer for Desktop |
Datareviewer |
|
Esri Nautical Solution |
Nautical |
Bathymétrie Esri | Nauticalb |
|
Extension ArcGIS Spatial Analyst |
Spatial |
|
StreetMap |
StreetMap |
|
Extension ArcGIS Tracking Analyst |
Suivi |
Noms de code de produit
|
Codes produit |
|---|
|
ArcView (équivalent de la licence ArcGIS for Desktop Basic) |
|
ArcEditor (équivalent de la licence ArcGIS for Desktop Standard) |
|
ArcInfo (équivalent de la licence ArcGIS for Desktop Advanced) |
|
Engine |
|
EngineGeoDB |
|
ArcServer |
Fonctions de gestion des licences
|
Fonction |
Explication | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CheckExtension(extension) |
Permet de vérifier si une licence disponible peut être utilisée pour un type d'extension spécifique.
|
||||||||||||||||
|
CheckInExtension(extension) |
Renvoie la licence pour que d'autres applications puissent l'utiliser.
|
||||||||||||||||
|
CheckOutExtension(extension) |
Récupère la licence.
|
||||||||||||||||
|
CheckProduct(code) |
Vérifie si la licence demandée est disponible.
|
||||||||||||||||
|
ProductInfo() |
Indique la licence du produit courant.
|
||||||||||||||||
|
SetProduct(code) |
Définit la licence bureautique.
|