Help:Tabular Data/fr

Les données tabulaires permettent aux utilisateurs de créer des tableaux de données au format CSV, et de les utiliser depuis d'autres wikis pour créer automatiquement des tableaux, des listes, ou des graphiques.

Pour créer une nouvelle table, allez sur Wikimedia Commons, et créez une nouvelle page dans l'espace de noms Data avec un suffixe .tab tel que. N'hésitez pas à expérimenter en créant des pages avec le préfixe Sandbox/&lt;username>/. Pour l'instant, le contenu de la page ne peut être édité que dans le format JSON brut et avec un éditeur de table de base, mais un gadget permet d'importer et d'exporter des fichiers CSV et Excel. À terme (écrit le 21 novembre 2016), nous espérons qu'il y aura un éditeur de type tableur pour simplifier l'édition des données.



Licence des données
Toutes les données de l'espace de noms  doivent indiquer explicitement la licence des données. La licence recommandée est du domaine public, sous licence Creative Commons Zero (CC0). Pour indiquer cela, chaque page de données doit avoir, ce qui signifie que les données peuvent être utilisées sous la CC0 version 1.0, ou (à votre choix) n'importe quelle version ultérieure. En éditant les données, vous reconnaissez les conditions d'utilisation et vous acceptez irrévocablement de publier votre contribution dans le domaine public sous licence CC0.

S'il n'est pas possible de publier les données sous la licence CC0, les licences suivantes sont également supportées :


 * CC-BY:
 * CC-BY-1.0: Creative Commons Attribution 1.0
 * CC-BY-2.0: Creative Commons Attribution 2.0
 * CC-BY-2.5: Creative Commons Attribution 2.5
 * CC-BY-3.0: Creative Commons Attribution 3.0
 * CC-BY-4.0: Creative Commons Attribution 4.0
 * CC-BY-4.0+: Creative Commons Attribution 4.0 or later version
 * CC-BY-SA
 * CC-BY-SA-1.0: Creative Commons Attribution-Share Alike 1.0
 * CC-BY-SA-2.0: Creative Commons Attribution-Share Alike 2.0
 * CC-BY-SA-2.5: Creative Commons Attribution-Share Alike 2.5
 * CC-BY-SA-3.0: Creative Commons Attribution-Share Alike 3.0
 * CC-BY-SA-4.0: Creative Commons Attribution-Share Alike 4.0
 * CC-BY-SA-4.0+: Creative Commons Attribution-Share Alike 4.0 or later version
 * ODbL-1.0
 * ODbL-1.0: ODC Open Database License v1.0

Tout modèle important des données de sources hors licence CC0 doit se conformer aux modalités d'attributions pertinentes, il est donc fortement recommandé de préférer la licence CC0 dans la mesure du possible.

Dans le futur, la liste des licences supportées par les données pourra être étendue.



Types de données
Les données JSON tabulaires prennent en charge plusieurs types de valeurs de base. Vous pouvez également utiliser  au lieu de la valeur pour la marquer comme manquante.


 * &mdash; Une valeur numérique avec une partie fractionnelle optionnelle et pouvant utiliser une notation exponentielle, mais qui n'inclut pas les nombres non numériques comme NaN.
 * &mdash; ne permet que les valeurs  et.
 * &mdash; une chaîne de caractères ne dépassant pas 400 caractères. Les caractères spéciaux comme les nouvelles lignes  et les tabulations   ne sont pas autorisés.
 * &mdash; Une chaîne multilingue, représentée comme un objet avec des clés qui sont les codes des langues (par exemple "en"), et des valeurs qui sont des chaînes limitées à 400 caractères. Par exemple,  a des valeurs chaînes de caractères à la fois pour l'anglais et pour le français.



Champs de niveaux supérieurs
Les données tabulaires possèdent plusieurs éléments de niveau supérieur, obligatoires et optionnels :


 * The required  field must always be set to   string value. For now, tabular data only supports CC0 (Public Domain dedication) license version 1.0 or later. More license support may be available in the future.
 * The required  field must set to an object that contains a list. Each field describes a column of the tabular data. Each field must be an object with mandatory   and   values.
 * The required  field is the name of the column. The value must begin with a letter or an underscore , and must only contain letters, underscores, or digits. This is done so that each header can be easily used from a coding environment like Lua or Vega graphs.
 * The required  field must be set to one of these values: ,  ,  , or.
 * The optional  field is an optional translation for the column's header. If set, it must be a localized string object.
 * The required  field must always be set to a list of lists. Each sub-list must have the same number of elements as headers, and must match the value types.
 * The optional  field must be set to a localized string value - an object with at least one key-value, where the key is a language code (e.g. "en"), and the value is a description string.
 * The optional  field must be a Wiki markup string value that describes the source of the data.

Utilisation
Il y a deux façons d'utiliser ces données :


 * A Lua script on any wiki can get this data by calling . The function returns tabular data in almost the same format as the original JSON, except that all localized strings will be converted to regular strings, and the license field will also include a localized license name. To get the data in another language, pass language code as the second parameter. To get the data in the original, unmodified form, use "_" as the language code.
 * A Vega graph can get tabular data by using  as the data source url.

On Commons, transcluding a page from the Data namespace, i.e., will render it as an HTML table. To access data directly on a wiki page, you can import (if you don't already have them) the tabular data module (requires the navbar module) and optionally the tabular query template. (requires the before mentioned tabular data module) With these tools you can easily get the value of a single cell.

Exemple
Voir c:Data:COVID-19 cases in Santa Clara County, California.tab pour un exemple de la manière dont les données JSON sont rendues sur Commons.



Restrictions et pièges

 * Each string value except the  must be no more than 400 symbols long. Special characters like new lines   and tabs   are not allowed.
 * The overall size of the page may not exceed 2MB.



Notes aux administrateurs

 * Site administrators may customize error messages, such as  to make sure editors know about the CC0-only limitation.



Conversion des données en JSON
There are several tools available for converting other formats to JSON

CSV and TSV

 * convertcsv.com (select "CSV to JSON Array") - Generate output as JSON Array, under 'output options' select option 'if to JSON Array, create array for column names with name'. You will still need to manually add "name": and "type": to each entry in "fields" (see example above for formatting)

XLS

 * xls-to-json



Voir aussi

 * - similarly structured map data in the Data: namespace on commons.
 * - some implementation details
 * - templates to do graphs with the Commons Datasets
 * DataNamespace - previous proposal
 * TheDJ/tabularImportExport.js - A script to import from and export to CSV and Excel files, by User:TheDJ.
 * T154071
 * T154071