Importer par lots des données (AllSource)

Synthèse

Importe des fichiers KML, des fichiers KMZ, des shapefiles, des feuilles de calcul Excel, des fichiers texte contenant des données tabulaires, des fichiers GeoJSON et des fichiers GPX dans des classes d’entités stockées dans une géodatabase unique.

Utilisation

  • Si la valeur Données en entrée est un dossier, il sera exploré de manière récursive afin d’y rechercher des fichiers KML (.kml) et KMZ (.kmz), des shapefiles (.shp), des classeurs Excel (.xlsx et .xls), des fichiers texte contenant des données tabulaires, (.csv, .txt et .tab), des fichiers GeoJSON (.geojson) et des fichiers GPX (.gpx). Le paramètre Filtre permet de limiter les fichiers qui sont importés des dossiers.

  • Les rasters, ou superpositions terrestres contenues dans un fichier .kml ou .kmz, sont convertis en un jeu de données mosaïque dans le paramètre Géodatabase cible. Les rasters source référencés par le jeu de données mosaïque sont stockés dans leur format natif dans un sous-dossier nommé d’après le jeu de données mosaïque. Ce sous-dossier se situe au même emplacement que la géodatabase cible. Ces fichiers sont nommés d’après la valeur Géodatabase cible, le suffixe _Rasters leur étant ajouté. Par exemple, si la valeur Géodatabase cible est C:\Data\OperationalData.gdb, un dossier nommé OperationalData_Rasters est créé sous C:\Data.

  • Si vous importez des fichiers dans une géodatabase d’entreprise, vérifiez que le fichier de connexion à la base de données (.sde) est spécifié sous forme de chemin UNC dans le paramètre Géodatabase cible et que le chemin est accessible par la géodatabase d’entreprise.

  • Il est possible de spécifier en entrée des fichiers KML et KMZ, versions 2.2 et antérieures de la norme Open Geospatial Consortium  KML. Les emplacements des points qui utilisent l’onglet d’adresses (par géocodage) ne sont pas pris en charge. L’emplacement doit être spécifié selon sa latitude et sa longitude dans le fichier KML source.

  • Le délimiteur standard pour les fichiers texte à données tabulaires dotés des extensions .csv et .txt est une virgule, et pour les fichiers dont l’extension est .tab, il s’agit d’une tabulation. Pour utiliser une table en entrée avec un délimiteur non standard, vous devez spécifier ce dernier à l’aide d’un fichier schema.ini. Pour plus d’informations, reportez-vous à la rubrique Fichier Schema.ini (pilote du fichier texte) dans la documentation Microsoft.

  • Pour les feuilles de calcul Excel et les fichiers texte à données tabulaires en entrée, seule la géométrie de type point est prise en charge.

  • La spécification GeoJSON prend en charge plusieurs types de géométrie. Une classe d’entités distincte est créée pour chaque type de géométrie dans le fichier .geojson en entrée selon la convention de dénomination FichierGeoJSONSource_TypeGéométrie. Par exemple, si le fichier .geojson se nomme World Airports.geojson et qu’il contient les types de géométrie point, multi-points, polyligne et polygone, les classes d’entités sont nommées World Airports_Points, World Airports_Multipoint, World Airports_Polylines et World Airports_Polygons.

  • Les systèmes de coordonnées tiennent compte des éléments suivants lors de l’exécution de cet outil :

    • Dans le cas des shapefiles, de fichiers .kml, .kmz, .geojson et .gpx, le système de coordonnées du jeu de données en sortie est le même que celui du jeu de données en entrée. Les spécifications KML et GPX exigent que le système de coordonnées du jeu de données en entrée soit GCS WGS1984.
    • En ce qui concerne les classeurs Excel et les fichiers texte à données tabulaires, le système de coordonnées de la sortie est GCS WGS1984.

  • Si l’une des coordonnées en entrée d’une entité n’est pas valide (coordonnées nulles ou non valides), l’entité correspondante a une géométrie nulle. L’outil Vérifier les géométries permet de rechercher les géométries nulles dans la sortie.

  • Les coordonnées prises en charge pour les fichiers texte à données tabulaires (.csv, .txt et .tab) ainsi que pour les classeurs Excel sont des latitudes et longitudes en degrés décimaux dans le système de référence de carroyage militaire (MGRS) et au format USNG (United States National Grid). La source est recherchée parmi les colonnes de coordonnées dans l’ordre suivant : latitude et longitude dans des colonnes distinctes, latitude et longitude dans une même colonne, MGRS et enfin USNG.

    Remarque :

    En ce qui concerne les valeurs de latitude et de longitude dans une colonne unique, la valeur de latitude doit être la première, la longitude étant séparée par un espace, une virgule ou une barre oblique.

    Les noms de colonnes suivants sont valides :

    • Latitude : latitude, lat, y_coordinate, y_coord et y
    • Longitude : longitude, long, lon, x_coordinate, x_coord et x
    • Latitude/longitude : latitude_longitude, lat_long, lat_lon, xy_coordinate, xy_coordinates, xy_coord, xy_coords et xy
    • Coordonnées MGRS : mgrs, mgrs_coordinate, mgrs_coordinates, mgrs_coord et mgrs_coords
    • Coordonnées USNG : usng, usng_coordinate, usng_coordinates, usng_coord et usng_coords

  • Toutes les feuilles de calcul d’un classeur Excel sont importées.

  • La symbologie est appliquée aux couches en sortie qui sont ajoutées à la carte en fonction de la symbologie des fichiers de données source comme suit :

    Remarque :
    Une carte active doit exister dans le projet ArcGIS AllSource au moment de l’exécution de l’outil pour que la symbologie soit préservée. Si l’outil est exécuté en dehors d’un projet ArcGIS AllSource, c’est-à-dire à partir d’un script Python autonome, la symbologie n’est pas conservée.
    • Dans le cas des couches en sortie créées à partir de fichiers .kml ou .kmz, la symbologie est extraite à partir du fichier source .kml ou .kmz et est appliquée aux couches en sortie. Il est possible de remplacer cette symbologie en fournissant un fichier de couche (.lyrx ou .lyr) dans le dossier du fichier .kml ou .kmzsource. Le fichier de couche doit avoir le même nom de base que le fichier de données source, auquel est ajouté un trait de soulignement (_), et le même type de géométrie (points, polylignes ou polygones) que la couche à remplacer. Par exemple, si le fichier .kml est nommé World Airports.kml, qu’il contient des entités ponctuelles, linéaires et surfaciques et que vous souhaitez remplacer la symbologie de tous les types de géométrie, les fichiers de couche sont nommés World Airports_Points.lyrx, World Airports_Polylines.lyrx et World Airports_Polygons.lyrx. Les valeurs du type de géométrie respectent la casse. Si un fichier de couche n’existe pas pour un type de géométrie donné, la symbologie du fichier .kml ou .kmz source est appliquée à la couche en sortie.
    • Dans le cas de couches en sortie créées à partir de sources autres que des fichiers .kml ou .kmz, la symbologie est appliquée à la couche en sortie s’il existe un fichier de couche (.lyrx ou .lyr) dans le dossier du fichier de données source. Le fichier de couche doit avoir le même nom de base que le fichier de données source, à l’exception des feuilles de calcul Excel et des fichiers .geojson. Dans le cas de feuilles de calcul Excel, le fichier de couche doit porter le même nom de base que le fichier de données source, auquel est ajouté un trait de soulignement (_) et le nom de la feuille de calcul. Par exemple, si le fichier Excel s’appelle World.xlsx et qu’il contient une feuille de calcul nommée Cities (2018), le fichier de couche doit être nommé World_Cities (2018).lyrx ou World_Cities (2018).lyr. Dans le cas de fichiers .geojson, le fichier de couche doit porter le nom de base du fichier de données source, auquel est ajouté un trait de soulignement (_) et le type de géométrie en sortie (points, multi-points, polylignes et polygones). S’il n’existe aucun fichier de couche, un symbole par défaut est appliqué à la couche en sortie.

Paramètres

ÉtiquetteExplicationType de données
Données en entrée

Dossiers contenant les fichiers de données ou les fichiers de données à convertir en classes d’entités de géodatabase.

Folder; File
Géodatabase cible

Géodatabase cible dans laquelle les classes d’entités en sortie sont stockées.

Workspace
Filtre
(Facultatif)

Applique un filtre afin de limiter les fichiers à importer des dossiers. Les caractères génériques suivants du filtre fonctionnent sur le chemin complet des données en entrée :

  • * : correspond à n’importe quel caractère
  • ? : correspond à un seul caractère
  • [plage] : correspond à un seul caractère de la plage
  • [!plage] : correspond à n’importe quel caractère de la plage
Vous pouvez ajouter plusieurs modèles au filtre en les séparant par une barre verticale (|). Les comparaisons de modèle ne respectent pas la casse ; l’utilisation du modèle *airport.shp, *AIRPORT.SHP ou *Airport.shp, par exemple, entraîne l’importation du même shapefile.

Voici quelques exemples de filtres :

  • Pour importer tous les shapefiles, indiquez *.shp.
  • Pour importer tous les shapefiles et tous les fichiers .kml, indiquez *.shp|*.kml.
  • Pour importer tous les fichiers dont le chemin ou le nom contient airport, indiquez *airport*.
  • Pour importer tous les fichiers .geojson dont le chemin ou le nom contient airport, indiquez *airport*.geojson.
  • Pour importer tous les fichiers .kmz dont le nom contient la chaîne airport à laquelle sont ajoutés deux caractères, indiquez *airport??.kmz.
  • Pour importer tous les fichiers dont le chemin ou le nom contient un nombre compris entre 1990 et 1997, indiquez *199[0-7]*.
  • Pour importer tous les shapefiles dont le chemin contient le nom de dossier exact airfacilities, indiquez *\airfacilities\*.shp.

String
Inclure les sous-dossiers
(Facultatif)

Indique si les sous-dossiers sont explorés de manière récursive.

  • Cochée : des données sont recherchées dans tous les sous-dossiers. Il s’agit de l’option par défaut.
  • Non cochée : les données sont recherchées uniquement dans le dossier de niveau supérieur.

Boolean
Inclure la superposition du terrain
(Facultatif)

Spécifie si une superposition de sol KML ou KMZ (raster, photos aériennes, etc.) est incluse dans la sortie.

Soyez prudent si le fichier KMZ désigne un service qui propose des images raster. L'outil essaie de traduire les images raster à toutes les échelles disponibles. Ce processus risque de prendre du temps et de surcharger le service.

  • Option activée : les superpositions de sol sont incluses dans la sortie. Il s’agit de l’option par défaut.
  • Option désactivée : les superpositions de sol ne sont pas incluses dans la sortie.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Géodatabase mise à jour

Géodatabase cible mise à jour.

Workspace

arcpy.intelligence.BatchImportData(in_data, target_gdb, {filter}, {include_sub_folders}, {include_groundoverlay})
NomExplicationType de données
in_data
[in_data,...]

Dossiers contenant les fichiers de données ou les fichiers de données à convertir en classes d’entités de géodatabase.

Folder; File
target_gdb

Géodatabase cible dans laquelle les classes d’entités en sortie sont stockées.

Workspace
filter
(Facultatif)

Applique un filtre afin de limiter les fichiers à importer des dossiers. Les caractères génériques suivants du filtre fonctionnent sur le chemin complet des données en entrée :

  • * : correspond à n’importe quel caractère
  • ? : correspond à un seul caractère
  • [plage] : correspond à un seul caractère de la plage
  • [!plage] : correspond à n’importe quel caractère de la plage
Vous pouvez ajouter plusieurs modèles au filtre en les séparant par une barre verticale (|). Les comparaisons de modèle ne respectent pas la casse ; l’utilisation du modèle *airport.shp, *AIRPORT.SHP ou *Airport.shp, par exemple, entraîne l’importation du même shapefile.

Voici quelques exemples de filtres :

  • Pour importer tous les shapefiles, indiquez *.shp.
  • Pour importer tous les shapefiles et tous les fichiers .kml, indiquez *.shp|*.kml.
  • Pour importer tous les fichiers dont le chemin ou le nom contient airport, indiquez *airport*.
  • Pour importer tous les fichiers .geojson dont le chemin ou le nom contient airport, indiquez *airport*.geojson.
  • Pour importer tous les fichiers .kmz dont le nom contient la chaîne airport à laquelle sont ajoutés deux caractères, indiquez *airport??.kmz.
  • Pour importer tous les fichiers dont le chemin ou le nom contient un nombre compris entre 1990 et 1997, indiquez *199[0-7]*.
  • Pour importer tous les shapefiles dont le chemin contient le nom de dossier exact airfacilities, indiquez *\airfacilities\*.shp.

String
include_sub_folders
(Facultatif)

Indique si les sous-dossiers sont explorés de manière récursive.

  • SUBFOLDERSDes données sont recherchées dans tous les sous-dossiers ; il s’agit de l’option par défaut.
  • NO_SUBFOLDERSLes données sont recherchées uniquement dans le dossier de niveau supérieur.
Boolean
include_groundoverlay
(Facultatif)

Spécifie si les superpositions de sol KML ou KMZ (raster, photos aériennes, etc.) sont incluses dans la sortie.

Soyez prudent si le fichier KMZ désigne un service qui propose des images raster. L'outil essaie de traduire les images raster à toutes les échelles disponibles. Ce processus risque de prendre du temps et de surcharger le service.

  • GROUNDOVERLAYLes superpositions de sol sont incluses dans la sortie. Il s’agit de l’option par défaut.
  • NO_GROUNDOVERLAYLes superpositions de sol ne sont pas incluses dans la sortie.
Boolean

Sortie obtenue

NomExplicationType de données
out_geodatabase

Géodatabase cible mise à jour.

Workspace

Exemple de code

Exemple 1 d’utilisation de l’outil BatchImportData (fenêtre Python)

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction BatchImportData en mode immédiat :

import arcpy 
arcpy.intelligence.BatchImportData("c:/data/sourcedata", "c:/data/output.gdb", "", "SUBFOLDERS", "NO_GROUNDOVERLAY")
Exemple 2 d’utilisation de l’outil BatchImportData (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction BatchImportData dans un script autonome :

# Name: BatchImportData_Example2.py
# Description: Imports all shapefiles with 'airport' in the file name or file
#              path within a directory to feature classes in a single geodatabase.
# Requirements: Standard or Advanced license

# Import system modules
import arcpy

# Set local variables
in_data = ["c:/data/sourcedata"]
target_gdb = r"\\data\operationaldata.sde" 
filter = "*airports*.shp" 
include_sub_folders = "NO_SUBFOLDERS" 

# Run BatchImportData
arcpy.intelligence.BatchImportData(in_data, target_gdb, filter, include_sub_folders)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.