Accéder au contenu principal Passer au contenu complémentaire

Ensemble de données

Les sources de données suivantes peuvent être utilisées avec des opérations dans l'extension GeoOperations Qlik côté serveur.

CSV

Fichiers texte avec des données de table, éventuellement avec des géométries. Au lieu de spécifier des géométries, il est possible de spécifier des noms d'emplacements. Tous les champs seront chargés sous forme de chaînes.
Paramètres CSV
Paramètre Type Utilisation Description
url chaîne par défaut : vide.

URL du fichier contenant les données. Seules les URL avec le protocole HTTPS ou LIB sont autorisées.

Vous pouvez utiliser des fichiers des sources de données de l'espace de l'application via la syntaxe suivante : lib://DataFiles/<file name>. Par exemple, lib://DataFiles/Offices.csv. Vous pouvez également spécifier un espace stockant les fichiers via la syntaxe suivante : lib://<space name>:DataFiles/<file name>. Par exemple, lib://EuropeSales:DataFiles/Offices.csv. Vous pouvez également spécifier un fichier depuis un connecteur Web Storage Provider via la syntaxe suivante : lib://<Web Storage Provider>/<file name>. Par exemple, lib://Dropbox/Offices.csv.

keyField chaîne par défaut : vide. Nom du champ contenant les identités de chaque géométrie. Si vous laissez le champ vide, un champ clé sera généré.
geometryField chaîne par défaut : vide. Nom du champ de géométrie, le cas échéant. À la place d'une géométrie, il est possible de spécifier une colonne avec des noms de points ou de zones bien connus comme "Type de géométrie" ci-dessous. Si des données de points figurent dans deux champs, spécifiez-les au format suivant : nom du champ de latitude, suivi d'une virgule, puis nom du champ de longitude.
geometryType chaîne par défaut : POINT Type de géométrie du champ Geometry. Les valeurs autorisées sont les suivantes :
  • Point - géométrie de type point au format de point Qlik Sense : "[longitude,latitude]"
  • PointLatLon - un champ avec des latitudes et un champ avec des longitudes
  • Line - géométrie de type ligne au format de ligne Qlik Sense : "[[longitude,latitude],[longitude,latitude],...]"
  • Polygon - géométrie de type polygone, à savoir, un tableau de lignes fermées ou un tableau de tableau de lignes fermées en cas de plusieurs polygones
  • LocationNamedPoint - nom d'un point géographique tel qu'une ville
  • LocationNamedArea - nom d'une zone géographique telle qu'un pays
  • WKT - géométrie au format WKT, prend en charge POINT, LINESTRING, MULTILINESTRING, POLYGON et MULTIPOLYGON, voir Représentation textuelle bien connue de géométrie
En cas de points ou de zones nommés, la géométrie est recherchée dans le service de localisation et une colonne est ajoutée pour la géométrie. Des colonnes de pays, de type et de régions administratives sont ajoutées dans l'ensemble de données Zones et points standard.
suffix chaîne par défaut : vide. Pour les utilisateurs avancés. La chaîne spécifiée est ajoutée à l'ensemble des ID. Il s'agit d'un moyen pratique de spécifier davantage d'informations telles que le type ou le code de pays aux services de localisation basés sur serveur. Sinon, ajoutez les données supplémentaires lors du chargement de la table dans Qlik. Avec le suffixe suivant, tous les éléments sont spécifiés comme des villes en Suède :
,SE:city
Voir la Spécification de Geometry Service (uniquement en anglais) pour plus d'informations sur la syntaxe à utiliser.
header chaîne par défaut : vide. Noms des colonnes séparés par une virgule. Si cette valeur est vide, la première ligne contient l'en-tête.
fieldSeparator chaîne par défaut : TAB Caractère qui sépare les champs. Outre les caractères ordinaires, les mots clés TAB, NEWLINE, COMMA et SEMICOLON sont autorisés.
recordSeparator chaîne par défaut : NEWLINE Caractère qui sépare les lignes. Outre les caractères ordinaires, les mots clés TAB, NEWLINE, COMMA et SEMICOLON sont autorisés.
encoding chaîne par défaut : UTF-8 Jeu de caractères du fichier. Mêmes valeurs autorisées que dans Java.
stringQuotes chaîne par défaut : vide. Caractère qui peut être utilisé pour citer des chaînes. Les séparateurs de champs et d'enregistrements à l'intérieur des guillemets ne seront pas analysés en tant que tels. Les guillemets seront supprimés des données importées. Outre les caractères ordinaires, les mots clés QUOTE("), DOUBLEQUOTE(") et SINGLEQUOTE(') sont autorisés.
crs chaîne par défaut : Auto CRS (Système de référence de coordonnées) des données à charger. Les données seront projetées de ce CRS vers WGS84 (EPSG:4326) avant d'être chargées dans l'application.

En cas de définition sur Auto, EPSG:4326 (WGS84) est utilisé.

GEOFILE

Charge différents types de formats de fichier géographiques tels que GeoJSON et ESRI Shapefile.

Cet exemple charge un fichier GeoJson via l'opération Simplify :

Load * Extension GeoOperations.ScriptEval(' SELECT nuts.NUTS_ID as NUTS_ID, Simplified_nuts_Geometry FROM Simplify() DATASOURCE nuts GEOFILE url="https://datahub.io/core/geo-nuts-administrative-boundaries/r/nuts_rg_60m_2013_lvl_1.geojson"');
Paramètres GEOFILE
Paramètre Type Utilisation Description
url chaîne par défaut : vide.

URL du fichier contenant les données. Seules les URL avec le protocole HTTPS ou LIB sont autorisées.

Vous pouvez utiliser des fichiers des sources de données de l'espace de l'application via la syntaxe suivante : lib://DataFiles/<file name>. Par exemple, lib://DataFiles/SalesGeographies.geojson. Vous pouvez également spécifier un espace stockant les fichiers via la syntaxe suivante : lib://<space name>:DataFiles/<file name>. Par exemple, lib://EuropeSales:DataFiles/SalesGeographies.geojson. Vous pouvez également spécifier un fichier depuis un connecteur Web Storage Provider via la syntaxe suivante : lib://<Web Storage Provider>/<file name>. Par exemple, lib://Dropbox/SalesGeographies.geojson.

keyField chaîne par défaut : vide. Nom du champ contenant les identités de chaque géométrie. Si vous laissez le champ vide, un champ clé sera généré.
type chaîne par défaut : Auto Type de fichier. Les valeurs autorisées sont les suivantes :
  • Auto - Tente de détecter le type de fichier à partir du nom du fichier.
  • GeoJSON - Format GeoJSON tel que spécifié par geojson.org.
  • GML - Pour lire des fichiers GML ou se connecter à des services WFS. Lit des fichiers featureCollection et crée une ligne pour chaque élément featureMember. GeoOperations prend uniquement en charge GML2.
  • Shape - Fichier zip avec au moins un fichier shp et un fichier dbf pour le format de fichier de forme ESRI. Il est important que le fichier zip soit créé avec le même chiffrement de caractères que les fichiers qu'il contient.
  • ESRIJson - JSON tel que renvoyé par le serveur ESRI ArcGIS (voir Document de format ESRI). Cela permet de se connecter à ArcGIS et d'importer des données depuis les services qu'il a publiés.
  • DXF - Pour lire des géométries à partir d'un fichier AutoCAD DXF. Un ensemble limité de types d'entité est pris en charge pour les points et les lignes : POINT, TEXT, MTEXT, ARC, CIRCLE, LINE, POLYLINE, LWPOLYLINE, SPLINE, and MLINE
encoding chaîne par défaut : vide. Pour certains formats (tels que ESRI Shapefile), le chiffrement de caractères n'est pas défini dans le format. Cela permet de fournir ces informations. Pour la plupart des formats, cette propriété est ignorée.
expectedGeomType chaîne par défaut : Auto Il est possible de charger un seul type géométrique à la fois. S'il en existe plusieurs types dans les données, utilisez cette propriétés pour définir le type à charger. Pour les formats qui ne prennent pas en charge plusieurs types, ce paramètre est ignoré.
  • Auto - Tente de détecter automatiquement le type.
  • Point - Recherche des points dans le fichier spécifié.
  • Line - Recherche des lignes dans le fichier spécifié.
  • Polygon - Recherche des polygones dans le fichier spécifié.
crs chaîne par défaut : Auto Système de référence de coordonnées (CRS) des données à charger. Les données seront projetées de ce CRS vers WGS84 (EPSG:4326) avant d'être chargées dans l'application.

En cas de définition sur Auto ou si ce paramètre est vide, une tentative d'analyse sera effectuée à partir du fichier. Si aucun CRS n'est trouvé dans le fichier, EPSG:4326 (WGS84) est utilisé. Notez que si vous définissez cette valeur sur un CRS, cela remplace les informations du fichier. Cela ne doit être effectué que pour les fichiers ne contenant pas ces informations ou dont les informations sont connues pour être erronées. Les fichiers contenant des données avec plusieurs CRS ne sont pas pris en charge.

INTABLE

Il est possible de déclarer une table transmise en entrée à la fonction Extension pour spécifier comment elle doit être interprétée. Si elle n'est pas déclarée, le champ clé et le champ de géométrie peuvent, dans de nombreux cas, être automatiquement détectés en fonction du contenu. Cependant, il est recommandé de déclarer les tables, de sorte que leur interprétation ne change pas après un chargement avec de nouvelles données.

Si la table contient des noms au lieu de géométries ou de colonnes de latitude et de longitude, elle doit être déclarée.

Si la table n'est pas déclarée, elle comptera comme la première table des ensembles de données par défaut des opérations. Si elle est déclarée, elle sera comptée dans l'ordre dans lequel elle est déclarée.

Normalement, le format de géométrie Qlik Sense est utilisé, mais le format WKT (Représentation textuelle bien connue de géométrie) est également pris en charge. Cela permet de lire des données géographiques provenant d'une base de données via l'un des connecteurs de base de données habituels, puis de convertir les géométries en géométries Sense via l'opération Load. Notez que lorsque les géométries sont lues depuis la base de données, il convient d'appliquer une fonction qui renvoie la colonne au format WKT. La fonction SQL standard est appelée ST_AsText(), mais certaines bases de données ont leur propre fonction.

Il est possible d'utiliser un seul des paramètres qui spécifient le champ d'emplacement à la fois, sauf latitudeField et longitudeField, qui doivent toujours être définis par paires.

Une seule table inline peut être spécifiée par opération. Si vous devez utiliser des données dans deux ou davantage de tables inline, vous pouvez utiliser STORE pour enregistrer les autres tables inline sous forme de fichiers CSV, puis les charger à partir des fichiers CSV.

Exemple avec des champs de latitude et de longitude :

MyCities: LOAD * inline " cid;lat;long 1;57.7;12 2;45.42;-75.70 " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' TravelAreas(costValue="10",costUnit="minutes") DATASOURCE cities INTABLE keyField="cid", latitudeField="lat", longitudeField="long"', MyCities);
Exemple dans lequel les données contiennent des emplacements nommés et, à cause de cela, il convient de déclarer le paramètre namedAreaField :
MyCountries: LOAD * inline " cid;Country 1;US 2;CA " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' Simplify() DATASOURCE countries INTABLE keyField="Country", namedAreaField="Country"', MyCountries{Country});
Paramètres INTABLE
Paramètre Type Utilisation Description
keyField chaîne facultatif Nom d'un champ contenant les identités uniques de chaque ligne. S'il n'est pas spécifié, une colonne de clés nommée _autoIndex_ sera ajoutée avec des valeurs uniques pour chaque ligne.
pointField chaîne facultatif Champ contenant des données de point au format de point Qlik Sense, "[longitude,latitude]". Les données de point WKT ("POINT(...)") sont également prises en charge.
lineField chaîne facultatif Champ contenant des données de ligne au format de ligne Qlik Sense : "[[longitude,latitude],[longitude,latitude],...]". Les données de ligne WKT ("LINESTRING(...)" ou "MULTILINESTRING(...)") sont également prises en charge.
polygonField chaîne facultatif Champ contenant des données de ligne au format de polygone Sense, à savoir, un tableau de lignes fermées ou un tableau de tableau de lignes fermées en cas de plusieurs polygones. Les données de polygone WKT ("POLYGON(...)" ou "MULTIPOLYGON(...)") sont également prises en charge.
latitudeField chaîne facultatif Champ contenant des valeurs de latitude.
longitudeField chaîne facultatif Champ contenant des valeurs de longitude.
namedPointField chaîne facultatif Champ contenant des noms de fonctions géographiques recherchées dans la base de données d'emplacements. Les noms seront représentés avec des points.
namedAreaField chaîne facultatif Champ contenant des noms de fonctions géographiques recherchées dans la base de données d'emplacements. Les noms seront représentés avec des polygones. Tous les noms de la base de données d'emplacements n'ont pas de polygones associés.
crs chaîne par défaut : Auto CRS (Système de référence de coordonnées) des données à charger. Les données seront projetées de ce CRS vers WGS84 (EPSG:4326) avant d'être chargées dans l'application.

En cas de définition sur Auto, EPSG:4326 (WGS84) est utilisé.

LOCATIONSERVICE

Points et zones disponibles dans un service de localisation Qlik GeoAnalytics Server. Le type de pays doit être spécifié.

Les champs des tables chargées depuis le service de localisation sont les suivants :

  • LocationDbId - ID unique de chaque entité.
  • LocationPoint/LocationArea - Géométrie de l'entité.
  • CountryIso2 - Code de pays de deux lettres.
  • Adm1Code - Code propre à la nation de la zone administrative de premier ordre.
  • Adm2Code - Code propre à la nation de la zone administrative de deuxième ordre.
  • LocationDbType - Voir la Spécification de Geometry Service (uniquement en anglais) pour plus d'informations sur les types.

Cet exemple charge les états des États-Unis :

MyAirports: Load * Extension GeoOperations.ScriptEval(' Load() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="STATE", country="us" ');
Paramètres LOCATIONSERVICE
Paramètre Type Utilisation Description
geometry chaîne par défaut : Area Sélectionnez un accès Points ou Areas.
type chaîne par défaut : Country Type de données représenté par les noms, par exemple, pays, régions administratives, codes postaux, etc. Il est possible d'utiliser les noms de type simplifiés suivants (non sensibles à la casse) dans les types natifs de la base de données d'emplacements :
  • CONTINENT - Nom de continent.
  • COUNTRY - Nom de pays.
  • COUNTRYISO2 - Code alpha-2 ISO 3166-1.
  • COUNTRYISO3 - Code alpha-2 ISO 3166-1.
  • ADMIN1 - Division administrative de premier ordre.
  • STATE - Alias de ADMIN1.
  • ADMIN2 - Division administrative de deuxième ordre.
  • ADMIN3 - Division administrative de troisième ordre.
  • ADMIN4 - Division administrative de quatrième ordre.
  • POSTALCODE - Code postal.
  • ZIP - Alias de POSTALCODE.
  • CITY - Nom de ville.
  • AIRPORTIATA - Code IATA d'aéroport.
  • AIRPORTICAO - Code ICAO d'aéroport.
Voir la Spécification de Geometry Service (uniquement en anglais) pour plus d'informations sur les types détaillés.
country chaîne par défaut : vide. Code de pays (2 ou 3 lettres) du pays auquel accéder. Il est possible de spécifier plusieurs pays, séparés par des virgules. La valeur par défaut signifie qu'il n'existe pas de restriction à un seul pays.
 

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !