Le portail de données permet aux visiteurs d'accéder rapidement aux données.

Un portail de données peut être constitué de différentes pages :

1. La page d'accueil est le point d’entrée principal du portail de données ;
2. La page des données permet de rechercher et de filtrer les différents jeux de données du portail ;
3. La page des visualisations est utilisée pour rechercher et de filtrer les différentes visualisations du portail ;
4. Les pages de contenu permettent de mettre en avant certaines données et de leur donner encore plus de contexte, ou de faire des tableaux de bord intégrants différentes données.

La page d'accueil permet d'avoir un aperçu des données présentes sur le portail de données.
Elle permet aux visiteurs d'accéder rapidement aux données mises en avant, de visualiser les chiffres clés, de rechercher des données ou encore de se connecter au portail.

Page d'accueil

La page d'accueil d'un portail est configurable.
Sur le portail open data de Koumoul, l'accueil contient treize points.

1. Logo du portail
   En cliquant sur le logo du portail vous pouvez accéder au site institutionnel.
2. Titre du portail
3. Liens vers les réseaux sociaux du producteur du portail
4. Barre de navigation
   La barre de navigation vous permet d'accéder aux pages principales des données et des visualisations ainsi qu'aux pages de contenu, à vos notifications et à la connexion sur le portail si celle-ci est disponible.
5. Notifications
   La cloche des notifications vous permet de visualiser les dernières notifications sur votre compte. Un clic sur une notification vous fait naviguer vers la page du jeu de données. Les notifications ne sont disponibles que pour les utilisateurs connectés.
6. Connexion au portail
   Sur certains portails, il est possible de créer un compte et de s'y connecter. Les comptes sont nécessaires pour accéder aux données privées ou pour utiliser les notifications du portail.
7. Description et image principale
8. Recherche
   Cette fonction permet de réaliser une recherche dans les métadonnées des jeux de données du portail.
9. Thématiques
   Un clic sur une thématique vous permet de filtrer les données de celle-ci.
10. Visualisation mise en avant et compte Twitter du producteur du portail
    Les portails peuvent mettre en avant une visualisation ainsi que les derniers tweets du compte du producteur. La visualisation est directement utilisable sur la page d'accueil. Il est possible d'accéder à la page de la visualisation en cliquant sur son titre.
11. Dernières visualisations
    Les réutilisations sont présentées sous formes de fiches avec un titre, un aperçu de la visualisation et deux boutons d'action. Le premier bouton d'action permet d'afficher la visualisation dans une fenêtre tout en restant sur la page d'accueil. Le second bouton d'action sert à accéder à la page de la visualisation.
12. Derniers jeux de données
    Les jeux de données sont présentés sous forme de fiches avec un titre, une description, des boutons d'action et la date de mise à jour des données. Trois boutons d'action sont toujours disponibles : le tableau, la documentation de l'API du jeu de données ainsi que le schéma du jeu de données. Si le jeu de données possède des coordonnées, l'icône pour afficher une carte générique sera disponible.
13. Footer
    Dans le footer, vous pouvez retrouver les liens vers les réseaux sociaux du producteur ainsi que des liens qu'il a ajoutés. Ces liens peuvent être affichés sous la forme de logos.

La page de données vous permet d'accéder à l'ensemble des données du portail. L'affichage est responsive et permet une navigation aussi bien sous ordinateur que sur smartphone.

Le nombre de jeux de données auquel vous avez accès ainsi que le bouton de téléchargement du catalogue des jeux de données est affiché en première ligne de la page. La fonction de recherche ainsi que des filtres par concepts et des tris sont disponibles. Il est aussi possible de trier les jeux de données par thématiques en cliquant sur une ou plusieurs des thématiques affichées.

Chaque jeu de données est présenté sous forme d'une fiche contenant le titre, le début de la description, la thématique et des boutons d'action. Les boutons d'action vous permettent d'accéder au tableau en fenêtre ou en plein écran, à la documentation de l'API, au schéma du jeu de données ainsi qu'à la carte générique des jeux du données si celui-ci possède des coordonnées.

Un clic sur la fiche vous fait naviguer vers la page du jeu de données.

La page d'un jeu de données est composé de plusieurs éléments :

1. Le titre et la description du jeu de données ;
2. Les métadonnées du jeu de données et les boutons d'action ;
3. Les icônes de partage sur les réseaux sociaux ;
4. Les visualisations.

Les visualisations externes peuvent être ajoutées en fin de page du jeu de données.

Le titre et la description

Le titre et la description du jeu de données permettent de donner un contexte aux données. La description présente les données, les différents traitements réalisés pour les obtenir ou bien le producteur des données.

Les métadonnées et les boutons d'action

Les métadonnées sont disponibles sous forme de fiche. Elles contiennent le nombre de lignes, la taille du fichier CSV, la source des données lorsque celle-ci est externe, la licence, ainsi que le producteur des données lorsqu'il est renseigné.

Les boutons d'action sont aussi présents dans cet encadré. De gauche à droite : le tableau, le tableau en plein écran, la carte générique, la documentation de l'API, le téléchargement du fichier original, le téléchargement des données enrichies, le schéma des données, le code HTML pour intégrer le tableau ou la carte à un site ainsi que la cloche de notification pour s'abonner au jeu de données.

Le tableau

Le tableau vous permet d'accéder aux 10 000 premières lignes du fichier.

Il contient plusieurs sections :

1. la recherche ;
2. le mode de visualisation des lignes ;
3. le choix des colonnes ;
4. le téléchargement ;
5. les filtres sur une colonne ;
6. le filtre sur une valeur d'une colonne.

1. Les filtres sur les valeurs d'une colonne vous permettent de réaliser un filtre de type « égal à » ou « commence par » sur les colonnes avec du texte et de réaliser des filtres « supérieur ou égal à » ou « inférieur ou égal à » sur les colonnes avec des nombres ou des dates. Vous pouvez réaliser plusieurs filtres. Le nombre de lignes filtrées est alors disponible à côté de la recherche.
2. Téléchargement des lignes filtrés sous différents formats.
   Le téléchargement aux formats XLSX, ODS et GeoJSON sont limités aux 10 000 premières lignes.

Les choix des colonnes permettent de sélectionner les colonnes que vous souhaitez afficher dans le tableau.
Il est ensuite possible de télécharger le fichier avec seulement les colonnes que vous avez sélectionnées.

Le tableau en plein écran

Le tableau en plein écran possède les mêmeS fonctionnalités que le tableau.

1. la recherche ;
2. le mode de visualisations des lignes ;
3. le choix des colonnes ;
4. le téléchargement ;
5. les filtres sur une colonne ;
6. le filtre sur une valeur d'une colonne.

La carte générique

La carte générique présente des données géographiques. Un clic sur un des points ou géométries vous permet d'afficher les données brutes de l'élément.

La documentation de l'API

Chaque jeu de données possède sa propre API. La documentation interactive de l'API permet aux développeurs de réaliser des requêtes et de visualiser les résultats rapidement.

Le téléchargement du fichier original Le bouton de téléchargement dans les métadonnées vous permet de télécharger le fichier brut des données. Le format dépend du type de fichier importé par le producteur des données.

Le téléchargement des données enrichies Le bouton de téléchargement des données enrichies vous permet de télécharger le fichier CSV contenant les données brutes ainsi que les données enrichies. Les données enrichies sont présentés sous la forme de colonnes en fin de tableau.

Description des champs

La description des champs correspond au schéma des données, autrement dit : à l'ensemble des colonnes présentes dans votre jeu de données. Vous pouvez ainsi accéder à la clé, au nom, au type, au concept et à la description de chacune des colonnes du jeu de données.

Le code d'intégration

Le code d'intégration vous permet d'intégrer de tableau ou la carte d'un jeu de données directement sur votre site sous forme d'une iframe.
Les visiteurs de votre site auront ainsi accès aux données sans devoir naviguer vers le portail de données.

Les pièces jointes

Les pièces jointes correspondent à des fichiers ajoutés en complément du jeu de données. Ils peuvent contenir un dictionnaire de variable, une présentation au format PDF des données ou encore une image correspondant aux données.

Les notifications

Il est possible d'activer deux types de notifications sur un jeu de données :

• Mise à jour des données ;
• Rupture de compatibilité des données.

La rupture de compatibilité des données correspond à une modification du schéma du jeu de données.

Les icônes de partage

Les icônes de partage vous permettent de partager rapidement le lien de la page sur différents réseaux sociaux.
La vignette du partage correspond à la vignette de la première visualisation de la page.

Les visualisations

Les visualisations interactives facilitent l'accès et l'exploration du jeu de données.
Les descriptions permettent de mieux comprendre les données et de découvrir certains points mis en avant par le producteur des données.

En cliquant sur le titre d'une visualisation, vous accédez à sa page. Sur cette page, vous retrouvez la description et la visualisation affichée en plus grand.

La page des visualisations vous permet d'accéder à l'ensemble des visualisations du portail.
L'affichage est responsive et permet une navigation aussi bien sous ordinateur que sur smartphone.

La fonction de recherche, des filtres par type de visualisation et des tris sont disponibles en haut de la page. Il est aussi possible de trier les visualisations par thématique en cliquant sur une ou plusieurs des thématiques affichées.

Chaque visualisation est présentée sous forme d'une fiche contenant le titre, un aperçu de la visualisation, la thématique et des boutons d'action. Les boutons d'action vous permettent d'accéder à la visualisation dans une fenêtre ou en plein écran.

Un clic sur la fiche vous fait naviguer vers la page de la visualisation.

La page d'un jeu de données est composé de plusieurs éléments :

1. Le titre et la description du jeu de données
2. Les metadonnées du jeu de données et les boutons d'actions
3. Les icones de partage sur les réseaux sociaux
4. La visualisation
5. Les données utilisées dans la visualisation

Le titre et la description

Le titre et la description d'une visualisation permettent de donner un contexte, de mieux comprendre les données et de découvrir certains points mis en avant par le producteur des données.

Les metadonnées et les boutons d'actions

Les metadonnées sont disponibles sous forme de fiche. Elles contiennent l'organisme qui a publié la visualisation, le type de visualisation, les boutons d'actions et la date de mise à jour de la visualisation.

Les boutons d'actions permettent d'accéder au code HTML pour intégrer la visualisation à un site externe ainsi qu'à une présentation de la visualisation en plein écran.

Les icones de partage

Les icones de partage vous permettent de rapidement partage le lien de la page sur différents réseaux sociaux.
La vignette du partage correspond à l'aperçu de la visualisation.

La visualisation

Toutes nos visualisations sont interactives. Elles permettent de plus facilement explorer les données.

Données utilisées

Les données utilisées sont présentées sous forme de fiches. Chaque fiche est composée d'un titre, d'une description, de thématiques et de boutons d'actions.
Un clic sur la fiche vous permet d'accéder à la page du jeu de données.

Les pages de contenu sont disponibles dans la barre de navigation sous forme de lien direct vers la page ou de sous-menus. Ces pages permettent de présenter un ensemble de jeux de données, une licence ou une démarche en particulier.
Pour le moment, deux types de présentations de ces pages sont disponibles : les pages thématiques et les pages de présentation libres.

Pages thématiques

Les pages thématiques sont présentées avec une image sous forme de bannière.

Elles sont décomposées en plusieurs blocs, présentant un ou plusieurs jeux de données par bloc.
Les blocs sont composées d'un titre, d'une description, une visualisation et les jeux de données qui lui sont associées.

Pages libres

Les pages libres sont moins structurées que les pages thématiques et sont plus facilement personnalisables.

Elles permettent d'afficher plus de contenus différents et de modifier plus facilement les composants de la page.

Avoir un compte sur un portail vous permet de soumettre des réutilisations, ainsi que d'avoir un accès plus rapide lors des appels aux API.

Dans votre espace personnel, vous avez accès aux données fournies, au renouvellement de mot de passe et à la suppression de votre compte.

Soumettre une réutilisation

Une fois connecté, vous pouvez soumettre une réutilisation à partir de votre espace personnel ou directement sur une page de données.

Renseignez les différents éléments de la réutilisation. Tant que vous n'avez pas soumis votre réutilisation, vous pouvez la modifier.

Quand vous aurez soumis votre réutilisation à l'aide de la flèche verte de la fiche, seuls les administrateurs du portail pourront la modifier et la valider.

Notifications

Cette section vous permet d'activer les notifications globales sur l'ajout de jeux de données sur le portail, ou l'ajout dans une thématique du portail en particulier.

Pour des notifications ciblées sur des jeux de données, visitez la page du jeu de données et cliquez sur la cloche dans les métadonnées.

Clés d'API

Les clés d'api vous permettent d'avoir un meilleur débit pour vos requêtes.
Vous pouvez créer plusieurs clés d'API, le débit sera alors partagé sur l'ensemble de vos clés.

• Un utilisateur anonyme ne peut pas effectuer plus de *cent requêtes par intervalle de cinq secondes. Sa vitesse de téléchargement totale sera limitée à 2 MB/s pour les contenus statiques (fichiers de données, pièces jointes...) et à 500 kB/s pour les autres appels.
• Un utilisateur authentifié (session ou clé d'API) ne peut pas effectuer plus de cent requêtes par intervalle d'une seconde. Sa vitesse de téléchargement totale sera limitée à 4 MB/s pour les contenus statiques (fichiers de données, pièces jointes...) et à 1 MB/s pour les autres appels.