Chaque fois qu’un outil est exécuté dans un script, une licence ArcGIS est requise. Les outils des extensions ArcGIS, comme l’ArcGIS Spatial Analyst extension, requièrent une licence supplémentaire pour l’extension correspondante. Si les licences requises ne sont pas disponibles, un outil échoue et renvoie des messages d'erreur. Par exemple, si vous procédez à une installation avec une licence ArcGIS Desktop Basic, l’exécution d’un outil qui nécessite une licence Desktop Standard ou Desktop Advanced échoue.
Dans le cas de l’utilisation d’une licence ArcGIS Desktop Basic ou Desktop Standard, un script doit définir le produit sur Desktop Basic ou sur Desktop 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.
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 de bureau, tandis que la fonction ProductInfo indique l’actuelle licence de produit.
Licences d'extensions
Il est possible d’extraire les licences pour extensions d’une gestionnaire de licences et de les restituer après usage. CheckExtension permet de vérifier si une licence est disponible à l’extraction pour un type particulier d’extension, tandis que CheckOutExtension permet d’extraire la licence. Lorsque la licence de l'extension a été extraite par le script, les outils de l'extension peuvent être exécutés. Une fois qu’un script n’a plus besoin des outils d’une extension donnée, il convient d’utiliser la fonction CheckInExtension pour restituer la licence au gestionnaire de licences de manière à la rendre disponible pour d’autres applications. 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 ci-après illustre l’exécution de certains outils ArcGIS 3Danalyst, Analyst, ainsi que la définition de la licence de produit de bureau sur ArcGIS Desktop Basic puisqu’il n’est pas nécessaire d’utiliser une licence ArcGIS Desktop Advanced pour exécuter des outils à partir d’une extension. L’exécution du script échoue si la licence ArcGIS Desktop Basic n’est pas définie explicitement et si aucune licence ArcGIS Desktop Advanced n’est disponible, puisqu’il est nécessaire d’utiliser une licence de bureau pour exécuter des outils d’extension.
class LicenseError(Exception):
pass
# Set desktop license used to Basic (keyword is arcview)
#
import arcview
import arcpy
try:
if arcpy.CheckExtension("3D") == "Available":
arcpy.CheckOutExtension("3D")
else:
# Raise a custom exception
#
raise LicenseError
arcpy.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 arcpy.ExecuteError:
print(arcpy.GetMessages(2))
finally:
# Check in the ArcGIS 3D Analyst extension
#
arcpy.CheckInExtension("3D")
Dans l’exemple ci-dessus, l’ArcGIS 3D Analyst extension est réinsérée selon une clause finally. Ainsi, l’extension est toujours restituée, qu’une exception se produise ou pas.
Une valeur renvoyée Failed, Unavailable ou NotLicensed indique que l’extension n’a pas pu être extraite.
Vous trouverez ci-dessous les noms des extensions et leurs noms de code d'extension :
| Extension | Code extension |
|---|---|
ArcGIS 3D Analyst extension | 3D |
ArcGIS Data Interoperability extension for Desktop | DataInteroperability |
ArcGIS Data Reviewer Desktop | Datareviewer |
ArcGIS Aviation Airports | Aéroports |
ArcGIS Aviation Charting | Aeronautical |
ArcGIS Bathymetry | Bathymétrie |
ArcGIS Maritime | Nautical |
ArcGIS Geostatistical Analyst extension | GeoStats |
ArcGIS Network Analyst extension | Réseau |
ArcGIS Spatial Analyst extension | Spatial |
ArcGIS Schematics extension | Schematics |
ArcGIS Tracking Analyst extension | Suivi de l'emplacement |
ArcGIS Workflow Manager (Classic) Desktop | JTX |
ArcScan | ArcScan |
ArcGIS Business Analyst | Commerce |
ArcGIS Defense Mapping | Défense |
ArcGIS Production Mapping | Foundation |
ArcGIS Roads and Highways | Autoroutes |
StreetMap | StreetMap |
Noms de code de produit
| Codes produit |
|---|
ArcView (équivalent à une licence ArcGIS Desktop Basic) |
ArcEditor (équivalent à une licence ArcGIS Desktop Standard) |
ArcInfo (équivalent à une licence ArcGIS 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.
|