Créer un jeu de données à partir d'une source distante (URL, API, FTP)

Comme source de données pour un jeu de données, vous pouvez ajouter un fichier depuis un URL, un API, ou un serveur FTP (en utilisant le protocole FTP, FTPS ou SFTP).

La taille limite d'un fichier est de 240 Mo. Si votre fichier est trop volumineux, vous pouvez le compresser avant de le télécharger.

Pour plus d'informations sur les formats de fichiers compressés ou non compressés, consultez Formats de fichiers pris en charge.

Vous pouvez connecter la plateforme à :

• Un serveur distant via son URL, pour importer les fichiers stockés sur ce serveur distant

• Une source distante qui expose les enregistrements de données via une API

Opendatasoft prend en charge les URL HTTP et HTTPS vers les fichiers, par exemple « http://example.org/mydata.csv ».

Opendatasoft prend en charge les méthodes de connexion authentifiées suivantes : login/mot de passe, clé API, protocole OAuth2 (type d'octroi client_credentials) et fourniture d'informations dans un en-tête HTTP.

1. Dans Catalogue > Datasets, cliquez sur le bouton Nouveau jeu de données

2. Dans l'assistant qui s'ouvre, sous la section Récupérer un fichier, sélectionnez À partir d'une URL

3. Configurez votre connexion HTTP

4. A partir de l'aperçu des 20 premiers enregistrements qui apparaît, configurez la source

5. Configurez les informations de l'ensemble de données ou utilisez les valeurs préremplies :

   • Dans le champ Nom de l'ensemble de données, saisissez le titre de cet ensemble de données

   • Dans le champ Identifiant technique du jeu de données, saisissez un identifiant significatif pour cet ensemble de données.

   • Si vous souhaitez que toute personne ayant accès à votre espace de travail puisse explorer l'ensemble de données, désactivez Accès restreint aux utilisateurs et groupes autorisés.

Si vous utilisez une API qui vous est fournie, assurez-vous qu'il répond aux exigences suivantes :- Être de type REST et préférablement en JSON, avec une méthode "GET".- Elle doit être disponible via internet- Elle ne doit pas être paginée ou incrémentale, c'est à dire que les résultats doivent être obtenus en un seul appel- Elle doit être accessible par la plateforme Opendatasoft par une simple authentification : clé d'API permanente, en-tête HTTP fixe, etc...)

Opendatasoft prend en charge les URL FTP, FTPS ou SFTP pour :

• Fichiers, par exemple : "ftp://example.org/my_dir/mydata.csv"

• Dossiers, par exemple : "ftp://example.org/my_dir/"

Dans Catalogue > Datasets, cliquez sur le bouton Nouveau jeu de données

1. Dans l'assistant qui s'ouvre, sous la section Récupérer un fichier , sélectionnez Depuis un serveur FTP

2. Configurez votre connexion

L'authentification par certificat SSH est disponible pour les serveurs SFTP. Concernant la configuration du certificat SSH : - collez l'intégralité du fichier de clé privée dans le champ Clé privée - la phrase secrète est relative à la clé privée et est facultative

1. A partir de l'aperçu des 20 premiers enregistrements qui apparaît, configurez la source

2. Configurez les informations de l'ensemble de données ou utilisez les valeurs préremplies :

   • Dans le champ Nom de l'ensemble de données, saisissez le titre de cet ensemble de données

   • Dans le champ Identifiant technique du jeu de données, saisissez un identifiant significatif pour cet ensemble de données.

   • Si vous souhaitez que toute personne ayant accès à votre espace de travail puisse explorer l'ensemble de données, désactivez Accès restreint aux utilisateurs et groupes autorisés.

Opendatasoft ne prend pas en charge le FTP implicite car il est considéré comme obsolète

Après avoir créé un jeu de données, une interface d'édition pour ce jeu de données s'ouvre. Seuls les utilisateurs disposant des autorisations nécessaires, soit "Créer jeu de données", soit "Modifier jeu de données", peuvent utiliser cette interface. Cette interface d'édition vous permet de traiter les données, de configurer les jeux de données et leurs visualisations, et de gérer la publication des jeux de données.

Si vous mettez à jour votre fichier source et que vous le republiez, le fichier entier sera chargé. Cependant, si la source est un dossier et non un fichier, Opendatasoft ne prendra en compte que les fichiers nouvellement téléchargés dans ce dossier.

Si vous supprimez un fichier du dossier FTP, il faut effectuer un nettoyage. A droite de la ressource, cliquez sur nettoyer le cache avant de republier pour que cela se répercute sur vote dataset. Pour plus d'informations sur les dossiers FTP, veuillez lire cette section sur la recherche de fichiers multiples stockés sur un serveur FTP.

Vous pouvez créer des jeux de données basés sur des données provenant de services distants pour lesquels nous avons créé des connecteurs dédiés.

Pour plus d'information sur les connecteurs disponibles, voir cette page. Notez que certains connecteurs ne sont disponibles qu'à la demande et peuvent faire l'objet d'une tarification.