La vue tableau présente plusieurs différences et améliorations par rapport à l'ancien portail.

Enrichissement des opérations sur les colonnes

En plus du tri ascendant ou descendant, un menu déroulant permet désormais de réaliser d'autres opérations :

• Accès direct à la description du champ (l'accès par survol pose des problème d'accessibilité en vue mobile)
• Possibilité de cacher la colonne
• Possibilité de fixer la colonne à gauche, ce qui permet de défiler horizontalement dans des tableaux ayant beaucoup de colonnes tout en gardant toujours visible une colonne permettant d'identifier la ligne ("Nom de la structure" par exemple)
• Filtres applicables sur la colonne, la section suivante donne plus de détails sur ce point

Filtres

Les capacités de filtrage évoluent vers des fonctions classiques de type égalité, contient, supérieur, etc. en lieu et place d’un filtre exact sur une valeur avec le décompte des éléments correspondants ("facettes").

Ce changement permet notamment :

• D'exclure des valeurs ou de faire une recherche dans un intervalle par exemple
• De simplifier le parcours utilisateur en évitant de le submerger dès lors que les options sont nombreuses ou insuffisamment hiérarchisées.
• De renforcer la compatibilité et l’ergonomie sur mobile.

Les filtres dans la nouvelle vue tableau s'appliquent maintenant depuis le menu déroulant du titre de la colonne.

De nouvelles capacité de filtrage sont possibles :

• Filtrage par exclusion d'une ou de plusieurs valeur
• Filtrage par bornes de type inférieur / supérieur, disponible pour les types nombre et date
• Filtrage de type commence par ou contient pour les types textuels

Options d'affichage de la vue table

Il est désormais possible de choisir parmi 3 affichages différents :

• La vue table "classique" qui est un tableau de données avec scroll infini. C'est la vue par défaut en mode desktop.
• La vue table "dense" qui est un tableau comme le précédent, avec moins d'espacement pour afficher plus d'informations.
• La vue "vignettes" : c'est la vue par défaut sur mobile, et la mieux adaptée quand le nombre de colonnes devient important et qu'il faut beaucoup scroller horizontalement

Il y a également un menu pour afficher / masquer certaines colonnes. Si les colonnes sont réparties dans des groupes, il est même possible d'afficher / masquer plusieurs colonnes à la fois ! On peut ainsi masquer par exemple toutes les information liées à l'adresse d'une structure.

La vue tableau présente plusieurs différences et améliorations par rapport à l'ancien portail.

Enrichissement des opérations sur les colonnes

En plus du tri ascendant ou descendant, un menu déroulant permet désormais de réaliser d'autres opérations :

• Accès direct à la description du champ (l'accès par survol pose des problème d'accessibilité en vue mobile)
• Possibilité de cacher la colonne
• Possibilité de fixer la colonne à gauche, ce qui permet de défiler horizontalement dans des tableaux ayant beaucoup de colonnes tout en gardant toujours visible une colonne permettant d'identifier la ligne ("Nom de la structure" par exemple)
• Filtres applicables sur la colonne, la section suivante donne plus de détails sur ce point

Filtres

Les capacités de filtrage évoluent vers des fonctions classiques de type égalité, contient, supérieur, etc. en lieu et place d’un filtre exact sur une valeur avec le décompte des éléments correspondants ("facettes").

Ce changement permet notamment :

• D'exclure des valeurs ou de faire une recherche dans un intervalle par exemple
• De simplifier le parcours utilisateur en évitant de le submerger dès lors que les options sont nombreuses ou insuffisamment hiérarchisées.
• De renforcer la compatibilité et l’ergonomie sur mobile.

Les filtres dans la nouvelle vue tableau s'appliquent maintenant depuis le menu déroulant du titre de la colonne.

De nouvelles capacité de filtrage sont possibles :

• Filtrage par exclusion d'une ou de plusieurs valeur
• Filtrage par bornes de type inférieur / supérieur, disponible pour les types nombre et date
• Filtrage de type commence par ou contient pour les types textuels

Options d'affichage de la vue table

Il est désormais possible de choisir parmi 3 affichages différents :

• La vue table "classique" qui est un tableau de données avec scroll infini. C'est la vue par défaut en mode desktop.
• La vue table "dense" qui est un tableau comme le précédent, avec moins d'espacement pour afficher plus d'informations.
• La vue "vignettes" : c'est la vue par défaut sur mobile, et la mieux adaptée quand le nombre de colonnes devient important et qu'il faut beaucoup scroller horizontalement

Il y a également un menu pour afficher / masquer certaines colonnes. Si les colonnes sont réparties dans des groupes, il est même possible d'afficher / masquer plusieurs colonnes à la fois ! On peut ainsi masquer par exemple toutes les information liées à l'adresse d'une structure.

L'évolution de portail s'accompagne d'une évolution des API. Le portail étant basé sur une solution technique différente du précédent, les APIs sont également différentes.

Cependant, pour assurer une continuité de service, des routes d'API ont été implémentées dans la section "rétrocompatibilité". Elles sont là pour assurer temporairement la transition et nous vous invitons vivement à basculer sur les nouvelles routes d'API natives.

Récupérer des lignes de données

La route d'API qui permet de récupérer les enregistrements et qui est notamment utilisée par la vue table est la suivante :

/data-fair/api/v1/datasets/{dataset_id}/lines

Quelques remarques sur les similitudes / différences avec la route /records de l'ancien portail :

• Le paramètre select fonctionne de la même manière
• Le paramètre order_by est remplacé par le paramètre sort. Il a la même syntaxe pour un tri croissant. Pour un tri décroissant, la syntaxe diffère avec un moins devant plutôt que l'ajout de desc.
• Dans cette route d'API, tous les champs peuvent être filtrés avec des paramètres type cle_du_champ_eq ou cle_du_champ_in. Ces paramètres permettent d'avoir une syntaxe très proche du where in de l'API de l'ancien portail
• Il n'y a pas de fonctions de type now() dans l'API du nouveau portail. Ce choix a été fait car ce type de fonction ne permet pas une mise en cache et n'est pas en adéquation avec l'architecture REST de la plateforme. Dans la nouvelle API, c'est l'appelant qui doit proposer la date en faisant le calcul.
• Il n'est plus possible d'ignorer la limite de lignes, il faut donc parfois faire plusieurs appels d'API pour avoir l'équivalent à limit=-1 de l'ancienne API. La dépagination peut être gérée par le header de réponse Link qui donne la requête pour la page suivante. A noter que le limit=-1 est bien supporté dans la route de rétrocompatibilité.

Agréger des données

Le portail possède maintenant une route d'API qui permet de faire des agrégations sur plusieurs niveaux. Cette route, qui permet également de calculer des métriques sur les agrégations telles que des moyennes ou des sommes, est la suivante :

/data-fair/api/v1/datasets/{dataset_id}/values_agg

• Est ce que mon compte utilisateur est encore valide sur le nouveau portail ?

Non, pour des raisons de sécurité, il n'est pas possible de transférer les comptes utilisateur de l'ancien portail vers le nouveau. Vous devez donc recréer un compte utilisateur.

• Est ce que ma clé d'API est encore valide sur le nouveau portail ?

Non, la clé d'API étant lié à un compte, elle n'est plus valable pour le nouveau portail. Cependant, l'authentification vers les API de jeux de données publics est optionnelle sur le nouveau portail.

• Comment récupérer toutes les lignes d'un jeu de données d'un coup avec la nouvelle API ?

Pour des raisons de performance, la nouvelle API ne permet de récupérer que 10 000 enregistrements à la fois pour un jeu de données. Si le jeu de données contient plus d'enregistrements que cette limite, il faut soit faire plusieurs appels (la réponse donne l'appel pour les 10 000 enregistrements suivants dans la propriété next), soit passer par les routes de rétrocompatibilité.

• Lorsque l’on requête via l’API une colonne de type date-heure, peut-on dans l’appel API spécifier la timezone que l’on souhaite en retour ?

Non ce n'est pas possible c'est l'appelant qui doit formater la date dans la bonne timezone. Les routes de rétrocompatibilité supportent ces opérations par contre.

• Combien de temps l'API de rétrocompatibilité va-t-elle être maintenue ?

Cette API sera disponible au moins jusque fin 2028. Elle est en place pour assurer la continuité de service suite à la migration de portail mais nous vous encourageons vivement à migrer vers les routes d'API native dès que vous le pouvez et pour tous les nouveaux développements.