Help:Tabular Data/sv

Tabellarisk data gör så att användare kan skapa CSV-liknande datatabeller och använda dem från andra wikier för att skapa automatiska tabeller, listor och diagram.

För att skapa en ny tabell går du till Wikimedia Commons och skapar en ny sida i namnrymden Data med ett .tab-suffix, såsom. Experimentera gärna genom att skapa sidor med prefixet Sandbox/&lt;username>/. Sidinnehåll kan för tillfället endast redigeras i oformaterat JSON-format och med en grundläggande tabellredigerare, men en finess möjliggör import/export från/till CSV- och Excel-filer. Eventuellt (skrivet 21 november 2016), vi hoppas att det kommer finnas en kalkylblads-liknande editor för att förenkla dataredigering.



Datalicens
Alla data i namnrymden  måste uttryckligen ange datans licens. Den rekommenderade licensen är Public Domain, licensierad under licensen Creative Commons Zero (CC0). För att ange detta måste alla datasidor ha, vilket betyder att datan kan användas under CC0 version 1.0 eller (om du vill) senare versioner. Genom att redigera datan godkänner du användarvillkoren och går med på att oåterkalleligen släppa dina bidrag till allmän egendom under CC0.

Om det inte går att publicera datan under CC0, stöds också följande licenser:


 * 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

Alla mallar som hämtar data från icke-CC0-licensierade datauppsättningar behöver följa relevanta tillskrivningsvillkor, därför rekommenderas det starkt att föredra CC0 närhelst möjligt.

Någon gång i framtiden kan listan över licenser som stöds av namnrymden Data expanderas.



Datatyper
Tabellarisk JSON-data stödjer flera grundläggande värdetyper. Du kan också istället använda värdets  för att markera att det saknas.


 * &mdash; Ett numeriskt värde med en valfri fraktionsdel och kan använda exponentiell E-notation, man kan inte inkludera icke-nummer som NaN.
 * &mdash; tillåter bara värdena  och.
 * &mdash; ett textsträng som inte är längre än 300 tecken lång. Specialtecken som nya rader  och rader   är inte tillåtna.
 * &mdash; En flerspråkig sträng, representerad som ett objekt med nycklar som är språkkoder (t.ex. "sv") och värden som är en sträng med över begränsningen på max 400 tecken. Till exempel,  har strängvärden för både engelska och franska.



Toppnivåfält
Tabellarisk data har flera obligatoriska och valfria topp-nivå-element:


 * &mdash; obligatoriskt fält måste alltid sättas till strängvärdet . Tabellarisk data stödjer för tillfället bara licensen CC0 (Public Domain dedication) version 1.0 eller senare. Stöd för fler licenser kan komma i framtiden.
 * &mdash; obligatoriskt fält måste sättas till ett objekt som innehåller en lista. Varje fält beskriver en kolumn med tabelldata. Varje fält måste vara ett objekt med de obligatoriska värdena  och.
 * &mdash; obligatoriskt fält, är kolumnens namn. 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.
 * &mdash; required field, must be set to one of these values:,  ,  , or.
 * &mdash; optional field, is an optional translation for the column's header. If set, it must be a localized string object.
 * &mdash; 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.
 * &mdash; 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.
 * &mdash; optional field, must be a Wiki markup string value that describes the source of the data.

Användning
Det finns två sätt att använda denna data:


 * 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.

Exempel
See c:Data:COVID-19 cases in Santa Clara County, California.tab for an example of how the JSON data renders on Commons.



Begränsningar och aha

 * 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.



Administratörsanteckningar

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



Konvertera data till JSON
There are several tools available for converting other formats to JSON

CSV and TSV

 * convertcsv.com &mdash; (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 &mdash; Convert xls files to JSON in NodeJS



Se även

 * &mdash; snarlikt strukturerad kartdata i namnrymden Data: på Commons.
 * &mdash; vissa implementeringsdetaljer
 * &mdash; mallar för att skapa diagram med Commons datamängder
 * DataNamespace &mdash; tidigare förslag
 * TheDJ/tabularImportExport.js &mdash; Ett skript för att importera från och exportera till CSV- och Excel-filer, av User:TheDJ.
 * T154071 &mdash; Tillåt icke-CC0-licenser för datamängder
 * T154071 &mdash; Tillåt icke-CC0-licenser för datamängder